Customizing IPCS interface

If you want a customized interface to be active to select the z/OS® Communications Server dump analysis commands, customize the IPCS panel BLSPPRIM by adding the highlighted lines in Figure 1 to create and activate option 7 on the IPCS Primary Option Menu as shown in Figure 2. This modification allows you to access VTAMMAP directly for dump processing. When this option is selected, control is passed to the ISTDE01 EXEC. This EXEC controls the IPCS panels for the dump formatter.

For information regarding TCP/IP IPCS CLISTs, see z/OS Communications Server: IP Diagnosis Guide.

Figure 1. Sample IPCS panel BLSPPRIM customization

Note: This sample is not necessarily identical to the one on your system.

)ATTR
 /* ================================================================ */
 /*    5685-001 This panel is "Restricted materials of IBM"          */
 /*    (C) Copyright IBM Corporation 1988                            */
 /*    Licensed materials - property of IBM                          */
 /*    Refer to copyright instructions, form number G120-2083        */
 /* ================================================================ */
 ¢ TYPE(INPUT) INTENS(HIGH) CAPS(OFF) JUST(LEFT) PAD(NULLS)
 @ TYPE(TEXT) COLOR(GREEN) INTENS(LOW)
)BODY
%------------------------ IPCS PRIMARY OPTION MENU  ----------------------------
%OPTION  ===>¢ZCMD
                                                           @********************
%   0 +DEFAULTS    - Specify default dump and options      @* USERID  - &ZUSER
%   1 +BROWSE      - Browse dump data set                  @* DATE    - &ZDATE
%   2 +ANALYSIS    - Analyze dump contents                 @* JULIAN  - &ZJDATE
%   3 +SUBMIT      - Submit problem analysis job to batch  @* TIME    - &ZTIME
%   4 +COMMAND     - Enter IPCS subcommand or CLIST        @* PREFIX  - &ZPREFIX
%   5 +UTILITY     - Perform utility functions             @* TERMINAL- &ZTERM
%   6 +DUMPS       - Manage dump inventory                 @* PF KEYS - &ZKEYS
%   7 +VTAM        - VTAM dump analysis commands           %********************
%   T +TUTORIAL    - Learn how to use the IPCS dialog
%   X +EXIT        - Terminate using log and list defaults
 
+Enter%END+command to terminate IPCS dialog
)INIT
  &ZPRIM = YES          /* Always a primary option menu    */
  &ZHTOP = BLSPHELP     /* Tutorial table of contents      */
  .CURSOR = ZCMD
  .HELP = BLSPHELP
  &ZHINDEX = &Z         /* No tutorial index is supplied   */
)PROC
  &PASSLIB = &Z
  IF (&ZDBCS = YES, NO)
    &PASSLIB = PASSLIB
  &ZSEL = TRANS( TRUNC (&ZCMD,'.')
                0,'PGM(BLSGSCMD) PARM(%BLSCSETD)'
                1,'PGM(BLSLDISP) NEWAPPL(BLSL) &PASSLIB'
                2,'PANEL(BLSPSCRN)'
                3,'PANEL(BLSPBKGD)'
                4,'PANEL(BLSPDSLE)'
                5,'PANEL(BLSPUTIL)'                /*            %00A*/
                6,'PGM(BLSGDUIN)'
                7,'PGM(BLSGSCMD) PARM(%ISTDE01) NEWAPPL(ISTD) &PASSLIB'
                t,'PGM(ISPTUTOR) PARM(BLSPTUTR)'
                T,'PGM(ISPTUTOR) PARM(BLSPTUTR)'
              ' ',' '
                x,'EXIT'
                X,'EXIT'
                *,'?' )
)END

Figure 2. Addition of option 7 to the IPCS primary option menu

-----------------------IPCS PRIMARY OPTION MENU--------------------------
OPTION  ===> _
 
 
   0  DEFAULTS    - Specify default dump and options
   1  BROWSE      - Browse dump data set
   2  ANALYSIS    - Analyze dump contents
   3  SUBMIT      - Submit problem analysis job to batch
   4  COMMAND     - Enter IPCS subcommand or CLIST
   5  UTILITY     - Perform utility functions
   6  DUMPS       - Manage dump inventory
   7  VTAM        - VTAM dump analysis commands
   T  TUTORIAL    - Learn how to use the IPCS dialog
   X  EXIT        - Terminate using log and list defaults
 
 
 
Enter END command to terminate IPCS dialog