gtpm1m39 | TPF V4R1 Migration Guide: 3.1 to 4.1 |
There are a number of new E-type loader functions that you can use
to load E-type programs to the TPF 4.1 system. The
following information describes the parameters for the ZOLDR command that you
use to perform these E-type loader functions. You can enter the
ZOLDR command in any system state.
See E-Type Loader for more information about the E-type loader.
See TPF Operations for a complete description of the
ZOLDR command.
- ACCEPT
- Replaces the programs at the allocated addresses with the versions of the
programs that are contained in a specified loadset. Once the programs
are replaced, the E-type loader deletes the loadset and returns to the
TPF 4.1 system the fixed file records that were occupied by the
programs in the loadset. There are no fallback capabilities once you
accept a loadset.
- ACTIVATE
- Makes the programs in a specified loadset available for use by new
ECBs. When you activate a loadset, all of the programs contained in
that loadset become available for use at the same time, regardless of whether
the programs reside in main storage or on file. You can load and
activate more than one version of the same program provided that the various
versions are contained in different loadsets. You can activate a
loadset on specific processors or on all processors. You can also
restrict the use of the programs in the loadset to specific ECBs providing you
code the necessary function using the E-type loader selective activate
user exits.
- ALTER
- Changes the allocation characteristics of unallocated programs that are
loaded and activated using the E-type loader, and changes the following
E-type loader default values:
- Threshold value for the number of extra PAT slots
- Threshold value for the number of E-type loader fixed file records
- Maximum number of incompatible PAT slots to report before ending the
E-type loader load function
- Time interval for starting the E-type loader policing routine
- Time interval for starting the E-type loader long running job
detection and reclaim detection routine.
- CLEAR
- Clears and initializes all the file-resident E-type loader
structures.
- DEACTIVATE
- Prevents new ECBs from entering the programs contained in a specified
loadset. This function allows you to fall back to previous versions of
programs. You can deactivate the loadset on specific processors or on
all processors. You can also force active ECBs to exit if they attempt
to use the programs in the deactivated loadset. You can specify whether
the ECBs should issue a system error dump when they exit.
- DELETE
- Deletes a loadset and returns the E-type loader fixed file records
to the TPF 4.1 system.
- DISPLAY
- Displays information about loadsets, specific programs contained in
loadsets, the current program allocation characteristics, and the
E-type loader default values that are currently defined in the
system.
- EXCLUDE
- Removes one or more programs from a specified loadset. When you
exclude a program from a loadset, it is not deleted. The
program can be added to the loadset again using the reinclude function.
- LOAD
- Reads sets of programs from an input device. These sets of programs
are called loadsets. The programs are put into fixed file
records, but cannot be used until they are activated. These fixed file
records are returned to the system when the delete or accept function is
performed on the loadset. You can also use the load function to
allocate programs to the online system.
- RECLAIM
- Rebuilds the E-type loader database to recover any E-type
loader fixed file records that were lost.
- REINCLUDE
- Adds one or more programs to a specified loadset. Only programs
that were previously excluded from the loadset can be reincluded in the
loadset.
There are many differences between loading E-type programs in the
TPF 3.1 system and loading E-type programs in the TPF 4.1
system. These differences are compared in Table 44.
Table 44. Loading and Activating New Versions of Programs
TPF 3.1 System
| TPF 4.1 System
|
- Create an OLD tape that contains the programs you want to load to the TPF
system by running the offline job OLDR.
- Enter the ZOLDR LOAD command to load the programs. Once the load
function is complete, the programs are available to the TPF system.
|
- Create loadsets that contain the programs you want to load to the TPF
system by running the offline job OLDR.
- Enter the ZDSMG DEFINE command to assign a data definition name and device
type to the input device that you specified in the JCL for the offline job
OLDR.
- Enter the ZOLDR LOAD command to load the loadsets.
- Enter the ZOLDR ACTIVATE command to activate the loadsets. Once the
activate function is complete, the programs contained in the loadsets are
available to the TPF system.
|
If you load and activate programs using the E-type loader and those
programs prove unacceptable, you can easily fall back to previous versions of
the programs. Table 45 compares the differences between falling back to previous
versions of programs in the TPF 3.1 system and the TPF 4.1
system.
Table 45. Falling Back to Previous Versions of Programs
TPF 3.1 System
| TPF 4.1 System
|
Enter the ZOLDR FLKB command.
| Enter the ZOLDR DEACTIVATE or ZOLDR EXCLUDE command.
|
If you load and activate programs using the E-type loader and those
programs prove acceptable, you can easily replace the previous versions of the
programs with the new programs. Table 46 compares the differences between accepting new programs on
the TPF 3.1 system and the TPF 4.1 system.
Table 46. Accepting New Versions of Programs
TPF 3.1 System
| TPF 4.1 System
|
Enter the ZOLDR DLET command.
| Enter the ZOLDR ACCEPT command.
|
Table 47 compares the differences between reissuing ZOLDR commands if
there is a TPF system malfunction.
Table 47. Reissuing ZOLDR Commands Should The TPF System Malfunction
TPF 3.1 System
| TPF 4.1 System
|
Enter the ZOLDR REST command.
| The TPF 4.1 system attempts to automatically recover. If it
cannot automatically recover, enter the ZOLDR CLEAR command.
|