CSLSCDRG: deregistration request

By issuing the CSLSCDRD request, you can terminate the connection between the IMSplex member and SCI. After successful completion of this request, the SCI token is no longer valid.

To make subsequent SCI requests, the IMSplex member must create a new connection with SCI with a CSLSCREG request.

CSLSCDRG syntax

CSLSCDRG DSECT syntax

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

Figure 0. The DSECT function
Read syntax diagramSkip visual syntax diagramCSLSCDRGFUNC=DSECT
CSLSCDRG DEREGISTER syntax

The CSLSCDRG FUNC=DEREGISTER request deregisters the IMSplex member from SCI. After successful completion of the CSLSCDRG FUNC=DEREGISTER request, the SCITOKEN is invalid.

Figure 0. The DEREGISTER function
Read syntax diagramSkip visual syntax diagramCSLSCDRGFUNC=DEREGISTERPARM= parmSCITOKEN= scitokenRETCODE= returncodeRSNCODE= reasoncode

CSLSCDRG parameters

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

CSLSCDRG return and reason codes

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

Table 1. CSLSCDRG return and reason codes
Return code Reason code Meaning
X'00000000' X'00000000' The request completed successfully.
X'01000004' X'00001010' z/OS® cross-system coupling facility leave for member failed.
X'01000008' X'00002018' Invalid SCI token.
  X'00002038' Parameter list version is invalid.
X'01000010' X'00004000' SCI is not active on the local LPAR where this SCI request is being issued.
  X'00004014' CSLSDR00 could not be loaded.
  X'00004018' There are still outstanding requests during deregistration.
  X'00004FFF' Function is not supported.
X'01000014' X'00005000' An SCI internal error occurred.
  X'00005004' SCI was unable to add the ESTAE routine.
  X'00005008' A BPE SVC error occurred.
  X'00005020' An ENQ resource error occurred.
  X'00005500' An abend occurred during CSLSCDRG processing.