Setting up the ISPF tables

These are the tables in the SEQQTBL0 library that you must allocate to the ISPF table library (ISPTLIB):

EQQACMDS
ISPF command table
EQQAEDIT
Default ISPF edit profile
EQQELDEF
Default ended-in-error-list layouts
EQQEVERT
Ended-in-error-list variable-entity read table
EQQLUDEF
Default dialog connect table
EQQRLDEF
Default ready-list layouts
EQQXVART
Dialog field definitions

If you use the ISPF command table EQQACMDS, invoke Tivoli Workload Scheduler for z/OS as a separate ISPF application with the name EQQA. Invoking the Tivoli Workload Scheduler for z/OS dialog describes this in more detail. If you want to use a different ISPF application name, for example EQQB, create a command table with the name EQQBCMDS.

The customization of the ISPF Dialog is affected and depends on the ISPF application names. This makes necessary that you create copies of the EQQACMDS and EQQAEDIT members of SEQQBTL0 for each ISPF application and locate these copies in ISPTLIB. For example, for the ISPF application names EQQX and EQQY you need to create the ISPTLIB members EQQXCMDS, EQQYCMDS, EQQXEDIT, and EQQYEDIT.

If necessary, you can modify or create an ISPF command table, using ISPF/PDF option 3.9. Note that ISPF/PDF option 3.9 writes the created or modified table to the data set allocated to the ISPTABL.

Setting up the default dialog-controller connection table

Table EQQLUDEF contains values used when establishing the connection between the scheduler dialog user and the controller. These are default values set initially for your installation by the system programmer. Individual users can then modify the values to suit their requirements. Modify the table, adding the following information:

When a user opens the scheduler dialog 0.1, the scheduler first tries to read the connection table EQQALTCP in the ISPF profile library ISPPROF. The connection table name begins with the NEWAPPL ID specified when invoking the scheduler dialog. For example, if the ISPF application name is EQQB, the connection table name is EQQBLTCP. If you used a different ISPF application name xxxx, the connection table name is xxxxLTCP (if the application name is shorter than four characters, it is filled with x up to length 4). If it cannot find the table, it reads the default connection table EQQLUDEF from the ISPTLIB allocation.

When a user modifies the connection table (through the scheduler dialog option 0.1), the changes are written to the EQQALTCP (or xxxxLTCP ) table of ISPPROF.

To change the distributed EQQLUDEF table:

  1. Choose the scheduler dialog option 0.1.
  2. Set up the dialog-controller connections for the installation.
  3. Copy the connection table EQQALTCP (or xxxxLTCP ) from your ISPF profile library to the scheduler table library allocated to ISPTLIB, renaming the copy to the default connection table name EQQLUDEF.

You can access and work with different controllers from the same TSO session, using ISPF SPLIT to start different Tivoli® Workload Scheduler for z/OS® instances with different ISPF application names. In this case you might want to add more than one option to invoke Tivoli Workload Scheduler for z/OS from the ISPF master application menu, as in the following example:

BODY                                                        
 .                                                            
 .                                                            
 .                                                            
     1 ....... - .............                                
     2 ....... - .............                                
     . ....... - .............                                
     OA OPC - Operations Planning and Control A <===          
     OB OPC - Operations Planning and Control B <===          
     . ....... - .............                                
  PROC                                                        
 .                                                            
 .                                                            
 .                                                            
     1, ....                                                  
     2, ....                                                  
     ., ....                                                  
     OA, 'PANEL(EQQOPCAP) NEWAPPL(EQQA)                       
     OB, 'PANEL(EQQOPCAP) NEWAPPL(EQQB)                       
 .                                                            
 .                                                            
 .                                                            
  END
Note:
Because the value of the ISPF variable &XOPCNM. (displayed in the EQQOPCAP dialog as "You are communicating with xxxx") and the default controller selected in the 0.1 dialog (EQQXLUSL) are stored, respectively, in members xxxxPROF and xxxxLOUT, make sure that any changes you make to these ISPF profile members are made consistently. For example, if you modify or delete xxxxPROF, you must also modify or delete xxxLOUT.

Setting up list tables and graphical attribute tables

The ISPF tables for list layouts, EQQRLDEF and EQQELDEF, are the default tables displayed for all Tivoli Workload Scheduler for z/OS dialog users in your installation. They can be modified to suit an individual user's requirements or you can create new defaults for all users in your installation. Modified tables are stored in the user's ISPF profile library under another member name. Tivoli Workload Scheduler for z/OS: Customization and Tuning describes how to modify the default tables for your installation.

GDDM® default values are used for graphical attributes. The defaults can be modified to suit the requirements of an individual user or you can create default values for all users. Modified defaults are stored in the EQQAXGRC member of the ISPF profile data set.

When setting up these tables for dialog users, keep the following points in mind: