CSLDMDRG: ODBM client deregistration request

The CSLDMDRG request deregisters an ODBM client with ODBM.

An ODBM client issues the CSLDMDRG request when the ODBM client is finished sending ODBA calls through ODBM. The deregister request cleans up the internal control blocks that ODBM stores for the ODBM client.

CSLDMDRG DSECT syntax

Use the DSECT function of a CSLDMDRG request to include equate (EQU) statements in your program for the CSLDMDRG parameter list length and return and reason codes.
Read syntax diagramSkip visual syntax diagramCSLDMDRGFUNC=DSECT

CSLDMDRG request protocol syntax

Read syntax diagramSkip visual syntax diagramCSLDMDRGFUNC=DEREGISTERECB= ecbODBMNAME= odbmnamePARM= parmRETCODE= returncodeRSNCODE= reasoncodeSCITOKEN= scitoken

CSLDMDRG parameters

The CSLDMDRG parameters specify the ODBM values required for deregistration with ODBM.

The addresses can be specified as either a symbol or a register from 2 to 12.

The CSLDMDRG request includes the following parameters:
ODBMNAME=symbol
ODBMNAME=(r2-r12)
(Required) - Specifies the 8-byte ODBM name to which to send the command deregistration request.

If the value of ODBMNAME is specified as a symbol, the symbol must be the label of the ODBM field. If the value of ODBMNAME is specified as a register, the register must contain the address of the ODBM name field.

PARM=symbol
PARM=(r1-r12)
(Required) - Specifies the CSLDMDRG parameter list. The length of the parameter list must be equal to the parameter list length EQU value defined by DDRG_PARMLN.

If the value of PARM is specified as a symbol, the symbol must denote the start of the parameter list storage. If the value of PARM is specified as a register, the register must contain the address of the parameter list.

RETCODE=symbol
RETCODE=(r2-r12)
(Required) - Specifies a 4-byte field to receive the return code on output. ODBM return codes are defined in the CSLDRR. SCI return codes are defined in CSLSRR.

The return code can be from ODBM (CSLDMDRG) or SCI (CSLSCMSG or CSLSCRQS). If ECB is specified, the RETCODE is not valid until the ECB is posted. All return codes contain the SCI member type indicator for either SCI or ODBM in the high order byte (X'01' for SCI and X'04' for ODBM).

RSNCODE=symbol
RSNCODE=(r2-r12)
(Required) - Specifies a 4-byte field to receive the reason code on output. ODBM reason codes are defined in the CSLDRR. SCI reason codes are defined in CSLSRR.
SCITOKEN=symbol
SCITOKEN=(r2-r12)
(Required) - Specifies a 16-byte field containing the SCI token. This token uniquely identifies this connection to SCI. The SCI token is returned by a successful CSLSCREG FUNC=REGISTER request.

CSLDMDRG return and reason codes

The return and reason codes in the following table can be returned on a CSLDMDRG macro request.
Table 1. CSLDMDRG return and reason codes
Return code Reason code Meaning
X'00000000' X'00000000' The CSLDMDRG request completed successfully.
X'04000010' X'00004004' The client is not registered.
X'00004020' The parameter list version of the parameter list specified on the PARM= parameter is invalid.