Install the ISPF IUI Using Screen Prompts

For best results, install the ISPF IUI using screen prompts. You can also install the ISPF IUI using the LIBDEF service. To install the ISPF IUI using screen prompts:

Procedure

  1. Take one of the following actions:
    • Build a CLIST to bring up the ISPF/DTF Primary Option Menu.

      For a quick way to gain access to Sterling Connect:Direct®, build a CLIST that allocates Sterling Connect:Direct files and brings up an ISPF/PDF Primary Option Menu with Sterling Connect:Direct on it. The following sample shows a CLIST that brings up the ISPF/PDF Primary Option Menu. The libraries with the high-level qualifier of $CD are required for Sterling Connect:Direct.

      CONTROL NOMSG
                FREE FILE (SYSPROC                                 -
                          ISPLLIB                                  -
                          ISPPLIB                                  -
                          ISPMLIB                                  -
                          ISPSLIB                                  -
                          ISPCLIB                                  -
                          DMPUBLIB                                 -
                          DMMSGFIL)
      CONTROL MSG
      ALLOC F(SYSPROC) DA(‘SYS1.CLIST’                             -
                       $CD.SDGAISPC’) SHR
      ALLOC F(ISPPLIB) DA(‘$CD.SDGAPENU’                             -
                       ‘SYS1.ISFPLIB’                              -
                       ‘SYS1.ISRPLIB’                              -
                       ‘SYS1.ISPPLIB’                              -
                       ‘SYS1.ICQPLIB’) SHR
      ALLOC F(ISPMLIB) DA(‘$CD.SDGAMENU’                          -
                         ‘SYS1.ISRMLIB’                            -
                         ‘SYS1.ICQMLIB’                            -
                         ‘SYS1.ISPMLIB’) SHR
      ALLOC F(ISPLLIB) DA(‘$CD.SDGALINK’                          -
                         ‘SYS1.ISRLOAD’                            -
                         ‘SYS1.ISPLOAD’) SHR
      ALLOC F(ISPSLIB)  DA(‘$CD.SDGASENU’) SHR
      ALLOC F(DMPUBLIB) DA(‘$CD.SDGAPROC’) SHR
      ALLOC F(DMMSGFIL) DA(‘$CD.MSG’) SHR
      PDF
    • Integrate Sterling Connect:Direct for TSO use.

      Modify the LOGON PROC used to sign on to TSO to integrate Sterling Connect:Direct for TSO use by including the Sterling Connect:Direct libraries. The bold lines in the following sample are inserted for Sterling Connect:Direct. The TSO user must also have access to the ISPF/PDF modules ISPLINK and ISPEXEC.

      //TSO PROC
      //*
      //IEFPROC   EXEC PGM=IKJEFT01,DYNAMBR=25,
      //               PARM="PROFILE MODE WTPMSG MSGID"
      //STEPLIB DD DSN=$CD.SDGALINK,DISP=SHR
      //*
      //SYSPROC DD DSN=$CD.SDGAISPC,DISP=SHR
      //           DD DSN=SYS1.CLIST,DISP=SHR
      //           DD DSN=USER.CLIST,DISP=SHR
      //SYSHELP    DD DSN=SYS1.HELP,DISP=SHR
      //SYSUADS    DD DSN=SYS1.UADS,DISP=SHR
      //SYSLBC     DD DSN=SYS1.BRODCAST,DISP=SHR
      //SYSPRINT   DD TERM=TS,SYSOUT=A
      //SYSTERM    DD TERM=TS,SYSOUT=A
      //SYSTSPRT   DD TERM=TS,SYSOUT=A
      //SYSIN      DD TERM=TS,SYSOUT=A
      //SYSTSIN    DD DDNAME=IEFRDER
      //IEFRDER    DD TERM=TS,SYSOUT=A
      //ISPLLIB DD DSN=$CD.SDGALINK,DISP=SHR
      //           DD DSN=SYS1.ISRLOAD,DISP=SHR
      //           DD DSN=SYS1.ISPLOAD,DISP=SHR
      //ISPPLIB DD DSN=$CD.SDGAPENU,DISP=SHR 
      //           DD DSN=SYS1.ISRPLIB,DISP=SHR
      //           DD DSN=SYS1.ISPPLIB,DISP=SHR
      //ISPMLIB DD DSN=$CD.SDGAMENU,DISP=SHR
      //           DD DSN=SYS1.ISRMLIB,DISP=SHR
      //           DD DSN=SYS1.ISPMLIB,DISP=SHR
      //ISPSLIB DD DSN=$CD.SDGASENU,DISP=SHR
      //           DD DSN=SYS1.ISRSLIB,DISP=SHR
      //           DD DSN=SYS1.ISPSLIB,DISP=SHR
      //ISPTABL    DD DSN=USR.ISPTABL,DISP=SHR /* USER SPECIFIED */
      //ISPTLIB    DD DSN=USR.ISPTABL,DISP=SHR /* USER SPECIFIED */
      //           DD DSN=SYS1.ISRTLIB,DISP=SHR
      //           DD DSN=SYS1.ISPTLIB,DISP=SHR
      //ISPPROF    DD DSN=USR.ISPPROF,DISP=SHR /* USER SPECIFIED */
      //DMPUBLIB DD DSN=$CD.SDGAPROC,DISP=SHR
      //DMMSGFIL DD DSN=$CD.MSG,DISP=SHR
  2. Modify the ISPF/PDF Primary Option Menu for the local IUI (changes are in bold), as follows:
    • For option M, change the file name $CD.MSG to reflect the Message file name specified in the DGACVDEF member of the $CD.SDGACNTL library to display messages in the Sterling Connect:Direct Message file.
    • For option N, change the file name $CD.NETMAP to reflect the name of the VSAM file that contains the Sterling Connect:Direct network map for starting the local IUI.

      The sample shows a modified ISPF/PDF Primary Option Menu.

    %------------ISPF/PDF PRIMARY OPTION MENU--------------------
    %OPTION ===>_ZCMD                                       +
    %
    %                                        +USERID    - &ZUSER
    % 0+SPF PARMS     - Specify ...          +TIME      - &ZTIME
    % 1+BROWSE        - Display ...          +DATE      - &ZDATE
    % 2+EDIT          - Create ...           +JULIAN    - &ZJDATE
    % 3+UTILITIES     - Perform ...          +TERMINAL  - &ZTERM
    % 4+FOREGROUND    - Compile,...          +PF KEYS   - &ZKEYS
    % 5+BACKGROUND    - Compile, Assemble, or Link Edit 
    % 6+COMMAND       - Enter TSO command or CLIST 
    % 7+SUPPORT       - Test dialog or convert menu/message fmts 
    % M+C:D-MSGS      - Display Sterling Connect:Direct messages
    % N+C:D           - Sterling Connect:Direct 
    % X+EXIT          - Terminate ISPF using List/Log defaults 
    % 
    % 
    )INIT 
             .HELP=TTUTOR
             &ZHTOP=TTUTOR
             &ZHINDEX=TINDEX 
    )PROC
             &ZSEL=TRANS( TRUNC (&OPT,‘.’)
               0,‘PANEL(ISPOPT)’
               1,‘PGM(ISPBRO)’
               2,‘PGM(ISPEDIT)’ 
               3,‘PANEL(ISPUTIL)’
               4,‘PANEL(ISPFORA)’
               5,‘PANEL(ISPJOB)’
               6,‘PGM(ISPTSO)’
               7,‘PANEL(ISPQTAC) NEWPOOL’
               M,‘PGM(DGADGDSP) PARM($CD.MSG)’
               N,‘PGM(DGADISTR) PARM($CD.NETMAP) NEWAPPL(CD)’
               X,‘EXIT’ 
    )END
  3. Define VSAM alias (optional).

    In installations with many users, VSAM user catalogs often isolate application files from z/OS system files. If the Sterling Connect:Direct VSAM files are cataloged in a VSAM user catalog, that user catalog must have a VSAM ALIAS defined in the VSAM Master Catalog so that local IU users can find the necessary files. Sterling Connect:Direct files, such as the network map and Message file, must be accessed by the IUI that runs in the user's TSO region.