Previous Topic: DC/UCF General RegistersNext Topic: Testing for DC/UCF Return Codes


DC/UCF Status Codes

Following each DML request for data communication services, the system places a return code in register 15 to indicate either an error or a specific condition that occurred during processing. Table 3-3 lists the runtime register 15 return codes for the DML statements associated with DC/UCF services. Specific return codes are listed for each command in Chapter 6.

For every DML verb, a register 15 value of X'00' indicates that the request has been serviced successfully.

The following table shows the DC/UCF Runtime Register 15 Return Codes.

R15 Value

DML Verb

Return Condition

X'00'

All verbs

No error

 

#ENQ

  • ACQUIRE—All requested resources have been acquired.
  • TEST—All tested resources have already been enqueued by the issuing task with the EXCLUSIVE/SHARED option specified by the test request.

 

#SETIME

The request to cancel a previously issued #SETIME has been serviced successfully.

X'04'

#ATTACH

The maximum number of tasks has already been attached; no new tasks can be attached at this time.

 

#COMMIT

Internal run-unit table full; check the CA IDMS/DC log for details.

 

#DELQUE

The parameter list is invalid.

 

#DELSCR

The parameter list is invalid.

 

#DEQ

At least one resource id (RSCID) cannot be found; all that were located have been dequeued.

 

#ENQ

  • ACQUIRE—At least one of the resources indicated is currently owned by another task and is not available for the EXCLUSIVE/SHARED option specified; no new resources have been acquired.
  • TEST—At least one of the tested resources is owned by another task and is not available to this task for the EXCLUSIVE/SHARED option specified.

 

#FINISH

There are too many run units for the internal run-unit table. This is a system internal error and should be reported.

 

#GETQUE

The parameter list is invalid.

 

#GETSCR

The parameter list is invalid.

 

#GETSTG

The request specified a storage id that did not previously exist; the indicated space has been allocated.

 

#LINEIN

The input area specified for return of data to the issuing program is too small to accommodate the full data stream; the returned data has been truncated accordingly.

 

#LINK

Either the request cannot be serviced because of an I/O, program-not-found, or potential deadlock error or no null program definition elements (PDEs) have been allocated. If the load fails, the link will fail and a minor code will be returned in register 1.

 

#LOAD

There is not enough space in the program pool to load the program.

 

#MREQ

The specified edit or code table cannot be found or is invalid for use with the named map.

 

#PRINT

An I/O error occurred during processing.

 

#PUTJRNL

The derived journal record length is zero or negative.

 

#PUTQUE

Invalid #PUTQUE request. Check for proper queue-id specification and logical selection of options.

 

#PUTSCR

Invalid request. Check for proper scratch-id specification and logical selection of options as specified in the #PUTSCR statement.

 

#ROLLBAK

Internal run-unit table full; check the CA IDMS/DC log for details.

 

#SENDMSG

An I/O error occurred during processing.

 

#SETIME

For a #SETIME TYPE=CANCEL request, the internal control element (ICE) address specified cannot be found.

 

#STRTPAG

A paging session was already in progress when another #STRTPAG command was issued. An implied #ENDPAG has been processed and the #STRTPAG has been executed successfully.

 

#TREQ

For a #TREQ GET, #TREQ PUTGET, or #TREQ CHECK request, the input area specified for the return of data to the issuing program is too small to accommodate the full data stream; the returned data has been truncated accordingly.

 

#TRNSTAT

A new transaction statistics block (TSB) has been allocated.

X'08'

#ATTACH

The requested task code is invalid.

 

#COMMIT

An invalid request has been issued. #COMMIT is valid only if the program accesses CA IDMS/DB database or dictionary entities (that is, CA IDMS/DB records or DC/UCF scratch/queue records). Typically, #COMMIT need be specified only when CA IDMS/DB database or dictionary entities are accessed in an update usage mode.

 

#DELQUE

The requested queue header record (QUEID) cannot be found.

 

#DELSCR

The requested scratch area id (SAID) cannot be found.

 

#ENQ

  • ACQUIRE—Not applicable.
  • TEST—At least one of the tested resources is not already owned by any task and is available for the EXCLUSIVE/SHARED option specified. If both conditions described for return codes X'04' and X'08' exist, the register 15 value will be X'04'.

 

#FINISH

An invalid request has been issued. #FINISH is only valid if the program accesses CA IDMS/DB database or dictionary entities (that is, CA IDMS/DB records or DC/UCF scratch/queue records). #FINISH need be specified only when the program performs database or dictionary accessing activities.

 

#GETQUE

The requested queue header record (QUEID) cannot be found.

 

#GETSCR

The requested scratch area id (SAID) cannot be found.

 

#GETSTG

There is insufficient storage in the storage pool to process the request.

 

#LINEIN

The I/O session has been canceled; the terminal operator has pressed the CLEAR (3270), ATTENTION (2741), or BREAK (teletype) key.

 

#LINEOUT

The I/O session has been canceled; the terminal operator has pressed the CLEAR (3270), ATTENTION (2741), or BREAK (teletype) key.

 

#LOAD

An I/O error occurred during a load from a load library.

 

#MREQ

I/O has been interrupted; the terminal operator has pressed the ATTENTION (2741) or CLEAR (3270) key.

 

#PRINT

The parameter list passed to #PRINT contains an invalid field.

 

#PUTJRNL

The required storage is not available for the necessary control blocks.

 

#ROLLBAK

An invalid request has been issued. There is a possible logic error in the program. Ensure that checkpoints are made (by means of #COMMIT) in the program logic before the #ROLLBAK request.

 

#SENDMSG

The parameter list is invalid.

 

#TREQ

For a #TREQ GET, #TREQ PUTGET, or #TREQ CHECK request, output has been interrupted; the terminal operator has pressed the ATTENTION (2741) or CLEAR (3270) key.

 

#TRNSTAT

Storage for the transaction statistics block (TSB) is not available; waiting would cause a deadlock.

 

#WAIT

Waiting on the specified ECBs would cause a deadlock.

X'0C'

#ATTACH

The request cannot be serviced due to a security violation.

 

#COMMIT

An invalid status has been issued from DBIO/DBMS; check the CA IDMS/DC log for details.

 

#DELQUE

The requested queue record cannot be found

 

#DELSCR

The requested scratch record id (SRID) cannot be found within the named SAID.

 

#ENQ

  • ACQUIRE—A requested resource cannot be enqueued immediately and waiting would cause a deadlock; no new resources have been acquired.
  • TEST—Not applicable.

 

#FINISH

An invalid status has been issued from DBIO/DBMS; check the CA IDMS/DC log for details.

 

#GETQUE

The requested queue record cannot be found.

 

#GETSCR

The requested scratch record id (SRID) cannot be found within the named SAID.

 

#GETSTG

The parameter list is invalid.

 

#LINEIN

A logical or permanent I/O error has been encountered in the input data stream.

 

#LINEOUT

A logical or permanent I/O error has been encountered in the output data stream.

 

#LOAD

The requested program is nonconcurrent and in use.

 

#MREQ

A logical error (for example, invalid control character) has been encountered in the output data stream.

 

#PRINT

No printer logical terminals have been defined in this DC/UCF system.

 

#PUTJRNL

An invalid error status has been issued from DBIO/DBMS; check the IDMS/DC log for details.

 

#ROLLBAK

An invalid error status has been issued from DBIO/DBMS; check the IDMS/DC log for details.

 

#SENDMSG

The message destination is undefined.

 

#TREQ

For a #TREQ GET, #TREQ PUTGET, or #TREQ CHECK request a logical error (for example, invalid control character) has been encountered in the output data stream.

 

#TRNSTAT

No transaction statistics block (TSB) exists; #TRNSTAT TYPE=BIND has not been issued. This return code is valid only for #TRNSTAT TYPE=ACCEPT and #TRNSTAT TYPE=END statements.

X'10'

#DELQUE

No resource control element (RCE) exists for the queue record; currency has not been established.

 

#GETSTG

The requested storage cannot be allocated immediately (insufficient storage) and waiting would cause a deadlock.

 

#LINEIN

The line request block (LRB) contains an invalid field.

 

#LINEOUT

The line request block (LRB) contains an invalid field.

 

#LOAD

The requested program has been temporarily overlayed in the program pool, resulting in a storage conflict.

 

#MREQ

A permanent I/O error occurred during processing.

 

#PRINT

A print screen request has been made from a non-3270-type terminal or from a 3270-type terminal without read buffer support.

 

#PUTSCR

The request to replace a scratch record has been serviced successfully.

 

#TREQ

For a #TREQ GET, #TREQ PUTGET, or #TREQ CHECK request, a permanent I/O error occurred during processing.

 

#TRNSTAT

Either the task in question is not associated with a terminal or the request is invalid.

X'14'

#LINEOUT

The name specified for DESTID, USERID, or LTERMID is unknown to this DC/UCF system.

 

#LOAD

The requested program is not defined to the program definition table (PDT), the requested program is marked as out of service, or a null program definition element (PDE) could not be allocated for the program.

 

#MREQ

The dial-up line for the terminal is disconnected.

 

#PRINT

Either the specified printer destination is invalid or, for OPTNS=DIRECT, LTEID or LTEADDR is invalid.

 

#PUTSCR

The request to add a new scratch record cannot be processed because the record id specified by the SRID operand already exists for the named scratch area.

 

#TREQ

For a #TREQ GET, #TREQ PUTGET, or #TREQ CHECK request, the dial-up line for the terminal is disconnected.

 

#TRNSTAT

Transaction statistics or task statistics are not enabled in this DC/UCF system.

X'18'

#GETQUE

The user area specified for the return of the queue record is too small; the returned record has been truncated to fit in the available storage space.

 

#GETSCR

The user area specified for the return of the scratch record is too small; the returned record has been truncated to fit in the available storage space.

 

#GETSTG

Allocated XA storage above the 16 megabyte line cannot be addressed by a 24-bit task.

 

#LOAD

The requested program cannot be loaded immediately due to insufficient space; waiting would cause a deadlock.

 

#MREQ

The terminal being used is out of service.

 

#PRINT

A terminal I/O error occurred during a #PRINT request.

 

#TREQ

For a #TREQ GET, #TREQ PUTGET, or #TREQ CHECK request, the terminal being used is out of service.

X'1C'

#DELQUE

An I/O error occurred during a delete queue operation.

 

#DELSCR

An I/O error occurred during a delete scratch operation.

 

#GETQUE

An I/O error occurred during get queue processing.

 

#GETSCR

An I/O error occurred during get scratch processing.

 

#PRINT

No printer can be found to satisfy the print-direct request and OPTNS=NOWAIT has been specified.

 

#PUTSCR

An I/O error occurred during processing.

 

#TREQ

For a #TREQ GET, #TREQ PUTGET, or #TREQ CHECK request, the terminal is closed or was never opened.

X'20'

#ATTACH

The maximum number of concurrent tasks has been reached.

 

#LOAD

An I/O error occurred during a load from the dictionary DDLDCLOD area.

 

#MREQ

The map request block (MRB) contains an invalid field, indicating a possible error in application program parameters.

 

#PRINT

The print-direct request specified an LTEID or LTEADDR that is out of service.

 

#TREQ

The terminal request block (TRB) contains an invalid field.

X'24'

#MREQ

The map load module requested by the map request block (MRB) cannot be found.

 

#PRINT

The print-direct request specified a wait; waiting would cause a deadlock.

 

#TREQ

The name specified for DESTID, LTERMID, or USERID is invalid.

X'28'

#MREQ

The requested map does not support the terminal device type being used.

 

#PRINT

A DCMT VARY PRINTER CANCEL command has been issued in the DC/UCF system for this direct printer.

X'2C'

#MREQ

An error was detected upon return from a user-written edit module. An invalid pointer to the data stream has been returned to register 1.

 

#PRINT

A DCMT VARY PRINTER REQUEUE command had been issued in the DC/UCF system for this direct printer.

X'30'

#MREQ

Invalid internal data has been encountered. Either the data in the record does not match the internal data or the internal data cannot be converted to the external format, as specified in the external picture.

X'34'

#MREQ

The named user-written edit module cannot be found.

X'38'

#MREQ

An invalid immediate write request to DESTID, LTERMID, or USERID has been issued.

X'3C'

#MREQ

The map load module is invalid.

X'40'

#MREQ

For an #MREQ IN request, the requested node for a header or detail was either not present or not updated. For an #MREQ OUT request, there is no current detail occurrence to be updated. No action is taken.

X'44'

#MREQ

No more modified detail occurrences require a mapin. For an #MREQ OUT request, the maximum amount of storage defined for pageable maps during system generation is insufficient.

X'48'

#MREQ

For an #MREQ IN request, the scratch record that contains the requested detail could not be accessed (internal error). For an #MREQ OUT,RESUME request, no detail occurrence, footer, or header fields exist.

X'4C'

#MREQ

For an #MREQ OUT request, the first screen page has been transmitted to the terminal.

X'50'

#MREQ

An #MREQ IN,COND=MPNS or #MREQ OUT,COND=MPNS request has been received when no map paging session is in progress. Either a #STRTPAG command was not issued prior to this #MREQ IN command or a #ROLLBAK was issued that rendered the scratch area for the pageable map (area id MPGPSCRA) unavailable. If the COND specification is not MPNS, this condition abends the map paging task.