Tailoring Screens, Task Codes, and Entry Options › Customizing Screen Displays

Customizing Screen Displays

Performance Monitor allows you modify screens and save them in the dictionary. This capability is controlled by the SITESAV and USERSAV parameters of the #PMGEN macro:

• USERSAV allows Performance Monitor users to save test versions (that is, versions other than 1) of monitor screens
• SITESAV allows Performance Monitor users to save all versions (including version 1) of monitor screens

The following pages tell you how to modify and save version 1 of Performance Monitor screens.

What you can do

You can modify the format of Performance Monitor screen displays (using EDIT and SORT) and save the screen load modules in the dictionary (using SAVE). For example, you can use these facilities to change the display size or the column order in the display. You can also specify that a certain field be displayed in descending order so that you can easily detect high activity.

Note: You should not edit screens whose window format is FIXED. To determine a window's format, use the ADMIN screen.

How to do it

To tailor a Performance Monitor screen, perform the following steps:

1. Sign on to a DC/UCF system.
2. Set a session test version of 1 by using the DCUF TEST command.
3. Set a session default dictionary by using the DCUF SET DICTNAME command.

   This name should specify the dictionary to which users are signed on while using Performance Monitor.

4. Sign on to Performance Monitor.
5. Make the screen the default window, as described in the CA IDMS Performance Monitor User Guide.
6. Make any required changes using the EDIT and SORT windows. For more information about EDIT and SORT, see the CA IDMS Performance Monitor User Guide.
7. Issue the SAVE command to request that Performance Monitor save the load module for the modified screen in the dictionary.

   A Performance Monitor subtask saves the load module in the session default dictionary. Because the session version was set to 1 (in Step 2), the load module is saved as version 1.

   Note: Because a subtask performs the save processing, all other active windows are available to you while the save occurs.

Restrictions

In order to save revised screen displays in this way (that is, in order to save version 1), the SITESAV parameter of the #PMGEN macro must specify YES. This macro is included in each of the three Performance Monitor initialization modules and is described in Part One of this manual.

Sample scenario

You can follow the steps below to tailor the screens for a component of Performance Monitor (Realtime Monitor, Interval Monitor, or Application Monitor):

1. Generate the #PMGEN macro with SITESAV=YES for the component whose screens are being changed, then complete the Performance Monitor installation.
2. Modify and save screen displays specific to your site.
3. Recode the #PMGEN macro with SITESAV=NO, then reassemble and relink the initialization module for the component.

Notes and suggestions

Observe these following guidelines:

• Users signed on to DC with a default version of 1 will use the modified screen displays automatically. To use the modified displays, ensure that your default DC version number (modified by the DCUF TEST command) is 1.
• Users signed on to DC under a test version (a version other than 1) use screen displays saved under their test version. If there is no screen display load module for their test version, they use the modified display.
• In order to ensure use among multiple dictionaries, you may want to punch the saved load module to a load library. This library must be ahead of the Performance Monitor load library in the CDMSLIB concatenation or search sequence.
• In order to allow certain users to always have site save capability, you may choose to implement separate task codes. This is explained in Tailoring Task Codes later in this appendix.

Example of tailoring and saving screens

The example below shows how to tailor and save the Active User Tasks screen used by the Realtime Monitor.

1. Press [PF4] to make the Active User Task Detail screen the default window.
2. Type edit at the CMD--> prompt.

   PM-R17.0 SYSTEM71               CA, Inc.                 V71      10.158 12:02:56.34
   

   CMD-->                                                         Window : 02
                                                                  Refresh: 10
     02 Active User Task Detail                                                 >
     Task       Task      Current Task  Link                     Task  Ecblist
     Number     Code      Program  Pri Level User_ID  Lterm_ID Status  Address
     1796       PMRM     PMWNDRVR  252                VL71001  RUN    00000000
   

   Press [Enter] to display the Edit Window Format screen.

3. Press [PF6] to display the screen for editing the window fields.

   PM-R17.0 SYSTEM99                CA, Inc.                  V72      10.158 15:34:18.54
   

   CMD-->                                                           Window : 02
                                                                    Refresh: 10
     02 EDIT Window Format - PF6 for Window Edit                               i
             Field  Field                                  Required Displayable
    Command  Order Number Field Name                       Field    Field
       _         1      1 Task_Number                         YES       YES
       _         2      2 Task_Code                           YES       YES
       _         3      3 Current_Program                     YES       YES
       _         4      4 Priority                            NO        YES
       _         5      5 Link_Levels                         NO        YES
       _         6      6 User_ID                             NO        YES
       _         7      7 Lterm_ID                            NO        YES
       _         8      8 Task_Status                         NO        YES
   

4. To move a field, enter m in the Command column of the field to move, and enter a in the Command column of the field that you want the moved field to follow. For example, to move Task_Status after Priority, enter m in the Command column for Task_Status, a in the Command column for Priority, and then press [Enter]. Repeat this step for each field you want to move.

   Note: For more information about the EDIT facility, see the CA IDMS Performance Monitor User Guide.

5. Press [PF3] to display the Active User Task Detail screen and verify the changes.
6. To save the changes permanently, type save at the CMD--> prompt and press [Enter].

   Performance Monitor tells you the module name, version, and dictionary for the saved load module for the screen.

   PM-R17.0 SYSTEM99                CA, Inc.                  V72      10.158 15:34:18.54
   

   CMD-->                                                          Window : 02
                                                                   Refresh: 10
     02 Save Site - Window Overrides
   The Window Load Module will be saved according to the following information:
           Module: PMRTMTSK
          Version:    98
         Dictname:
         Dictnode:
    PRESS PF6 IN ORDER TO CONFIRM SAVE.
   

7. Press [PF6] to save the load module and version shown.

   Performance Monitor displays the message SAVE OF WINDOW DEFINITION IS IN PROGRESS. When the save is complete and the screen refreshes (either automatically or when you press [Enter]), Performance Monitor displays the message SAVE OF WINDOW DEFINITION SUCCESSFULLY COMPLETED.