The DFHTST TYPE=REMOTE macro defines temporary storage queue names that reside
in remote CICS® regions when
CICS intercommunication facilities are being used.
Use this macro also to define queues residing in a shared queue pool, which
is treated like a remote region except that the name of the remote system
matches the system name on a DFHTST TYPE=SHARED macro.

>>-DFHTST--TYPE=REMOTE------------------------------------------>
>--,DATAID=(-character-string--+-----------------------+-)------>
'-,character-string,...-'
>--,SYSIDNT=name--+---------------------------+----------------><
'-,RMTNAME=character-string-'
- TYPE=REMOTE
- Indicates that this TST entry defines a set of remote temporary storage
queues, which can reside either in a remote CICS region or in a shared TS
pool in a coupling facility.
- DATAID=(character-string[,character-string,…])|()
- Code
this with one or more alphanumeric TS queue names, where each name can be
up to 8-characters in length. Use 1 to 7 leading characters from the leading
characters of queue names to form generic names of those queues for which
requests are to be routed to a remote region or to a TS server. (See TST—temporary storage table for
information about generic names and matching criteria.)
Note: You cannot
use the list form of the DATAID operand when RMTNAME is specified. If you
specify the RMTNAME parameter, the syntax for DATAID is DATAID=character-string.
- character-string
- Each character string can represent a generic queue name, or a unique
TS queue name. Typically, generic names are specified using 1 to 7 leading
characters of TS queue names. The generic names are those used by application
programs in the region in which this TST is installed.
Multiple names
must be enclosed in parentheses, and separated by a comma. You can omit the
parentheses if you specify only one name.
- ()
- This special operand, without any value between the parentheses, is interpreted
by CICS as specifying any queue that is not more explicitly specified by other
DATAIDs. You can use this as a catch-all in the following way:
- If the queues with names beginning with letters L, M, and N are local,
and these are specified on a TYPE=LOCAL macro with suitable generic DATAIDs,
you can define all other queues as remote by specifying DATAID=() on the TYPE=REMOTE
macro, as follows:
DFHTST TYPE=LOCAL, *
DATAID=(L,M,N)
*
DFHTST TYPE=REMOTE, *
DATAID=()
The DATAID=() option on the TYPE=REMOTE macro is mutually
exclusive with DATAID=() on the TYPE=LOCAL macro, and the TST macro returns
an assembly error if it is specified on both local and remote entries.
DATAID=()
must be the last entry in a set of local and remote entries. Thus, if you
use DATAID=() on remote TS queue entries, the TYPE=REMOTE macros must follow
any TYPE=LOCAL macros.
- SYSIDNT=name
- Identifies
the region or server in which the remote or shared temporary storage queues
reside. For a remote queue owned by another CICS region, the 4-character
alphanumeric name specified must be the same as a REMOTENAME specified in
the CONNECTION definition, or the SYSIDNT name specified on a DFHTST TYPE=SHARED
entry.
You can use this parameter to specify the name of the local region
in which the TST is installed. When the SYSIDNT operand matches the SYSIDNT
specified on the system initialization parameter, the TS queues that match
the DATAIDs are treated as local queues.
- RMTNAME=character-string
- Code
this with the 1- to 8-character prefix that is to be used by CICS to replace
that specified in the DATAID operand when a reference to the temporary storage
queue is transmitted to a remote system or region. This operand defaults to
the character string specified in the DATAID operand. The length of the character
string specified in this operand must be the same as that in the DATAID operand.
This mechanism allows access to a temporary storage queue in the remote system
with the same name as one in the local system.