/CQSET command

Use a /CQSET SHUTDOWN SHAREDQ ON|OFF command to tell CQS whether to take a structure checkpoint during normal shutdown.

You can specify a structure checkpoint for a specific coupling facility or for all coupling facility list structures used by IMS.

Subsections:

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the command and keywords.

Table 1. Valid environments for the /CQSET command and keywords
Command / Keyword	DB/DC	DCCTL
/CQSET	X	X
SHAREDQ	X	X
SHUTDOWN	X	X
STRUCTURE	X	X

The following keywords are valid for the /CQSET command:

SHAREDQ: Specifies that the entire queue structure is to be checkpointed to the structure recovery data set. While the checkpoint is in progress for the structure, no CQS can access the structure.
During a structure checkpoint, every CQS connected to that structure also takes a system checkpoint.
SHUTDOWN: Specifies that CQS should take a structure checkpoint during normal CQS shutdown.
STRUCTURE: Specifies a specific structure name (or all) for which a CQS checkpoint is to be taken. If an overflow structure exists for a structure, a checkpoint is taken for both the primary and overflow structure.

IMS initiates a normal CQS shutdown during a normal IMS shutdown.

This command is valid only in a shared-queues environment.

In an IMSplex, when the /CQS command is issued through OM command processing, it is not serialized through the IMS CTL TCB.

This command can be issued to an IMSplex using the Batch SPOC utility.

Entry ET:

  /CQSET SHUTDOWN SHAREDQ ON STRUCTURE ALL

Response ET:

 DFS058I  CQSET COMMAND COMPLETE

Explanation: CQS will take a structure checkpoint when it shuts down.