gtpm1m39TPF V4R1 Migration Guide: 3.1 to 4.1

Loading E-Type Programs

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:

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.

Loading and Activating New Versions of Programs

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
  1. Create an OLD tape that contains the programs you want to load to the TPF system by running the offline job OLDR.
  2. Enter the ZOLDR LOAD command to load the programs. Once the load function is complete, the programs are available to the TPF system.

  1. Create loadsets that contain the programs you want to load to the TPF system by running the offline job OLDR.
  2. 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.
  3. Enter the ZOLDR LOAD command to load the loadsets.
  4. 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.

Falling Back to Previous Versions of Programs

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.

Accepting New Versions of Programs

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.

Reissuing ZOLDR Commands Should the TPF System Malfunction

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.