CSLSCRQR request return request

CSLSCRQR returns a request to the IMSplex member from which the request originated. It should be issued when the server has completed the request and is ready to return the output from the request. It copies the output back to the requestor's address space.

Only request servers can issue CSLSCRQR because an IMSplex member cannot issue the macro without first receiving a request. A request server must be authorized and running key 7.

CSLSCRQR parameters

PARM=symbol

PARM=(r1-r12)

(Required) - Specifies the CSLSCRQR parameter list. The length of the parameter list must be at least equal to the basic parameter list length of SRQR_PARMLN. However, if you code certain parameters on CSLSCRQR, you must provide a longer parameter list. Use the following table to decide if you must provide a parameter list of a longer length. If you are using more than one parameter listed, and the parameters have different minimum length values, always use the one that ends with the largest numeric value.

Table 1. Parameters that require a parameter list length larger than SRQR_PARMLN

Length EQU	Parameters that require this length
SRQR_PRMLV2	NOCPYABN

You can also define your parameter list to have a length of SRQR_PRMLMX bytes. This EQU is set to the length of the longest CSLSCRQR parameter list version, and the parameter list will always be long enough for any combination of macro parameters. However, this maximum length might change because of maintenance or across IMS releases.

NOCPYABN=N | Y

(Optional) - Specifies how SCI should handle an abend during the copy phase of the request return process.

N

SCI will take a dump and issue a message as determined by the logic in the ARR or FRR. NOCPYABDN=N is the default.

Y

SCI will not take a dump or issue a message if an abend is encountered while it attempts to copy data back to the requestor. SCI will only write an entry to the LOGREC data set.

This parameter was added as part of the Version 2 parameter list. If you include this parameter, your parameter list must be at least equal to the value specified by SQRQ_PRMLV2.

RQSTRC=symbol

RQSTRC=(r1-r12)

(Optional) - Specifies the return code that is associated with the request being returned. This return code will be given to the requesting member in the storage pointed to by the RETCODE parameter of the CSLSCRQS that originated this request. If this parameter is not specified, a return code of zero will be given to the requesting member.

If specified as a symbol, the symbol references storage that contains the return code.

RQSTRSN=symbol

RQSTRSN=(r1-r12)

(Optional) - Specifies the reason code that is associated with the request being returned. This reason code will be given to the requesting member in the storage pointed to by the RSNCODE parameter of the CSLSCRQS that originated this request. If this parameter is not specified, a reason code of zero will be given to the requesting member.

If specified as a symbol, the symbol references storage that contains the return code.

RQSTTKN=symbol

RQSTTKN=(r1-r12)

(Required) - Specifies the request token that is associated with the request being returned. This request token can be obtained from the input exit parameter list (INXP_RQSTTKN) when the request was presented to the request processing member.

If specified as a symbol, the symbol references storage that contains the return code.

RETCODE=symbol

RETCODE=(r1-r12)

(Required) - Specifies the address of a 4-byte field to receive the CSLSCRQR return code. SCI return codes are defined in CSLSRR. Possible return codes for CSLSCRQR are described in the following table.

RSNCODE=symbol

RSNCODE=(r1-r12)

(Required) - Specifies the address of a 4-byte field to receive the CSLSCRQR reason code. SCI reason codes are defined in CSLSRR. Possible reason codes for CSLSCRQR 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.

CSLSCRQR return and reason codes

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