Previous Topic: #PUTQUE ParametersNext Topic: #PUTQUE Example


#PUTQUE Status Codes

By default, the #PUTQUE request is unconditional; a runtime I/O error results in an abend of the issuing task. The issuing program can request return of control with the COND parameter to avoid an abend.

After completion of a #PUTQUE request, the value in register 15 indicates the outcome of the operation:

X'00'

The request has been serviced successfully.

X'04'

The request cannot be serviced; check for proper queue-id specification (for example, a negative queue ID is an improper specification) and for logical selection of options.

X'1C'

A database error occurred during queue processing. A common cause is a DBKEY deadlock. For a PUT QUEUE operation, this code can also mean that the queue upper limit has been reached.

If a database error has occurred, there are usually be other messages in the CA-IDMS/DC/UCF log indicating a problem encountered in RHDCRUAL, the internal Run Unit Manager. If a deadlock has occurred, messages DC001000 and DC001002 are also produced.

If an I/O error occurs while processing a #PUTQUE request, the system returns the address of the communications block to register 1. If no error occurs during processing, a user-defined register, assigned by the RTNQRID parameter, contains the queue record ID of the stored queue record.