IMS Version 9

/CQSET

Format

Read syntax diagramSkip visual syntax diagram                                  .-ON--.
>>-+-/CQSET-+--SHUTDOWN--SHAREDQ--+-----+--STRUCTURE------------>
   '-/CQS---'                     '-OFF-'

     .---------------.
     V               |
>--+---structurename-+-+---------------------------------------><
   '-ALL---------------'

Environments and Keywords

Table 30 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 30. Valid Environments for the /CQSET Command and Keywords
Command / Keyword DB/DC DBCTL DCCTL
/CQSET X X
SHAREDQ X X
SHUTDOWN X X
STRUCTURE X X

Usage

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.

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.

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.

Example for /CQSET Command

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.

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004