OSREQ TSO/E command processor return codes

The OSREQ TSO/E command processor returns to the TSO/E terminal monitor program (TMP) with a return code in register 15. This return code can be tested using the &LASTCC variable in a TSO/E CLIST. In all cases, except one, the return code in register 15 following the OSREQ command is the return code that was returned by the OSREQ macro in register 15. A return code of 20 indicates that the OSREQ TSO/E command processor encountered an error unrelated to the OSREQ macro which it invokes.

The following return codes are returned from the OSREQ TSO/E command processor:

Return code

Description

0

The requested OSREQ function successfully completed.

4

The requested OSREQ function was completed with a warning condition.

8

The requested OSREQ function was not completed due to an application programming error.

12

The requested OSREQ function was not completed due to an environmental error.

20

The OSREQ TSO/E command processor encountered an error during its processing. The following errors will cause a return code of 20:

Error: Description
1: A nonzero return code was received from the TSO/E parse service routine (IKJPARS) in register 15. Error message CBR0402I is issued.
2: A nonzero return code was received from the STORAGE OBTAIN macro when storage was requested for a data buffer for an OSREQ QUERY operation. Error message CBR0403I is issued.
3: The LENGTH keyword was not specified on an OSREQ STORE request. Error message CBR0406I is issued.
4: A nonzero return code was received from the STORAGE OBTAIN macro when storage was requested for a data buffer for an OSREQ STORE operation. Error message CBR0403I is issued.
5: A nonzero return code was received from the STORAGE OBTAIN macro when storage was requested for a data buffer for an OSREQ RETRIEVE operation. Error message CBR0403I is issued.
6: An invalid length was specified on an OSREQ RETRIEVE or COMPARE command. If the DATA option was specified, the length must be 268 435 456 or less. Error message CBR0407I is issued.
7: An invalid offset was specified on an OSREQ RETRIEVE or COMPARE command. Error message CBR0408I is issued.
8: An OSREQ RETRIEVE command was issued with the COMPARE keyword and the data comparison did not match. Or an OSREQ COMPARE command was issued and the data comparison did not match. Error message CBR0421I is issued.
9: Either the OFFSET keyword, the LENGTH keyword, or both the OFFSET and LENGTH keywords were not specified. Since the DATA option was specified and the object's size is greater than 268 435 456, both the OFFSET and LENGTH keywords are required in order to perform the OSREQ RETRIEVE or COMPARE command. Error message CBR0442I is issued.