System definitions for recovery-related functions

You are recommended to use a number of system definitions to ensure that your CICS regions provide the required recovery and restart support for your CICS applications.

System recovery table (SRT)
You are recommended to specify a system recovery table on the SRT system initialization parameter. If you do not specify a table suffix on this system initialization parameter, it defaults to YES, which means that CICS® tries to load an unsuffixed table (which probably won't exist in your load libraries). There is a pregenerated sample table, DFHSRT1$, supplied in CICSTS54.CICS .SDFHLOAD, and if this is adequate for your needs, specify SRT=1$ . This table adds some extra system abend codes to the built-in list that CICS handles automatically, even if you define only the basic DFHSRT TYPE=INITIAL and TYPE=FINAL macros.

If you want to add additional system or user entries of your own, modify the sample table. For information about modifying an SRT, see System recovery table (SRT) .

Resource definitions for recovery
Ensure that your CICS region includes DFHLIST as one of the lists specified on the GRPLIST system initialization parameter. Included in DFHLIST are the following groups, which provide basic recovery functions:
  • DFHRSEND
  • DFHSTAND
  • DFHVTAM

For information about the contents of these groups, see Supplied resource definitions, groups, and lists . For information about individual resource recoverability, see Configuring for recovery of CICS-managed resources.

System log streams and general log streams
Defining system log streams for each CICS region is the most fundamental of all the recovery requirements. A system log is mandatory to maintain data integrity in the event of transaction or system abends, and to enable CICS to perform warm and emergency restarts.

CICS uses the services of the MVS™ system logger for all its system and general logging requirements. The CICS log manager writes system log and general log data to log streams defined to the MVS system logger. For more information, see Logging and journaling.

Files
For VSAM files defined to be accessed in RLS mode, define the recovery attributes in the ICF catalog, using IDCAMS. For VSAM files defined to be accessed in non-RLS mode, you can define the recovery attributes in the CSD file resource definition, or in the ICF catalog, providing your level of DFSMS supports this. For BDAM files, you define the recovery attributes in the FCT.
Transient data queues
If you want your intrapartition queues to be recoverable, specify the recovery option in the definition for each queue. See SESSIONS attributes for information about defining the recovery option, RECOVSTATUS.
Temporary storage queues
If you want your temporary storage queues to be recoverable, specify the RECOVERY(YES) option in their TSMODEL resource definitions. See TSMODEL attributes for information about defining the recovery option.
Program list table (PLT)
Use the DFHPLT macro to create program list tables that name each program executed during initialization or controlled shutdown of CICS.

You specify the PLTPI system initialization parameter for the PLT to be used at initialization, and the PLTSD system initialization parameter for the PLT to be used at shutdown. You can also specify the shutdown PLT on the CICS shutdown command.

If you have global user exit programs that are invoked for recovery purposes, they must be enabled during the second stage of CICS initialization. You can enable these global user exit recovery programs in application programs specified in the first part of the PLTPI.

See Program list table (PLT) for information about defining program list tables.

Transaction list table (XLT)
There are two ways you can specify transactions that can be initiated from a terminal during the first quiesce stage of normal shutdown:
  • Use the DFHXLT macro to create a transaction list table that names the transactions.
  • Specify the SHUTDOWN(ENABLED) attribute on the transaction resource definition.


dfht226.html | Timestamp icon Last updated: Monday, 5 June 2017