Error situations in an attached tool

If one of the pre-configured Application Workflow Manager models (PDS Explorer, SCLM Application, or ChangeMan Application) or custom application models based on the REXX tool adapter TAUTOSAM are used, the attached tools will report error situations in a defined way.

See Workflow Manager Modeling Guide for more information on methods and techniques for tool attachment.

Application Workflow Manager displays an error message when the return code of the attached tool is higher than the value specified by the Application Workflow Manager model administrator under the property Max RC of Application Options in the Application Workflow Manager model. The recommended value for Max RC is 4. Then the following error message is displayed:


Max RC error

Within the message, the return code and message returned by the attached tool are displayed.

The following table shows special return codes typically used in preconfigured Application Workflow Manager models, specifically in models based on the REXX tool adapter TAUTOSAM.

Return code Meaning
0 Attached tool successfully executed; no message window is displayed.
11 The return code of the facility called (such as TSO or ISPF) is higher than the maximum return code specified in the facility call. The message contains the command called and the return code produced by the facility. Look up the meaning of the return code in the corresponding IBM book under the command reported by the message.
99 Undefined variable referenced or syntax error in the attached tool.

In addition to these special return codes, attached tools can return custom created return codes and messages. If the REXX TAUTOSAM is used as a template for custom tool adapters, these custom messages are reported with the same formatting.

The following examples shows the error messages displayed when certain error situations occur within an attached tool: