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.
  4. 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”.


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