Common Return and Reason Codes

Host Environment Commands › ADDRESS MIM Command › Common Return and Reason Codes

Common Return and Reason Codes

The following return codes are common to most functions. In addition to the actual return code in R15, REXX variables MIM.RETURN and MIM.REASON can also be examined.

0

Indicates the command executed successfully and terminated properly.

1

Indicates the command string is too long.

2

Indicates an error occurred during a parsing scan.

3

Received a syntax error from an executing TAPE function. The MIM.REASON normally contains a zero, but may contain one of the following specific codes to indicate the cause of certain errors when received from an executing TAPE function:

1 - An invalid range has been specified.
2 - A count was specified with non-numeric characters.
3 - An invalid hardware address was used under LOCAL search. However, partial results may still be returned.

9

Indicates an error occurred during the creation of a REXX variable.

10

Indicates there is no MIM facility available to service the request.

11

QNAME

Indicates the specified QNAME does not exist. This return code applies only in a case where the NAMELIST option is used, and there is not a single match.

TAPE

Indicates the specified devices do not all matched selection criteria. The reason code contains one of the following specific codes:

1 - Indicates no TAPE devices were found.

2 - Indicates a device list is specified, but only some devices were found.

12

The storage requirement for a response buffer exceeds the allowable limits. If you are running the command as a rule, the storage limitation is 32K. Additional filtration might be necessary to reduce the amount of returning information. If the command is not running as a rule, the limit is the amount of available storage.

13

Indicates the request to free storage has failed.

14

Indicates an abend occurred. MIM.REASON contains the abend code.

16

Indicates the OPS subsystem is not active.

17

Indicates an internal control block error was detected. MIM.REASON contains one of the following specific codes:

1 - Indicates the control block belongs to OPS/MVS.

2 - Indicates the control block belongs to the MIM API.

10nn

Specifies the return codes over 1000 are indicative of an error recognized by the MIM API. The actual MIM return code nn is incremented by 1000. MIM.REASON contains 1 if the error is SSOB related, or 2 if from within the MIM API.