Creating a screen definition

This section how to create a screen definition that combines several product views into a single screen. In the example used for this section, a company uses CICS, Db2, and IMS to operate an international parts distribution system. Remote sites in Asia, Europe, and South America issue CICS transactions to place orders for replacement parts from a central warehouse. The parts inventory system is managed by Db2 and IMS. A typical transaction consists of a thread that may extend through all three subsystems for completion.

The VistaPoint PARTORDR application is composed of CICS, Db2, and IMS workloads. Workloads are organized by the geographic region of the company's offices. Each product's workloads report the performance of their subsystem as they process remote transactions to order parts.

Enter reset to clear the screen.
Use the SETD dialog to establish the default context for your views.
The following figure shows the SETD dialog screen to set the default context, product, and scope for your views:
-------------------- SET DEFAULT CONTEXT, PRODUCT AND SCOPE ---------------
COMMAND ===>

Default Window Parameters:

Context ===> PRODUCTN
Product ===> MVVP
Scope ===> *

Type END to set default window parameters
CANcel to quit without setting
The SETD dialog establishes the default window settings for new windows. Subsequent views inherit the context, product, and scope values specified with the SETD dialog.
Press your END key to set your context with the same values displayed on the SETD dialog screen.
Enter apgrpr to display a real-time summary of the product workloads within VistaPoint applications.
Warning
Note
In this section, views from BMC AMI Ops Monitor for CICS, BMC AMI Ops Monitor for Db2, and BMC AMI Ops Monitor for IMS are used to build a customized screen. If your site does not have all of these products installed, substitute a combination of VistaPoint and product views that you think would make a good combination for your site.
Create a second window with the VS command.
Make the window about half the width of the screen. After you have created the second window, your screen should look like this.
08NOV2000 12:07:52 ----------- INFORMATION DISPLAY ---------------------------
COMMAND ===>                                              SCROLL ===> PAGE
CURR WIN ===> 2        ALT WIN ===>
>W1 -APGRPR-----------(PRODUCTN-*---- T2 =====================================
CMD Appl     Type       Avg % Obj     |
--- -------- ----       0.....50...100|
   FINANCE CICS 69.56 ******        |
    PAYROLL CICS 75.69 ********      |
    FINANCE DB2 76.40 **********    |
    PARTDIST IMS 83.59 ***********   |
    FINANCE MVS 86.40 ***********   |
    PARTDIST CICS 93.45 ************ |
    PARTDIST DB2 94.78 ************ |
Place 1 in the CURR WIN field and 2 in the ALT WIN field as shown in the example below.
08NOV2000 12:07:52 ----------- INFORM
COMMAND ===>
CURR WIN ===> 1 ALT WIN ===> 2
>W1 -APGRPR-----------(PRODUCTN-*----
By doing this, you are setting window 2 to display the hyperlink view that you will invoke from the APGRPR view shown in window 1.
Move the cursor over the word CICS shown beneath the highlighted Type field of the APGRPR view and press Enter.
08NOV2000 12:14:54 ----------- INFORMATION DISPLAY ---------------------------
COMMAND ===>                                            SCROLL ===> PAGE
CURR WIN ===> 1        ALT WIN ===>
>W1 =APGRPR===========(PRODUCTN=*===== >W2 -COBJR------------(PRODUCTN-*-------
CMD Appl    Type         Avg % Obj     | CMD Workload       % <= Resp Goal Resp
--- -------- ----        0.....50...100| --- Name----       0.....50...100 Goal
   FINANCE CICS 69.56 ******        |     POJAPAN 34.35 *****           1.0
    PAYROLL CICS 75.69 ********      |     POMEXICO 39.98 *****           0.3
    FINANCE DB2   76.40 **********    |     POFRANCE 42.22 ******
    PARTDIST IMS   83.59 ***********   |     POBRAZIL 50.89 *******
    FINANCE MVS   86.40 ***********   |     POSWEDEN 52.04 *******
    PARTDIST CICS 93.45 ************ |
    PARTDIST DB2   94.78 ************ |
This shows the COBJR view that appears in window 2 after completing the hyperlink from APGRPR.
The xOBJ series of views summarize response or elapsed time performance of transactions occurring within product targets that are defined as part of VistaPoint workloads. The xOBJ views allow you to see which product workloads within an application are performing well or not.
Divide the screen horizontally by placing the cursor directly over the vertical border separating W1 and W2 and executing the hs command.
This action creates a third window that extends the full width of the screen.
Success
Tip
After your screen is split into two or more windows, the width and height of subsequent windows depends on where you place the cursor before issuing the HSplit or VSplit commands:
- Full width or height windows: Place the cursor directly on the line separating the windows to create another window that extends the full width or height of the screen or to the next window border.
- Partial width or height windows: Place the cursor at the screen location where you want the top or left margin of the new window to begin. The window extends the full width or height between the screen border and an existing window.
Type 1 in the CURR WIN field and 3 in the ALT WIN field. Window 3 will receive the hyperlink view that you invoke from the APGRPR view.
Move the cursor over the word DB2 shown beneath the highlighted Type field of the APGRPR view and press Enter.
The following figure shows the screen divided into three different windows, each with a different product view:
08NOV2000 12:14:54 ----------- INFORMATION DISPLAY ---------------------------
COMMAND ===>                                          SCROLL ===> PAGE
CURR WIN ===> 1        ALT WIN ===>
>W1 =APGRPR===========(PRODUCTN=*===== >W2 -COBJR------------(PRODUCTN-*-------
CMD
    Appl     Type      Avg % Obj      | CMD Workload       % <= Resp Goal Resp
--- -------- ----       0.....50...100| --- Name----       0.....50...100 Goal
   FINANCE CICS 69.56 ******        |     POJAPAN 34.35 *****           1.0
    PAYROLL CICS 75.69 ********      |     POMEXICO 39.98 *****           0.3
    FINANCE DB2 76.40 **********    |     POFRANCE 42.22 ******
    PARTDIST IMS 83.59 ***********   |     POBRAZIL 50.89 *******
    FINANCE MVS 86.40 ***********   |     POSWEDEN 52.04 *******
    PARTDIST CICS 93.45 ************ |
    PARTDIST DB2 94.78 ************ |
W3 -DOBJR------------(PRODUCTN-*-------)08NOV2000----12:18:43----MVDB2---------5
CMD Workload        % <= Resp Goal Resp Goal Avg     Tran Composite Target
--- Name----        0.....50...100 Goal- % Resp--- Count Workload- --------
   PSMEXICO 92.08 ************* 0.50 95 046.500    12 PARTDIST CICSMEX1
    POSWEDEN 93.65 ************* 1.00 90 087.450    10 PARTDIST CICSSWE1
    P0FRANCE 93.84 ************* 1.00 90 092.555     9 PARTDIST CICSFRA2
    POBRAZIL 95.46 ************* 0.50 95 046.229     6 PARTDIST CICSBRZ4
    POJAPAN   96.25 ************* 0.80 90 074.782    22 PARTDIST CICSJPN4
The next step is to create a fourth window and place the BMC AMI Ops Monitor for IMS IOBJR view in it.
Split window 3 in half by entering VS from the COMMAND line, and then place the cursor directly beneath the vertical border between windows 1 and 2 and press Enter.
You should have four windows that divide the screen into equal quarters. Window 4 is still empty. You need to place the BMC AMI Ops Monitor for IMS IOBJR view in it by hyperlinking from the APGRPR view shown in window 1.
Place 1 and 4 in the CURR WIN and ALT WIN fields respectively.
Move the cursor over the word IMS shown beneath the highlighted Type field of the APGRPR view and press Enter.
The following figure shows the completed custom screen. Each window contains a separate product view of the parts ordering workloads. The APGRPR view shown in window 1 summarizes performance of the PARTDIST application by CICS, Db2, and IMS workloads. The remaining views show the performance of the individual product workloads that belong to the PARTDIST application:
08NOV2000 12:14:54 ----------- INFORMATION DISPLAY ---------------------------
COMMAND ===> SCROLL ===> PAGE
CURR WIN ===> 1 ALT WIN ===>
>W1 =APGRPR===========(PRODUCTN=*===== >W2 -COBJR------------(PRODUCTN-*-------
CMD Appl     Type        Avg % Obj     | CMD Workload       % <= Resp Goal Resp
--- -------- ----        0.....50...100| --- Name----       0.....50...100 Goal
   FINANCE CICS 69.56 ******        |     POJAPAN 34.35 *****           1.0
    PAYROLL CICS 75.69 ********      |     POMEXICO 39.98 *****           0.3
    FINANCE DB2   76.40 **********    |     POFRANCE 42.22 ******
    PARTDIST IMS   83.59 ***********   |     POBRAZIL 50.89 *******
    FINANCE MVS   86.40 ***********   |     POSWEDEN 52.04 *******
    PARTDIST CICS 93.45 ************ |
    PARTDIST DB2   94.78 ************ |
W3 -DOBJR------------(PRODUCTN-*----- |-W4 -IOBJR------------(PRODUCTN-*------5
CMD Workload        % <= Resp Goal Resp| CMD Workload        % <= Resp Goal
--- Name----        0.....50...100 Goal| --- Name----        0.....50...100
   PSMEXICO 92.08 ************* 0.5 |     POMEXICO 75.78 **********
    POSWEDEN 93.65 ************* 1.0 |     POFRANCE 79.44 **********
    P0FRANCE 93.84 ************* 1.0 |     POBRAZIL 82.48 ***********
    POBRAZIL 95.46 ************* 0.5 |     POSWEDEN 86.99 ***********
    POJAPAN   96.25 ************* 0.8 |     POJAPAN   88.24 ***********
When these four views are displayed from a single screen, you can get a quick performance overview of your CICS, Db2, and IMS workloads that process the parts orders.
This is a useful combination of views. It gives you a good starting point to troubleshoot workload transaction delays. Save this screen to use whenever you suspect a region or subsystem is having performance problems.
Type savescr on the COMMAND line and press Enter.
The Save Screen panel is a dialog to save the parameters used to create this screen and give it a permanent name. The parameters include the organization of the windows shown on the screen, the views within the windows, and the context of the views. You will be able to display this same screen again by invoking the custom screen name.
Success
Tip
When you create a custom screen, you save the context of the views shown in the windows.
---------------------------- SAVE SCREEN DEFINITION------------------------
COMMAND ===>

Screen Definition Parameters:

Name ===>
Description ===>
Replace ===> (Y/N)

Type END to save screen definition
CANcel to quit without saving

F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE
F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT
Fill in the Save Screen panel.
Choose a name for this screen definition—say, PARTWKLD, to associate it with the parts ordering workloads.
---------------------------- SAVE SCREEN DEFINITION------------------------
COMMAND ===>

Screen Definition Parameters:

Name ===> PARTWKLD
Description ===> DB2 CICS IMS parts orders
Replace ===> N (Y/N)

Type END to save screen definition
CANcel to quit without saving

F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE
F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT
Press your END key to exit the Save Screen dialog.
Notice the SCREEN DEF CREATED message in the upper right corner of the screen. The PARTWKLD screen definition has been saved successfully.

Summary of Steps to Create a Screen Definition

The following list summarizes the key steps to create a custom screen definition:

Enter RESET to clear the screen.
Complete the SETD dialog to establish the default context, product, and scope of subsequent views in the current session.
Display a view in the W1 window
Create a second window with either the HSplit or VSplit command.
Display a view in the second window.
Repeat Steps 4 and 5 as required to fill the screen with the windows and views that you want.
Type SAV to enter the Save Screen dialog.
Enter a name and description of the screen definition.
Press your END key to save the screen definition.

Creating a screen definition

MainView VistaPoint 1.1

On this page