CSLSCQSC: quiesce request

The SCI Quiesce request tells SCI to stop routing messages and requests that have been routed by TYPE to the issuing IMSplex member. After this request has successfully completed, the only messages and requests that are routed to the member are those that are routed directly by SCITOKEN or by NAME.

Note: Because of the asynchronous nature of the processes within the IMSplex and z/OS®, messages and requests routed by TYPE might still be received by the IMSplex member after successful completion of the CSLSCQSC FUNC=QUIESCE request. The potential for this occurring is small, but it can happen. The IMSplex member must be able to handle a message or request coming in after the CSLSCQSC FUNC=QUIESCE has successfully completed.

CSLSCQSC syntax

CSLSCQSC DSECT syntax

Use the DSECT function of a CSLSCQSC request to include equate (EQU) statements in your program for the CSLSCQSC parameter list length and the CSLSCQSC return and reason codes.

Figure 0.
Read syntax diagramSkip visual syntax diagramCSLSCQSCFUNC=DSECT

CSLSCQSC QUIESCE syntax

The CSLSCQSC FUNC=QUIESCE request quiesces the connection between SCI and the IMSplex member. After the successful completion of the request, only messages and requests that are routed directly by SCITOKEN or by NAME are sent to this IMSplex member.

Figure 0.
Read syntax diagramSkip visual syntax diagramCSLSCQSCFUNC=QUIESCEPARM= parmSCITOKEN= scitokenRETCODE= returncodeRSNCODE= reasoncode

CSLSCQSC parameters

PARM=symbol
PARM=(r1-r12)
(Required) - Specifies the CSLSCQSC parameter list. The length of the parameter list must be equal to the parameter list length EQU value defined by SQSC_PARMLN.
RETCODE=symbol
RETCODE=(r1-r12)
(Required) - Specifies a 4-byte field to receive the return code on output. SCI return codes are defined in CSLSRR. Possible return codes for CSLSCQSC are described in the following table.
RSNCODE=symbol
RSNCODE=(r1-r12)
(Required) - Specifies a 4-byte field to receive the reason code on output. SCI reason codes are defined in CSLSRR. Possible reason codes for CSLSCQSC are described in the following table.
SCITOKEN=symbol
SCITOKEN=(r1-r12)
(Required) - Specifies a 16-byte field containing the SCI token. This token uniquely identifies this connection to SCI. The SCI token was returned by a successful CSLSCREG FUNC=REGISTER request.

CSLSCQSC return and reason codes

The following table lists the return and reason codes that can be returned on a CSLSCQSC macro request. Also included is the meaning of a reason code (that is, what possibly caused it).

Table 1. CSLSCQSC return and reason codes
Return code Reason code Meaning
X'00000000' X'00000000' The request completed successfully.
X'01000008' X'01002038' The parameter list version is invalid.
X'01000010' X'00004000' SCI is not active.
  X'00004FFF' The function is not supported.
X'01000014' X'00005000' An SCI internal error occurred.