Return codes

Table 1 lists the return codes issued by the host command search routine.

Table 1. Return codes from the host command search routine
Return code (decimal)	Description
0	Processing was successful. For the HOSTCMD function, IRXHST located the host command and the host command returned a return code of 0 in register 15. For the ETMODE and NOETMODE functions, IRXHST set or cleared the ETMODE flag successfully.
20	Processing was not successful. For the HOSTCMD function, IRXHST could not locate the specified host command. IRXHST returns -3 in the command output buffer. The command string specified in parameters 3 and 4 may be incorrect, the requested command could not be located in the search order, or the host command environment routine is not defined in the host command environment table. This return code could also indicate a not valid function (parameter 1) passed to IRXHST. Valid functions are HOSTCMD, ETMODE and NOETMODE.
28	Processing was not successful. IRXHST could not locate a language processor environment. The command output area is not modified. Verify that you passed a valid environment block address.
32	Processing was not successful. The parameter list is not valid. The parameter list contains either too few or too many parameters, or the high-order bit of the last address in the list is not set to 1 to indicate the end of the parameter list. The command output buffer is not modified.
100	Processing was not successful. An abend occurred in the specified host command. IRXHST returns the abend code in the command output buffer. The compiler runtime processor should set the REXX special variable RC to this abend code.
`nn`	Processing was successful. The specified host command environment routine returned a non-zero return code. `nn` is the return code from the host command environment routine.