Configuration for other environments

If you plan to invoke the gateway by means other than through the HTTP server of RSE (for example, from the OMVS shell), configuration is required to ensure values are set for environment variables used by the gateway. This requires the environment set-up routine, ISPZXENV, to be modified to set values for the environment variables shown in Table 1.

Table 1. Environment variables to be set by the environment set-up routine, ISPZXENV
Environment variable	Description
STEPLIB	Specifies the STEPLIB data sets from where MVS™ load modules are run. This environment variable must be set to the names of the load library data sets containing the gateway modules (see Table 1) if these modules are not in the LINKLIST.
CGI_ISPCONF	Specifies the CONFIG directory path where the configuration files are stored.
CGI_ISPWORK	Specifies the WORKAREA directory path that is used for temporary files.
CGI_ISPPREF	Specifies the temporary data set prefix.

A sample of this REXX routine is provided in member ISPZXENV in the ISPF installation directory (/usr/lpp/ispf/bin). These lines in ISPZXENV may require modification:

STEPLIB = 'ISP.SISPLPA:ISP.SISPLOAD': The STEPLIB variable should specify the data sets containing the load modules for the TSO/ISPF client gateway (see Table 1). If these load modules reside in the LINKLIST, then the STEPLIB variable should be set to a null value (that is, '').
CGI_ISPCONF = '/etc/ispf': The CGI_ISPCONF variable specifies the HOME directory path where the configuration files reside for the gateway. For more information on the CONFIG directory, see Installing the gateway.
CGI_ISPWORK = '/var/ispf': The CGI_ISPWORK variable specifies the pathname of the directory where work files for the gateway are stored. For more information on the work directory, see Installing the gateway.
CGI_ISPPREF: The CGI_ISPPREF variable specifies the prefix to be used to allocate cataloged z/OS® work files. It supports the use of system variables &SYSUID, &SYSPREF and &SYSNAME. These system variables are described in Using the native API. If not specified, &SYSPREF..ISPF.VCMTEMP is used. The prefix must resolve to a value of 35 characters or less.

Place the amended version of ISPZXENV in a directory referenced before /usr/lpp/ispf/bin in your PATH variable, otherwise you may lose your changes when system maintenance is applied.