Connecting to a common recall queue list structure

Before the CRQ function can be used, an appropriately defined list structure must be configured in the active coupling facility resource manager (CFRM) policy. After configuring the CFRM policy, update your DFSMShsm ARCCMDxx member to include SETSYS COMMONQUEUE(RECALL(CONNECT(basename))).

When SETSYS COMMONQUEUE(RECALL(CONNECT(basename))) is specified in ARCCMDxx, DFSMShsm connects to the specified structure during startup processing. If the SETSYS command is issued after startup, DFSMShsm connects to the structure and then moves any requests on the host's local recall queue to the CRQ.

If the attempt to connect fails due to an environmental error, DFSMShsm retries the connection when the coupling facility signals that the structure is available. Even though the connection may be unsuccessful, the DFSMShsm host is associated with the specified CRQ until a SETSYS COMMONQUEUE(RECALL(DISCONNECT)) command is issued.

A CRQ cannot be shared between separate HSMplexes. To enforce this, each CRQ is associated with the HSMplex that allocated it. DFSMShsm fails any attempt to connect to a CRQ that is not associated with the HSMplex in which a connection request originates.

Related reading

For more information about configuring the list structure, see z/OS DFSMShsm Implementation and Customization Guide.