Overview

Status codes are four-digit runtime status codes that report on the interaction between the user program and the database management system in the CA IDMS environment. Whenever a request for a navigational DML function is processed, a code that reflects the completion status of that function is returned. This code is posted in a four-byte status field (ERROR-STATUS) in the IDMS communications block (DB) or in the IDMS-DC communications block (for DC/UCF).

ERROR-STATUS always contains the code associated with the navigational DML function most recently executed. A value of 0000 indicates that the DML function has been completed successfully. A nonzero value identifies an error condition, or reports a condition to be expected in the course of normal CA IDMS processing. For example, nn07 (the end of a set, area, or indexed set has been reached) or 3210 (new storage has been assigned).

If the value of ERROR-STATUS identifies an error condition, other fields in the communications block supply useful tracking information. RECORD-NAME and AREA-NAME identify the record and area most recently accessed successfully. ERROR-RECORD, ERROR-SET, and ERROR-AREA identify the record, set, and area last involved in the operation that produced the error condition.

The value of ERROR-STATUS is used to control the execution of the program. The user program must check the value of ERROR-STATUS after each navigational DML request. This check can be accomplished with the status-checking routine supplied (IDMS-STATUS) and/or with explicit statements.

Note: For more information about the use of these codes in the programming environment, see the CA IDMS Navigational DML Programming Guide.

Whenever the program detects an unexpected status in database access, the program should issue a ROLLBACK and not a FINISH. Otherwise, incomplete updates may be applied to the database.

Major code (first two digits) — These two digits indicate the DML function (for example, STORE) requested by the program.
Minor code (second two digits) — These two digits indicate the outcome of the requested DML function.

Note: Although every 4-digit code consists of the combination of a major code and a minor code, every minor code cannot be combined with every major code.

User Runtime Codes

The remainder of this chapter documents user runtime codes:

CA IDMS and DC major codes — Lists all major codes and associated DML functions that apply to both CA IDMS, DC, and UCF
CA IDMS minor codes — Lists all minor codes, the most common major/minor combinations, and describes their meanings
DC/UCF minor codes — Lists all minor codes for DC and UCF, the most common major/minor combinations, and describes their meanings