Return codes from a REXX BCPii host command

Table 1. Return codes from a REXX BCPii host command
REXX RC returned from a BCPii host command (in decimal)	Meaning and action
0 HWI_OK	Meaning: BCPii processed the REXX host command successfully. Action: Consult the BCPii return code on the BCPii service call to determine the final result of the request.
1 HWI_REXXParmSyntaxError	Meaning: Program error. The REXX BCPii host command has detected that the format of the parameters is not in the proper form to be accepted by BCPii. Action: Check for a probable coding error. See the BCPii return code on the BCPii service call to determine the reason for the syntax error. See the REXX programming considerations of the BCPii service to see the exact calling specifications. Compare the BCPii REXX service call attempted with service call examples in the supplied BCPii REXX programming sample found in SYS1.SAMPLIB. See the DiagArea for further diagnostic information.
2 HWI_REXXUnsupportedService	Meaning: Program error. An unknown BCPii service name was specified on the BCPii REXX host command. Action: Check for a probable coding error. Specify a valid BCPii service name (for example, HWICONN, HWILIST, and so on).
3 HWI_REXXInvalidNumofParms	Meaning: Program error. The number of parameters specified on the BCPii REXX host command for the service name specified does not match the number of parameters expected. Action: Check for a probable coding error. See the REXX programming considerations of the BCPii service to see the exact calling specifications. Compare the BCPii REXX service call attempted with service call examples found in the supplied BCPii REXX programming sample found in SYS1.SAMPLIB.
4 HWI_REXXStemVarRequired	Meaning: Program error. The BCPii REXX service specified on the BCPii REXX host command is missing one or more required stem variables in the positional parameter list. Action: Check for a probable coding error. See the REXX programming considerations of the BCPii service to see the exact calling specifications. A stem variable parameter must specify a “.” following the variable name (for example, “var.”). Also, compare the BCPii REXX service call attempted with service call examples found in the supplied BCPii REXX programming sample found in SYS1.SAMPLIB.
5 HWI_REXXParmNameTooLong	Meaning: Program error. One or more variables specified on the BCPii REXX service call on the BCPii REXX host command is greater than the BCPii maximum REXX variable length (40). Action: Check for a probable coding error. Reduce the variable name lengths on the BCPii REXX service call to be 40 characters or less in length.
6 HWI_REXXInvalidHostEnv	Meaning: System error. BCPii detected an unexpected error. The system rejects the service call. Action: Search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.
7 HWI_REXXInvokerNotFound	Meaning: Program error. The address space issuing the AXREXX invocation is no longer running. No new BCPii connections are allowed. Action: Determine the reason that the AXREXX-invoking address space terminated prior to the termination of the REXX exec. Correct the situation and start again.
8 HWI_REXXInvalidExecutionEnv	Meaning: Program error. BCPii does not support the BCPii host command running in the current execution environment. If the current execution environment is System REXX, it may mean that an attempt was made to issue a BCPii host command from an exec that was started using the MODIFY AXR command. If the current execution environment is either TSO/E or ISV-provided REXX, it may mean that the requested service was not supported in this environment. Action: Run the BCPii host command from a supported environment.
9 HWI_REXXUnSupportedListType	Meaning: Program error. BCPii does not support the specified ListType on the BCPii HWILIST service in the current execution environment. Action: Correct the specified ListType value or try this request again in a valid execution environment (for example, the System REXX environment).
32 HWI_REXXInternalSystemError	Meaning: System error. BCPii detected an unexpected error while invoking REXX services. The system rejects the service call. Action: A symptom record has been written to LOGREC to record the problem. Search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.
4095 HWI_Unexpected_Error	Meaning: System error. BCPii detected an unexpected error. The system rejects the service call. Action: A symptom record has been written to LOGREC to record the problem. Search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.