TSO logon procedure

Figure 1 is a sample TSO logon procedure (logon proc) to allocate the ISPF data sets required to execute ISPF.

Figure 1. TSO logon procedure

//ISPF     PROC
//ISPF     EXEC PGM=IKJEFT01,DYNAMNBR=100
//*
//STEPLIB  DD DSN=ISP.SISPLPA,DISP=SHR
//         DD DSN=ISP.SISPLOAD,DISP=SHR
//         DD DSN=CEE.SCEERUN,DISP=SHR
//         DD DSN=CEE.SCEERUN2,DISP=SHR
//*
//ISPMLIB  DD DSN=ISP.SISPMxxx,DISP=SHR
//         DD DSN=SYS1.SBPXMENU,DISP=SHR
//*
//*SYSHELP DD DSN=ISP.SISPHELP,DISP=SHR
//*
//ISPPLIB  DD DSN=ISP.SISPPxxx,DISP=SHR
//         DD DSN=SYS1.SBPXPENU,DISP=SHR
//*
//ISPSLIB  DD DSN=ISP.SISPSxxx,DISP=SHR
//         DD DSN=ISP.SISPSLIB,DISP=SHR
//*
//ISPTLIB  DD DSN=userid.ISPTABLE,DISP=SHR
//         DD DSN=ISP.SISPTxxx,DISP=SHR
//         DD DSN=SYS1.SBPXTENU,DISP=SHR
//*
//ISPILIB  DD DSN=ISP.SISPSAMP,DISP=SHR
//*
//SYSPROC  DD DSN=ISP.SISPCLIB,DISP=SHR
//         DD DSN=SYS1.SBPXEXEC,DISP=SHR
//*
//SYSEXEC  DD DSN=ISP.SISPEXEC,DISP=SHR
//*
//ISPTABL  DD DSN=userid.ISPTABLE,DISP=SHR
//*
//ISPPROF  DD DSN=userid.ISPTABLE,DISP=OLD
//*

The default names ISP.SISPyxxx are used for the ISPF data sets, where xxx represents the national language:

Language: xxx
US English: ENU
Japanese: JPN
German: DEU
Swiss German: DES
Uppercase English: ENP

Note: For information about data sets that are required by other products for them to run under ISPF, see the z/OS V2R2 Program Directory and the documentation for the specific product.

This logon procedure assumes that all data sets are cataloged and that SYSEXEC is included in the search order for REXX execs on your system. See z/OS TSO/E REXX User's Guide and z/OS TSO/E Command Reference for details about controlling the search order for REXX execs.

Start of change If you plan to allow the use of multiple ISPF sessions, the user's logon procedure must be configured to allow profile sharing. This option avoids enqueue lock outs and loss of profile updates when the same profile data set is used for concurrent ISPF sessions. With profile sharing enabled, the user's logon procedure is required to allocate ISPF profile data sets with the disposition SHARED, rather than NEW, OLD, or MOD, and the data sets must already exist. Or, these data sets must be temporary data sets. For more information, see Customizing for profile sharing. End of change

If you are using TSO line mode support, your logon procedure must invoke the alternate entry point PGM=IKJEFT1I. The TSO Line mode support cannot be used with the ISPF load modules in STEPLIB. Many of the ISPF load modules must be in the pageable link-pack area. See Set up ISPF GUI for TSO Line Mode support for more information.

This logon procedure includes the optional ISPILIB allocation. ISPILIB is used for images in Graphic Image Format (GIF) that are used by ISPF when running in GUI mode. For more information about using ISPF's image support, refer to the z/OS V2R2 ISPF User's Guide Vol I.

If an ISPLLIB is allocated when you use a STEPLIB to test new maintenance, releases, or versions of ISPF, you must include the data sets allocated to STEPLIB that contain ISPF load modules in the ISPLLIB allocation. This prevents mixing production code with code to be tested. For more information about library search order, refer to the z/OS V2R2 ISPF Services Guide.

The SCEERUN and SCEERUN2 libraries are required in STEPLIB or LNKLST if you plan to use either the ISPF Client/Server feature or the z/OS® UNIX Directory List utility. SCEERUN and SCEERUN2 are the Language Environment® run-time library data sets and contain run-time modules required by C/C++ code used by these ISPF features. These libraries must be in STEPLIB or LNKLST for the modules to be loaded at execution time. These modules are not searched for using the ISPLLIB allocation. See Language Environment considerations for more information.

If you plan to use the z/OS UNIX Directory List utility, these libraries must be allocated as shown in Figure 1: SYS1.SBPXMENU, SYS1.SBPXPENU, SYS1.SBPTMENU, SYS1.SBPXEXEC.

You must use a unique user profile data set (userid.ISPTABLE) in the sample logon procedure for each national language. If you do not, the result is mixed language messages and prompts. The data set userid.ISPTABLE must have record format FB, LRECL 80, and a block size that is a multiple of 80. You might want to allocate the ISPPROF, ISPTABLE, and ISPTLIB DDs in a REXX exec that is executed by the PARM on the EXEC statement of the logon procedure.