CQSDEREG request

The CQSDEREG request deregisters a client from CQS and invalidates the CQSTOKEN.

Format for CQSDEREG

DEREGISTER function of CQSDEREG

A CQSDEL request deletes one or more data objects from a queue structure or a resource structure.

Read syntax diagramSkip visual syntax diagramCQSDEREGFUNC=DEREGISTERCQSTOKEN= cqstokenaddressPARM= parmaddressRETCODE= returncodeaddressRSNCODE= reasoncodeaddress

DSECT function of CQSDEREG

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

Read syntax diagramSkip visual syntax diagramCQSDEREGFUNC=DSECT

Usage of CQSDEREG

The CQSDEREG request deregister a client from CQS and invalidates the CQSTOKEN. Prior to issuing this request, the client should issue the CQSDISC request to disconnect from all structures to which the client has a connection. When this request is successfully completed, no subsequent requests can be made to CQS until a CQSREG request has been made to get a new CQSTOKEN.

Parameter Description:

CQSTOKEN=cqstokenaddress
Input parameter that specifies the address of the 16-byte CQS registration token that uniquely identifies the client's connection to CQS. The registration token is returned by the CQSREG request.
PARM=parmaddress
Four-byte input parameter that specifies the address of a parameter list used by the request to pass parameters to CQS. The length of the storage area must be at least equal to the EQU value CQSDEREG_PARM_LEN (defined using the FUNC=DSECT request).
RETCODE=returncodeaddress
Output parameter that specifies the address of a 4-byte field to contain the CQSDEREG return code. The CQSDEREG return code is returned both in this field and in register 15.
RSNCODE=reasoncodeaddress
Output parameter that specifies the address of a 4-byte field to contain the CQSDEREG reason code. The CQSDEREG reason code is returned both in this field and in register 0.

Return and reason codes for CQSDEREG

The following table lists the return and reason code combinations that can be returned for CQSDEREG requests.

Table 1. CQSDEREG return and reason codes
Return code Reason code Meaning
X'00000000' X'00000000' Request completed successfully.
X'00000004' X'00000104' Unable to free CQS's storage in client's address space. The cqstoken is now invalid.
X'00000004' X'00000108' Unable to delete z/OS® Resource Manager routine. The cqstoken is now invalid.
X'00000008' X'00000210' cqstoken is invalid.
X'00000008' X'00000248' The CQSDEREG parameter list version is invalid. This error is probably caused by a difference in versions between the CQS client and the CQS address space the client is trying to use.
X'00000008' X'00000284' Parmlist version is invalid.
X'00000010' X'00000434' Request is active.
X'00000014' X'00000500' CQS internal error. The cqstoken is now invalid.
X'00000014' X'00000504' Storage allocation error for work area.
X'00000014' X'00000518' CQS internal error (unable to create ESTAE).
X'00000014' X'0000053C' Unable to load CQS deregistration module CQSREG10.