Data Manipulation Language Statements › #DELQUE—deletes all or part of a queue › #DELQUE Parameters

#DELQUE Parameters

PLIST=

Specifies the location of the 2-fullword storage area in which the system will build the #DELQUE parameter list.

SYSPLIST

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

parameter-list-pointer

Either a register that points to the area or the symbolic name of the area.

QUEID=

Specifies the 1- to 16-character queue header ID associated with the queue or queue record to be deleted.

queue-id-pointer

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. If the queue header ID is not specified, a blank ID is assumed.

LOC=

Indicates the portion of the queue to be deleted.

CURRENT

(Default); deletes only the current record of the queue associated with the requesting task.

ALL

Deletes all records in the queue and the queue header id.

COND=

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

NO

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

ALL

Specifies that the request is conditional. Control is returned if the delete cannot be serviced for one or more of the reasons listed below.

condition

Specifies under what conditions control should be returned to the issuing program. Multiple values must be enclosed in parentheses and separated by commas. Condition options are as follows:

• NQID—The queue header record cannot be found.
• NRID—LOC=CURRENT has been specified and the record previously established as current of queue cannot be found.
• NRCE—LOC=CURRENT has been specified and no resource control element (RCE) exists for the current record; that is, no record has been established as current of queue.
• IOER—An I/O error occurs while processing the delete.
• INVP—The parameter list built for the #DELQUE is invalid.

NQIDXIT=no-queue-id-label

Specifies the symbolic name of the routine to which control should be returned if the #DELQUE request cannot be serviced because the queue header record cannot be found.

NRIDXIT=no-queue-record-label

Specifies the symbolic name of the routine to which control should be returned if the #DELQUE request cannot be serviced because the record previously established as current of queue cannot be found.

NRCEXIT=no-current-of-run-unit-label

Specifies the symbolic name of the routine to which control should be returned if the #DELQUE request cannot be serviced because no current of queue has been established (no resource control element exists for the queue record).

IOERXIT=i/o-error-label

Specifies the symbolic name of the routine to which control should be returned if the #DELQUE request cannot be serviced because of an I/O error while processing the delete.

INVPXIT=invalid-parameter-list-label

Specifies the symbolic name of the routine to which control should be returned if the #DELQUE request cannot be serviced because of an invalid parameter in the parameter list.

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.