PLT—program list table

A program list table (PLT) contains a list of related programs. You may wish to generate several PLTs for one or more of the following reasons:
  • To specify a list of programs that you wish to be executed in the second and/or third initialization stages of CICS® startup. For more detail about the initialization stages, see the CICS Recovery and Restart Guide. For programming information about restrictions on using programs in the initialization stages, see the CICS Customization Guide. The selected list should be specified at initialization time by the PLTPI=xx system initialization parameter, where xx is the suffix of the PLT that contains the required list of programs.

    For convenience, the list of programs selected for execution during initialization is referred to as the 'PLTPI' list.

  • To specify a list of programs that you wish to be executed during the first and/or second quiesce stages of controlled shutdown. The selected list should be specified at initialization time by the PLTSD=xx system initialization parameter, where xx is the suffix of the PLT that contains the required list of programs.

    The PLT specified in the PLTSD system initialization parameter can be overridden at shutdown time by the PLT option in the CEMT PERFORM SHUTDOWN command.

    The shutdown PLT is normally loaded as CICS is being shutdown. However, it is possible to use the same PLT for both initialization and shutdown, and under these circumstances the PLT is loaded during initialization and CICS does not need to reload it during shutdown. If this is the case and the PLT is updated while CICS is operational, a CEMT SET PROGRAM NEWCOPY command must be issued for the PLT to ensure that the updated version is used when CICS is shutdown.

    For convenience, the list of programs selected for execution during shutdown is referred to as the 'PLTSD' list.

  • To specify a list of programs that you wish to have enabled or disabled as a group by a master terminal ENABLE or DISABLE command. This use of PLTs means that a master terminal operator can enable or disable a set of programs with just one command, instead of using a separate command for each program.
Any number of PLTs can be generated for the above purposes, provided that:
  1. Each PLT has a unique suffix
  2. Each program named in a PLT either has a program resource definition entry in the CSD file, or is capable of being autoinstalled (that is, the appropriate system initialization parameters have been specified for program autoinstall).
    Note: PLTs should not be defined as programs in the CSD.

PLTs must be placed in the DFHRPL library. However, CICS scans the LPA for phase 1 PLTPI programs if they are not already installed.

The following macros are available to define the PLT entries:
  • Control section—DFHPLT TYPE=INITIAL
  • Entries in program list table—DFHPLT TYPE=ENTRY
  • End of Program List Table—DFHPLT TYPE=FINAL (see TYPE=FINAL (end of table))