How to interpret CSL request return and reason codes

Common Service Layer (CSL) return and reason codes indicate the success or failure of sending the request to the CSL address space and reflect the success or failure of the particular CSL request that is being made.

Each of the CSL requests receives a return and reason code that indicates the result of the specified request. Because most of the requests involve more than one component, return and reason codes can originate from any of the components involved. For example, a Structured Call Interface (SCI) return and reason code can be received because SCI is the communications mechanism for these requests. The high order byte is used to help identify the component that set the return and reason codes.

The possible values of the high-order byte and the meanings of each value are:

X'00'

IMS™ set the return and reason code

X'01'

SCI set the return and reason code

X'02'

Operations Manager (OM) set the return and reason code

X'03'

Resource Manager (RM) set the return and reason code

X'04'

ODBM set the return and reason code

Each of the CSL requests have a table of return and reason codes. If you are unable to find the return and reason code for the request that you issued, use the high order byte in the return code to help identify the component that set the return and reason code. For example, if the reason code is X'01' (SCI), you should start by looking at the return and reason codes for the CSLSCMSG and CSLSCRQS macros.

ODBM reason codes are defined in the CSLDRR macro, OM reason codes are defined in the CSLORR macro, RM reason codes are defined in the CSLRRR macro, and SCI reason codes are defined in the CSLSRR macro. These macros can be found in the IMS.SDFSMAC data set.