Translation errors

Errors that occur while REXX is trying to interpret a CICSPlex SM API command result in a REXX return code. If REXX cannot process a command string or function, the run-time interface sets the REXX return code in one of two places:

RC variable

When the ADDRESS CPSM command is used.

The return code value is one of the following:

0

The command was successfully processed.

8

The command contained syntax errors that prevented REXX from processing it. EYUARnnnn messages that describe the error are written to the destination defined on your system for IRXSAY WRITEERR output.

16

The command could not be processed because of some system failure (such as a lack of storage). REXX messages that describe the error may be produced.

-3

The CICSPlex SM API environment is not available. This condition can occur if the function package is not properly installed. If the function package is installed, it could mean that you did not issue at least one EYUxxxx REXX function before invoking the ADDRESS CPSM command.

Function variable

When an EYUxxxx REXX function is used.

For most EYUxxxx functions, the return code value is one of the following:

0

The function was successfully processed.

1

The function failed. EYUARnnnn messages that describe the error are written to the destination defined on your system for IRXSAY WRITEERR output.

For the EYURESP and EYUREAS functions, the return code is either the numeric equivalent of the value being translated or -1, if the translation failed.

In general, if the REXX return code is anything other than:

0

From EYUAPI, EYUINIT, or EYUTERM

A valid RESPONSE or REASON value

From EYURESP or EYUREAS

the API command was not successfully interpreted by REXX and, therefore, was not passed to CICSPlex SM for processing. If a command is not processed, the RESPONSE and REASON values are not set and you do not need to check them.