CSLSCRDY: ready request

The SCI ready request enables the IMSplex member to receive messages and requests that are routed by TYPE. After the CSLSCREG request is issued and until CSLSCRDY is issued, the IMSplex member can only receive requests that are routed directly to a single target address space. The IMSplex member can send messages and requests that are routed by any method.

Note: The IMSplex member must be ready to process messages and requests that have been routed by TYPE when CSLSCRDY is issued. Because of the asynchronous nature of an IMSplex, the member might receive a message or request that has been routed by TYPE before control is returned after issuing CSLSCRDY.

CSLSCRDY syntax

DSECT syntax

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

Figure 0.
Read syntax diagramSkip visual syntax diagramCSLSCRDYFUNC=DSECT

READY syntax

The CSLSCRDY FUNC=READY request tells SCI that the IMSplex member is now ready to receive messages and requests that are routed by an IMSplex member type.

Figure 0.
Read syntax diagramSkip visual syntax diagramCSLSCRDYFUNC=READYSCITOKEN= scitokenPARM= parmRETCODE= returncodeRSNCODE= reasoncode

CSLSCRDY parameters

PARM=symbol
PARM=(r1-r12)
(Required) - Specifies the CSLSCRDY parameter list. The length of the parameter list must be equal to the parameter list length EQU value defined by SRDY_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 reason codes for CSLSCRDY are described in the following table.
RSNCODE=symbol
RSNCODE=(r1-r12)
(Required) - Specifies the address of a 4-byte field to receive the CSLSCRDY reason code. SCI reason codes are defined in CSLSRR. Possible reason codes for CSLSCRDY 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.

CSLSCRDY return and reason codes

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

Table 1. CSLSCRDY return and reason codes
Return code Reason code Meaning
X'00000000' X'00000000' The request completed successfully.
  X'00002038' The 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'00004FFF' The function is not supported.
X'01000014' X'00005000' An SCI internal error occurred.