Data Manipulation Language Statements › #DEQ—releases resources acquired by the issuing task › #DEQ Parameters

#DEQ Parameters

RSCID=

Specifies the resources to be released.

ALL

Requests that the system release all resources acquired by the issuing task by means of the #ENQ requests.

resource-id-pointer-options

Specifies the ID associated with a specific resource to be dequeued. Resource-id-pointer is a register that points to a field containing the id, the symbolic name of a user-defined field containing the id, or the ID literal enclosed in quotation marks. Resource-id-pointer must be enclosed in parentheses.

The optional resource-id-length specifies the length of the resource ID named by resource-id-pointer (up to 256 bytes). Resource-id-length is a register that contains the length, the symbolic name of a fullword, halfword, or byte-length user-defined field containing the length, or an absolute expression. The length of the ID need not be specified if resource-id-pointer is provided as a literal enclosed in quotation marks.

Multiple RSCID parameters must be in successive order, separated by commas.

PLIST=

Specifies the location of the storage area in which the system will build the #DEQ parameter list, as follows.

SYSPLIST

(Default); is the symbolic name of the storage area in which the system will build the #DEQ parameter list.

parameter-value-list-pointer

A register that points to the area or the symbolic name of the area in which the system will build the #DEQ parameter list.

The size, in fullwords, of the parameter-list area is equal to:

1 + 2P + ((R + 3)/4),

where:

• P is the number of resource-id specifications named for the RSCID parameter (described above).
• R is the number of resource-id-length specifications named in register notation for the RSCID parameter.

If RSCID=ALL is specified, the length of this storage area is one fullword; if five resource ids are specified and four have a length indicated in register notation, it is 13 fullwords. (Note that in this case the calculated value of 12.75 was rounded up to a whole number.)

COND=

Specifies whether this #DEQ is conditional and under what conditions control should be returned to the issuing program:

NO

(Default); specifies that the request is not conditional.

IDNF

Specifies that the request is conditional. Control is returned if one or more resource ids identified by the RSCID parameter cannot be found.

IDNFXIT=resource-id-not-found-label

Specifies the symbolic name of the routine to which control should be returned if the #DEQ request cannot be completely serviced because one or more resource ids cannot be found.

ERROR=error-label

Specifies the symbolic name of the routine to which control should be returned if a condition specified in the COND parameter occurs for which no other exit routine was coded. In this case, the ERROR parameter functions the same as IDNFXIT.