/QUIESCE command

The /QUIESCE command initiates the shutdown and deallocates the user for the specified ISC node.

Subsections:

Environment

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

Table 1. Valid environments for the /QUIESCE command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/QUIESCE X   X
NODE X   X
USER X   X

Syntax

Read syntax diagramSkip visual syntax diagram/QUIESCE/QUINODEnodenameUSERusernameALL

Keywords

The following keywords are valid for the /QUIESCE command:

NODE
Specifies the VTAM® node for the user to be shut down and deallocated.
USER
If the USER keyword is omitted, all half-sessions of an ISC node are affected. The half-sessions must be connected.

Restrictions for using NODE and USER parameters together:

  • Commands with the NODE USER keyword pair are valid only if:
    • The USER is signed on to the NODE
    • In an ISC environment, the USER is allocated to the NODE
    • The nodes and users already exist
  • /QUIESCE NODE USER commands are valid for ISC nodes only.

Usage notes

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

The /QUIESCE NODE command is valid for ISC nodes only.

/QUIESCE resets preset mode, test mode, lock node, lock lterm, pstop lterm, and purge lterm because these statuses are not significant and are not kept after a logon or restart. /QUIESCE also takes other actions depending on the recovery settings for the node:

RCVYCONV=NO
/QUIESCE causes any IMS conversations (active and held) to be terminated. Any conversational message that is queued or being processed has its output response message delivered asynchronously.
RCVYFP=NO
/QUIESCE causes Fast Path status and messages to be discarded
RCVYRESP=NO
/QUIESCE resets full-function response mode.

If global resource information is not kept in Resource Manager, /QUIESCE deallocates the user and resets status locally. If global resource information is kept in Resource Manager, /QUIESCE deallocates the user and resets status globally. If the user has no significant status, /QUIESCE deletes the user in Resource Manager. If the node has no significant status, and there are no other half-sessions for the node, /QUIESCE deletes the node in Resource Manager.

If ROUTE is specified, it should be specified with ROUTE(*). The command fails if not routed to the IMS where the node is active.

Example

Entry ET: 
  /QUIESCE NODE CAL USER LAX
Response ET: 
  /DFS058I  QUIESCE COMMAND COMPLETED

Explanation: The half-session of node CAL using user LAX is shut down.