Previous Topic: ADDRESS OPER Return Codes

Next Topic: ADDRESS OPSCTL Host Environment

IMS Type 2 Message Return and Reason Codes

The IMSPLEX manager API interface can generate a variety of unique return and reason codes, documented in IBM manual SC18-9967, IMS V10 System Programming API Ref. Errors associated with API registration can be found under the section CSLSCREG Return and Reason Codes and those with API dialog under CSLOMI Return and Reason Codes.

The ADDRESS OPER implementation utilizes only two of the API facilities. In the case of an error, OPS message 1137 is issued for a registration failure, and message 1138 will accompany a request/response error.

Both messages contain return and response codes, which can be used to look up the specific error condition in the above documentation, in the following format:

return/reason codes = X'aaaaaaaa'/X'bbbbbbbb'

Please note that a registration error will not allow the command to continue. A dialog error, however, can occur after the IMSPLEX manager starts data accumulation and might have incomplete results to return, thus producing a combination of both an error message and valid, but possibly partial, results.

The following error is an indication that the appropriate IMS product load library is not allocated:

X'01000010'/X'00004004' CSLSRG00 could not be loaded.