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, ISPZXENVEnvironment 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.