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.
Read syntax diagramSkip visual syntax diagram
>>-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:
  1. 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.
  2. 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).
  3. 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.