Customizing the ISMF Command and Line Operator Tables

This section explains the changes and additions you can make to the ISMF command and line operator tables in the load library.

Restrictions

Do not change the name of the command or line operator. You can, however, change the name of the routine that gets control.
You can replace one of the empty command or line operator tables that ISMF ships with a table of your own, but your table should use the same format as the ISMF tables.The control block, DGTMCTAP, in ISMF Command Table Format DGTMCTAP, contains the format for the command tables. The control block, DGTMLPAP, in ISMF Line Operator Table Format DGTMLPAP, contains the format for the line operator tables. If new commands are added to the tables, ISMF will recognize them.

ISMF Command Table Format DGTMCTAP

   CTAP
    Offsets      Type     Length  Name           Description
    ===========================================================================
          COMMAND TABLE - APPLICATION TABLE (CTAP)
    ===========================================================================
        0    (0) CHARACTER     *  CTAP
        0    (0) CHARACTER     8  CTAPMAIN
        0    (0) CHARACTER     4  CTAPVID        VISUAL ID: 'CTAP'
        4    (4) FIXED         2  CTAPLEN        LENGTH OF CTAP
        6    (6) FIXED         2  CTAPCNT        # OF COMMAND ENTRIES
        8    (8) CHARACTER    28  CTAPENT(*)
        8    (8) CHARACTER     8  CTAPNAME       COMMAND NAME

       16   (10) FIXED         1  CTAPTRUN       MIN. # OF CHARACTERS USED IN
                                                 TRUNCATION
       17   (11) BITSTRING     1  CTAPFLAG       FLAG FIELD
             1...  ....           CTAPST         COMMAND STATUS
             .1..  ....           CTAPIMED       IMMEDIATE COMMAND
             ..1.  ....           CTAPLIST       LIST COMMAND
             ...1  ....           CTAPACMD       ALTERNATE COMMAND
             ....  1111           CTAPRSVD       RESERVED
       18   (12) CHARACTER     8  CTAPRTNM       COMMAND ROUTINE NAME
       26   (1A) CHARACTER     8  CTAPTENM       CMD TERMINATION ROUTINE
       34   (22) BITSTRING     2  *              FILL UP END OF WORD
    Constants
    Length   Type      Value      Name           Description
    ===========================================================================
          END OF COMMAND TABLE - APPLICATION TABLE (CTAP) DEFINE
          COMMAND STATUS BITS
    ===========================================================================
             BIT       1          CMDENABL       COMMAND STATUS IS ENABLE
             BIT       1          CMDDSABL       COMMAND STATUS IS DISABL

ISMF Line Operator Table Format DGTMLPAP

    LPAP
    Offsets      Type     Length  Name           Description
    ===========================================================================
          LINE OPERATOR TABLE - APPLICATION TABLE (LPAP)
    ===========================================================================
        0    (0) CHARACTER     *  LPAP
        0    (0) CHARACTER     8  LPAPMAIN
        0    (0) CHARACTER     4  LPAPVID        VISUAL ID: 'LPAP'
        4    (4) FIXED         2  LPAPLEN        LENGTH OF LPAP
        6    (6) FIXED         2  LPAPCNT        # OF LINE OPERATORS
        8    (8) CHARACTER    28  LPAPENT(*)
        8    (8) CHARACTER     8  LPAPLONM       LINE OPERATOR NAME
       16   (10) FIXED         1  LPAPTRUN       MIN. # OF CHARACTERS USED IN
                                                 TRUNCATION
       17   (11) CHARACTER     3  *              RESERVED, UNUSED
       20   (14) CHARACTER     8  LPAPRTNM       LINE OP ROUTINE NAME
       28   (1C) CHARACTER     8  LPAPTENM       TERMINATION ROUTINE

Finding the Tables

The ISMF tables for line operators and commands are kept in the load library. They are grouped by function. Table 1 lists the application member names for line operators. Table 2 lists the application member names for commands.

Table 1. Member Names for Line Operator Tables
Function:	DFSMSdfp ISMF	DFSMShsm ISMF	DFSMSdss ISMF	ICKDSF ISMF	unused
Data Set Member	DGTTLPD1	DGTTLPD2	DGTTLPD3	none	DGTTLPD5 DGTTLPD6 DGTTLPD7 DGTTLPD8
DASD Volume Member	DGTTLPV1	none	DGTTLPV2	DGTTLPV5	DGTTLPV3 DGTTLPV4 DGTTLPV6 DGTTLPV7 DGTTLPV8
Management Class Member	DGTTLPM1	none	none	none	DGTTLPM2 DGTTLPM3 DGTTLPM4 DGTTLPM5 DGTTLPM6 DGTTLPM7 DGTTLPM8
Data Class Member	DGTTLPB1	none	none	none	DGTTLPB2 DGTTLPB3 DGTTLPB4 DGTTLPB5 DGTTLPB6 DGTTLPB7 DGTTLPB8
Storage Class Member	DGTTLPS1	none	none	none	DGTTLPS2 DGTTLPS3 DGTTLPS4 DGTTLPS5 DGTTLPS6 DGTTLPS7 DGTTLPS8
Storage Group Member	DGTTLPG1	none	none	none	DGTTLPG2 DGTTLPG3 DGTTLPG4 DGTTLPG5 DGTTLPG6 DGTTLPG7 DGTTLPG8
Aggregate Group Member	DGTTLPH1	none	none	none	DGTTLPH2 DGTTLPH3 DGTTLPH4 DGTTLPH5 DGTTLPH6 DGTTLPH7 DGTTLPH8
Optical Volume Member	DGTTLPO1	none	none	none	DGTTLPO2 DGTTLPO3 DGTTLPO4 DGTTLPO5 DGTTLPO6 DGTTLPO7 DGTTLPO8
Optical Library Configuration Member	DGTTLPL1	none	none	none	DGTTLPL2 DGTTLPL3 DGTTLPL4 DGTTLPL5 DGTTLPL6 DGTTLPL7 DGTTLPL8
Optical Drive Configuration Member	DGTTLPR1	none	none	none	DGTTLPR2 DGTTLPR3 DGTTLPR4 DGTTLPR5 DGTTLPR6 DGTTLPR7 DGTTLPR8
Tape Library Configuration Member	DGTTLPY1	none	none	none	DGTTLPY2 DGTTLPY3 DGTTLPY4 DGTTLPY5 DGTTLPY6 DGTTLPY7 DGTTLPY8
List Application Member	DGTTLPZ1	none	none	none	DGTTLPZ2 DGTTLPZ3 DGTTLPZ4 DGTTLPZ5 DGTTLPZ6 DGTTLPZ7 DGTTLPZ8
Mountable Tape Volume Member	DGTTLPT1	none	none	none	DGTTLPT2 DGTTLPT3 DGTTLPT4 DGTTLPT5 DGTTLPT6 DGTTLPT7 DGTTLPT8

Table 2. Member Names for Command Tables
Function:	DFSMSdfp ISMF	DFSMSdss ISMF	NaviQuest	unused
Data Set Member	DGTTCTD1	DGTTCTD2	DGTTCTD6	DCTTCTD3 DGTTCTD4 DGTTCTD5 DGTTCTD7 DGTTCTD8
DASD Volume Member	DGTTCTV1	none	DGTTCTV6	DGTTCTV2 DCTTCTV3 DGTTCTV4 DGTTCTV5 DGTTCTV7 DGTTCTV8
Management Class Member	DGTTCTM1 DGTTCTM2	none	none	DGTTCTM3 DGTTCTM4 DGTTCTM5 DGTTCTM6 DGTTCTM7 DGTTCTM8
Data Class Member	DGTTCTB1 DGTTCTB2	none	none	DGTTCTB3 DGTTCTB4 DGTTCTB5 DGTTCTB6 DGTTCTB7 DGTTCTB8
Storage Class Member	DGTTCTS1 DGTTCTS2	none	none	DGTTCTS3 DGTTCTS4 DGTTCTS5 DGTTCTS6 DGTTCTS7 DGTTCTS8
Storage Group Member	DGTTCTG1 DGTTCTG2	none	none	DGTTCTG3 DGTTCTG4 DGTTCTG5 DGTTCTG6 DGTTCTG7 DGTTCTG8
Aggregate Group Member	DGTTCTH1 DGTTCTH2	none	none	DGTTCTH3 DGTTCTH4 DGTTCTH5 DGTTCTH6 DGTTCTH7 DGTTCTH8
ACS Member	DGTTCTA1 DGTTCTA2	none	none	DGTTCTA3 DGTTCTA4 DGTTCTA5 DGTTCTA6 DGTTCTA7 DGTTCTA8
CDS Member	DGTTCTC1 DGTTCTC2	none	none	DGTTCTC3 DGTTCTC4 DGTTCTC5 DGTTCTC6 DGTTCTC7 DGTTCTC8
Optical Volume Member	DGTTCTO1	none	none	DGTTCTO2 DCTTCTO3 DGTTCTO4 DGTTCTO5 DGTTCTO6 DGTTCTO7 DGTTCTO8
Optical Library Configuration Member	DGTTCTL1	none	none	DGTTCTL2 DGTTCTL3 DGTTCTL4 DGTTCTL5 DGTTCTL6 DGTTCTL7 DGTTCTL8
Optical Drive Configuration Member	DGTTCTR1	none	none	DGTTCTR2 DGTTCTR3 DGTTCTR4 DGTTCTR5 DGTTCTR6 DGTTCTR7 DGTTCTR8
Tape Library Configuration Member	DGTTCTY1	none	none	DGTTCTY2 DGTTCTY3 DGTTCTY4 DGTTCTY5 DGTTCTY6 DGTTCTY7 DGTTCTY8
List Application Member	DGTTCTZ1	none	none	DGTTCTZ2 DGTTCTZ3 DGTTCTZ4 DGTTCTZ5 DGTTCTZ6 DGTTCTZ7 DGTTCTZ8
Mountable Tape Volume Member	DGTTCTT1	none	none	DGTTCTT2 DGTTCTT3 DGTTCTT4 DGTTCTT5 DGTTCTT6 DGTTCTT7 DGTTCTT8

Table 3 lists the member names for the profile application command tables. The tables are used for all applications.

Table 3. Member Names for Profile Application Command Tables
Function	Member Name
DFSMSdfp ISMF commands	DGTTCTP1
DFSMSdss ISMF commands	DGTTCTP2
unused	DCTTCTP3
unused	DGTTCTP4
unused	DGTTCTP5
unused	DGTTCTP6
unused	DGTTCTP7
unused	DGTTCTP8

Making the Changes

There are two ways to change the ISMF tables for line operators and commands. You can add new entries to the existing tables or to one of the unused tables ISMF ships. If you add entries to the ISMF tables, you should also update the ISPF command table.

Whenever a new command is added to an application in ISMF, it must be added to the command table for all applications in ISMF, not only for the application affected.

Modifying the Existing Tables

Because the tables are stored in the load library, you cannot edit them directly.

If you want to make extensive changes

Create your own table following the format that ISMF uses. See ISMF Line Operator Table Format DGTMLPAP for the format of the line operator tables.
Enter the line operators along with the ISMF entries in the new table.
Link-edit the new table under the original member name. This will overlay the original table with your new table.

If you want to make minor changes

you can SUPERZAP the member that contains the table you want to change. However, the next time a link-edit or maintenance is performed on the member, the change will be lost. For information on how to use SUPERZAP, see the publication, z/OS MVS Diagnosis: Tools and Service Aids.

Using One of the Unused Tables

ISMF ships some unused command and line operator tables in the load library. You can use the line operator tables to add your own entries. Table 1, Table 2, and Table 3 list the member names for the unused tables. To make entries in one of the unused tables:

Create a table following the format that ISMF uses.
Enter the new line operators in the table. For new commands, set the CTAPACMD bit to 1. Also, be sure to update the count value in CTAPCNT to reflect the number of entries in the table. See ISMF Command Table Format DGTMCTAP.
Link-edit the table using the member name for the unused table that you want to overlay.