Previous Topic: Install the ISPF Online Retrieval Option

Next Topic: Example 3


(Optional) Step 1: Add STEPLIB Statements

The action you take in this step depends on what you did during the base product installation—specifically, did you:

If the CA Deliver load modules were not copied to one of the libraries in the linklist, proceed with this step; otherwise go directly to the next step.

Follow these steps:

  1. Add STEPLIB DD statements to the TSO LOGON procedures if the load modules are not in a linklist library.
  2. Add a STEPLIB DD statement for the library containing the product's load modules to the LOGON procedures for those TSO users who are going to be using the ISPF online retrieval option.

Note: If you have CA View, the CA View load modules must also be either in the linklist or in a STEPLIB statement with this step.

Step 2: Add the Panel and Command Libraries (ISPF only)

Note: If you are running under SPF, go to Step 3.

If you run CA Deliver under ISPF, proceed with this step.

To add the panel and command libraries to the TSO LOGON procedure:

  1. Concatenate the command table library CAI.CVDETBL0 to DD statement ISPTLIB.
  2. Concatenate the panel library CAI.CVDEPNL0 to DD statement ISPPLIB.

Note: If you also plan to use RMOSPF (the ISPF interface), and multiple versions of CA Deliver, concatenate CAI.CVDETBL0 first. Use the CAI.CVDETBL0 from the most current release.

Step 3: (Optional) Modify an ISPF Selection Menu to Select Online Retrieval

If you want to add a selection code for the online retrieval feature to one of the ISPF selection menus, proceed with this step; otherwise, your detailed instructions for ISPF are complete.

To define your selection code, use the following command:

PGM(RMOSPF) PARM(high-level-database-name) NEWAPPL(RMO)

Use the value next to the NAME parameter on your Initialization Parameter Worksheet for PARM (high-level-database-name).

Note: Adding a selection code allows you to select the online retrieval feature in the same way you would select other ISPF options.

Panel Libraries

The names of the panel libraries vary from site to site and for the different releases of ISPF. These panel libraries are allocated to the ISPPLIB DD statement under TSO.

Be aware that some installations do not allow direct modifications of IBM panels and libraries. In this case, you can place the modified panels in user or site-specific libraries and concatenate them ahead of the IBM libraries.

Ask your system administrator for the specific ISPF panel library that applies to your site and contains the panel ISR@PRIM.

Note: The selection menus shown in the following examples are part of the program product ISPF and are copyrighted by IBM.

Example 1

This example shows you how to add selection code R to the primary option menu ISR@PRIM for ISPF.

The offset lines are the inserted lines.

%----------------------- ISPF/PDF PRIMARY OPTION MENU ------------------------
%OPTION ===>_ZCMD                                                               + 
%                                                           +USERID   - &ZUSER
%   0 +ISPF PARMS -   SPECIFY TERMINAL AND USER PARAMETERS   +TIME  -
%   1 +BROWSE      -  DISPLAY SOURCE DATA OR OUTPUT LISTINGS +TERMINAL -
%   2 +EDIT        -  CREATE OR CHANGE SOURCE DATA        +PF KEYS - &ZKEYS
%   3 +UTILITIES   -  PERFORM UTILITY FUNCTIONS                          
%   4 +FOREGROUND -   INVOKE LANGUAGE PROCESSORS IN FOREGROUND 
%   5 +BATCH       -  SUBMIT JOB FOR LANGUAGE PROCESSING                 
%   6 +COMMAND     -  ENTER TSO COMMAND, CLIST, OR REXX EXEC             
%   7 +DIALOG TEST -  PERFORM DIALOG TESTING                             
%   8 +LM UTILITIES - PERFORM LIBRARY ADMINISTRATOR UTILITY FUNCTIONS  
%   C +CHANGES     -  DISPLAY SUMMARY OF CHANGES FOR THIS RELEASE  
%   R +RMOSPF      -  DELIVER ADMINISTRATION                                    
%   T +TUTORIAL    -  DISPLAY INFORMATION ABOUT ISPF/PDF                 
%   X +EXIT        -  TERMINATE ISPF USING LOG AND LIST DEFAULTS    
%                                                                       
+ENTER%END+COMMAND TO TERMINATE ISPF.                                   
)INIT                                                                   
 .HELP = ISR00003                                                      
 &ZPRIM = YES        /* ALWAYS A PRIMARY OPTION MENU      */           
 &ZHTOP = ISR00003   /* TUTORIAL TABLE OF CONTENTS        */           
 &ZHINDEX = ISR91000 /* TUTORIAL INDEX - 1ST PAGE         */           
)PROC                                                                   
 &ZSEL = TRANS( TRUNC (&ZCMD,'.')                                      
                0,'PANEL(ISPOPTA)'                                      
                1,'PGM(ISRBRO) PARM(ISRBRO01)'                          
                2,'PGM(ISREDIT) PARM(P,ISREDM01)'                       
                3,'PANEL(ISRUTIL)'                                      
                4,'PANEL(ISRFPA)'                                       
                5,'PGM(ISRJB1) PARM(ISRJPA) NOCHECK'                    
                6,'PGM(ISRPTC)'                                         
                7,'PGM(ISPYXDR) PARM(ISR) NOCHECK'                      
                8,'PANEL(ISRLPRIM)'                                     
                C,'PGM(ISPTUTOR) PARM(ISR00005)'                        
            R,'PGM(RMOSPF) PARM(RMO.SYSTEM1) NEWAPPL(RMO)'         
                T,'PGM(ISPTUTOR) PARM(ISR00000)'                        
               ' ',' '                                                  
                 X,'EXIT'                                               
                 *,'?' )                                                
   &ZTRAIL = .TRAIL                                                     
 )END

Note: