Installing the gateway

To install the gateway, customize and run the JCL in the member ISPZINS1 in the ISPF samples data set ISP.SISPSAMP. Customize the JCL according to the instructions in the member.

This job performs these tasks:

Creates CONFIG and WORKAREA directories in the z/OS® UNIX file system at the directory you specify.
Copies the sample ISPF configuration table from member ISPZISPC in the samples data set ISP.SISPSAMP to file ISPF.conf in the CONFIG directory. This file requires customization.

The recommended base directory for the configuration files is /etc/ispf. The part of the directory up to ISPF must exist before running this job.

You must have read and write access to the WORKAREA directory /var/ispf/WORKAREA. The WORKAREA is used for the transfer of files. Temporary directories of the format /var/ispf/WORKAREA/userid/* are created during use of the interface.

Note: Some temporary session files might be created in the /tmp directory. Ensure all users have write access to the /tmp directory.

The interface removes any temporary files it creates in the WORKAREA directory. However, temporary output is sometimes left over, for example, if there is a communication error while processing. For this reason, it is recommended that you clear out the WORKAREA directory from time to time. To do this, use these commands in OMVS:

cd /var/ispf/WORKAREA
rm -r *

Where /var/ispf/WORKAREA depends on where you create the WORKAREA directory.