Executing a BCPii REXX exec in an ISV-provided REXX environment

BCPii supports the invocation of its APIs from ISV-provided REXX programming environments, provided that the REXX execs running in this environment are program-authorized.

Because BCPii support is not native to ISV-provided REXX environments, the BCPii host command environment must first be enabled. To accomplish this, the BCPii REXX exec must first invoke the BCPii-provided hwihost function to enable the BCPii host command environment prior to any BCPii API invocation using "address bcpii".

Note: It is also recommended (but not required) that you invoke the hwihost function to disable the BCPii host environment when it is no longer needed by the BCPii REXX exec.

To enable the BCPii host command environment, add the following statement to your BCPii REXX exec:

RC = hwihost("ON")

To disable the BCPii host command environment, add the following statement to your BCPii REXX exec:

RC = hwihost("OFF")

Invocations of the hwihost function in an exec running in either the System REXX or TSO/E REXX programming environments are ignored, and the resulting return code is always zero. This ensures compatibility of REXX execs running in any REXX programming environment on z/OS.