Customizing the Legacy ISPF Gateway

You must customize the ISPF configuration file ISPF.conf to host site requirements for ISPF data set allocation. This file is stored, by default, in directory /etc/ispf. The provided sample ISPF.conf has instructions to complete customization so your user site can:

Include the minimum ISPF data set allocations for the gateway to operate. This means allocating the minimum ISPF data sets required to initialize an ISPF session. In the sample provided, these are specified as the isp.sisp* data sets. You might need to change these for your site-specified data set names.
Add additional DDNAME file allocations or concatenate additional ISPF data sets.
Launch a customer-defined allocation executable (exec) to provide further data set allocation by user ID. A sample exec is provided in member ISPZISP2 in the ISPF samples data set ISP.SISPSAMP.

The allocations for each of the ISPF DDs must be specified on a single line with each data set separated by a comma. The maximum length of the string defining the data sets for a DD is 255 characters. If the data sets you want to define for a DD exceed this length, use the customer defined allocation exec to allocate the DD. Comment lines can be added by beginning the line with an asterisk (*). Here is a sample ISPF.conf:

* REQUIRED:
* Below is the minimum requirements for ISPF allocation.
* Change the default ISPF data set names below to match your
* host site.
* Add additional dsn concatenations on same line and separate
* by comma.
* Order of data sets listed is search order in concatenation.
*
sysproc=ISP.SISPCLIB
sysexec=SYS1.LOCAL.EXEC,ISP.SISPEXEC
ispmlib=ISP.SISPMENU
isptlib=ISP.SISPTENU
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB
ispllib=ISP.SISPLOAD,SYS1.LOCAL.LOAD

The ISPF_timeout option in the ISPF configuration file can be used to specify a time out value for reusable ("stateful") ISPF sessions. The time out value specifies the number of seconds a user's ISPF session can remain idle between service call requests. If the idle time exceeds the time out value, the session is terminated and the next service request for the user results in a new ISPF session being established. The default reusable ISPF session time out value is 900 seconds (15 minutes).

Here is an example of setting a time out value of 300 seconds (5 minutes):

ISPF_timeout = 300

Note: If you have the PDSMAN product installed, it must be disabled for use with the gateway by including the record in the ISPF.conf file:

ezyoff=nullfile