Host Environment Commands › ADDRESS HWS Commands › ADDRESS HWS Return and Reason Codes in REXX Programs

ADDRESS HWS Return and Reason Codes in REXX Programs

When an error occurs, regardless of the value of DEBUG an error message with the ID OPS0341S is created. This error message contains the return and reason code. These codes are also placed into REXX variables. When any ADDRESS HWS command executes in a REXX program, the variable HWSRC and HWSRS in that program contains the return and reason codes. The return code is:

0

The command has executed successfully.

>0

The host command issuing the HWS command contained errors.

8

The command has failed, and an error message was issued.

12

A nonzero return code was received from HiSrv. The first two bytes of the reason code were set and an error message was issued.

16

The host environment has abended while processing the HWS command.

The reason code is a hex value where the first two bytes contain the HiSrv reason code or zeros if there is no HiSrv error. The third byte is zeros, and the fourth byte contains one of the following reason codes:

X'10

Internal error accessing control blocks. Contact CA support and provide the full return and reason codes.

X'11'

The INITHWS parameter was not set.

X'12'

Attempting to run from within a rule.

X'20'

Internal parsing error. Contact CA support and provide the full return and reason codes.

X'21'

Internal parsing error. Contact CA support and provide the full return and reason codes.

X'22'

Internal parsing error. Contact CA support and provide the full return and reason codes.

X'23'

Unrecognized attribute name.

X'24'

The attribute type was not supported.

X'30'

HiSrv connection error. Contact CA support and provide the full return and reason codes.

X'31'

No entity was specified.

X'32'

HiSrv internal communication error. Contact CA support and provide the full return and reason codes.

X'33'

Parent entity was not specified.

X'34' X’35’

HiSrv error connecting to a target entity. Contact CA support and provide the full return and reason codes.

X'36'

HiSrv disconnect error.

X'37'

HiSrv GETATTR error.

X'38'

HiSrv SETATTR call error.

X'39'

HiSrv SENDCMD call error.

X'40'

Internal error, invalid attribute length. Contact CA support and provide the full return and reason codes.

X'41'

An internal REXX variable error. Contact CA support and provide the full return and reason codes.

X'42'

An internal REXX variable error. Contact CA support and provide the full return and reason codes.