Display Program Calls (DelayView)

The Program Calls panel displays program calls (PCs) that the DelayView panel presents in aggregate form.
camat12
As an application programmer for Z/OS systems, CA Mainframe Application Tuner (CA MAT) helps to identify sources of delays in your programs. CA MAT divides program delays into delay categories. The DelayView option shows the percentage of the monitored period that the program was in a wait state for each category.
For the Major Category "PC routine delay", you can display a list of program calls by:
  • Module,
  • CSECT
  • Offset
Type
PC
in the line command field for the PC routine delay and press Enter.
The Program Calls panel appears.
CA MAT ------------------------- Program Calls ----------- Row 1 to 12 of 56 COMMAND ===> SCROLL ===> CSR Primary commands: REGister Profile: PCTEST1 Line commands: S - Service Description L - Listing of Calling Csect U - Add/Change Service Description LC Calling Calling Calling PC Component PCT Visual Module Csect Offset Number or Module ________ ________ ________ ________ _________ ______ __________ ------------------------------------------------------------------------------- __ .NUCLEUS IEAVTSMG 0000009E 0000030F IEAVSTAI 0.03 __ CNZINLPA CNZS1WTO 00002392 0000030F IEAVSTAI 0.03 __ CNZINLPA CNZS1WTO 00006752 00000411 IEAVH708 0.27 => __ CNZINLPA CNZS1WTO 00006A10 0000041B CNZS1TRC 0.24 => __ CNZINLPA CNZS1WTO 0000E42C 00000B00 XCF 0.07 __ CNZINLPA CNZS1WTP 000003A6 0000011A ISGGRT 0.27 => __ CNZINLPA CNZS1WTP 00000A6E 0000011A ISGGRT 0.37 ==> __ CNZINLPA CNZS1XIT 00001B36 00000311 IGVVSTOR 0.03 __ CNZINLPA CNZS1XIT 00001FAC 0000011A ISGGRT 0.13 > __ CNZINLPA CNZS1XIT 0000219C 0000011A ISGGRT 0.10 > __ VSMPGM64 VSMP64IO 00001262 00002002 **N/A** 0.54 ====> __ VSMPGM64 VSMP64IO 00001262 00003104 **N/A** 0.07
The Program Calls panel displays program calls (PCs) that the DelayView panel presents in aggregate form.
The display summarizes the PCs by:
  • Calling Module
  • Csect
  • Offset 
The PCs may be PCs issued by the monitored application, or by services invoked by a program in the monitored application. More than one PC may be attributed to a location in the monitored application program.
The commands for the Program Calls panel:
Primary Commands:
  • REGister
    Displays the Program Listing Registration panel, to register a program with CA MAT.
Line Commands:
  • S -
    Service Description
    A pop-up panel shows the Service Description of the Component or Module that is invoked by the PC.
    The PC Service Description panel displays
  • U -
    Add/Change Service Description
    Displays a pop-up panel that allows the user to add or change a Service Description for the selected PC number.
    The Add/Change PC Service Description panel displays
  • L -
    Listing
    If the program is registered, the line command displays the program listing
The table shows the Program Calls information as follows:
  • Calling Module
    The name of the module that contains the CSECT responsible for the code path where the PC instruction was issued.
  • Calling CSECT
    The name of the CSECT responsible for the code path where the PC instruction was issued.
  • Calling Offset
    The location within the CSECT responsible for the code path where the PC instruction was issued.
  • PC Number
    The Program Call number specifies the name of the system component or module that is the target of the PC instruction.
  • Component or Module
    The name of the system component or module that is the target of the PC instruction that is issued with the indicated PC number.
  • PCT
    The percentage of time during a monitored period when CA MAT detected that the target of the PC instruction was executing on a CPU. The PC instruction is shown in the Component or Module column.
  • Visual
    Visual provides a graphical representation of the number that is displayed in the PCT column of the display.
    The graph color is determined by its value:
    • Green represents a value from 0 through 20
    • Yellow represents a value from 20 through 50
    • Red represents a value from 50 through 100
PC Service Description
For each PC Number shown on the Program Calls panel, you can display a description of the service the PC invokes.
Type
S
in the Line Command field for the PC number and press Enter.
The PC Service Description pop-up panel appears.
CA MAT ------------------------- Program Calls ----------- Row 1 to 12 of 56 C +---------------------------------------------------------------------+ CSR | CA MAT --------------- PC Service Description -------------------- | P | COMMAND ===> SCROLL ===> CSR | ST1 | | L | PC Number: 00000311 | | | | Component | L | or Module Service Description | | _________ _________________________________________________________ | | ------------------------------------------------------------------- | - | IGVVSTOR Storage release | ----- _ | *************************** End of Table ************************** | _ | | _ | | _ | | _ | | _ | | _ | | S | | _ +---------------------------------------------------------------------+ __ CNZINLPA CNZS1XIT 0000219C 0000011A ISGGRT 0.10 > __ VSMPGM64 VSMP64IO 00001262 00002002 **N/A** 0.54 ====> __ VSMPGM64 VSMP64IO 00001262 00003104 **N/A** 0.07
The PC Service Description pop-up panel shows all the Components or Modules that are associated with the selected program call, and the description of each.
The following information is displayed on the PC Service Description panel:
  • PC Number
    The PC number for which the Service Description was requested.
  • Component or Module
    The name of the system component or module that is the target of the PC instruction that is issued with the indicated PC number.
  • Service Description
    A brief description of the system component or module that is the target of the PC instruction that is issued with the indicated PC number.
Update PC Service Description
For each PC Number shown on the Program Calls panel, you can add or change the description of the service the PC invokes.
Type
U
in the Line Command field for the PC number and press Enter.
The Update PC Service Description panel appears.
CA MAT ------------------------- Program Calls ----------- Row 8 to 19 of 56 C +---------------------------------------------------------------------+ CSR | CA MAT ------------ Update PC Service Description ---------------- | P | COMMAND ===> SCROLL ===> CSR | ST1 | | L | PC Number: 00002002 | | | | Component | L | or Module Service Description | | _________ _________________________________________________________ | | ------------------------------------------------------------------- | - | **N/A**_ Description Not Available________________________________ | ----- _ | ________ _________________________________________________________ | _ | ________ _________________________________________________________ | _ | ________ _________________________________________________________ | U | ________ _________________________________________________________ | _ | ________ _________________________________________________________ | _ | *************************** End of Table ************************** | _ | | _ | | _ +---------------------------------------------------------------------+ __ VSMPGM64 VSMP64IO 000012A0 00003104 **N/A** 0.03 __ VSMPGM64 VSMP64IO 000012A0 00008204 **N/A** 0.07 __ VSMPGM64 VSMP64IO 000012A0 00008604 **N/A** 0.03
The Update PC Service Description panel allows you to update Components or Modules and descriptions that are associated with the selected program call.
The following information is displayed on the Update PC Service Description pop-up panel.
  • PC Number
    The PC number for which the Service Description was requested.
  • Component or Module
    The name of the system component or module that is the target of the PC instruction that is issued with the indicated PC number.
  • Service Description
    A brief description of the system component or module that is the target of the PC instruction that is issued with the indicated PC number.
You can overtype the information about this panel as needed.  Multiple lines are supported.  To remove the description from CA MAT, clear both columns.
Press the ENTER key to save your changes.  Press PF3 to exit.
Pressing PF3 before pressing Enter discards your changes.