Configuring the ISPF gateway

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.

Before you begin

You must install several PTF services for the ISPF gateway to function correctly with the z/OS deployment tools. See the following technical document for more information: http://www.ibm.com/support/docview.wss?uid=swg27042018.

Procedure

  1. 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.
  2. 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
  3. 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)
  4. 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
  5. 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.
  6. 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.

Feedback