After you install the IBM® z/OS® deployment
tools, you must configure the ISPF gateway on the z/OS server
to support IBM UrbanCode Deploy.
Procedure
- Open the ISPF gateway configuration file for editing. The ISPF gateway configuration file is defined by the CGI_ISPCONF variable
in the ISPZXENV environment file. The ISPZXENV environment
file is typically installed in the /usr/lpp/ispf/bin directory.
- Open the ISPF.conf file for editing. The ISPF.conf file, which is provided with z/OS,
contains customizable settings for the ISPF gateway. The concatenations
in the default ISPF.conf file look like the following
code:
sysproc=ISP.SISPCLIB
sysexec=ISP.SISPEXEC
ispmlib=ISP.SISPMENU
isptlib=ISP.SISPTENU
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB
ispllib=ISP.SISPLOAD
- Add the modules for the z/OS deployment
tools to the concatenations in the ISPF.conf file. The modules for the z/OS deployment
tools are the following files: hlq.SBUZEXEC, hlq.SBUZMENU,
and hlq.SBUZENV(BUZPROF). Edit
the ISPF.conf file to look like the following
code:
sysproc=ISP.SISPCLIB,hlq.SBUZEXEC
sysexec=ISP.SISPEXEC
ispmlib=ISP.SISPMENU,hlq.SBUZMENU
isptlib=ISP.SISPTENU
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB
ispllib=ISP.SISPLOAD
profile=hlq.SBUZENV(BUZPROF)
- If you plan to run programs or REXX executable files during
a deployment by calling an ISPF command, add the programs or REXX
executable files to the concatenations in the ISPF.conf file. In the ISPF.conf file, make load module
data sets available in the ISPLLIB concatenation,
and make executable files available in the SYSPROC or SYSEXEC concatenations. For example, the following ISPF.conf file
concatenations load modules for programs and REXX executable files.
The modules that are loaded are MYPROJ.MYCLIST, MYPROJ.MYREXX,
and MYPROJ.LOAD.
sysproc=ISP.SISPCLIB,hlq.SUCDEXEC,MYPROJ.MYCLIST
sysexec=ISP.SISPEXEC,MYPROJ.MYREXX
ispmlib=ISP.SISPMENU,hlq.SBUZMENU
isptlib=ISP.SISPTENU
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB
ispllib=ISP.SISPLOAD,MYPROJ.LOAD
- Ensure that the user account that you use to run the startispf.sh script
has access to the /tmp directory. The startispf.sh script
starts the ISPF gateway. This script is provided with the z/OS deployment
tools. The script is installed in the tool_installation_directory/bin directory.
- Edit the startispf.sh script file
to add the directory where the ISPF gateway is installed to the PATH variable. Additionally, the LOG_ISPF variable must
be set to a valid file location.
Results
You can run commands through the ISPF gateway. To test the
ISPF gateway configuration, issue the following command:
startispf.sh
TIME. If the ISPF gateway is configured correctly, the output
of the time sharing option (TSO)
TIME command is
displayed.
What to do next
Create a ship list file to identify the content to deploy.