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.