Displaying OAM and OSREQ reason code information

You can display reason code information for the OAM and OSREQ macros directly from a console or a TSO session, as of APAR OA58344 for V2R3 or later. These commands can also be invoked via JCL to aid in automation of error information capturing in real time.

From a console environment

To display reason code information for the OAM macro, issue the following operator command:

DISPLAY OAM,OAMRC,xxyy

where xxyy represents the 4-digit OAM reason code.

To display reason code information for the OSREQ macro, issue the following operator command:

DISPLAY OAM,OSREQRC,wwxxyyzz

where wwxxyyzz represents the 8-digit OSREQ reason code.

Examples:

If you issue DISPLAY OAM,OAMRC,0420, you will see the following display:
```
CBR0803I OAM reason code: 0420 Message: Object name is missing.
```

If you issue DISPLAY OAM,OSREQRC,04020402, you will see the following display:

CBR0803I OSREQ reason code: 04020402 Function: STORE Message: STORE,
STOREBEG, or CHANGE has completed but one or more of the following                     
conditions occurred, as indicated by bits set in byte 3 (02). The                      
bitmap messages determined for byte 3 are as follows:                                  
xxxxxx1x: Storage class specified for the object was overridden

From a TSO environment (command shell)

To display reason code information for the OAM macro, issue the following OAMUTIL command:

OAMUTIL OAMRC xxyy

where xxyy represents the 4-digit OAM macro reason code.

To display reason code information for the OSREQ macro, issue the following OAMUTIL command:

OAMUTIL OSREQRC wwxxyyzz

where wwxxyyzz represents the 8-digit OSREQ reason code.

Examples:

If you issue OAMUTIL OAMRC 0420 CBR0803I, you will see the following display:

OAM reason code: 0420 Message: Object name is missing. CBR0434I OAMRC successful.

If you issue OAMUTIL OSREQRC 04020402, you will see the following display:

CBR0803I OSREQ reason code: 04020402 Function: STORE Message: STORE, STOREBEG, or CHANGE has completed but one or more of the following conditions occurred, as
indicated by bits set in byte 3 (02). The bitmap messages determined for byte 3 are as follows:                                                                
xxxxxx1x: Storage class specified for the object was overridden                                                                                                
CBR0434I OSREQRC successful.