Recoverable temporary storage: DFHTST TYPE=RECOVERY
The DFHTST TYPE=RECOVERY macro specifies the generic names used for temporary storage queues for which recovery is applicable.
>>-DFHTST--TYPE=RECOVERY----------------------------------------> >--,DATAID=(-character-string--+-----------------------+-)----->< '-,character-string,...-'
- TYPE=RECOVERY
- Code this to identify the temporary storage queue names that are recoverable. If
a temporary storage queue name is such that it is defined by both
a remote and a recovery DATAID, it is considered to be remote. Recoverability
can only be specified in the CICS® region in which the queue
is local. Note: TYPE=ENTRY is retained for compatibility with previous releases, and means exactly the same as TYPE=RECOVERY.
- DATAID=(character-string[,character-string,…])|()
- Code
this with one or more alphanumeric TS queue names that you want to
be recoverable, where each name can be up to 8-characters in length.
(See TST: temporary storage table for
information about generic names and matching criteria.)
- character-string
- Each character string can represent a generic queue name,
or a unique TS queue name. Generic names are specified using 1 to
7 leading characters of TS queue names. DATAIDs that use all 8 characters
define unique queues names. Multiple names must be enclosed in parentheses, and separated by a comma. You can omit the parentheses if you specify only one name. Some CICS-generated TS queue names that you should consider for recovery are:
- DF refers to temporary storage queues used by CICS interval control for START commands with data, but which do not specify a REQID.
- ** refers to temporary storage queues used by the BMS ROUTE command, and to those commands that use the PAGING operand.
- $$ refers to temporary storage queues used by the BMS CMSG transaction when the PROTECT=YES option is specified on a START TRANSID command.
- ()
- This special (null) operand, without any value between the parentheses, is interpreted by CICS as specifying any queue that is not more explicitly specified by other DATAIDs.
Note:- If a TST is generated with no TYPE=RECOVERY entries, no recovery processing is performed. If an EXEC CICS START command is issued with any of the FROM, RTRANSID, RTERMID, or QUEUE parameters specified, and a REQID is not specified, CICS generates request identifications starting with the prefix “DF”. If recovery is required for these requests, the TST should be generated with the corresponding generic name.
- All temporary storage queues used by restartable transactions (those defined with RESTART(YES) in the transaction resource definition) should be made recoverable (including those with the default DF prefix).
- Only data on auxiliary storage can be made recoverable. Data written to main storage is not recoverable, regardless of any recovery options that you may specify.
- When a task modifies temporary storage data designated as recoverable, the data is protected from modification by a concurrent task by enqueuing on the queue name. The queue name is not dequeued until the task terminates or issues a task syncpoint request to designate the end of a logical unit of work. At this time a log record is written to the system log data set to provide external information sufficient to recover the data if the system subsequently terminates abnormally.
Example
This DFHTST TYPE=RECOVERY macro defines recoverable temporary storage queues:DFHTST TYPE=RECOVERY,
DATAID=(DF,**,
$$(,character-string)...)
- The DATAID DF makes the temporary storage queues used on CICS start requests recoverable.
- The DATAIDs ** and $$ make the default temporary storage queues used by BMS recoverable.
- The DATAID character string represents the leading characters of each temporary storage queue identifier that you want to be recoverable. For example, DATAID=(R,ZIP) makes recoverable all temporary storage queues that have identifiers starting with the character “R” or the characters “ZIP”.
