Temporary storage data sharing—DFHTST TYPE=SHARED

The DFHTST TYPE=SHARED macro specifies the remote system name by which CICS® identifies a temporary storage pool in the coupling facility.
Read syntax diagramSkip visual syntax diagram
>>-DFHTST--TYPE=SHARED--,SYSIDNT=system-name--,POOL=pool-name--><

TYPE=SHARED
indicates that this TST entry defines a mapping between a system identifier (SYSIDNT) specified on a TYPE=REMOTE entry and a pool of TS data sharing queues.
SYSIDNT=system_name
specifies the 1- to 4-character system name that corresponds to a TS pool name.
CICS uses this SYSIDNT to map remote queues (defined by a TYPE=REMOTE entry, or an explicit SYSID on an API command) to a TS server, as follows:
  • If an API temporary storage command specifies a remote queue explicitly (by means of the SYSID option), CICS maps the SYSID to a matching SYSIDNT on a TYPE=SHARED entry:
    • If a matching SYSIDNT is found, CICS uses the corresponding POOL name to identify the TS server that manages the shared TS queue.
    • If the SYSID does not match any TYPE=SHARED entry, the request is function shipped to the remote queue-owning region (QOR) named by SYSID.
  • If an API temporary storage command references a remote queue identified by a TYPE=REMOTE entry, CICS checks for a matching SYSIDNT in the TYPE=SHARED entries:
    • If a TYPE=SHARED entry with a matching SYSIDNT is found, CICS uses the corresponding POOL name to identify the TS server that manages the shared TS queue.
    • If a TYPE=SHARED entry is not found, the queue is a remote queue and the request is function shipped to the QOR.

You can create multiple TYPE=SHARED entries, with different SYSIDNT names, that refer to the same POOL name. In this case, references to the same queue name refer to the same queue name regardless of which SYSID is used (on the API).

POOL=pool_name
specifies the 1- to 8-character name of the pool of TS queues that is to be used for TS requests that specify, implicitly or explicitly, the corresponding system name. The pool-name must match the name specified on the POOL parameter of the TS server that manages the TS pool.