CA Explore Performance
Management for z/VSE
®
Report Reference Guide
r7.1
This documentation and any related computer software help programs (hereinafter referred to as the
"Documentation") are for your informational purposes only and are subject to change or withdrawal by CA at any
time.
This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in
part, without the prior written consent of CA. This Documentation is confidential and proprietary information of CA
and may not be used or disclosed by you except as may be permitted in a separate confidentiality agreement
between you and CA.
Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the
Documentation, you may print a reasonable number of copies of the Documentation for internal use by you and
your employees in connection with that software, provided that all CA copyright notices and legends are affixed to
each reproduced copy.
The right to print copies of the Documentation is limited to the period during which the applicable license for such
software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to
certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or
destroyed.
TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION "AS IS" WITHOUT
WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END
USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS
DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS
INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE
POSSIBILITY OF SUCH LOSS OR DAMAGE.
The use of any software product referenced in the Documentation is governed by the applicable license agreement
and is not modified in any way by the terms of this notice.
The manufacturer of this Documentation is CA.
Provided with "Restricted Rights." Use, duplication or disclosure by the United States Government is subject to the
restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.2277014(b)(3), as applicable, or their successors.
Copyright © 2010 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein
belong to their respective companies.
CA Product References
This document references the following CA products:
■
CA Explore® Performance Management for z/VSE (CA Explore PM for
z/VSE)
■
CA Explore® Performance Management for CICS (CA Explore PM for CICS)
Contact CA
Contact Technical Support
For your convenience, CA provides one site where you can access the
information you need for your Home Office, Small Business, and Enterprise CA
products. At http://ca.com/support, you can access the following:
■
Online and telephone contact information for technical assistance and
customer services
■
Information about user communities and forums
■
Product and documentation downloads
■
CA Support policies and guidelines
■
Other helpful resources appropriate for your product
Provide Feedback
If you have comments or questions about CA product documentation, you can
send a message to techpubs@ca.com.
If you would like to provide feedback about CA product documentation,
complete our short customer survey, which is also available on the CA Support
website, found at http://ca.com/docs.
Contents
Chapter 1: Using History Reporting
17 Welcome to CA Explore PM for z/VSE History Reporting ......................................... 17 Memory and Partition Requirements........................................................ 17 Concepts and Terminology ................................................................ 18 Command Syntax ......................................................................... 19 Chapter 2: Planning Your Reports
21 Action Plan ................................................................................... 21 Step 1: Decide Whether to Use Short-Term or Long-Term Data .................................. 22 Flashback File (Short-Term Data) .......................................................... 22 Archive File (Long-Term Data) ............................................................. 23 Step 2: Decide Whether to Use a Canned Report ............................................... 23 Step 3: Decide What Format to Use ............................................................ 23 Plot Reports .............................................................................. 24 Graph Reports ............................................................................ 24 Flashback Reports ........................................................................ 25 Step 4: Decide What Information to Include .................................................... 25 Variables ................................................................................. 26 Variable Options .......................................................................... 26 ID Options and Identifiers ................................................................. 26 Step 5: Decide How to Further Tailor Information ............................................... 27 Chapter 3: Writing Your Report
29 Step 1: Create a Job Stream .................................................................. 29 Report Input from Flashback Files .......................................................... 30 Report Input from Archive Files ............................................................ 31 Report Input from Tape Log Files .......................................................... 32 JCL for Producing Reports Using Disk Log File Data .......................................... 33 Specifying Report Output Preferences ...................................................... 33 Step 2: Write History Reporting Commands .................................................... 34 Global Commands ........................................................................ 35 Report Commands ........................................................................ 35 Writing One Report ....................................................................... 36 Writing Multiple Reports ................................................................... 37 Tailoring Reports Using Secondary Commands .............................................. 38 Step 3: Generate Reports ..................................................................... 39 Contents 5
Chapter 4: Reading Reports
41 Reading Tabular Reports ...................................................................... 41 Simple Tabular Reports ................................................................... 42 Complex Tabular Reports .................................................................. 43 TAB2 Reports ............................................................................. 44 Reading Plot Reports .......................................................................... 50 PLOT Command Horizontal Reports ........................................................ 50 PLOT2 Command Horizontal Reports ....................................................... 52 VPLOT Command Vertical Reports.......................................................... 53 VPLOT2 Command Vertical Reports ........................................................ 55 MPLOT Command Vertical Reports ......................................................... 57 HPLOT Reports ........................................................................... 60 Reading Graph Reports ....................................................................... 61 GRAF2 Reports ........................................................................... 63 Reading Flashback Reports .................................................................... 69 Meanings of Default Column Headings in Flashback Reports ................................. 70 Chapter 5: Canned Reports
71 Generating Canned Reports ................................................................... 71 Command Syntax and Operand ............................................................ 71 Command Expansions ..................................................................... 72 Tailoring Canned Reports ..................................................................... 73 Creating Your Own Canned Reports ............................................................ 74 Method 1: Add Reports to the Supplied Member ............................................ 74 Method 2: Create an RDT Containing Your New Canned Reports ............................. 75 Canned Report Descriptions ................................................................... 76 Former VSE/PT Users ..................................................................... 79 VSE.CACHE.STAT Report .................................................................. 79 VSE.CHANNEL.STAT Report................................................................ 80 XA Users ................................................................................. 81 VSE.CICS.STAT Report .................................................................... 81 VSE.CONTENTION.ANALYSIS .............................................................. 83 VSE.CPU.ANALYSIS.STAT.................................................................. 86 VSE.DELAY.ANALYSIS ..................................................................... 88 VSE.DEVICE.STAT Report ................................................................. 90 VSE.DISK.DSN.STAT Report ............................................................... 91 VSE.DISK.STAT Report .................................................................... 95 VSE.DSN.STAT Report .................................................................... 96 VSE.GETVIS.STAT Report ................................................................. 97 VSE.JOB.STAT Report .................................................................... 100 VSE.LOCK.STAT ......................................................................... 101 6 Report Reference Guide
VSE.LPAR.CPU.STAT Report .............................................................. 103 VSE.PACCNT.STAT Report ................................................................ 104 VSE.PAGE.STAT Report................................................................... 106 VSE.PID.CPU Report ..................................................................... 107 VSE.PRINT.FORMS.STAT Report .......................................................... 108 VSE.PROGRAM.LOAD.STAT ............................................................... 109 VSE.SAMCPU.BUSYR.STAT Report......................................................... 111 VSE.SAMCPU.BUSYV.STAT Report ......................................................... 114 VSE.SAMPLE.COUNT.STAT Report ......................................................... 117 VSE.SAMPLE.RATE.STAT Report .......................................................... 118 VSE.SEEK.STAT Report ................................................................... 120 VSE.SVC.STAT Report .................................................................... 121 VSE.SYSCPU.BUSYR.STAT Report ......................................................... 124 VSE.SYSCPU.BUSYV.STAT Report ......................................................... 127 VSE.SYSTEM.STAT Report ................................................................ 130 VSE.THRESHOLD.LOG.STAT .............................................................. 132 VSE.THRESHOLD.STAT Report ............................................................ 133 VSE.VERSION4.DATA Report ............................................................. 135 VSE.VM.CPU.STAT ....................................................................... 139 VSE.XA.DEVICE.STAT Report ............................................................. 140 Chapter 6: Commands
143 Understanding Syntax Rules .................................................................. 143 Case .................................................................................... 143 One Command Per Line .................................................................. 143 Line Position ............................................................................. 144 Command Continuation .................................................................. 144 Word Separation ......................................................................... 144 Blank Lines .............................................................................. 144 Processing Order ........................................................................ 144 Comments .............................................................................. 144 Command Syntax Conventions ............................................................... 145 Using Global Commands ..................................................................... 146 Using Report Commands ..................................................................... 147 List of Secondary Report Commands ...................................................... 148 Command Descriptions ...................................................................... 149 CANRPT Command ....................................................................... 149 CARDLEN Command ..................................................................... 149 COMMENT Command ..................................................................... 150 COST Command ......................................................................... 150 COUNT Command........................................................................ 153 DEFINE Command ....................................................................... 154 Contents 7
EACH Command ......................................................................... 159 END Command .......................................................................... 162 EXCLUDE Command ..................................................................... 162 EXITRTN Command ...................................................................... 163 FLASHBACK Command ................................................................... 164 FROM and TO Commands ................................................................ 165 GLOBAL Command ....................................................................... 169 GOTO Command ......................................................................... 170 GRAF Command ......................................................................... 171 GRAF2 Command ........................................................................ 172 GROUP Command........................................................................ 174 HEADER Command ...................................................................... 176 HPLOT Command ........................................................................ 177 IF Command ............................................................................ 178 INCLUDE Command ...................................................................... 179 INPUT Command ........................................................................ 180 INVOICE Command ...................................................................... 183 LINECOUNT Command ................................................................... 186 MPLOT Command ........................................................................ 186 OPTION Command ....................................................................... 187 OUTPUT Command ....................................................................... 195 PERIOD Command ....................................................................... 197 PLOT Command ......................................................................... 198 PLOT2 Command ........................................................................ 199 PRTEXIT................................................................................. 202 RANGE Command ........................................................................ 203 RUN Command .......................................................................... 205 SELECT Command ....................................................................... 206 SHIFT Command......................................................................... 207 TABulate Command ...................................................................... 208 TAB2 Command ......................................................................... 212 TITLE1, TITLE2, and TITLE3 Commands ................................................... 213 VPLOT Command ........................................................................ 215 VPLOT2 Command ....................................................................... 217 Structure of Variable Names.................................................................. 217 Variable Descriptions ........................................................................ 218 Units of Measure ......................................................................... 218 Explanation of the Data Column Heading .................................................. 219 CACHE Variable Class .................................................................... 219 CHANNEL Variable Class .................................................................. 221 CONTENTION Variable Class .............................................................. 224 COUNT Variable Class .................................................................... 225 8 Report Reference Guide
CPU Variable Class ....................................................................... 228 DATASPACE Variable Class ............................................................... 231 DEVICE Variable Class ................................................................... 232 DISK Variable Class ...................................................................... 235 DSN Variable Class....................................................................... 240 DYNAMIC Variable Class .................................................................. 243 GETVIS Variable Class ................................................................... 244 Configuration Requirement ............................................................... 245 INTERRUPT Variable Class ................................................................ 247 INTERVAL Variable Class ................................................................. 247 JOB Variable Class ....................................................................... 250 LOCK Variable Class...................................................................... 251 LPAR Variable Class ...................................................................... 253 LTA Variable Class ....................................................................... 254 MCPU Variable Class ..................................................................... 256 OPERATOR Variable Class ................................................................ 258 OTHER Variable Class .................................................................... 259 PAGE Variable Class ...................................................................... 261 PHASE Variable Class .................................................................... 263 REAL Variable Class ...................................................................... 265 SAMPLE Variable Class ................................................................... 266 Variables Valid For XA I/O Users Only ..................................................... 267 SGETVIS Variable Class .................................................................. 268 STEP Variable Class ...................................................................... 271 SVC Variable Class ....................................................................... 274 SYSTEM Variable Class ................................................................... 276 TAPE Variable Class ...................................................................... 278 THRESHOLD Variable Class ............................................................... 280 VM Variable Class ........................................................................ 282 WAIT Variable Class...................................................................... 282 VSE/POWER Accounting Variables ............................................................ 284 Definitions............................................................................... 285 General PACCNT Variables ................................................................ 285 PACCNT Advanced Function Printing (AFP) Variables ....................................... 287 PACCNT RJE Bisynch (BSC) Variables ..................................................... 287 PACCNT Execution (EXEC) Variables ...................................................... 289 ACCNT List (LIST) Variables .............................................................. 291 PACCNT Network (PNET) Variables ........................................................ 294 PACCNT PUNCH Variables ................................................................ 295 PACCNT READER Variables ............................................................... 297 PACCNT Receiver (RECV) Variables ....................................................... 298 PACCNT System Network Architecture (SNA) Variables ..................................... 300 Contents 9
PACCNT System-up (SYS) Variables ....................................................... 301 PACCNT NJE Transmitter (TRANS) Variables ............................................... 302 PACCNT Spool-Access-Connect (XCONN) Variables ......................................... 304 PACCNT Spool-Access-Operation (XSPOOL) Variables ...................................... 305 Chapter 7: Variables
309 Structure of Variable Names.................................................................. 309 Variable Descriptions ........................................................................ 309 Units of Measure ......................................................................... 310 Explanation of the Data Column Heading .................................................. 310 CACHE Variable Class .................................................................... 311 CHANNEL Variable Class .................................................................. 313 CONTENTION Variable Class .............................................................. 316 COUNT Variable Class .................................................................... 317 CPU Variable Class ....................................................................... 319 DATASPACE Variable Class ............................................................... 323 DEVICE Variable Class ................................................................... 323 DISK Variable Class ...................................................................... 326 DSN Variable Class....................................................................... 331 DYNAMIC Variable Class .................................................................. 333 GETVIS Variable Class ................................................................... 334 Configuration Requirement ............................................................... 335 INTERRUPT Variable Class ................................................................ 337 INTERVAL Variable Class ................................................................. 337 JOB Variable Class ....................................................................... 340 LOCK Variable Class...................................................................... 341 LPAR Variable Class ...................................................................... 343 LTA Variable Class ....................................................................... 344 MCPU Variable Class ..................................................................... 346 OPERATOR Variable Class ................................................................ 348 OTHER Variable Class .................................................................... 350 PAGE Variable Class ...................................................................... 351 PHASE Variable Class .................................................................... 354 REAL Variable Class ...................................................................... 356 SAMPLE Variable Class ................................................................... 357 Variables Valid For XA I/O Users Only ..................................................... 359 SGETVIS Variable Class .................................................................. 360 STEP Variable Class ...................................................................... 363 SVC Variable Class ....................................................................... 366 SYSTEM Variable Class ................................................................... 367 TAPE Variable Class ...................................................................... 369 THRESHOLD Variable Class ............................................................... 372 10 Report Reference Guide
VM Variable Class ........................................................................ 373 WAIT Variable Class...................................................................... 374 VSE/POWER Accounting Variables ............................................................ 375 Definitions............................................................................... 376 General PACCNT Variables ................................................................ 377 PACCNT Advanced Function Printing (AFP) Variables ....................................... 378 PACCNT RJE Bisynch (BSC) Variables ..................................................... 379 PACCNT Execution (EXEC) Variables ...................................................... 380 ACCNT List (LIST) Variables .............................................................. 382 PACCNT Network (PNET) Variables ........................................................ 384 PACCNT PUNCH Variables ................................................................ 386 PACCNT READER Variables ............................................................... 388 PACCNT Receiver (RECV) Variables ....................................................... 389 PACCNT System Network Architecture (SNA) Variables ..................................... 391 PACCNT System-up (SYS) Variables ....................................................... 392 PACCNT NJE Transmitter (TRANS) Variables ............................................... 393 PACCNT Spool-Access-Connect (XCONN) Variables ......................................... 395 PACCNT Spool-Access-Operation (XSPOOL) Variables ...................................... 396 Chapter 8: Variable Options
399 Valid Variable Options ....................................................................... 399 Specifying Options ....................................................................... 400 Descriptions of Variable Options .............................................................. 400 COUNT Option ........................................................................... 400 FORMAT Option .......................................................................... 400 LOGICAL Option ......................................................................... 401 MAX and MIN Options .................................................................... 402 MAXDATE and MAXTIME Options .......................................................... 402 PerCenT Option .......................................................................... 403 RATE Option ............................................................................. 403 SELZERO Option ......................................................................... 405 TOTAL Option............................................................................ 405 XTIME, XTIMEM, and NXTIME Options ..................................................... 406 XTND and NXTND Options ................................................................ 406 Chapter 9: ID Options
409 Descriptions of ID Options ................................................................... 410 VSE/POWER Accounting ID Options ........................................................... 413 Specifying Identifiers with ID Options ......................................................... 419 Using Generic Characters in Identifiers ........................................................ 419 Specifying Identifiers in Hexadecimal ......................................................... 420 Contents 11
Using ID Options with Commands ............................................................ 420 Specifying ID Options ........................................................................ 420 TAB Report Using an ID Option and Identifiers ................................................. 422 TAB and TAB2 Report Using ID Options ....................................................... 422 Graph Report Using an ID Option Without Identifiers ........................................... 423 Graph Report Using an ID Option and Identifiers ............................................... 424 Flashback Report Using an ID Option and Identifiers ........................................... 425 Using ID Options with Variables .............................................................. 425 Specifying ID Options ........................................................................ 426 Using ID Options with Commands Versus with Variables........................................ 426 Sample Report 1 ............................................................................ 427 Sample Report 2 ............................................................................ 427 Example Using ID Options with Variables ...................................................... 428 Using ID Options with Both Commands and Variables .......................................... 428 Formatting Identifiers in Output .............................................................. 429 Using the FORMAT Option .................................................................... 430 Option Syntax and Operand .................................................................. 430 Using the DEFINE Command ................................................................. 431 Using the DEFINE Command versus the FORMAT Option ....................................... 433 Chapter 10: Tabular Reports
435 TABulate Command .......................................................................... 436 Organizing Reports by Time and Date or Resources ............................................ 436 Tabulating by Date and Time ............................................................. 436 Tabulating by Day ....................................................................... 437 Tabulating by Resources ................................................................. 438 Tabulating by Both Time or Date and Resources ........................................... 438 Specifying Variables With or Without ID Options ............................................... 439 Using Both CICS and VSE Variables ....................................................... 440 Using ID Options with Variables ........................................................... 441 Changing Column Headings .................................................................. 441 Using Variable Options ....................................................................... 443 Displaying Percentage of Change Over Time ............................................... 443 Changing a Count to a Rate .............................................................. 444 Formatting Numeric Data ................................................................. 445 Specifying a Time Period for a Variable .................................................... 446 Shifting a Column to the Right ............................................................ 447 Limiting the Resources Included in a Report ................................................... 448 Limiting Reports Organized by Identifier ................................................... 449 Limiting Reports Organized by Time and Date ............................................. 450 Sorting Reports.............................................................................. 450 Sorting Reports by Different Keys ......................................................... 451 12 Report Reference Guide
Sorting Reports in Ascending Order ....................................................... 452 Sorting Reports by Identifier.............................................................. 454 Using Other Commands with the TAB Command ............................................... 454 Tabulating by Ranges .................................................................... 455 Using the RANGE Option ................................................................. 457 Tabulating by Groups .................................................................... 458 Tabulating by Both Group and Range ...................................................... 458 Creating Charge-Back Reports ............................................................ 460 Creating Reports on GETVIS Usage ....................................................... 460 TAB2 Reports ............................................................................... 462 Chapter 11: Plot Reports
463 Using Data from Other CA Explore PM for z/VSE Systems ...................................... 463 Horizontal Reports (PLOT and PLOT2) ......................................................... 464 PLOT Command ......................................................................... 464 Creating a Simple PLOT Report ........................................................... 465 Using ID Options in Plot Reports .......................................................... 465 Excluding Global Values from a Plot ....................................................... 466 Changing a Plot's Scale................................................................... 467 Specifying the Characters in a Plot ........................................................ 468 Converting Counts to Rates ............................................................... 469 PLOT2 Command ............................................................................ 470 Vertical Reports (VPLOT, VPLOT2, and MPLOT) ................................................ 470 VPLOT Command ........................................................................ 470 Option Syntax and Operands ............................................................. 470 Creating a Simple VPLOT Report .......................................................... 471 Using the SCALE(mX) Operand ........................................................... 473 Using the SCALE(n) Operand ............................................................. 475 Using the SCALE(n,mX) Operand ......................................................... 477 Creating Seek Analysis Reports ........................................................... 478 Creating Plots for Multiple Time Periods ................................................... 479 Seek Analysis Report on a Range of Cylinders ............................................. 483 Using the STACK Operand ................................................................ 484 VPLOT2 Command ....................................................................... 486 Option Syntax and Operands ............................................................. 486 Creating a Simple VPLOT2 Report ......................................................... 486 Using the SCALE(mX) Operand ........................................................... 488 Distribution Plot Reports (MPLOT)............................................................. 489 MPLOT Command ........................................................................ 490 Option Syntax and Operands ............................................................. 490 Using One Variable....................................................................... 491 Using Multiple Variables .................................................................. 493 Contents 13
Horizontal Reports (HPLOT) .................................................................. 496 HPLOT Command ........................................................................ 497 Option Syntax and Operands ............................................................. 497 Using VPLOT with HPLOT ................................................................. 498 Using MPLOT with HPLOT ................................................................. 499 Using the SCATTER Operand.............................................................. 501 Chapter 12: Graph Reports
503 GRAF Reports (GRAF and GRAF2) ............................................................. 503 GRAF Command ......................................................................... 503 Command Syntax and Operands .......................................................... 503 Creating a Simple GRAF Report ........................................................... 505 Graphing by an Alternate Resource ....................................................... 505 Including an AVERAGE Line in a Graph .................................................... 506 Limiting Reports Using ID Options ........................................................ 507 Limiting Reports Using the FOR Operand .................................................. 508 Changing the Scale of a Report ........................................................... 509 Sorting Reports .......................................................................... 510 Creating Reports on Specified Shifts ...................................................... 510 Creating Reports with Multiple Time Periods ............................................... 511 GRAF2 Reports .............................................................................. 512 Chapter 13: Flashback Reports
513 FLASHBACK Command ....................................................................... 513 Output Considerations ....................................................................... 514 Command Syntax and Operands .............................................................. 514 Default Flashback Reports .................................................................... 515 Output Consideration for Flashback Reports ................................................... 515 Default VSEEXEC Report ..................................................................... 515 Default VSEJOB Report....................................................................... 516 Default VSELIST Report ...................................................................... 517 Default VSESAMP Report ..................................................................... 518 Default VSESTEP Report ..................................................................... 519 Tailoring Default Flashback Reports ........................................................... 520 Using ID Options to Limit FLASHBACK Reports ................................................. 521 Limiting Reports to Specified Variable Values .................................................. 523 Creating Specialized Flashback Reports ....................................................... 524 Using the Date and Time Operands ........................................................... 526 Chapter 14: VSE/POWER Reports
529 Creating VSE/POWER Accounting Reports ..................................................... 529 14 Report Reference Guide
Organizing and Limiting VSE/POWER Accounting Reports ................................... 530 Prewritten VSE/POWER Accounting Reports ................................................... 532 Combination Report ...................................................................... 532 Job and Step Report ..................................................................... 535 Jobname and Device Report .............................................................. 537 List Output Report ....................................................................... 539 Print Forms Report ....................................................................... 541 Spool Access Report ..................................................................... 542 Start, Stop, and Date Report ............................................................. 544 Unique Job Report ....................................................................... 546 Unique Step Report ...................................................................... 548 Appendix A: User Exits
551 User Exit Execution .......................................................................... 551 Source Code ............................................................................. 551 Index
553 Contents 15
Chapter 1: Using History Reporting
CA Explore® Performance Management for z/VSE (CA Explore PM for z/VSE)
provides batch-reporting facilities that let you produce easy-to-run, canned
and customized reports.
This guide explains how to use the history reporting commands and variables
to create reports. It assumes that the person writing reports has a functional
knowledge of VSE, can edit a file, and can access the flashback and log files
that are described in the chapter "Planning Your Reports."
This section contains the following topics:
Welcome to CA Explore PM for z/VSE History Reporting (see page 17)
Welcome to CA Explore PM for z/VSE History Reporting
The CA Explore PM for z/VSE history reporting subsystem, or report writer, lets
you produce graphic and tabular reports from the performance data collected
by CA Explore PM for z/VSE. With these reports, you can study resource use
on a long-term basis, or you can detect and analyze unusual events.
The CA Explore PM for z/VSE report writer lets you report on a variety of VSE
activities, such as channel activity, CPU utilization, and maximum disk service
time. You control the time that each detail line in a report represents and the
time frame that a report covers. You can also access the information you
want, at the level of detail you indicate. With just one pass through the
historical data, you can create up to 50 reports, each covering a different time
period.
Memory and Partition Requirements
The amount of virtual storage needed by the report writer depends on the
types of reports to be produced, the number of reports requested in each run,
and the amount of input data used. To reduce the amount of virtual storage
required, limit the number of reports in each run or narrow the time period
covered by each report.
We recommend that you run the report writer in a partition of at least one
megabyte.
Chapter 1: Using History Reporting 17
Welcome to CA Explore PM for z/VSE History Reporting
Concepts and Terminology
Becoming familiar with the major concepts and terminology used in this
manual will enable you to use the report writer more efficiently. These
concepts and terms are shown in the following table:
Item
Purpose
Examples
Report writer
commands
Used with JCL to produce
reports. Report writer
commands include global
commands and report
commands.
INPUT, RUN, CANRPT,
PLOT, EACH, TITLE1
Global commands
Report writer commands
that affect all reports in a
run.
COUNT, INPUT, RUN
Report commands
CANRPT, PLOT, EACH,
Report writer commands
TITLE1
that affect only a single
report. Report commands
include primary report
commands and secondary
report commands.
Primary report
commands
Report commands that
define the type of report
to be generated.
CANRPT, PLOT, TAB2
Secondary report
commands
Report commands that
alter or enhance a report.
EACH, FROM, TITLE1
Operands
Keywords specified with
commands or variable
options that affect the
content or structure of a
report. Different
commands and variable
options have different
operands.
The syntax of the
CANRPT command is
CANRPT reportname.
Its operand is
reportname.
Variable options
Keywords that change
either the type of data a
variable represents or the
format of that data.
FORMAT, MAX, RATE
ID options
Keywords that either
change the scope of the
data that a variable
represents, or organize
the data in a tabular,
graph, or flashback report
JOBID, DEVID, VOLSER
18 Report Reference Guide
Welcome to CA Explore PM for z/VSE History Reporting
Item
Purpose
Examples
by a type of resource.
Identifiers
Either the name of a
particular resource or a
generic specification of a
group of resources that a
report or variable is to be
limited to. Identifiers are
specified following ID
options.
MYJOB, ¬OPER1, 001+,
PACK*
Command Syntax
History reporting commands are specified using conventions or syntax.
Sample Syntax
This example of the PLOT command illustrates the command syntax used in
this guide.
PLOT variable [options] [ALONE] [SCALE({n},{mX})] [CHAR1(x)]
[CHAR2(x)]
The command syntax elements are shown in the following table:
This Syntax
Indicates
Examples
Lowercase italicized
letters
Variables or items you are to PLOT variable
where you replace
replace with specific
variable with a word or
information.
value.
All capital letters
Literals or items you must
enter as shown.
Mixed case
Mixed case indicates you can PerCenT.
enter either the uppercase
portion or the entire word.
Square brackets
Optional operands.
PLOT variable
where you must enter
PLOT as it is shown.
[options] [ALONE]
where you can choose
from several options to
replace options, or enter
the ALONE option as
shown.
Chapter 1: Using History Reporting 19
Welcome to CA Explore PM for z/VSE History Reporting
This Syntax
Indicates
Examples
Braces
Parameters from which you
must choose only one.
{n},{mX}
Parentheses
Parentheses indicate that
you must enter parentheses
around the item as shown.
[SCALE({mX},{n},{CO
MMON})]
Or-sign
An or-sign indicates a choice [PGMSTOR=[NO|YES]]
between related items. Enter
only one of the items.
Underscore
INPUT {(TAPEIN) }
Underscoring indicates the
default. If you want a
{(EVSEFBK)}
command's underscored
parameters only, you do not
have to specify the
command.
Ellipses
Variables that are part of a
series, but are not shown.
n1,…,n10
Ellipses
Vertical ellipses are used in reports to indicate that only part of a report is
shown, as follows:
JOB
JOB
STEP
TOTAL
AVERAGE
TCPU
CPU
DISK
SERVICE
TAPE
LINES
PAGES
MAX
MAX
NAME
COUNT
COUNT DURATION DURATION TIME
TIME
SIO
TIME
IO
SPOOLED
SPOOLED
GETVIS %GETVIS
-------- ------- ------- -------- -------- -------- ------- --------- -------- -------- ---------- ---------- -------- -----COMPLK
3
3
00:00:47 00:00:15 1.667
0.417
930
0.040
0
577
25
348K
7.6
CREADS
2
2
00:01:37 00:00:48 0.860
0.430
232
0.046
0
4,816
122
72K
1.7
CATALR
2
2
00:00:14 00:00:07 0.249
0.124
256
0.043
0
76
4
48K
1.2
AXPHJ6F
1
5
00:00:39 00:00:07 0.616
0.123
732
0.040
0
108
9
312K
1.5
AXPHJ6B
1
5
00:00:25 00:00:05 0.548
0.110
710
0.030
0
107
9
296K
1.5
GSJOBCTL
1
3
00:00:25 00:00:08 0.539
0.179
655
0.029
0
88
4
308K
8.1
CICSMROA
1
2
01:32:51 00:46:25 7.741
0.860
763
0.036
0
55,875
1,692
472K
11.9
ERRM
1
1
00:01:39 00:01:39 7.875
7.875
685
0.055
0
6,224
157
68K
1.8
EVSEBKUP
1
1
00:00:28 00:00:28 1.242
1.242
656
0.032
0
58
2
204K
5.0
FAQSDSPL
1
1
00:00:08 00:00:08 0.560
0.560
276
0.024
0
65
3
296K
7.8
LIBR
1
1
00:00:08 00:00:08 0.141
0.141
86
0.057
0
276
10
16K
0.4
PAUSE
1
0
00:00:00 00:00:00 0.000
0.000
0
0.000
0
29
1
0
0.0
NICK2
1
0
00:00:00 00:00:00 0.000
0.000
0
0.000
0
14
2
0
0.0
SETSDL
1
0
00:00:00 00:00:00 0.000
0.000
0
0.000
0
7
1
0
0.0
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
-------- ------- ------- -------- -------- -------- ------ -------- ------- ------- ---------- ---------- -------- -----SUMMARY
22
61
09:37:26 00:09:27 75.41
0.711 23,654
0.036
45
68,575
2,061
2664K
90.2
-------- ------- ------- -------- -------- -------- ------- -------- -------- ------- ---------- ---------- -------- ------
20 Report Reference Guide
Chapter 2: Planning Your Reports
This chapter describes the steps you take in planning your report—what it
should include what it should look like, and the range of time in which it
should report.
This section contains the following topics:
Action Plan (see page 21)
Step 1: Decide Whether to Use Short-Term or Long-Term Data (see page 22)
Step 2: Decide Whether to Use a Canned Report (see page 23)
Step 3: Decide What Format to Use (see page 23)
Step 4: Decide What Information to Include (see page 25)
Step 5: Decide How to Further Tailor Information (see page 27)
Action Plan
Before you start writing a report, you must make the following decisions:
Step
Action
1
Decide whether you want to use short-term or long-term data.
This determines which file you access and the jobstream you use
to run the report.
For short-term data, use the flashback file.
For long-term data, use either the archive file or the log file (a
backup of the archive file).
2
Decide whether it would be easier to use a report writer canned
(predefined) report that provides the information that you want,
instead of writing your own history reporting commands.
3
Decide what format you want for the report: tabular, plot, graph,
or flashback. Examples of each of these are shown later in this
chapter. The format determines the primary report command that
you use.
4
Decide what information you want in the report, which resources
you want this information to be about, and the order and format in
which you want the information to be presented. For example, you
might want to create a tabular report showing all jobnames, in
alphabetical order, the number of times each was executed, and
the average duration of each. To select this information, you use
variables, variable options, ID options, and identifiers.
Chapter 2: Planning Your Reports 21
Step 1: Decide Whether to Use Short-Term or Long-Term Data
Step
Action
5
Decide how to further tailor your report using secondary
commands. Such commands can limit the time period that a report
covers, group the resources included in the report, or assign a
descriptive title to the report.
Step 1: Decide Whether to Use Short-Term or Long-Term Data
When you run CA Explore PM for z/VSE, you can specify that historical data be
collected into either or both of the following VSAM disk files:
■
Flashback file (EVSEFBK)—A wrap-around disk file used for short-term
analysis, including batch reports, online reports, and online flashback
analysis.
■
Archive file (EVSEARC)—Backed up to tape or disk to create a log file for
long-term analysis. Performance data can be appended to the end of the
log file.
You can then use the data in the flashback file, the archive file, or the log file
to write reports. Logging data to the flashback or archive file is optional, but
you cannot generate history reports if there is no data in the file you use.
Note: You can generate reports from data collected by CA Explore PM for
z/VSE versions 4, 5, and 6.
Flashback File (Short-Term Data)
Because you can create reports directly from the flashback file, you can use it
to generate reports on recent data quickly. The flashback file is a wrap-around
file. It writes over old data as soon as its disk space is depleted. How quickly
the flashback file begins to wrap depends on its size, the settings of your CA
Explore PM for z/VSE configuration options, and your site's typical VSE work
load.
After you use the default allocation for a few days, you can increase or
decrease the allocation for your flashback file to meet your needs. To increase
or decrease the size of your flashback file, use the INSTALL utility option. For
more information, see the Utilities Guide.
22 Report Reference Guide
Step 2: Decide Whether to Use a Canned Report
Archive File (Long-Term Data)
You can define the period of time that the performance information in the
archive file covers.
You can either create a report directly from the archive file (if you are running
CA Explore for z/VSE 6.3 or higher), or you can first back up the archive file to
a tape or a disk to create a log file and use the log file as input for your
reports. A common practice is to back up the archive file to a tape or a disk
when it becomes full, so that you do not lose data.
For more information about using the EXPUTIL program to back up or merge
archive files, see the Utilities Guide.
Limiting the Time Required for Running Reports
Because the log file can contain a large amount of data, generating a report
that uses it can take a long time. To limit output when testing reports, either
use the flashback file or specify the COUNT card to limit the records read from
your log file.
Step 2: Decide Whether to Use a Canned Report
The report writer includes a number of predefined or canned reports that are
described in the "Canned Reports" chapter. Review these descriptions. If you
find a report similar to the one that you want to produce and if you are new to
the report writer, we suggest that you use the canned report.
Canned reports are easy to produce because the commands are already
written for you. The report writer shows you the commands and lets you tailor
them. However, when you are more experienced with the report writer, you
may choose to write your own report commands to create reports that suit
your needs more precisely.
Step 3: Decide What Format to Use
If you decide not to use a canned report, you must write the commands to
produce your report. Whether you produce your reports from the flashback file
or the log file, you can generate reports in four formats: tabular, plot, graph,
and flashback. Detailed information about creating reports in each of these
formats is provided in dedicated chapters in this guide. For more information
about reading each type of report, see the chapter "Reading Reports."
The sections that follow provide a sample of each report format.
Chapter 2: Planning Your Reports 23
Step 3: Decide What Format to Use
Plot Reports
Plot reports show the values of one or two variables across time. For instance,
you can print a report that shows the CPU utilization of your system each
hour. The following report, created with the PLOT command, plots the number
of SIOs for a single specified device (plotted with Xs) and for all devices
(plotted with hyphens [-]):
SHIFT NONE
EACH
30 MINUTES
PERIOD NONE
01/25/99 10.00.00
10.30.00
11.00.00
11.30.00
12.00.00
12.30.00
SUMMARY:
RANGE:
SYMBOLS:
"X" =
DEVICE SIO COUNT
0
2943
5886
8830
11773
14717
17660
20603
23547
26490
29434
X
+........+........+.........+.........+.........+.........+........+........+........+........+
.X----------------------.
.
.
.
.
.
.
.
337 7703
.XX----------------------------------------------------------.
.
.
.
549 18586
.XX-------------------------------------------------------------------------------------------708 29434
.-------------------------------------------------.
.
.
.
.
133 15161
.XXXXX----------------.
.
.
.
.
.
.
. 1535 7071
.XXXXX----------------------.
.
.
.
.
.
. 1584 8935
.
.
.
.
.
.
.
.
.
.
. SUMMARY:
.XXX--------------------------------------------.
.
.
.
.
.
807 14481
+........+........+.........+.........+.........+.........+........+........+........+........+
0
2943
5886
8830
11773
14717
17660
20603
23547
26490
29434
X
-
DEVICE SIO COUNT
"-" =
GLOBAL DEVICE SIO COUNT
Graph Reports
Graph reports are formatted like plot reports, but they break down resource
usage by identifiers (job, user, channel, disk, and so on) for each time period
you specify. This can give you specific information, such as how active certain
disk devices are during peak periods. Use the GRAF command to produce a
report like the following, which shows the number of disk SIOs by each of
several VSE systems:
0
1910
3820
5730
7640
9550
11460
13370
15280
17190
19100
X
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 19100
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
. 11436
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
. 9668
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
. 8042
.
.
.
.
.
.
.
.
.
.
.
4
.
.
.
.
.
.
.
.
.
.
.
2
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
1910
3820
5730
7640
9550
11460
13370
15280
17190
19100
X
VSE001
DOSRES
SYSVR1
AVERAGE>
VSE002
VSE003
SYMBOLS:
"X" =
DISK SIO COUNT
24 Report Reference Guide
Step 4: Decide What Information to Include
Flashback Reports
Flashback reports present a formatted listing of system events in the order
they occurred. Use flashback reports to discover the source of a recent
problem, using data from either the flashback file or the log file. The
FLASHBACK command produces a report like the following:
PART
ID
---F8
F9
FA
F8
F4
F4
F8
F4
F4
BG
BG
BG
F4
F4
F8
F8
F8
F8
F8
----
DATE
-------06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
06/26/04
--------
START
TIME
-------08.12.32
08.12.44
08.13.04
08.13.01
08.17.36
08.18.38
08.21.00
08.31.07
08.31.45
06.38.19
08.32.54
08.45.47
08.58.36
08.59.55
09.01.29
09.01.34
09.01.41
09.03.34
09.03.42
--------
STOP
TIME
-------08.12.58
08.13.20
08.13.30
08.13.36
08.18.00
08.18.52
08.21.17
08.31.22
08.31.53
08.32.53
08.32.55
08.45.52
08.58.50
09.00.05
09.01.34
09.01.41
09.01.44
09.03.42
09.03.46
--------
ID
-E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
--
POWER
NAME
-------GSEDIT
GSEDIT
GSFAOCM
GSFAOEX
RODARCH
RODARCH
GSMSHPUF
RODARCH
RODARCH
STDLBADD
STDLBADD
LIBRTEST
RODARCH
RODARCH
AXPL13
AXPL13
AXPL13
AXP3010
AXP3010
--------
USER
POWER
VSE
PHASE
INFO
CC
JOB NAME
NAME
------------- ----- -------- -------TO MERROW
10
GSEDIT
LNKEDT
TO MERROW
10
GSEDIT
LNKEDT
TO MERROW
10
GSFAOCM LNKEDT
TO MERROW
10
GSFAOEX LNKEDT
10
RODARCH LNKEDT
10
RODARCH RODARCH
TO DSHANNO
10
GSMSHPUF LNKEDT
10
RODARCH LNKEDT
10
RODARCH RODARCH
10
BGVAE
EVSEIBAT
10
STDLBADD
10
LIBRTEST LIBR
10
RODARCH LNKEDT
10
RODARCH RODARCH
10
AXPL13
LIBR
10
AXPL13
LNKEDT
10
AXPL13
LIBR
10
AXP3010 IDCAMS
10
AXPL13
AXPL13
------------- ----- -------- --------
VSE REC
JOB
CPU
SIO
PAGES
CC TYPE DURATION
TIME
COUNT SPOOLED
--- ---- -------- -------- -------- -----10
L
00:00:25 0.420
2010
3
10
L
00:00:36 0.377
1947
2
10
L
00:00:26 0.280
1277
2
10
L
00:00:34 0.397
2082
3
10
L
00:00:24 0.326
1181
4
20
L
00:00:14 0.237
4558
94
10
L
00:00:17 0.260
937
3
10
L
00:00:14 0.313
1178
4
20
L
00:00:07 0.230
4035
85
10
L
01:54:33 1.010
1688
0
00
L
00:00:01 0.020
51
1
10
L
00:00:04 0.083
226
2
10
L
00:00:13 0.333
1179
4
20
L
00:00:10 0.240
4557
94
10
S
00:00:05 0.140
384
3
10
S
00:00:06 0.150
389
3
10
L
00:00:02 0.047
145
3
10
L
00:00:08 0.207
529
4
10
L
00:00:04 0.090
208
4
--- ---- -------- -------- -------- ------
For details and extended examples of how to use each of these formats, see
the corresponding chapters in this guide. For more information about reading
each of these types of reports, see the chapter Reading Reports".
Step 4: Decide What Information to Include
After you determine the format of your report, you must decide what
information to include and which resources you want that information about.
You specify this information as follows:
■
Use variables and variable options to specify the information you want,
and in what format. For example, you can create a report showing job use,
and you can have this information presented as the number of occurrences
or as percentages.
■
Use ID options and identifiers to specify which resources you want
information about.
The following sections briefly describe how to use variables, variable options,
ID options, and identifiers. Detailed information is provided later in this guide.
Chapter 2: Planning Your Reports 25
Step 4: Decide What Information to Include
Variables
Use variables to specify what information to include in a report, and in what
order. For example, if you want a report that plots the number of jobs
executed on your system, you would use the following command, which uses
the variable VSE JOB COUNT:
PLOT VSE JOB COUNT
Variable Options
Use variable options to change either the type of data a variable represents or
the format of that data. For example, by default the variable VSE JOB COUNT
gives the number of jobs executed. You can use the variable option RATE with
this variable to plot the rate at which these jobs were executed (the number
per second) instead, as follows:
PLOT VSE JOB COUNT RATE
ID Options and Identifiers
Use ID options and identifiers to specify which resources to include in a report.
You can specify ID options and identifiers with variables or with commands, as
follows:
■
You can limit a particular variable to certain individual resources by
specifying an ID option and one or more identifiers with the variable. For
example, if you want to plot the number of times the job TESTJOB was
executed, you can use the following command, which includes the ID
option JOBID and the identifier TESTJOB:
PLOT VSE JOB COUNT JOBID(TESTJOB)
■
You can limit an entire tabular, graph, or flashback report to resources of a
given type by specifying an ID option with the report command. You can
further limit the report to individual resources of that type by specifying
identifiers with the ID option. For example, the following command
generates a tabular report showing the number of times the jobs JOB1 and
JOB2 were executed and the average duration of each:
TAB JOBID(JOB1,JOB2) VSE JOB COUNT AND VSE JOB DURATION
For additional information on variables, variable options, and how to specify ID
options and identifiers, see the chapters "Variables", "Variable Options", and
"ID Options".
26 Report Reference Guide
Step 5: Decide How to Further Tailor Information
Step 5: Decide How to Further Tailor Information
In addition to restricting your report to certain variable values for specified
resources, you can further tailor the report using secondary report commands.
For example, you can use the commands TO and FROM to limit a report to
only those jobs that were executed between 9 a.m. and 11 a.m. on June 1.
You can also use the EACH command to define the time period that each detail
line in a report represents, and you can use the TITLE1, TITLE2, and TITLE3
commands to specify a multi-line title for the report.
For more information about secondary report commands, see the chapter
"Commands."
Chapter 2: Planning Your Reports 27
Chapter 3: Writing Your Report
This chapter describes the general procedure for writing and submitting any
history report or a series of reports. For more information about reading
reports generated by the report writer, see the chapter "Planning Your
Reports."
The general steps you must complete to produce a report follow:
Step
Action
1
Create a job stream. The job stream varies depending on whether
you take the report input from the flashback file, the archive file, or
the log file. Sample JCL for each of these cases is provided in the
detailed description of Step 1.
2
Specify the commands required to create your report.
3
Combine the commands with the job stream.
4
Mount the tape containing the log file if you plan to use input from a
tape log file. The log file can be a disk file, and the flashback file is
always on disk.
5
Run the jobstream created in Step 3.
The following topics provide detailed instructions for completing Steps 1
through 3.
This section contains the following topics:
Step 1: Create a Job Stream (see page 29)
Step 2: Write History Reporting Commands (see page 34)
Step 3: Generate Reports (see page 39)
Step 1: Create a Job Stream
You can produce reports using either flashback files, archive files, or log files
(backups of the archive file to tape or disk) as input to the report. The JCL for
each input file type is furnished in the topics that follow. Use the version of JCL
that is appropriate for your type.
Chapter 3: Writing Your Report 29
Step 1: Create a Job Stream
Customize your reports by specifying additional parameters in the EXEC
statement. You can choose parameters that let you suppress the introductory
report banner, force all output to uppercase, print lines containing report data
only, set the date format, and specify whether to list report commands before
printing the report. For more information, see Specifying Report Output
Preferences.
After you define the JCL for your report, write your history reporting
commands. These commands are described in Step 2: Write History Reporting
Commands. After writing your commands, incorporate these commands into
the JCL, as described in Step 3: Generate Reports.
Report Input from Flashback Files
Use the sample jobstream below to write reports that use flashback file data.
* $$ JOB
* $$ LST CLASS=A
// JOB FBCKRPT
PERFORMANCE MONITOR REPORT WRITER
// DLBL EVSEFBK,'evsefbk.file',,VSAM,CAT=catalog
(1)
// EXEC EXPRPT,SIZE=EXPRPT
INPUT(EVSEFBK)
(2)
************************************************
***
**
***
Your history reporting commands go here.
***
**
(3)
***
************************************************
/*
/&
* $$ EOJ
Specify the following information (corresponding to the numbers in the
preceding figure) in your jobstream:
1.
You must include this DLBL statement. Replace evsefbk.file with the
dataset name of your flashback file. Specify the parameter CAT=catalog,
replacing catalog with the name of the VSAM catalog where the flashback
file resides, if this information is not included in system standard labels.
2.
This statement is required for generating reports from the flashback file.
3.
After the INPUT command, insert your history reporting commands.
30 Report Reference Guide
Step 1: Create a Job Stream
Report Input from Archive Files
Use the following sample jobstream to write reports that use archive file data.
* $$ JOB
* $$ LST CLASS=A
// JOB FBCKRPT
PERFORMANCE MONITOR REPORT WRITER
// DLBL EVSEARC,'evsearc.file',,VSAM,CAT=catalog
(1)
// EXEC EXPRPT,SIZE=EXPRPT
INPUT(EVSEARC)
(2)
************************************************
***
**
***
Your history reporting commands go here.
***
**
(3)
***
************************************************
/*
/&*
$$ EOJ
Specify the following information (corresponding to the numbers in the
preceding figure) to tailor your job stream:
1.
You must include this DLBL statement. Replace evsefbk.file with the
dataset name of your flashback file. You must specify EVSEARC as the
DLBL filename for the CA Explore for z/VSE archive file. Specify the
parameter CAT=catalog, replacing catalog with the name of the VSAM
catalog where the archive file resides, if this information is not included in
system standard labels.
2.
This statement is required for generating reports from the archive file.
3.
After the INPUT command, insert your history reporting commands.
Chapter 3: Writing Your Report 31
Step 1: Create a Job Stream
Report Input from Tape Log Files
Use the sample jobstream below to write reports that use data from a backup
of the archive file to tape.
* $$ JOB
* $$ LST
// JOB ARCRPT
PERFORMANCE MONITOR REPORT WRITER
// TLBL filename,'evsearc.backup'
// ASSGN SYS004,TAPE
(1)
ASSIGNING INPUT FILE
// PAUSE MOUNT INPUT TAPE ON SYS004
// MTC REW,SYS004
// EXEC EXPRPT,SIZE=EXPRPT
INPUT(filename)
(2)
************************************************
***
**
***
Your history reporting commands go here. **
***
(3)
***
************************************************
/*
/&*
$$ EOJ
Specify the following information (corresponding to the numbers in the
preceding figure) in your jobstream:
1.
Replace filename with the filename of your tape log file. Replace
evsearc.backup with the dataset name of the file. Include a TLBL
statement for each tape log file that you want to use as input.
2.
Replace filename with the filename of your tape log file. If you do not
specify an INPUT command, the report writer defaults to TAPEIN, which
causes the report writer to expect input from tape and to process the file
in the same manner as the command INPUT(TAPEIN).
3.
Insert your history reporting commands after the INPUT command.
32 Report Reference Guide
Step 1: Create a Job Stream
JCL for Producing Reports Using Disk Log File Data
Use the sample jobstream below to write reports that use data from a backup
of the archive file to disk.
* $$ JOB
* $$ LST
// JOB ARCRPT
PERFORMANCE MONITOR REPORT WRITER
// DLBL DISKxxx,'evsearc.backup'
(1)
// EXEC EXPRPT,SIZE=EXPRPT
INPUT(DISKxxx)
(2)
************************************************
***
**
***
Your history reporting commands go here. **
***
(3)
***
************************************************
/*
/&*
$$ EOJ
Specify the following information (corresponding to the numbers in the
preceding figure) in your jobstream:
1.
Replace DISKxxx with the filename of your disk log file. Replace
evsearc.backup with the dataset name of the file. Include a DLBL
statement for each disk log file that you want to use as input.
2.
Replace DISKxxx with the filename of your disk log file.
3.
Insert your history reporting commands after the INPUT command.
Specifying Report Output Preferences
You can add parameters to your EXEC statement to perform the following
tasks:
■
Suppress the introductory report banner.
■
Force all output to uppercase.
■
Print only lines containing report data.
■
Set the date format.
■
Specify whether you want to list the report commands before printing the
report.
Chapter 3: Writing Your Report 33
Step 2: Write History Reporting Commands
Parameters
Parameter
Purpose
BANNER
Produces a banner that precedes reports and identifies them
as output from the CA Explore PM for z/VSE report writer.
Specify 'BANNER=YES' to include this banner.
CASE
Specify 'CASE=UPPER' to force all output to uppercase.
DATAONLY
Specify 'DATAONLY=YES' to print lines containing report
data only. Otherwise, all lines are printed.
DATEFRMT
Sets the format of dates in report output to mm/dd/yy or
dd/mm/yy.
ECHO
Specifies whether you want to list the report commands
before printing the report. Set the value to NO only after
you verify that the report commands are correct.
Format
// EXEC EXPRPT,SIZE=EXPRPT,PARM=['BANNER=NO|YES']
['CASE=UPPER']
['DATAONLY=[NO|YES]']
['DATEFRMT=[MM/DD/YY|DD/MM/YY]']
['ECHO=[YES|NO]']
Separate each parameter with a comma when using more than one
parameter.
Step 2: Write History Reporting Commands
Report writer uses two types of history reporting commands:
■
Global commands—Control the report writer, not any specific report. For
example, global commands can control the page size that the report writer
prints, or how many columns the report writer reads in one statement.
Global commands affect all reports included in one run.
■
Report commands—Control what happens in a single report. For example,
report commands can control the time interval or format of a single report.
34 Report Reference Guide
Step 2: Write History Reporting Commands
Global Commands
Global commands set values that stay in effect for all reports printed in one
run. For example, if you use the LINECOUNT command to tell the report writer
how many lines are on one page, that number of lines applies to all reports in
that run.
You can insert global commands anywhere within the report commands. Most
global commands affect all reports in the run without regard to placement. The
exceptions are the DEFINE command, the GLOBAL command, and some
operands of the OPTION command, which affect only reports that come after
them.
For a complete list of global commands, see List of Global Commands in this
chapter.
Report Commands
Report commands build a report by telling the report writer what kind of report
to write, what variables to use, when to start the report, and so on. The two
types of report commands are primary and secondary.
Primary Report Commands
Each report must contain only one of the following primary report commands:
■
TAB—Creates a tabular report showing the value of the specified variables
for each time or identifier.
■
PLOT—Plots the value of a variable horizontally over time.
■
VPLOT—Plots the value of a variable vertically over time using bars.
■
MPLOT—Plots the value of a variable vertically over time using outlining.
■
GRAF—Graphs resource usage by identifier (transaction, terminal, and so
on).
■
FLASHBACK—Produces a report containing a line or a page per
transaction.
■
INVOICE—Produces a tabular invoice report using the cost factors you
specify.
■
CANRPT—Produces a canned report.
For more information about primary commands, see the chapter "Commands."
Chapter 3: Writing Your Report 35
Step 2: Write History Reporting Commands
Secondary Report Commands
After primary report commands, you can include secondary report commands.
Secondary report commands alter or enhance the report. For example, use the
secondary commands FROM and TO, to limit the time range covered by a
report, or use TITLE1 to define a title for the report.
For a complete list of secondary report commands, see List of Secondary
Report Commands in this chapter.
Required Report Commands: END and RUN
Each report must end with the END command, which tells the report writer
that the report description is complete.
After the END command, you can start another report. For each new report,
the variables you set in the previous report are no longer in effect. If you want
to use the same variables, you must enter them again. Values set by global
commands, however, remain in effect unless overridden by another command.
Use the RUN command to start executing the reports you described. When the
report writer encounters RUN, it stops reading your commands and starts
writing reports. Commands after the RUN command are ignored, so make sure
that RUN is always the last command that you give to the report writer.
Writing One Report
The following example shows the minimum commands necessary to write one
report:
primarycommand [variable]
END
RUN
The commands in this example perform the following functions:
Primary
Command
Command
primarycommand
36 Report Reference Guide
Description
One of the following primary report
commands, possibly followed by one or
more report writer variables:
TAB
Creates a tabular report showing the
value of the specified variable for each
time period or identifier.
PLOT
Plots the value of the specified variable
Step 2: Write History Reporting Commands
Primary
Command
Command
Description
horizontally over time.
PLOT
Plots the value of the specified variable
horizontally over time.
VPLOT
Plots the value of the specified variable
vertically over time using bars.
MPLOT
Plots the value of the specified variable
vertically over time using outlining.
GRAF
Graphs resource usage by identifier
(job, dataset, device, and so on).
FLASHBACK
Produces a report containing one line
per job, jobstep, or job pseudo-step,
according to the options specified.
INVOICE
Produces a tabular invoice report using
the cost factors you specify.
CANRPT
Produces a canned report.
END
Indicates the end of this report.
RUN
Runs all of the reports you specified.
Note: In this example, only one report
was requested.
Writing Multiple Reports
To write multiple reports in a single run, end each set of report commands
with the END command. Specify the RUN command following the END
command for the last report.
Each flashback report must be run as a single report in a separate run. You
cannot specify another primary report command (such as TAB or PLOT) in a
jobstream with the FLASHBACK command.
The following example shows the minimum number of commands needed to
write two reports—a GRAF report and a PLOT report. Note that each report
includes an END command:
GRAF variable
END
PLOT variable
END
RUN
Chapter 3: Writing Your Report 37
Step 2: Write History Reporting Commands
Tailoring Reports Using Secondary Commands
You can tailor a report by inserting secondary commands before the report's
END command.
You can, for example, add the SHIFT command to the preceding example to
include in the graph report only the hours from 8:00 a.m. to 12:00 p.m., as
follows:
GRAF variable
SHIFT 08:00:00 12:00:00
END
PLOT variable
END
RUN
Because the SHIFT command is not used with the PLOT command, the
resulting plot report covers all 24 hours. To apply the same time restrictions to
the plot report as to the graph report, include the SHIFT command with the
PLOT command as well as with the GRAF command.
Creating Multiple Tailored Reports
You can use the same secondary command for each report you create. For
example, if you are printing 10 reports, you can use the SHIFT command with
each primary report command to specify the time period that you want each
report to cover. You cannot use the same secondary command twice for the
same report, even if you specify two different time periods. The exceptions to
this rule are the COST, EXCLUDE, GROUP, INCLUDE, and RANGE commands,
which may be repeated in the same report.
The following example shows the incorrect use of secondary commands in a
command stream:
Incorrect Command Stream
Corrected Command Stream
GRAF variable
GRAF variable
SHIFT 08:00:00 12:00:00
SHIFT 13:00:00 17:00:00
END
PLOT variable
SHIFT 08:00:00 17:00:00
END
GRAF variable
SHIFT 13:00:00 17:00:00
END
END
RUN
PLOT variable
END
RUN
38 Report Reference Guide
Step 3: Generate Reports
Note: The SHIFT commands in this example are indented to make each list of
commands more readable. A command can begin anywhere, as long as it is
the leftmost word on the line.
Step 3: Generate Reports
After you have written your history reporting commands, insert them into the
job stream you defined in Step 1.
For example, assume that you have written the following report commands to
create a VPLOT report that shows the transaction use for every 30 minutes in
a 24-hour period:
VPLOT VSE CPU UTILIZATION
FROM 01/03/04 00:00:00
TO
01/03/04 23:59:59
EACH 30 MINUTES
END
RUN
Insert the preceding commands into the jobstream as shown below. (This
jobstream uses input from the flashback file, as explained earlier in this
chapter.)
* $$ JOB
* $$ LST CLASS=A
// JOB FBCKRPT
PERFORMANCE MONITOR REPORT WRITER
// DLBL EVSEFBK,'EVSEFBK.FILE',,VSAM
// EXEC EXPRPT,SIZE=EXPRPT
INPUT(EVSEFBK)
************************************************
VPLOT VSE CPU UTILIZATION
FROM 01/03/04 00:00:00
TO
01/03/04 23:59:59
EACH 30 MINUTES
END
RUN
************************************************
/*
/&
* $$ EOJ
Chapter 3: Writing Your Report 39
Chapter 4: Reading Reports
This chapter explains how to read the following four types of report writer
reports:
■
Tabular reports—Show the values of variables for one or more individual
resources or times and are composed of rows and columns.
■
Plot reports—Plot the value of a variable for a group of resources either
against time or against another variable.
■
Graph reports—Compare the value of variables for several resources of the
same type using graphs.
■
Flashback reports—Contain detailed information about transactions using
tabular reports.
This section contains the following topics:
Reading
Reading
Reading
Reading
Tabular Reports (see page 41)
Plot Reports (see page 50)
Graph Reports (see page 61)
Flashback Reports (see page 69)
Reading Tabular Reports
You can create the following types of tabular reports either by using the TAB
command or by using the TAB command with the TAB2 command:
■
TAB command generates either simple or complex reports:
Simple tabular reports give information about a single group of resources
and are organized either by resource or by time period.
Complex tabular reports give information about a single group of resources
and are organized by both resource and time period.
■
Reports generated by the TAB and TAB2 commands used together, which
give information about two groups of related resources
In all tabular reports, a column is created for each variable that you specify in
the TAB and TAB2 commands. Each report writer variable is assigned an
abbreviation that is used by default to create the column heading for that
variable's data. For more information about meaning of a default heading in a
report, see the lists of variables in the chapter "Variables."
You can change the column headings in a report by using the HDR1 and HDR2
operands. For more information, see the chapter "Tabular Reports".
Chapter 4: Reading Reports 41
Reading Tabular Reports
Simple Tabular Reports
Simple tabular reports are created by the TAB command and are organized
either by resource or by time period.
In the tabular report structure, the first column of the report lists the key for
each row. These keys can be dates and times, or individual resources of a
single type, such as library names, jobnames, channel IDs, or volume IDs. The
following report gives information about several libraries:
LIBRARY
LOAD
NAME
COUNT
-------- -------SVA
72039
IJSYSRS
7557
TESTLIB
2585
DCMLIB
2037
PRD1
1352
PRODLIB
1334
PRD2
431
EXPCLIB
230
SQLIB
17
TEMPLIB
16
-------- -------SUMMARY
87598
-------- --------
For each period or resource listed in the first column, the remaining columns
show the value of each variable specified in the TAB command.
■
The first column of the report lists the key for each row. These keys can be
either dates and times or individual resources of a single type.
■
The preceding report is organized by library, and the names of all libraries
meeting the criteria specified by the report commands are listed in the
first column.
■
The remaining columns in the report show the value of each variable
specified in the TAB command, for each time period or resource listed in
the first column:
■
For tabular reports organized by time or date, the numbers in the body of
the report represent the performance for all resources of the relevant type
during the specified time period.
■
For tabular reports organized by time or date, the numbers in the body of
the report represent the performance for all resources of the relevant type
during the specified time period.
■
For tabular reports organized by time or date, the numbers in the body of
the report represent the performance for all resources of the relevant type
during the specified time period.
42 Report Reference Guide
Reading Tabular Reports
■
For tabular reports organized by resource, the rows in the report give the
performance of the one individual resource whose ID is listed in the first
column.
■
For example, the preceding report shows that the load count for library
SVA was 72039.
■
The last row in the table is labeled SUM or SUMMARY (depending on the
width of the column) and shows the total or average value of each variable
for all resources listed. For example, the preceding report shows that the
total load count for the libraries listed was 87598.
Complex Tabular Reports
More complex tabular reports created by the TAB command are organized by
both time period and resource; they show the values of variables for specified
resources during each time period.
The following report is organized by time and by jobname within each time
period:
TIME
----10.00
--------11.00
---------
JOB
NAME
-------$JC2XCX
TST2COPY
LVTOC
$0JC2XC5
$0JC2XC4
-------SUMMARY
-------$JC2XCX
SQLMON
DOSVSDMP
ESQLINK
ARIS34GD
-------SUMMARY
--------
JOB
COUNT
-------8
4
2
2
2
-------18
-------5
2
2
2
1
-------12
--------
STEP
COUNT
-------8
4
3
2
2
-------19
-------5
3
2
2
2
-------14
--------
TCPU
TIME
-------1.044
0.504
0.118
0.193
0.192
-------2.051
-------0.951
0.273
14.13
1.202
1.239
-------17.79
--------
SIO
COUNT
---------1,652
861
110
230
230
---------3,083
---------1,373
235
116
1,008
876
---------3,608
----------
LOAD
COUNT
-------128
124
21
32
32
-------337
-------833
61
34
272
279
-------1479
--------
SVC
COUNT
---------40
44
7
10
10
---------111
---------123
9
20
56
56
---------264
----------
Tabular reports like the preceding report have the following structure:
■
The first column lists dates or times. In the preceding report, the first
column organizes the report into two periods of one hour each.
■
The second column lists the resources specified by the ID option used with
the TAB command, for each time period. The jobs that are active during
each time period are also shown. Note that the same jobname can be
listed more than once in the second column, as is the case with the job
$JC2XCX in the preceding report. This is because a job can be active
during more than one time period.
Chapter 4: Reading Reports 43
Reading Tabular Reports
■
The remaining columns show the values of the specified variables for each
resource listed for each time period. For example, the preceding report
shows that the job TST2COPY accounted for 861 SIOs, 124 loads, and 44
supervisor calls.
■
The report includes a SUM or SUMMARY row for each time period, which
shows the total or average value of each variable for that period, for all
resources listed.
TAB2 Reports
Reports generated by the TAB and TAB2 commands used together show the
values of various variables for a set of resources and the breakdown of those
variables.
A TAB command was used to generate the sample report earlier in this chapter
that shows the load count of each of several libraries. Adding a TAB2
command to the TAB command can generate a report that also shows which
sublibraries in each library accounted for these loads, as shown in the
following example:
LIBRARY
LOAD
SUBLIB
LOAD
44 Report Reference Guide
Reading Tabular Reports
NAME
COUNT
NAME
-------- -------- -------SVA
72039
SDL
IJSYSRS
7557
SYSLIB
TESTLIB
2585
TEST1
DCMLIB
2037
330
SORT
TVSAM
EPIC
-------SUMMARY
-------PRD1
1352
BASE
PRODLIB
1334
FAQSPCS
DYNB
EVSETEST
ECOM593
ECOM574
EXPCOM
DCMCOMM
DCMFAQS
ALT471
COMPDT
ALERT70
-------SUMMARY
-------PRD2
431
DBASE
CONFIG
XXXSQL
-------SUMMARY
-------EXPCLIB
230
EXPC500
SQLIB
17
V310
V320
-------SUMMARY
-------TEMPLIB
16
VSAMC
-------- -------- -------SUMMARY
87598
-------- -------- --------------- -------- --------
COUNT
-------72039
7557
2585
1781
146
103
7
-------2037
-------1352
397
267
172
138
89
89
71
71
27
9
4
-------1334
-------213
125
93
-------431
-------230
12
5
-------17
-------16
-------87598
---------------
The first two columns of the preceding TAB2 report were generated by the TAB
command and have the structure explained earlier in this chapter. The
columns to the right of these were generated by the TAB2 command and have
the following structure:
■
The SUBLIB NAME column lists the names of all sublibraries in each library
for which there were loads.
■
The remaining column shows the number of loads for each sublibrary. One
column is created for each variable specified with the TAB2 command, in
the order specified.
Chapter 4: Reading Reports 45
Reading Tabular Reports
■
The information for each table also includes a row labeled SUM or
SUMMARY (depending of the width of the column), which gives the
average or total value for each variable for all the resources listed. In this
case, the SUMMARY lines show the total number of loads for all
sublibraries listed for each library.
■
The last row in the report, also labeled SUM or SUMMARY, gives the total
or average for each column for the resources listed. In this case, it shows
the total number of loads to the libraries listed.
TAB2 Command
Use the TAB2 command to present more information about each resource
reported upon by the TAB command.
Creating a Simple TAB2 Report
The following commands create a report showing information about each
volume and about each data set on each volume:
TAB VOLSER VSE DSN SIO
AND,
VSE DSN SERVTIME
TAB2 DSNID VSE DSN SIZE
VSE DSN READS
VSE DSN WRITES
END
RUN
46 Report Reference Guide
AND,
AND,
Reading Tabular Reports
The preceding commands create a report like the following:
VOLSER
DSN
SERVICE
DSN
DSN
DSN
DSN
ID
SIO
TIME
NAME
SIZE
READS
WRITES
-------- ---------- -------- ------------------------------------ -------- -------- -------DEV224
1,078
0.007
DEVTST2.PRODUCTION.CA-EXPLORE.LIBRARY
1125
1208
29
DEVTST2.VIO.PDS
300
74
103
DCM.SYSTEMS.PRODUCTION.LIBRARY
300
67
DEVTST2.MON.PDS
235
224
66
------------------------------------- ------- -------- -------SUMMARY
235
1573
198
------------------------------------- ------- -------- -------DOSRES
657
0.006
VSE.SYSRES.LIBRARY
899
218
VSE.PRD1.LIBRARY
330
18
VSE.POWER.QUEUE.FILE
4
592
VSAM.MASTER.CATALOG
42
2
DOSRES.VTOC
16
VSAM.MASTER.CATALOG.INDX
8
-------------------------------------- -------- ------- ------SUMMARY
330
302
594
-------------------------------------- -------- ------- ------DEV22B
333
0.007
EVSE.DEVTST2.FLSHBACK
225
3071
24
DEVTST2.VSAM.USER.CATALOG
24
46
4
EXPCFBK.DEVTST2
15
21
16
EXPCFIL.DEVTST2
15
1
1
AXP.LOG1.KSDS
5
8
8
AXP.LOG1.KSDS.INDX
1
8
EXPCFIL.DEVTST2.INDX
1
1
DEV22B.VTOC
16
DEVTST2.VSAM.USER.CATALOG.INDX
10
-------------------------------------- ---- --- -------- -----SUMMARY
225
3182
53
-------------------------------------- -------- -------- -----DEV223
40
0.009
ALERT.RULES
5
40
------------------------------- ------ -------- -------- -----SUMMARY
5
40
------------------------------------- -------- -------- ------DEV22F
9
0.016
EPIC.CATALOG.FOR.DEVTST2
13
21
------------------------------------- -------- -------- ------SUMMARY
13
21
------------------------------------- -------- -------- ------DEV227
7
0.006
ISM.VSE13.PROD.LIBRARY
780
21
------------------------------------- -------- -------- ------SUMMARY
780
21
------------------------------------- -------- -------- -------------- ---------- -------- ------------------------------------- -------- -------- ------SUMMARY
2,124
0.007
13
5139
845
-------- ---------- -------- ------------------------------------- -------- -------- -------------- ---------- -------- ------------------------------------- -------- -------- -------
Limiting TAB2 Reports Using the FOR Operand
Use the FOR operand to limit the number of identifiers included in a report.
In the following example, the FOR operand is specified with both the TAB and
TAB2 commands to create a report showing jobs and the disk devices
associated with them:
TAB
JOBID
FOR 3 VSE DISK SIO
AND,
VSE DISK SERVTIME
TAB2 VOLSER FOR 6 VSE DISK SIO
AND,
VSE DISK SERVTIME
END
RUN
Chapter 4: Reading Reports 47
Reading Tabular Reports
The preceding commands generate a report like the following:
JOB
SIO
SERVICE VOLSER
NAME
COUNT
TIME
ID
-------- ---------- -------- -------JCLSCHED
6,583
0.039
WM08RS
SYSWK1
VSE001
-------SUMMARY
-------CICSMROA
3,282
0.038
SYSWK1
WM08RS
VSE001
VSESYS
-------SUMMARY
-------CICSEC16
2,788
0.061
WM08RS
DOSRES
SYSWK1
VSE001
GOAL01
VSESYS
-------SUMMARY
--------
SIO
COUNT
---------3,333
2,728
522
---------6,583
---------2,622
427
222
11
---------3,282
---------908
622
441
420
374
23
---------2,788
----------
SERVICE
TIME
-------0.032
0.047
0.039
-------0.039
-------0.038
0.040
0.043
0.019
-------0.038
-------0.066
0.066
0.067
0.059
0.038
0.057
-------0.061
--------
Although the FOR 6 operand is specified for the TAB2 command, fewer than
six volumes are listed for each of the first two jobs in the report. These are the
only volumes with activity for those jobs.
Using DATE, TIME, DATETIME, or DAY with the TAB2 Command
You can specify the DATE, TIME, DAY, or DATETIME operand with the TAB2
command if you do not specify any of these operands with the TAB command.
This allows you to create reports organized first by identifier and then by time
period.
The following commands create a report organized first by volume, then by
time:
TAB VOLSER VSE DSN SIO
AND,
VSE DSN SERVTIME
TAB2 TIME
VSE DSN SIO
AND,
VSE DSN READS
AND,
VSE DSN WRITES
EACH HOUR
FROM 02/01/04 12:00:00
TO
END
RUN
48 Report Reference Guide
02/01/04 16:00:00
Reading Tabular Reports
The preceding commands create a page for each active volume as follows:
VOLSER
DSN
SERVICE
DSN
DSN
DSN
ID
SIO
TIME
TIME
SIO
READS
WRITES
-------- ---------- -------- ----- ---------- -------- -------DOSRES
22,841 0.004
12.00
11,170
9060
2123
13.00
3,865
1938
1914
14.00
1,961
262
1699
15.00
5,845
2991
2807
----- ---------- -------- -------PERIOD
22,841 14251
8543
Creating TAB2 Reports on GETVIS Usage
GETVIS information is logged by CA Explore PM for z/VSE and can be used to
display GETVIS usage by partition, job, or step.
The following commands produce a report containing both partition- and jobrelated GETVIS information:
TAB PID FOR 7 VSE GETVIS USED
AND,
VSE GETVIS MAXUSED
AND,
VSE GETVIS %USED
AND,
VSE GETVIS MAX%USED
TAB2 JOBID
VSE GETVIS USED
AND,
VSE GETVIS MAXUSED
AND,
VSE GETVIS %USED
AND,
VSE GETVIS MAX%USED
END
RUN
Chapter 4: Reading Reports 49
Reading Plot Reports
The preceding commands generate a report like the following:
PART GETVIS
MAX
%GETVIS
MAX
ID
USED
GETVIS
USED
%GETVIS
---- -------- -------- -------- -------F3
2659k
2696k
90.9
91.3
FB
2521k
2764k
75.6
79.3
F7
1037k
1992k
57.2
99.8
JOB
NAME
-------VTAMSTRT
SQL310
JCLSCHED
EVSTAT
-------SUMMARY
-------F5
704k
888k
35.5
44.3
EVSEIBAT
F2
676k
1080k
37.7
56.0
CICSMROA
ALT
-------SUMMARY
-------AR
612k
680k
42.1
46.8
SYSTEM
F4
313k
1068k
20.4
52.6
CICSMROB
GSLJCLUF
SARDATCL
PLMDATCL
EVSTAT
ALT
JCLXCU
-------SUMMARY
----------- -------- -------- -------- -------- -------SUM
1030k
0
52.6
0.0
---- -------- -------- -------- -------- ----------- -------- -------- -------- -------- --------
GETVIS
USED
-------2671k
2595k
1100k
16k
-------1037k
-------707k
709k
67k
-------676k
-------612k
797k
172k
165k
124k
75k
69k
24k
-------313k
--------------580k
---------------
MAX
GETVIS
-------2696k
2764k
1992k
32k
-------1992k
-------888k
1080k
296k
-------1080k
-------680k
1068k
204k
180k
248k
112k
304k
48k
-------1068k
--------------3976k
---------------
%GETVIS
USED
-------90.9
75.6
55.2
2.0
-------57.2
-------35.5
38.7
3.4
-------37.7
-------42.1
40.8
3.1
3.0
4.4
2.0
3.3
0.9
-------20.4
--------------43.7
---------------
MAX
%GETVIS
-------91.3
79.3
97.8
2.0
-------99.8
-------44.3
56.0
4.9
-------56.0
-------46.8
52.6
3.6
3.2
4.4
2.0
5.1
0.9
-------52.6
--------------100.0
---------------
Reading Plot Reports
Plot reports plot the value of a variable for a group of resources either against
time or against another variable.
Plot reports fall into three categories:
■
Horizontal plot reports—Plot a variable horizontally across time. Horizontal
plot reports are generated by the PLOT and PLOT2 commands.
■
Vertical plot reports—Plot a variable vertically across time. Vertical plot
reports are generated by the VPLOT, VPLOT2, and MPLOT commands.
■
Distribution plot reports—Plot a variable vertically against another variable
instead of plotting across time. Distribution plot reports are generated by
the HPLOT command used with either the VPLOT or the MPLOT command.
PLOT Command Horizontal Reports
Horizontal plot reports created with the PLOT command alone plot the value of
a single variable.
50 Report Reference Guide
Reading Plot Reports
The following horizontal plot report shows the number of SIOs for a particular
device (plotted with Xs) and for all devices (plotted with hyphens [-]).
SHIFT NONE
EACH
HOUR
PERIOD NONE
DEVICE SIO COUNT
01/07/04 10.00.00
11.00.00
12.00.00
13.00.00
14.00.00
15.00.00
SUMMARY:
RANGE:
SYMBOLS:
"X" =
0
2858
5717
8576
11435
14294
17153
20012
22871
25730
28589
X
+........+........+........+.........+........+.........+.........+........+........+........+
.XXXXXXXXXXXXXXX---------------------.
.
.
.
.
. 4720 11327
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX----------------------.
.
.
. 13307 19694
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX----- 26906 28589
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX----------- .
.
.
. 16041 19219
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX---------.
.
.
. 14181 17077
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-----------------.
.
.
. 15002 19836
.
.
.
.
.
.
.
.
.
.
. SUMMARY:
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-------------- .
.
.
. 15026 19290
+........+........+........+.........+........+.........+.........+........+........+........+
0
2858
5717
8576
11435
14294
17153
20012
22871
25730
28589
X
-
DEVICE SIO COUNT
"-" =
GLOBAL DEVICE SIO COUNT
Horizontal plot reports have the following structure:
■
The three lines in the upper left of the report give information about the
time period covered by the report. You can create plots covering different
shifts or periods using the SHIFT command or the PERIOD command. The
time period represented by each detail line is determined by the EACH
command. The default is one day.
■
The next line of the report displays the plot's scale. This scale is displayed
again just below the plot. You can alter a plot's scale with the SCALE
operand.
■
The leftmost columns of the report list the dates and times for each detail
line. A date is not shown unless it has changed from the preceding line. In
the preceding report, each detail line represents an hour.
■
The rightmost columns of the report list the numeric values for each detail
line. The headings of these columns are the characters used in the plot;
what each character represents is shown at the bottom of the report
following the SYMBOLS: label.
■
Plot reports can show the value of a variable for a single resource or a
group of resources of a given type, together with the average or total
value for all resources of that type. For example, in the preceding report,
the CPU usage for the user specified with the PLOT command is plotted
with Xs, and the total CPU usage for all users is plotted with hyphens (-).
■
If you do not specify a particular resource or group of resources, the plot
will show the value of the variable for all resources of the type associated
with the variable. Two plot characters will still be assigned, as in the
preceding report, but only the global character will appear in the plot.
Chapter 4: Reading Reports 51
Reading Plot Reports
■
A report summary is given at the end of the report if you specify the
RANGE command, or at the end of each period in the report if you specify
the PERIOD command. These lines are labeled RANGE: or PERIOD: and
indicate the following information in graph and numeric form:
■
RANGE indicates the average performance for the entire report
■
PERIOD indicates the average performance for the period
PLOT2 Command Horizontal Reports
Horizontal plot reports created with the PLOT and PLOT2 commands used
together plot the values of two variables.
The following PLOT2 report, like the preceding PLOT report, includes the SIO
count for a single device (plotted with Xs) and for all devices (plotted with
hyphens [-]). However, the following report also shows the average device
service time for the same device and for all devices; these are plotted with Ns
and plus signs (+), respectively.
SHIFT NONE
EACH
HOUR
PERIOD NONE
DEVICE I/O SERVICE TIME
0
2858
5717
8576
11435
14294
17153
20012
22871
25730
28589
0
0.002
0.004
0.007
0.009
0.011
0.013
0.015
0.018
0.020
0.022
+........+........+........+.........+.........+.........+.........+.........+........+.........+
01/07/04 10.00.00 .XXXXXXXXXXXXXXX---------------------.
.
.
.
.
.
.NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN
11.00.00 .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX----------------------.
.
.
.
.NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN
12.00.00 .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-----.NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN
.
13.00.00 .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX----------- .
.
.
.
.NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN++++++++
.
14.00.00 .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX---------.
.
.
.
.NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN
15.00.00 .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-----------------.
.
.
.
.NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN+++++++++
.
SUMMARY:
.
.
.
.
.
.
.
.
.
.
.
RANGE:
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-------------- .
.
.
.
.NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN
.
+........+........+........+.........+.........+.........+.........+.........+........+.........+
0
0.002
0.004
0.007
0.009
0.011
0.013
0.015
0.018
0.020
0.022
0
2858
5717
8576
11435
14294
17153
20012
22871
25730
28589
SYMBOLS: "X" = DEVICE SIO COUNT
"-" = GLOBAL DEVICE SIO COUNT
"N" = DEVICE I/O SERVICE TIME
"+" = GLOBAL DEVICE I/O SERVICE TIME
52 Report Reference Guide
X
N
+
4720 11327
0.022 0.019
13307 19694
0.022 0.022
26906 28589
0.021 0.021
16041 19219
0.018 0.020
14181 17077
0.022 0.022
15002 19836
0.019 0.021
SUMMARY:
15026 19290
0.020 0.020
N
X
+
-
Reading Plot Reports
The structure of PLOT2 reports is the same as the structure of PLOT reports
with the following exceptions:
■
Since the variables may be plotted using different scales, two scales are
shown. The top scale applies to the PLOT variable (in this case, SIO
count), and the second scale applies to the PLOT2 variable (in this case,
device service time).
■
Each time listed in the leftmost column is followed by two detail lines
instead of one. The first plots the value of the PLOT variable, and the
second plots the value of the PLOT2 variable. The rightmost columns list
these values numerically.
■
The summary includes two ranges instead of one, the first for the PLOT
variable and the second for the PLOT2 variable.
VPLOT Command Vertical Reports
Vertical plot reports created with the VPLOT command alone plot a single
variable.
Chapter 4: Reading Reports 53
Reading Plot Reports
The following vertical plot report plots the CPU activity every 15 minutes on a
single day:
SHIFT NONE
EACH
15 MINUTES
AMOUNT OF VIRTUAL CPU CONSUMED
PERIOD NONE
VIRTUAL
VIRTUAL
CPU
CPU
--------------16.25
I
X
I 16.25
I
X
I
I
X
X
I
I
X
X
I
I
X
X
X
I
14.22
I
X
X
X
I 14.22
I
X
X
X
I
I
X
X
X
I
I
X
X
X
I
I
X
X
X
I
12.18
I
X
X
X
I 12.18
I
X X
X
X
X
I
I
X X
X
X
X
X
I
I
X X
X X
X
X
X
X
I
I
X X
X X
X
X
X
X
I
10.15
I
X X
X X
X
X
X
X
I 10.15
I
X X
X X
X
X
X
XXX
I
I
X X
X X X
X
X
X
XXX
I
I
X X
X X X
X
X
X
XXX
I
I
X X
X X X
X
X X
X
X
XXX
I
8.127
I
X X
X X X
X XX X
XX
X
XXX
I 8.127
I
X
X X
X X X X
X XX X
XX
X
XXX
I
I
X
X X
X X X X
X XX X
XX
X
XXX
I
I
XX
X X XXX X X X
X X XXX X
XXX X XX XXXX
I
I
XX
X
X X XXX X XXX
X X XXX X
XXX X XX XXXX
I
6.096
I
X
XX
X
X X XXXX XX XXX
X X XXX XX
XXX X XX XXXXX
I 6.096
AI------------X-------XXX-------X---X-X-XXXX-XX-XXX--XXX-X--XXXXXX---XXX-XX--XX-XXXXX--------------------------- I
I
X
XXX
X
XXX XXXX XX XXXXXXXX X XXXXXXXX XXXXXXX XX XXXXX
X
I
I
X
XXX
X
XXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XX XXXXX
X
X
I
I
X
XXX
X
XXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXX
I
4.065
I
X
XXX
X
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXX
I 4.065
I
X
XXX
XX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXX
I
I
XX X XXXXX
XX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
2.034
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I 2.034
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
0.000
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I---------II 0.000
00:00
02:30
05:00
07:30
10:00
12:30
15:00
17:30
20:00
22:30
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
SYMBOLS:
"X" = AMOUNT OF VIRTUAL CPU CONSUMED
Vertical plot reports have the following structure:
■
The leftmost column shows the scale of the report and identifies the data
being plotted (in this case, VIRTUAL CPU). This information is repeated in
the rightmost column.
■
The lines immediately underneath the plot show the dates and times for
the vertical detail lines. The detail lines show the value of the specified
variable for each time period; the variable represented by the plot
character is shown near the bottom of the report following the SYMBOLS:
heading.
54 Report Reference Guide
Reading Plot Reports
■
The time period represented by each vertical detail line in the report is
shown in the upper left corner of the report following the word EACH. You
can use the EACH command to specify the time period that each detail line
in the plot should represent; otherwise the time period for each detail line
is calculated dynamically based on the total time period that the plot
covers. The default is one day. In this case, each detail line covers 15
minutes.
■
The horizontal line labeled A indicates the average value for the variable
during the time period covered by the report.
VPLOT2 Command Vertical Reports
Using the VPLOT2 command with the VPLOT command causes a second
variable to be plotted on top of the first.
Chapter 4: Reading Reports 55
Reading Plot Reports
The following VPLOT2 report includes the information in the VPLOT report (CPU
usage, plotted with Xs). The following report also plots the number disk SIOs
each 15 minutes, using Os. However, note that where the letter E appears in
the sample report shown next, a Ä symbol would appear in the actual report.
SHIFT NONE
EACH
15 MINUTES
AMOUNT OF VIRTUAL CPU CONSUMED
PERIOD NONE
VIRTUAL
SIO
CPU
COUNT
--------------16.25
I
X
O
I 17952
I
X
O
I
I
X
O
O
I
I
X
O
E
I
I
X
O
X
E
I
14.22
I
X
O
X
E
I 15708
I
X
O
X
E
I
I
X
O
X
E
I
I
X
O
X
E
I
I
X
O
X
E
I
12.18
I
X
O
E
E
I 13464
I
X X
O
X
E
E
I
I
X X
E
X
E
E
I
I
X X
X E
X
X
E
E
I
I
X X
X E
X
X
E
E
I
10.15
I
X X
X E
X
X
E
E
I 11220
I
X X
X E
X
X
E
XEX
I
I
X X
X X E
X
X
E
XEX
I
I
X X
X X E
X
X
E
XEX
I
I
X E
X X E
X
X X
E
E
XEX
I
8.127
I
X E
X X E
X XX X
EE
E
XEX
I 8976
I
X
X E
X X X E
X XX X
EE
E
XEX
I
I
X
X E
X X X E
X XX X
EE
E
XEX
I
I
XX
X E XXX X X E
X X XXX X
EEX X EX XEXX
I
I
XX
X
X E XXX X EXE
X E XXX X
EEX X EX XEXX
I
6.096
I
X
XX
X
X E XXXX XX EXE
X E XXX XX
EEX X EX XXEXX
I 6732
AI------------X-------XXX-------X---X-E-XXXX-XE-EXE--XXX-E--XXXXXX---EEX-XE--EE-XXEXX--------------------------- I
I
X
XXX
X
XXE XXXX XE EXEXXXXX E XXXXXEXX XEEXXXE EE XXEXX
X
I
I
X
XXX
X
XXE XXXXXXEXEXEXXXXEXEXXXEEXEXXXXEEXXXEX EE XXEXX
X
X
I
I
X
XXX
X
XXE XXXXXXEXEXEXXXXEXEXXEEEXEXXXXEEXXXEX EEXXXEXXXXXXXXXXXXXEX
I
4.065
I
X
XXX
X
XXEXXXXXXXEXEXEXXEXEXEXXEEEXEEXXXEEXXXEX EEXXXEXXXXXXXXXXXXXEX
I 4488
I
X
XXX
XE XXEXEXXXXXXXEXEXEXXEXEXEXXEEEXEEXXXEEEXEEXXEEXXXEXXXXXXXXXXXXXEX
I
I
XX X XXXXX
XX XEXXXEXEXXEXXXXEXEXEXXEXEXEXXEEEEEEEEEEEEXEEXXEEXXXEXXXXXXXXEXXXXEX
I
IXXXXXXXXXXXXXXXXXXXXEEXXXXXXXXEXXXEXEXXEXXXXEXEEEEEEEEEEEEEEEEEEEEEEEEEEEEXEEEEEEEEEEEEEEEEEEEEE--------------IA
IXXXXXXXXXXXXXXXXXXXXEEXXXXXXXXEXXXEXEXXEXEXXEXEEEEEEEEEEEEEEEEEEEEEEEEEEEEXEEEEEEEEEEEEEEEEEEEEE
I
2.034
IXXXXXXXXXXXXXXXXXXXXEEEXXXXXXXEXXXEEEXEEEEXEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEXEEEEEEEEEEEEEEEEEEEEE
I 2244
IXXXXXXXXXXXXXXXXXXXXEEEXXXXXXXEXXXEEEXEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEXEEEEEEEEEEEEEEEEEEEEE
I
IXXXXXXXXXXXXEXXXXXXXEEEXXXXXXXEXXXEEEXEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEXEEEEEEEEEEEEEEEEEEEEE
I
IXXXXXXXXXXXXEEXXXXEEEEEXXXEEXEEXEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEXEEEEEEEEEEEEEEEEEEEEE
I
EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE
I
0.000
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I----------II
0
00:00
02:30
05:00
07:30
10:00
12:30
15:00
17:30
20:00
22:30
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
SYMBOLS:
"X" = AMOUNT OF VIRTUAL CPU CONSUMED
"O" = DEVICE SIO COUNT
56 Report Reference Guide
Reading Plot Reports
The structure of VPLOT2 reports is the same as the structure of VPLOT reports
with the following exceptions:
■
Since two variables are plotted, two scales are shown. The scale to the left
of the plot applies to the VPLOT variable (in this case, VIRTUAL CPU), and
the scale to the right of the plot applies to the VPLOT2 variable (in this
case, SIO COUNT).
■
Two average lines appear as well, one for each variable plotted. The letter
A appears to the left of the line for the VPLOT variable, and the A appears
to the right of the line that indicates the average value for the VPLOT2
variable.
■
The line labeled SYMBOLS: at the bottom of the report includes two plot
characters instead of one and identifies the variable represented by each.
MPLOT Command Vertical Reports
The MPLOT command creates plots similar to those created by the VPLOT or
VPLOT2 commands, but only the outline of the plot is shown. Specifying the
MPLOT command with a single variable generates a report similar to a VPLOT
report. Specifying two variables generates a report similar to a VPLOT2 report.
Chapter 4: Reading Reports 57
Reading Plot Reports
Sample Single-Variable MPLOT Report
Note: Single-variable MPLOT reports have the same structure as VPLOT
reports.
SHIFT NONE
EACH
15 MINUTES
AMOUNT OF VIRTUAL CPU CONSUMED
PERIOD NONE
VIRTUAL
VIRTUAL
CPU
CPU
--------------16.25
I
X
I 16.25
I
X
I
I
X
X
I
I
X
X
I
I
X
X
X
I
14.22
I
X
X
X
I 14.22
I
X
X
X
I
I
X
X
X
I
I
X
X
X
I
I
X
X
X
I
12.18
I
X
X
X
I 12.18
I
X X
X
X
X
I
I
X X
X
X
X
X
I
I
X X
X X
X
X
X
X
I
I
X X
X X
X
X
X
X
I
10.15
I
X X
X X
X
X
X
X
I 10.15
I
X X
X X
X
X
X
X X
I
I
X X
X X X
X
X
X
X X
I
I
X X
X X X
X
X
X
X X
I
I
X X
X X X
X
X X
X
X
X X
I
8.127
I
X X
X X X
X XX X
XX
X
X X
I 8.127
I
X
X X
X X X X
X XX X
XX
X
X X
I
I
X
X X
X X X X
X XX X
XX
X
X X
I
I
XX
X X XXX X X X
X X X X X
X X X XX X X
I
I
XX
X
X X X X X XXX
X X X X X
X X X XX X X
I
6.096
I
X
XX
X
X X X X XX X X
X X X X XX
X X X XX X
X
I 6.096
AI------------X-------X-X-------X---X-X-X--X-XX-X-X--XXX-X--X--X-X---X-X-XX--XX-X---X--------------------------- I
I
X
X X
X
XXX X X XX X XX X X X
X X
X X XX X
X
X
I
I
X
X X
X
X X X
X X
X X
X
X XX X
X
X
X
I
I
X
X X
X
X X X
X X X
XXXXXX XXXX X
I
4.065
I
X
X X
X
X X
X X
X
I 4.065
I
X
X X
XX XX
X X
X
I
I
XX X XX X
XX X X
X
X
I
IXXXXXXXXXXXX X XX
XXX X
X
I
I
X
I
2.034
I
X
I 2.034
I
X
I
I
X
I
I
X
I
I
X
I
0.000
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I---------II 0.000
00:00
02:30
05:00
07:30
10:00
12:30
15:00
17:30
20:00
22:30
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
SYMBOLS:
"X" = AMOUNT OF VIRTUAL CPU CONSUMED
58 Report Reference Guide
Reading Plot Reports
Sample Two-Variable MPLOT Report
The following MPLOT report plots the same information as the VPLOT2 report.
However, where the letter E appears in the sample report, a Ä symbol would
appear in the actual report.
SHIFT NONE
EACH
15 MINUTES
DEVICE OF SIO COUNT
PERIOD NONE
VIRTUAL
SIO
CPU
COUNT
--------------16.25
I
X
O
I 17952
I
X
O
O
I
I
X
O
E
I
I
X
O
E
I
I
X
O
X
E
I
14.22
I
X
O
X
E
I 15708
I
X
O
X
E
I
I
X
O
X
E
I
I
X
O
E
E
I
I
X
O
E
E
I
12.18
I
X
O
E
E
I 13464
I
X X
O
X
E
E
I
I
X X
E
X
E
E
I
I
X X
X E
X
X
E
E
I
I
X X
X E
X
X
E
E
I
10.15
I
X X
X E
X
X
E
E
I 111220
I
X X
X E
X
X
E
XOX
I
I
X X
X X E
X
X
E
XOX
I
I
X X
X X E
X
X
E
XOX
I
I
X E
X X E
X
X X
E
E
XOX
I
8.127
I
X E
X X E
X XX X
EX
E
XOX
I 8976
I
X
X E
X X X E
X XX X
EX
E
XOX
I
I
X
X E
X X X E
X XX X
EX
E
XOX
I
I
XX
X E XXX X E E
X X X X X
E X X EX XO X
I
I
XX
X
X E X X X EXE
X E X X X
EOX X EX XO X
I
6.096
I
X
XX
X
X E X X XX E E
X E X X XX
EOX X EX X O X
I 6732
AI------------X-------X-X-------X---X-E-X--X-XE-E-E--XXX-E--X--X-X---EOX-XE--EE-X-O-X----------------------------I
I
X
X X
X
XXE X X XE E OXX X E X
O X XOO X E EE X O X
X
I
I
X
X X
X
X E X
X OXO O
XOX OO O X OO
OX EE X O X
X
X
I
I
X
X X
X
X E X
O O O
O O
O O O
OO
OX EOX O
XXXXXX XXXXOX
I
4.065
I
X
X X
X
X OX
O O O
O O
O O O
OO
OX EO
O
OX
I 4488
I
X
X X
XE XXO O O
O O O O O O
O O O
O O OOX EO
O
OX
I
I
XX X XX X
XX XOX O O O
O OOO O O O
O O O OOO O OO XOO O
O
OX
I
IXXXXXXXXXXXX--X-XX--OO-XXX--X-O---O-O--O-O--O-O--OO-O-O-OO-------------O--O-O-OOO-OOOOOOOO-OOOO-E--------------IA
I
OO
O
OOO OOO O O
O O
E
I
2.034
I
O O
O
O O O O OO O
O O
E
I 2244
I
O O
O
O O O
O O O
O O
E
I
I
O
O O
O
O O O
O O
O O
E
I
I
OO
OO O
OO OO OO
O
O
O O
E
I
IOOOOOOOOOOOO OOOO
OOO O O
O
E
I
0.000
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I---------II
0
00:00
02:30
05:00
07:30
10:00
12:30
15:00
17:30
20:00
22:30
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
01/07
SYMBOLS:
"X" = AMOUNT OF VIRTUAL CPU CONSUMED
"O" = DEVICE SIO COUNT
Single-variable MPLOT reports have the same structure as VPLOT reports.
Two-variable MPLOT reports have the same structure as VPLOT2 reports.
Chapter 4: Reading Reports 59
Reading Plot Reports
HPLOT Reports
The HPLOT command is used with either the VPLOT or the MPLOT command to
plot the distribution of one variable based on the value of another variable.
The variable specified with the VPLOT or MPLOT command is still plotted
vertically, but instead of being plotted against time, it is plotted against the
variable specified with the HPLOT command.
The HPLOT and VPLOT commands were used to produce the following report,
which plots the number of device SIOs against device service time.
SHIFT NONE
EACH
RECORD
DEVICE I/O SERVICE TIME
PERIOD NONE
SIO
COUNT
200K
I
+
I
X X
I
X X
I
X X
I
X X
175K
I
X X
I
X X
I
X X
I
X X
I
X X
150K
I
X X
I
X XX
I
X XX
I
X XX
I
X XX
125K
I
X XX
I
X XX
I
XX XX
I
XX XX
I
XX XX
100K
I
XX XX
I
XXXXX
I
XXXXX X
I
XXXXX X
I
XXXXXXXX
75000
I
XXXXXXXX
I
XXXXXXXX
I
XXXXXXXX X
I
XXXXXXXX X
I
XXXXXXXX X
50000
I
XXXXXXXX X
I
XXXXXXXX X
I
XXXXXXXX X
X
I
XXXXXXXX XX X
X
I X
XXXXXXXX XXXX
X
25000
I X
X
XXXXXXXXXXXXX
XXX
I X
XX
XXXXXXXXXXXXX
XXX
I XX
XX
XXXXXXXXXXXXX
XXX
X
I XX
XXX
X XXXXXXXXXXXXXXX XXX
X
X X
I XXXX XXXXX XXXXXXXXXXXXXXXXXXXXXXX XX X X X XX
X
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I
0.000
0.010
0.020
0.030
0.040
0.050
0.060
0.070
0.080
0.090
0.100
X
A - 0.021
SAMPLE COUNT ==> 2508
DEVICE I/O SERVICE TIME
SAMPLES WITHIN H-SCALE ==> 2491
99.3%
SAMPLES WITHIN V-SCALE ==> 2508
100.0
60 Report Reference Guide
Reading Graph Reports
Distribution plot reports have the following structure:
■
The leftmost column shows the scale for the VPLOT or MPLOT variable and
identifies that variable (in this case SIO COUNT).
■
The first line immediately underneath the plot shows the scale for the
HPLOT variable. This variable is identified by the text centered two lines
beneath the scale (in this case, DEVICE I/O SERVICE TIME).
■
On the line immediately beneath the scale, the average value of the
HPLOT variable is displayed after the label A -. The letter A is positioned at
the point on the scale where this average value falls.
■
The detail lines in the report show the correlation between the HPLOT
variable and the VPLOT or MPLOT variable. If the VPLOT command was
specified, the entire detail line is filled in with the plot character; if the
MPLOT command was specified, only the outline of the plot is given. If the
value of the VPLOT or HPLOT variable exceeds the scale used for that
variable, a plus sign (+) appears at the top of the column to indicate the
entire column is not included. The preceding report shows that as device
service time goes up, fewer device SIOs are performed.
■
If any resources included by the HPLOT variable exceed the scale used for
that variable, a detail line is created for those resources; it appears to the
right of the HPLOT scale, as shown in the preceding report.
■
The number following the label SAMPLE COUNT near the bottom of the
report is the total number of samples in the data file. The number and
percentage of those samples that fell within the HPLOT scale is shown
after the SAMPLES WITHIN H-SCALE label, and the number and
percentage of those samples that fell within the VPLOT or MPLOT scale is
shown after the SAMPLES WITHIN V-SCALE label. The preceding report
was created from 2508 samples, 2491 (99.3%) of which fell within the
HPLOT scale and all of which fell within the VPLOT scale.
Reading Graph Reports
Graph reports are graphs used to compare the value of variables for several
resources of the same type. You can create graph reports using either the
GRAF command alone or the GRAF command together with the GRAF2
command.
Graph reports created using the GRAF command alone graph the value of a
single variable for several resources of the same type. For example, a graph
report might show the response time of each terminal in a group or the CPU
usage of all operators on a system.
Chapter 4: Reading Reports 61
Reading Graph Reports
The following graph report shows the service time for the three disks with the
highest service times each hour:
SHIFT NONE
EACH
HOUR
PERIOD NONE
DEVICE I/O SERVICE TIME
0
0.004
0.008
0.012
0.016
0.020
0.024
0.028
0.032
0.036
0.040
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.
.
.
.
.
.
.
.
.
.
.
02/29/04 10.00.00 .
.
.
.
.
.
.
.
.
.
.
0350
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
0554
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
0555
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
.
.
.
02/29/04 11.00.00 .
.
.
.
.
.
.
.
.
.
.
0123
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
0121
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
.
0351
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
02/29/04 12.00.00 .
.
.
.
.
.
.
.
.
.
.
0351
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
0121
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
0350
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
0.004
0.008
0.012
0.016
0.020
0.024
0.028
0.032
0.036
0.040
SYMBOLS:
"X" =
X
0.042
0.038
0.037
0.037
0.019
0.017
0.033
0.023
0.017
X
DEVICE I/O SERVICE TIME
Graph reports have the following structure:
■
The first line shows the scale used in the report. This scale is also shown
just below the plot. You can alter a graph's scale with the SCALE operand
of the GRAF command.
■
The leftmost column lists the individual resources represented in the graph
(in this case, disk IDs). By default, a graph report includes information
about all the individual resources of the type associated with the variable
specified. You can override this default organization by specifying an ID
option with the GRAF command.
■
By default, resources are listed in descending order. In this case, the disks
with the longest service times are listed first.
■
The rightmost column lists the value that each bar graph represents. The
heading of this column is the character used in the graph; what the
character represents is shown at the bottom of the report following the
SYMBOLS: label.
■
If a variable's value exceeds the scale used, a greater-than sign (>)
appears in the far right column of the bar graph. This occurs in the
preceding report for the first device listed.
62 Report Reference Guide
Reading Graph Reports
GRAF2 Reports
Reports generated by the GRAF and GRAF2 commands used together are more
detailed than reports generated by the GRAF command alone. For each
resource graphed by the GRAF command, the GRAF2 command can list a set
of related resources and graph a statistic for each.
The following sample GRAF2 report includes the information shown in the
preceding GRAF report (disk service times, plotted with Xs using a different
scale), although only the first two time periods are shown. The following report
also shows the two data sets on each of those disks that had the highest
service times (plotted with Os).
SHIFT NONE
EACH
HOUR
PERIOD NONE
DEVICE I/O SERVICE TIME
0
0.005
0.010
0.015
0.020
0.025
0.030
0.035
0.040
0.045
0.050
X
0
0.004
0.008
0.013
0.017
0.021
0.025
0.029
0.034
0.038
0.042
O
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.
.
.
.
.
.
.
.
.
.
.
02/29/04 10.00.00 .
.
.
.
.
.
.
.
.
.
.
0350
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
. 0.042
VSE.PRD1.LIBRARY.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO .
.
0.037
DOS.LABEL.FILE.F.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO.
.
.
.
0.029
0554
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
. 0.038
VSESYS.VOL1.LABE.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
.
.
.
0.032
DEVVSE.SYS$ARC,P.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
.
.
.
0.030
0555
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
. 0.037
VSE.SYSRES,LIBRA.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO.
.
.
0.040
DOSRES.VTOC
.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
.
.
.
0.030
.
.
.
.
.
.
.
.
.
.
.
02/29/04 11.00.00 .
.
.
.
.
.
.
.
.
.
.
0123
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
. 0.037
SQL.LIBRARIES
.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO .
.
0.037
0121
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
.
. 0.019
EXPLORE.CICS.DEV.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO>
0.046
EXPLORE.CICS.DEV.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
.
.
0.034
0351
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
. 0.017
VSE.PRD2.LIBRARY.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
.
.
.
0.032
AXP.LOG1.KSDS.IN.OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
.
.
.
0.030
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
0.004
0.008
0.013
0.017
0.021
0.025
0.029
0.034
0.038
0.042
O
0
0.005
0.010
0.015
0.020
0.025
0.030
0.035
0.040
0.045
0.050
X
SYMBOLS: "X" = DEVICE I/O SERVICE TIME
"O" = DATASET AVERAGE I/O SERVICE TIME
The structure of GRAF2 reports is the same as the structure of GRAF reports
with the following exceptions:
■
Since the variables may be graphed using different scales, two scales are
shown. The top scale applies to the GRAF variable, which is graphed with
Xs, and the second scale applies to the GRAF2 variable, which is graphed
with Os. In the preceding report, the top scale applies to service time for
each disk, and the second scale applies to the service time for each data
set. You can create reports in which both variables are graphed using the
same scale by specifying the SCALE(COMMON) operand with the GRAF2
command.
Chapter 4: Reading Reports 63
Reading Graph Reports
■
Two columns rather than one appear to the left of the graph. The leftmost
column lists the identifiers associated with the GRAF variable, and the
indented column lists, for each of these, the resources associated with the
GRAF2 variable.
■
Two columns rather than one appear to the right of the graph, headed by
the symbols used in the graph and listing the numeric values of the detail
lines. In some cases, the value of a variable for a given resource may be
nonzero but yet be too low to appear graphically.
GRAF2 Command
You cannot use the GRAF2 command without the GRAF command.
The variables you specify with the GRAF and GRAF2 commands must be
logically related. The following table shows incorrect and correct uses of the
GRAF and GRAF2 commands:
Incorrect:
Correct:
GRAF VSE DISK SIO
GRAF2 VSE CPU UTILIZATION
GRAF VSE DISK SERVTIME
GRAF2 VSE DSN SERVTIME
GRAF VSE DSN SIO
GRAF2 VSE DSN SERVTIME
GRAF VSE DISK SIO
GRAF2 VSE DSN SIO
GRAF VSE DISK SIO
GRAF2 VARS VSE CPU UTILIZATION
AND,
VSE CHANNEL SIO
AND,
VSE STEP COUNT
GRAF VSE DISK SIO
GRAF2 VARS VSE DSN SIO AND,
VSE DSN READS AND,
VSE DSN WRITES
GRAF VSE STEP COUNT
GRAF2 VARS VSE CPU UTILIZATION
AND,
VSE CHANNEL SIO
GRAF VSE STEP COUNT
GRAF2 VARS VSE STEP DURATION
AND,
VSE STEP CPU
AND,
VSE DSN SIO
AND,
VSE PHASE LOADS
Command Syntax and Operands
The syntax of the GRAF2 command is as follows:
GRAF2 [VARS] [idopt[(idents)]] var [options] [HDR(text)] [CHAR1(x)]
[SCALE({n},{mX},{COMMON})] [SORT order] [FOR n] [AND,
var [options] [HDR(text)] [CHAR1(x)]] [AND,...]
64 Report Reference Guide
Reading Graph Reports
The operands for the GRAF2 command have the following meanings:
Operand
Meaning
VARS
Indicates that there is more than one variable in this
GRAF2 report.
idoption(identifiers)
Any ID option that is valid for the variable, specified
with or without identifiers. Specifying this operand
causes the resulting subgraphs to be organized by the
specified ID option and limited to the identifiers
specified by identifiers. If you do not specify an ID
option, all identifiers of the type associated with the
variable are included in the subgraphs. You can use
this operand only if you specify a single variable with
the GRAF2 command.
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID
option you specify must include at least one identifier.
CHAR1(x)
Sets the plot character for the variable. Replace x with
any valid EBCDIC character.
SCALE(n)
By default, the highest value of a bar graph's axis is
set to the highest value of the graphed variables. For
variables that represent percentages, the default
maximum value is 100%.
or
SCALE(mX)
or
SCALE(n,mX)
or
SCALE(COMMON)
To override this dynamic scale, specify n as the
maximum value. If the variable that you choose
produces integers, n must be an integer. You cannot
use more than three digits to the right of the decimal
point when specifying n.
In some cases, bar graphs in a graph report will be too
short to appear. To display these graphs, you can
cause each plot character to appear as m characters
by specifying the multiplier mX, where m is an integer.
Since the resulting bar graphs will no longer
correspond numerically to the scale, this is useful only
for determining relative performance.
To have the same scale used for both variables,
specify SCALE(COMMON).
You can specify the SCALE operand only with the first
variable you specify with the GRAF2 command.
SORT order
Sorts the report. Replace order with one of the
following:
■
DESCENDING—Sorts identifiers in descending
order of value of the variable specified. This is the
Chapter 4: Reading Reports 65
Reading Graph Reports
Operand
Meaning
default sorting order.
■
ASCENDING—Sorts identifiers in ascending order
of value of the variable specified.
You can specify the SORT operand only with the first
variable you specify with the GRAF2 command.
FOR n
Limits the report to the n identifiers in each time
period that would appear first in the report, where n is
an integer. For reports sorted in descending order,
these are the n most active identifiers; for reports
sorted in ascending order, these are the n least active
identifiers. You can specify the FOR operand only with
the first variable you specify with the GRAF2
command.
AND,
Signals that another variable will be specified. The
comma after AND lets you continue to the next line. If
you specify multiple variables, you must use the VARS
operand.
Limiting GRAF2 Reports Using the FOR Operand
Use the FOR n operand to produce a report on the n resources with the
highest or lowest values (depending on the sorting order) for the variable
being graphed.
The following commands graph SIO counts by disk and by data set for each
disk. Since a report on every active data set on every active disk would be
extremely long, the FOR operand is used to limit the report to the five disks
with the highest SIO counts and, for each of those disks, the three most active
data sets.
GRAF
VSE DISK SIO FOR 5
GRAF2 VSE DSN SIO
END
RUN
66 Report Reference Guide
FOR 3
Reading Graph Reports
The preceding commands generate a report like the following:
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
X
0
3192
6385
9578
12770
15963
19156
22348
25541
28734
31927
*
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0861
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
74515
NEW.VENDOR.MASTE.**********************************************************************
.
.
.
.
22470
NEW.PURCHASE.ORD.********************************************************
.
.
.
.
.
.
.
18031
NEW.VENDOR.MASTE.***************************************.
.
.
.
.
.
.
.
.
.
12327
0860
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
. 53109
ITEM.MASTER.FILE.****************************************************************
.
.
.
.
.
.
20331
CICS.DATA.COLLEC.**************************** .
.
.
.
.
.
.
.
.
.
.
8885
ITEM.MASTER.FILE.*******************.
.
.
.
.
.
.
.
.
.
.
.
.
.
6112
0632
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX .
. 47908
BIMEDIT.LIBRARY..****************************************************************************** .
.
.
.
.
24936
VSAM.MCAT
.********************************************************* .
.
.
.
.
.
.
.
.
18279
VSAM.MCAT.INDX .******
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1876
0225
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
. 44322
DOS.LABEL.FILE.0.**********************************************************************
.
.
.
.
.
.
22390
VSE.POWER.DATA.F.**********************
.
.
.
.
.
.
.
.
.
.
.
.
.
7095
DOS.PAGING.FILE..*************
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4216
0740
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
. 41705
DISTRIBU.TION.FI.****************************************************************************************************
3
1927
DISTRIBU.TION.FI.*************************
.
.
.
.
.
.
.
.
.
.
.
.
.
8047
DISTRIBU.TION.FI.**
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
684
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
3192
6385
9578
12770
15963
19156
22348
25541
28734
31927
*
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
X
SYMBOLS: "X" = DEVICE SIO COUNT
"*" = DATASET SIO COUNT
Tailoring GRAF2 Reports Using the SCALE Operand
Use the SCALE operand to specify a scale for the GRAF2 variable. This operand
is particularly useful for creating a common scale in reports on time-related
variables and in reports in which the same variable is specified with both the
GRAF and GRAF2 commands.
The following commands produce a report on phase loads that uses the same
scale for both the GRAF and GRAF2 variables:
GRAF
LIBRARY VSE PHASE LOADS FOR 4 SCALE(2000)
GRAF2 SUBLIB
VSE PHASE LOADS FOR 5 SCALE(2000)
END
RUN
Chapter 4: Reading Reports 67
Reading Graph Reports
The preceding commands generate a report like the following:
SHIFT NONE
EACH
DAY
PERIOD NONE
VSE PHASE LOADS
X
DCMLIB
330
SORT
TVSAM
EPIC32
RODS
PRD1
BASE
PRODLIB
FAQSPCS
EXPCOM
ALTC470
ECOM574
EVSETEST
PRD2
DBASE
CONFIG
XXXSQL
SYMBOLS:
"X" =
"*" =
0
200
400
600
800
1000
1200
1400
1600
1800
2000
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.......
+
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
.*********************************************************************************
.
.
.****************** .
.
.
.
.
.
.
.
.
.***
.
.
.
.
.
.
.
.
.
.
.*
.
.
.
.
.
.
.
.
.
.
.*
.
.
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.*******************************************************************************************
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.***************
.
.
.
.
.
.
.
.
.
.***************
.
.
.
.
.
.
.
.
.
.***********
.
.
.
.
.
.
.
.
.
.******* .
.
.
.
.
.
.
.
.
.
.*****
.
.
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.*************************
.
.
.
.
.
.
.
.
.******* .
.
.
.
.
.
.
.
.
.
.*
.
.
.
.
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
200
400
600
800
1000
1200
1400
1600
1800
2000
X
VSE PHASE LOADS
VSE PHASE LOADS
*
2073
1611
362
62
19
19
1824
1824
1389
306
295
221
140
104
674
495
150
29
Comparing Performance Using Multiple Variable Criteria
Use multiple variables with the GRAF2 command to compare the performance
of a class of resources with respect to those variables. For example, you can
compare the performance of jobsteps with respect to duration, CPU usage, and
data set I/O.
When you specify more than one variable with the GRAF2 command, a oneline bar graph is created for each variable specified. The bar graph represents
average performance for all active identifiers associated with the variable.
The following commands produce a report on the three disks with the highest
SIO counts. For each disk, the number of disk reads, disk writes, and disk
senses is graphed below the SIO count. Since more than one variable is
specified, the VARS operand precedes the variables specified with the GRAF2
command. The CHAR1 operands specify a different plot character for each
variable.
GRAF
VSE DISK SIO
FOR 3
GRAF2 VARS VSE DISK READS
CHAR1(D)
CHAR1(R) AND,
VSE DISK WRITES CHAR1(W) AND,
VSE DISK SENSES CHAR1(S)
END
RUN
68 Report Reference Guide
Reading Flashback Reports
The preceding commands generate a report like the following:
0
251.1
502.2
753.3
1004
1255
1506
1757
2008
2259
2511
0
197.3
394.6
591.9
789.2
986.5
1183
1381
1578
1775
1973
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0124
.DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
DEV READ COUNT .RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
DEV WRITE COUNT .WWWWWWWWWWWWWW
.
.
.
.
.
.
.
.
.
DEV SENSE COUNT .SSSSSSSSSSSSS
.
.
.
.
.
.
.
.
.
0125
.DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
.
.
.
DEV READ COUNT .RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
.
.
.
.
DEV WRITE COUNT .WWWWWWWWWWWWWWWWWWWWWWWWWWWW .
.
.
.
.
.
.
.
DEV SENSE COUNT .SS
.
.
.
.
.
.
.
.
.
.
0553
.DDDDDDDDDDDDDDDDDDDDDDDDDDD .
.
.
.
.
.
.
.
DEV READ COUNT .RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
.
.
.
.
.
.
.
DEV WRITE COUNT .
.
.
.
.
.
.
.
.
.
.
DEV SENSE COUNT .
.
.
.
.
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
197.3
394.6
591.9
789.2
986.5
1183
1381
1578
1775
1973
0
251.1
502.2
753.3
1004
1255
1506
1757
2008
2259
2511
SYMBOLS: "D" = DEVICE SIO COUNT
D
R
2511
1973
286
252
1915
1311
558
46
666
655
9
2
R
D
For more information about the report writer commands, see the chapter
"Commands."
For more information about graph reports, see the chapter "Reading Reports."
For more information about report writer variables and lists of the ID options
you can use with each class of variable, see the chapter "Variables."
For more information about descriptions of ID options and their use with
commands and variables, see the chapter "ID Options."
Reading Flashback Reports
Flashback reports are tabular reports that contain detailed information about
jobs. They contain one line of data for each job, jobstep, or job pseudo end-ofstep meeting the criteria specified with the FLASHBACK command.
Chapter 4: Reading Reports 69
Reading Flashback Reports
Jobs or steps are listed in chronological order of ending time. You cannot sort
flashback reports. The following flashback report gives information about jobs
that executed in the BG partition:
PART
ID
---BG
BG
BG
BG
BG
BG
BG
BG
BG
BG
BG
BG
BG
BG
BG
BG
----
START
TIME
-------08.00.01
08.06.32
08.19.20
08.48.35
08.54.54
09.02.23
09.05.35
09.14.01
09.41.05
09.58.03
10.07.58
10.13.57
10.14.30
10.18.41
10.21.10
10.25.38
-------08.00.01
---- --------
END
TIME
-------08.05.29
08.10.54
08.39.34
08.51.35
09.01.54
09.02.27
09.09.59
09.18.08
09.41.09
10.07.57
10.08.01
10.14.09
10.14.51
10.21.04
10.25.37
10.25.43
-------10.25.43
--------
JOB
NAME
-------DPD070
GLR320
TEST11
VMR215
TEST10
LIBR
EDD311
APR250
RCPEXPND
DIR010
CATALOG
JOBDAY
JOBINV
PROGSTAT
TEST10
CATALOG
--------
STEP
NAME
-------CPYDT
GL2155
LISTLOG
VM0242
LISTLOG
LIBR
DP0601
MTPBATCH
LIBR
DP4451
LIBR
BIMUTIL
BIMUTIL
EXPRPT
LISTLOG
LIBR
--------
TOTAL
TCPU
DISK
DISK
TAPE
OTHER
PAGE
PAGE
GETVIS %GETVIS
DURATION TIME
IO
SERVTIME
IO
IO
FAULTS
IO
USED
USED
-------- -------- -------- -------- -------- -------- -------- -------- ------- ------00:05:28 12.71
13588
0.025
2718
0
13
3
220K
29.0
00:04:21 53.66
6189
0.028
0
0
245
20
115K
12.4
00:20:13 187.1
24514
0.043
13371
0
216
53
45K
17.1
00:02:59 7.462
7086
0.019
0
0
117
12
169K
30.1
00:06:59 6.972
4512
0.057
826
0
112
2
47K
11.0
00:00:04 0.135
106
0.022
0
0
21
9
24K
19.4
00:04:24 2.053
1815
0.031
0
0
188
61
24K
6.1
00:04:06 3.644
3912
0.028
0
0
132
2
66K
36.4
00:00:03 0.180
128
0.026
0
0
30
13
0
0.0
00:09:54 27.08
16199
0.030
0
0
81
18
125K
18.8
00:00:03 0.127
103
26
0
0
25
0
12K
9.7
00:00:12 0.057
24
0.022
0
0
16
0
4K
0.5
00:00:20 0.061
24
0.025
0
0
16
0
12K
1.3
00:02:22 9.789
3076
0.038
0
0
33
13
288K
30.4
00:04:27 10.02
5245
0.032
1127
0
195
8
36K
15.8
00:00:04 0.118
96
0.033
0
0
25
0
24K
19.4
-------- -------- -------- -------- -------- -------- -------- -------- -------- -------02:17:32 426.4
137K
0.031
26715
0
3529
320
54K
13.9
-------- -------- -------- -------- -------- -------- -------- ----- ----------- -------- -------- --------
The particular structure of a flashback report depends upon the type of report
requested. In general, the first several columns in the report serve to identify
the jobs or steps being reported on; these are listed in chronological order of
ending time. The remaining columns in the report show the values of pertinent
variables for each job or step. For more information about examples of each
type of flashback report, see the chapter "Flashback Reports."
Meanings of Default Column Headings in Flashback Reports
Flashback reports have one or more columns for variable data. Each report
writer variable is assigned an abbreviation that is used by default to create the
column heading for that variable's data. For more information about the
default headings in flashback reports, see the Default Flashback Reports in the
chapter "Flashback Reports." For more information about the default heading
created by a variable you specify with the FLASHBACK command, see the
description of the variable in the chapter "Variables." You can change the
column headings for variables you specify by using the HDR1 and HDR2
operands of the FLASHBACK command.
70 Report Reference Guide
Chapter 5: Canned Reports
A canned report has commands that are already written for you. The report
writer includes canned reports on many frequently requested topics. This
chapter explains and describes canned reports furnished by CA Explore PM for
z/VSE, and includes the following information:
■
How to produce reports with the CANRPT command
■
How to create new (customized) canned reports
■
Quick reference list of all canned reports
■
Description of each canned report and a sample of each report's output
This section contains the following topics:
Generating Canned Reports (see page 71)
Tailoring Canned Reports (see page 73)
Creating Your Own Canned Reports (see page 74)
Canned Report Descriptions (see page 76)
Generating Canned Reports
To generate a canned report, use the CANRPT command followed by the name
of the canned report you want to produce.
When you enter the commands for the canned report of your choice, the
report writer generates all the history reporting commands and variables
needed for the report.
Command Syntax and Operand
The syntax of the CANRPT command is shown following:
CANRPT reportname
The operand for the CANRPT command has the following meaning:
Operand
Meaning
reportname
Name of the canned report you want to create.
Chapter 5: Canned Reports 71
Generating Canned Reports
At a minimum, you must use the following commands to run a canned report:
■
CANRPT command followed by the report name
■
END command to end the report
■
RUN command to run the report
To produce a VSE.SYSTEM.STAT report, insert the following commands into a
jobstream and run the jobstream as described in the "Writing a Report"
chapter.
CANRPT VSE.SYSTEM.STAT
END
RUN
Command Expansions
When the report writer encounters the CANRPT command, it prints the
commands that the report writer is generating. The list of commands is called
an expansion.
An expansion helps you understand how the history reporting commands
work. After the commands make sense, you can create your own reports using
the same commands you see in the CANRPT expansions, but tailoring them to
meet your needs.
The expansion of the CANRPT VSE.DSN.STAT command is shown following:
CANRPT VSE.DSN.STAT
(1)
ERPT237I CANNED REPORT EXPANSION
(2)
+*-----------------------------------------*
(3)
+*
DISPLAY IN TABULAR FORMAT VARIOUS
*
(3)
+*
INFORMATION ON ALL ACTIVE DATASETS
*
(3)
+*-----------------------------------------*
(3)
+TITLE2 DATASET STATISTICS
(4)
+TAB DATETIME DSNID,
(4)
+
VSE DSN CUU
AND,
(4)
+
VSE DSN VOLID
AND,
(4)
+
VSE DSN SIO
AND,
(4)
+
VSE DSN SIO PCT
AND,
(4)
+
VSE DSN SIO RATE HDR2(RATE) AND,
(4)
+
VSE DSN SERVTIME
(4)
+
VSE DSN MAXSERVTIME
AND,
(4)
+ERPT237I END OF UNCAN EXPANSION
(5)
secondary commands
(6)
72 Report Reference Guide
Tailoring Canned Reports
The following explanations correspond to the numbers in the preceding
example:
1.
CANRPT command, which generates the commands in the expansion.
2.
Message generated after each CANRPT command to inform you that the
following statements were expanded by the report writer.
3.
Comments generated by the CANRPT command to document the report.
4.
Actual commands that create the report. The CANRPT VSE.DSN.STAT
command generated these commands.
5.
Message that the CANRPT expansion is over.
6.
Secondary commands that you specified following the CANRPT command
appears following the expansion. Secondary commands are not included in
the sample expansions in this chapter.
Tailoring Canned Reports
You can tailor any canned report by adding secondary commands (such as
FROM and TO) between the CANRPT command and the END command.
The length of reports generated by the CANRPT command depends upon the
canned report requested, the activity of your system, and the amount of data
in your input file. It is recommended that you use the COUNT command, the
SELECT command, or the FROM and TO commands to limit report size.
Although you can add commands after the CANRPT command, you cannot
reorder the columns in the report or replace the variables in the report.
You cannot add a secondary command that is already included in a canned
report's expansion.
The following example uses the FROM and TO commands to limit the data in
the VSE.SYSTEM.STAT report to the week of October 7, 2003:
CANRPT VSE.SYSTEM.STAT
FROM 10/07/03
TO
10/11/03
END
RUN
Chapter 5: Canned Reports 73
Creating Your Own Canned Reports
The following example uses the RANGE command to include only channels with
more than 100 SIOs in the VSE.CHANNEL.STAT report:
CANRPT VSE.CHANNEL.STAT
RANGE VSE CHANNEL SIO 100+ DEFERRED
END
RUN
The following example uses the SELECT command to generate a report
showing job activity for jobs with names beginning with PROD:
CANRPT VSE.JOB.STAT
SELECT JOBID(PROD*)
END
RUN
Creating Your Own Canned Reports
The report writer uses a report definition table (RDT) to generate canned
reports. The default RDT is contained in the phase EXPRDT. The report writer
loads the phase EXPRDT upon detection of the first CANRPT command.
You can create customized canned reports in either of the following ways:
■
Add new canned reports to the supplied member EXPRDT.A or change
existing reports in it.
■
Create an RDT containing your new canned reports.
Each of these methods is explained further in the following sections.
Method 1: Add Reports to the Supplied Member
To add new canned reports to the supplied member EXPRDT.A or to change
existing reports in it, follow these steps:
Step
Action
1
Edit the member EXPRDT.A in the RO for VSE residence
library.sublibrary. Add any new canned reports or customize existing
reports to suit your needs.
2
Assemble the member EXPRDT.A.
3
Save the member EXPRDT.A.
74 Report Reference Guide
Creating Your Own Canned Reports
Important! If you modify the supplied member EXPRDT.A, make a backup
copy of the member using another name. When you install a new release of
CA Explore PM for z/VSE, EXPRDT.A is overwritten. Unless you have a backup
copy of the member, you lose any modifications you made.
To run any canned report in the member EXPRDT.A, use the following
commands, replacing your-report-name with the name of the canned report
you want to run:
CANRPT your-report-name
END
RUN
Method 2: Create an RDT Containing Your New Canned Reports
To create an RDT containing your new canned reports, follow these steps:
Step
Action
1
Create a jobstream that uses the ERPTTAB macro to create
an RDT. A sample jobstream is given in the following section.
2
Decide whether or not to link edit your RDT as EXPRDT,
considering the following:
If you link-edit your RDT as EXPRDT, then you should copy
the member EXPRDT.A into your jobstream. All supplied
canned reports and your new canned reports are contained
in the same member, and you never have to specify the
phase name when you run a canned report.
Important! If you link edit your RDT as EXPRDT and fail to
copy the member EXPRDT.A into your jobstream, all supplied
canned reports are lost.
If you link edit your RDT using a name other than EXPRDT,
then you must specify the phase name each time you run
any of your customized reports.
3
Run the jobstream to assemble and link-edit your RDT.
Chapter 5: Canned Reports 75
Canned Report Descriptions
A sample jobstream that assembles and link-edits an RDT is shown in the
following example:
* $$ JOB JNM=EXPRDT,CLASS=0,USER='User information'
* $$ LST CLASS=A
// JOB EXPRDT
create report definition table
// OPTION NOXREF
// OPTION CATAL,NODECK
PHASE phase-name,*
(1)
// EXEC ASSEMBLY
ERPTTAB your-report-name,
(2)
'*----------------------------------------------*',
'*
Add commands in single quotes here.
*',
'*
The following lines show sample commands
*',
(3)
'*----------------------------------------------*',
'TAB DATETIME DSNID VSE DSN SIO RATE
AND,',
'
VSE DSN SIO
AND,',
'
VSE DSN SERVTIME
'
END
/*
// EXEC LNKEDT
/&
* $$ EOJ
Modify the sample jobstream as follows:
1.
Replace phase-name with the name you want to assign to this RDT phase.
2.
Replace your-report-name with the name you want to assign to your
report. Follow it by a comma.
3.
On the lines following your-report-name, insert report commands within
single quotes. Follow each command's ending quote with a continuation
comma.
Use the following commands to run your report. If you link-edited the RDT as
EXPRDT, you do not need to specify the parameter MEMBER=phase-name.
CANRPT your-report-name MEMBER=phase-name
END
RUN
Canned Report Descriptions
The following sections describe each of the canned reports supplied with CA
Explore PM for z/VSE.
76 Report Reference Guide
Canned Report Descriptions
The description of each report provides sample commands for running the
report, including secondary commands (such as FROM and TO) that are
recommended to limit report size. Heading information is omitted from the
sample reports.
The canned reports provided with CA Explore PM for z/VSE are as follows:
This Report:
Displays:
VSE.CACHE.STAT
Device cache statistics by volume.
VSE.CHANNEL.STAT
All active channels, sorted by channel
address.
VSE.CICS.STAT
Both VSE and CICS resources,
including CPU, disk, transaction, and
file activity.
VSE.CONTENTION.ANALYSIS
Job contention statistics by jobname
and the corresponding PID-TIDs
causing the contention.
VSE.CPU.ANALYSIS.STAT
Virtual and real CPU utilization, in six
vertical plots.
VSE.DELAY.ANALYSIS
Job delay statistics by jobname and
wait type.
VSE.DEVICE.STAT
All active devices, sorted by I/O
count.
VSE.DISK.DSN.STAT
All active disk devices and their
associated data sets, sorted by
volume and data set name.
VSE.DISK.STAT
All active disk devices, sorted by I/O
count.
VSE.DSN.STAT
All active disk data sets, sorted by
start I/O count.
VSE.GETVIS.STAT
GETVIS information by partition and
jobname.
VSE.JOB.STAT
Job activity, sorted by job execution
count.
VSE.LOCK.STAT
Lock activity organized by lock
resource name and partition ID.
VSE.LPAR.CPU.STAT
LPAR CPU activity, sorted by partition
name and logical processor address.
VSE.PACCNT.STAT
VSE/POWER job accounting data.
Chapter 5: Canned Reports 77
Canned Report Descriptions
This Report:
Displays:
VSE.PAGE.STAT
Paging, sorted by page extent
number.
VSE.PID.CPU
CPU usage for each partition.
VSE.PRINT.FORMS.STAT
Printing statistics, sorted by form ID.
VSE.PROGRAM.LOAD.STAT
Program load statistics by jobname.
VSE.SAMCPU.BUSYR.STAT
Real CPU utilization distribution based
on one-minute intervals.
VSE.SAMCPU.BUSYV.STAT
Virtual CPU utilization distribution
based on one-minute intervals.
VSE.SAMPLE.COUNT.STAT
System statistics collected at oneminute intervals, displayed as counts.
VSE.SAMPLE.RATE.STAT
System statistics collected at oneminute intervals, displayed as rates.
VSE.SEEK.STAT
Disk device activity, by plotting the
number of seek I/O to each device
against the cylinder addresses for
that device.
VSE.SVC.STAT
SVC activity and descriptions of all
active SVC codes.
VSE.SYSCPU.BUSYR.STAT
Real CPU utilization distribution based
on SYSTIMEI intervals.
VSE.SYSCPU.BUSYV.STAT
Virtual CPU utilization distribution
based on SYSTIMEI intervals.
VSE.SYSTEM.STAT
System activity, including CPU,
paging, and disk activity.
VSE.THRESHOLD.LOG.STAT
All VSE thresholds that have been
triggered.
VSE.THRESHOLD.STAT
All performance thresholds and their
corresponding resources.
VSE.VERSION4.DATA
Data from CA Explore PM for z/VSE
version 4.
VSE.VM.CPU.STAT
VM CPU activity, sorted by VM
machine ID.
VSE.XA.DEVICE.STAT
All active disk devices, sorted by
volume and disk ID in each time
period (available only if CA Explore
for z/VSE is running on a VSE
78 Report Reference Guide
Canned Report Descriptions
This Report:
Displays:
system).
Former VSE/PT Users
For users migrating from IBM VSE/PT (Performance Tool), CA Explore PM for
z/VSE provides canned reports that produce output in the same format as the
VSE/PT reports. The available reports are shown following.
This Report Command:
Produces:
VSEPT.DASDIO.GRAPH
DASD I/O Activity Graph - provides a
graph of SIO activity on DASD.
VSEPT.DASDIO.STATS
DASD I/O Analysis Report - gives
information about SIO for DASD used.
VSEPT.DEVICE.STATS
Individual Device Activity Report gives information about device
activity.
VSEPT SYSTEM.UTIL
System Utilization Report - gives
information about CPU activity, by
system and partition.
VSEPT.PAGING.STATS
System Paging Activity Report - gives
information about CPU paging
activity, by system and partition.
VSE.CACHE.STAT Report
The VSE.CACHE.STAT report displays device cache statistics by volume. The
Cache column on the Configure DASD I/O panel must be set to Y for data to
display in this report. The following commands generate a VSE.CACHE.STAT
report:
Expansion CANRPT VSE.CACHE.STAT
FROM 03/26/04 08:00:00
TO
03/26/04 18:00:00
EACH HOUR
END
RUN
Chapter 5: Canned Reports 79
Canned Report Descriptions
The CANRPT VSE.CACHE.STAT command expands as follows:
CANRPT VSE.CACHE.STAT
ERPT237I CANNED REPORT EXPANSION
+*-------------------------------------------*
+* DISPLAY DEVICE CACHE STATISTICS BY VOLUME *
+*-------------------------------------------*
+TAB DATETIME VOLSER,
VSE CACHE READ-NORM-REQS
AND,
+
VSE CACHE READ-NORM-HITS
AND,
+
VSE CACHE WRITE-NORM-REQS
AND,
+
VSE CACHE DASDFW-HITS
AND,
+
VSE CACHE READ-SEQ-REQS
AND,
+
VSE CACHE READ-SEQ-HITS
AND,
+
VSE CACHE WRITE-SEQ-REQS
AND,
+
VSE CACHE DASDFW-SEQ-HITS
AND,
+
VSE CACHE READ-CFW-REQS
AND,
+
VSE CACHE READ-CFW-HITS
AND,
+
VSE CACHE WRITE-CFW-REQS
AND,
+
VSE CACHE WRITE-CFW-HITS
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.CACHE.STAT command generates a report like the following:
VSE.CHANNEL.STAT Report
VOLSER NORMREAD NORMREAD NORMWRIT DASDFW SEQ READ SEQ READ
DATE
TIME
ID
REQUESTS
HITS
REQUESTS
HITS
REQUESTS
HITS
------- ----- -------- -------- -------- -------- -------- -------- -------2/13/03 00:00 DOSRES
3038
2876
407
0
0
0
SYSWK1
1022
1022
107
0
0
0
------- ----- -------- -------- -------- -------- -------- -------- --------
SEQ WRIT DASDFW
REQUESTS SEQ HITS
-------- -------0
0
0
0
-------- --------
CFW READ CFW READ
REQUESTS
HITS
-------- -------0
0
0
0
-------- --------
CFW WRIT CFW WRIT
REQUESTS
HITS
-------- -------0
0
0
0
-------- --------
VSE.CHANNEL.STAT Report
The VSE.CHANNEL.STAT report displays information about all active channels.
The following commands generate a VSE.CHANNEL.STAT report:
CANRPT VSE.CHANNEL.STAT
END
RUN
80 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.CHANNEL.STAT command expands as follows:
CANRPT VSE.CHANNEL.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS
*
+*
INFORMATION ON ALL ACTIVE CHANNELS
*
+*-----------------------------------------*
+TITLE2 CHANNEL STATISTICS
+TAB
CHNID SORT ALPHA,
+
VSE CHANNEL SIO
AND,
+
VSE CHANNEL SIO PCT
AND,
+
VSE CHANNEL SIO RATE HDR2(RATE)
AND,
+
VSE CHANNEL BUSY
AND,
+
VSE CHANNEL BUSYS
AND,
+
VSE CHANNEL %FAIL
AND,
+
VSE CHANNEL INTERRUPT
AND,
+
VSE CHANNEL Q-DEPTH
AND,
+
VSE CHANNEL MAXQ-DEPTH
AND,
+
VSE CHANNEL DEVBUSY
AND,
+
VSE CHANNEL MAXDEVBUSY
AND,
+
VSE DEVICE SERVTIME
+ERPT237I END OF UNCAN EXPANSION
XA Users
Because the variables VSE CHANNEL DEVBUSY and VSE CHANNEL
MAXDEVBUSY are valid only for 370 and VM modes, the columns for those
variables contain zeroes for XA systems.
The CANRPT VSE.CHANNEL.STAT command generates a report like the
following:
CHANNEL
ID
-------00
01
02
03
0E
-------SUMMARY
--------
CHANNEL
SIO
---------2,167
8,155
422
23,929
58
---------34,731
----------
CHANNEL
% SIO
-------6.2
23.5
1.2
68.9
0.1
-------100.0
--------
CHANNEL
PCT
PCT
%SIO
RATE
BUSY
BUSYS
FAILED
-------- -------- -------- -------0.42
0.0
0.0
0.0
1.60
0.0
0.0
0.0
0.08
0.0
0.0
0.2
4.69
0.0
0.0
0.0
0.01
0.0
0.0
16.7
-------- -------- -------- -------6.81
0.0
0.0
0.0
-------- -------- -------- --------
I/O
AVG
MAX
DEVICES
INTERUPT
Q-DEPTH Q-DEPTH ACTIVE
---------- -------- -------- -------5,041
1.4
2
12.7
8,155
1.0
1
1.0
465
1.0
1
1.0
23,929
1.9
3
4.3
68
1.0
1
0.0
---------- -------- -------- -------37,658
1.3
3
5.0
---------- -------- -------- --------
MAX
SERVICE
DEV BUSY
TIME
-------- -------13
0.008
1
0.027
1
0.055
5
0.024
0
0.254
-------- -------13
0.024
-------- --------
VSE.CICS.STAT Report
The VSE.CICS.STAT displays information about both VSE system resources
and CICS resources.
Chapter 5: Canned Reports 81
Canned Report Descriptions
To run the VSE.CICS.STAT report, you must include an INPUT command
specifying both the CA Explore PM for z/VSE flashback file and the CA Explore
for CICS flashback file.
The following commands generate a VSE.CICS.STAT report:
INPUT(EVSEFBK,EXPCFBK)
CANRPT VSE.CICS.STAT
END
RUN
The CANRPT VSE.CICS.STAT command expands as follows:
CANRPT VSE.CICS.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY BOTH VSE SYSTEM RESOURCES
*
+*
AND CICS RESOURCES
*
+*-----------------------------------------*
+TITLE2 VSE SYSTEM AND CICS STATISTICS
+TAB DATETIME VSE CPU ACTIVE
AND,
+
VSE CPU UTILIZATION
+
VSE PAGE FAULTS RATE,
+
HDR1(P-FAULT) HDR2(RATE)
+
VSE DEVICE SIO,
+
HDR1(TOTAL) HDR2(IO)
AND,
+
VSE DISK SIO HDR1(DISK) HDR2(IO)
AND,
+
VSE DISK SIO RATE,
+
HDR1(DISK-IO) HDR2(RATE)
+
VSE DISK SERVTIME,
+
HDR1(DISK) HDR2(SERVTIME)
AND,
+
TRANSACTION USE
AND,
+
TRANSACTION USE RATE HDR2(RATE)
AND,
+
TERMINAL RESPONSE
AND,
+
FILE REQUESTS
AND,
+
FILE SERVTIME
+ERPT237I END OF UNCAN EXPANSION
82 Report Reference Guide
AND,
AND,
AND,
Canned Report Descriptions
The CANRPT VSE.CICS.STAT command generates a report like the following:
DATE
-------09/17/03
09/18/03
09/19/03
09/20/03
09/21/03
09/22/03
09/23/03
09/24/03
-------PERIOD
--------
TIME
----00.00
00.00
00.00
00.00
00.00
00.00
00.00
00.00
---------
CPU
CPU
P-FAULT
TOTAL
DISK
DISK-IO
DISK
TRAN
TRAN
TERM
FILE
FILE
ACTIVE %ACTIVE
RATE
IO
IO
RATE
SERVTIME
USE
RATE
RESP
USE
I/O TIME
-------- -------- -------- ---------- ---------- -------- -------- -------- -------- -------- -------- ------01:08:39
10.6
0.09
50,465
41,186
1.03
0.027
457
0.01
1.421
22197
0.005
01:30:31
12.0
0.08
135,482
119,159
1.38
0.022
891
0.01
1.289
57343
0.008
01:02:43
10.8
0.06
98,341
70,465
0.98
0.027
521
0.01
1.365
26901
0.009
00:17:05
3.1
0.02
4,989
4,034
0.45
0.021
68
0.00
0.642
1900
0.003
00:03:11
0.7
0.02
845
621
0.67
0.020
21
0.00
0.710
217
0.003
02:13:32
16.4
0.12
273,101
224,178
1.93
0.028
2018
0.02
1.193
97045
0.010
01:49:29
13.0
0.15
187,422
151,342
1.60
0.030
1359
0.02
1.544
72663
0.009
00:08:38
8.9
0.05
53,985
36,985
0.91
0.030
432
0.01
1.391
21988
0.007
-------- -------- -------- ---------- ---------- -------- -------- -------- -------- -------- -------- ------08:10:48
11.2
0.08
804,630
647,970
1.21
0.024
5767
0.01
1.331
300K
0.009
-------- -------- -------- ---------- ---------- -------- -------- -------- -------- -------- -------- -------
VSE.CONTENTION.ANALYSIS
The VSE.CONTENTION.ANALYSIS report displays job contention statistics by
jobname. When applicable, statistics for each job are broken down by the
partition, job, step, and task IDs causing the contention.
The MONDELAY configuration option must be set to YES for data to be
displayed in this report. For more information about instructions on setting
this configuration option, see the Online User Guide.
The following commands generate a VSE.CONTENTION.ANALYSIS report:
CANRPT VSE.CONTENTION.ANALYSIS
END
RUN
Chapter 5: Canned Reports 83
Canned Report Descriptions
The CANRPT VSE.CONTENTION.ANALYSIS command expands as follows:
CANRPT VSE.CONTENTION.ANALYSIS
ERPT237I CANNED REPORT EXPANSION
+*-------------------------------------------*
+* DISPLAY JOB CONTENTION STATISTICS BY
*
+* JOB NAME AND THE CORRESPONDING PARTITION, *
+* JOB, STEP AND TASKID CAUSING THE CONTENTION*
+*-------------------------------------------*
+DEFINE ID JOBWAIT JOBID ' ' WAITID ' ' DISKID
+DEFINE ID CONTID
CONPID(1,2) '
+
CONSTEPID ' ' CONTID(1,2)
' CONJOBID ' ',
+TAB JOBWAIT SORT ALPHA,
REPORT
+
1
HDR1(
JOB
WAIT
NAME
ID
+
HDR2(
+
VSE WAIT CODE AND,
+
VSE WAIT COUNT
),
CUU ),
+TAB2 CONTID HDR1(-------CONTENTION--------),
+
+
HDR2(PID JOBNAME
STEPNAME TID),
VSE CONTENTION COUNT
+ERPT237I END OF UNCAN EXPANSION
84 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.CONTENTION.ANALYSIS command generates a report like
the following:
JOB
WAIT
WAIT
WAIT
-------CONTENTION-------CONT
NAME
ID
CUU CODE
COUNT PID JOBNAME STEPNAME TID
COUNT
---------------------- ---- -------- ------------------------- -------$IP2EES AVRBND
7D
1
$IP2EES CPU-ACTV
83
1
$IP2EES CPU-WAIT
83
1
F1 POWSTART IPWPOWER 0022
1
------------------------- -------SUMMARY
1
------------------------- -------$IP2EES FETCHBND
85
5
$IP2EES I/O-ACTV
82
7
$IP2EES IDLEWAIT
82
3
$IP2EES PMRBND
87
2
$SYSOPEN CPU-ACTV
83
3
$SYSOPEN CPU-WSYS
83
2
$SYSOPEN CPU-WSYS 000E 83
1
$SYSOPEN FETCHBND
85
4
$SYSOPEN FETCHBND 000E 85
4
$SYSOPEN I/O-ACTV
82
2
$SYSOPEN I/O-ACTV 000E 82
4
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
*JOBCTL* CPU-WAIT
83
56
F1 POWSTART IPWPOWER 0022
83
AR SYSTEM
SYSSTEP 0013
49
F5 FAQSXP5 FAQSMAIN 0026
14
F4 FAQSVM5 FAQSVMX 0025
7
FA NO NAME NO NAME 002B
7
F3 VTAMSTRT NO NAME 0024
6
F7 NO NAME NO NAME 0028
6
FB EVSEIBAT EVSESBAT 009D
5
FB BETATAPE MSHP
002C
4
F3 VTAMSTRT ISTINCVT 0024
4
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
------------------------- -------SUMMARY
231
------------------------- -------*JOBCTL* I/O-QUED 022B 82
1
*JOBCTL* I/O-QUED 022C 82
417
F3 VTAMSTRT ISTINCVT 0007
94
F5 NO NAME NO NAME 0026
84
F4 NO NAME NO NAME 0025
58
F1 POWSTART IPWPOWER 0022
50
F3 VTAMSTRT NO NAME 0024
48
F6 NO NAME NO NAME 0027
47
F9 NO NAME NO NAME 002A
45
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Chapter 5: Canned Reports 85
Canned Report Descriptions
VSE.CPU.ANALYSIS.STAT
The VSE.CPU.ANALYSIS.STAT report displays three vertical plots of real CPU
utilization and three plots of virtual CPU utilization, using 1-minute intervals,
using 15-minute intervals, and showing hourly averages. The following
commands generate a VSE.CPU.ANALYSIS.STAT report:
CANRPT VSE.CPU.ANALYSIS.STAT
END
RUN
86 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.CPU.ANALYSIS.STAT command expands as follows:
CANRPT VSE.CPU.ANALYSIS.STAT
ERPT237I CANNED REPORT EXPANSION
+*--------------------------------------------------*
+* Produce six vertical plots each displaying
*
+* different views of both Virtual and Real CPU
*
+* Utilization.
*
+*--------------------------------------------------*
+TITLE1 Real CPU Util distribution (1 min intervals)
+TITLE2 FROM: $RFWEEKDAY $RFCALMONTH $RFDAY at $RFTIME
+TITLE3 TO:
$RTWEEKDAY $RTCALMONTH $RTDAY at $RTTIME
+VPLOT VSE COUNT ESMFSAM HDR1(SAMPLE) HDR2(COUNT)
+HPLOT VSE SAMPLE %CPUREAL SCALE(100)
+EACH RECORD
+END
+TITLE1 Virt CPU Util distribution (1 min intervals)
+TITLE2 FROM: $RFWEEKDAY $RFCALMONTH $RFDAY at $RFTIME
+TITLE3 TO:
$RTWEEKDAY $RTCALMONTH $RTDAY at $RTTIME
+VPLOT VSE COUNT ESMFSAM HDR1(SAMPLE) HDR2(COUNT)
+HPLOT VSE SAMPLE %CPUVIRT SCALE(100)
+EACH RECORD
+END
+TITLE1 Real CPU Util distribution (15 min intervals)
+TITLE2 FROM: $RFWEEKDAY $RFCALMONTH $RFDAY at $RFTIME
+TITLE3 TO:
$RTWEEKDAY $RTCALMONTH $RTDAY at $RTTIME
+VPLOT VSE COUNT ESMFSYS HDR1(SAMPLE) HDR2(COUNT)
+HPLOT VSE CPU %BUSYR SCALE(100)
+EACH RECORD
+END
+TITLE1 Virt CPU Util distribution (15 min intervals)
+TITLE2 FROM: $RFWEEKDAY $RFCALMONTH $RFDAY at $RFTIME
+TITLE3 TO:
$RTWEEKDAY $RTCALMONTH $RTDAY at $RTTIME
+VPLOT VSE COUNT ESMFSYS HDR1(SAMPLE) HDR2(COUNT)
+HPLOT VSE CPU %BUSYV SCALE(100)
+EACH RECORD
+END
+TITLE1 Real CPU Utilization (hourly average)
+TITLE2 FROM: $RFWEEKDAY $RFCALMONTH $RFDAY at $RFTIME
+TITLE3 TO:
$RTWEEKDAY $RTCALMONTH $RTDAY at $RTTIME
+VPLOT VSE CPU %BUSYR SCALE(100)
+EACH 15 MINUTES AVERAGED
+END
+TITLE1 Virtual CPU Utilization (hourly average)
+TITLE2 FROM: $RFWEEKDAY $RFCALMONTH $RFDAY at $RFTIME
+TITLE3 TO:
$RTWEEKDAY $RTCALMONTH $RTDAY at $RTTIME
+VPLOT VSE CPU %BUSYV SCALE(100)
+EACH 15 MINUTES AVERAGED
+ERPT237I END OF UNCAN EXPANSION
Chapter 5: Canned Reports 87
Canned Report Descriptions
The CANRPT VSE.CPU.ANALYSIS.STAT command generates six reports like the
following. Only one of the reports generated is shown here.
FROM
12/06/03 18.45.01
REAL CPU UTILIZATION (HOURLY AVERAGE)
REPORT 5 PAGE 1
TO
12/13/03 18.45.01
FROM: Saturday December 06 AT 18.45.00
REPORT DATE 02/10/04 18.22.39
SHIFT NONE
TO:
Saturday December 13 AT 18.44.59
EACH
15 MINUTES AVERA
PERIOD NONE
REAL
REAL
%CPU
%CPU
-------------100.0
I
I 100.0
I
I
I
I
I
I
I
I
87.5
I
I 87.5
I
I
I
I
I
I
I
I
75.0
I
I 75.0
I
I
I
I
I
I
I
I
62.5
I
X
I 62.5
I
X
X
I
I
XX
XX
I
I
XXX XX X
X
I
I
XXXXXXXXXX X
XX
I
50.0
I
XXXXXXXXXXX XXXX
XX XXX
I 50.0
I
XXXXXXXXXXXX XXXXX X XXX XXXX X
I
I
XXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXX
I
I
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
X
I
I
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
X
I
37.5
I
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
X
X
I 37.5
I
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXX
X
I
AI---------XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX--XXX------X----X---------X----------------------------------- I
I
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXX
X
X
X X
I
I
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXX
XXX XX
XX X
X
I
25.0
I
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXXXXXX XX XXXXX X XX X
I 25.0
IX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXX XX XX XXXX
I
IX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
X
I
IX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
X
I
IX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
X
I
12.5
IX X
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXX
I 12.5
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I---------II
00:00
02:30
05:00
07:30
10:00
12:30
15:00
17:30
20:00
22:30
SYMBOLS:
"X" = PERCENTAGE OF REAL CPU CONSUMED
VSE.DELAY.ANALYSIS
The VSE.DELAY.ANALYSIS report displays job delay statistics by jobname and
wait type.
88 Report Reference Guide
Canned Report Descriptions
The MONDELAY configuration option must be set to YES for data to be
displayed in this report. For more information about instructions on setting this
configuration option, see the Online User Guide. The following commands
generate a VSE.DELAY.ANALYSIS report:
CANRPT VSE.DELAY.ANALYSIS
END
RUN
The CANRPT VSE.DELAY.ANALYSIS command expands as follows:
CANRPT VSE.DELAY.ANALYSIS
ERPT237I CANNED REPORT EXPANSION
+*-------------------------------------------*
+* DISPLAY JOB DELAY STATISTICS BY
*
+* JOB NAME AND CORRESPONDING WAIT TYPES
*
+*-------------------------------------------*
+TAB JOBID VSE JOB
COUNT AND,
+
VSE STEP COUNT AND,
+
VSE STEP DURT
+
VSE STEP %WORK
+TAB2 WAITID VSE WAIT CODE
AND,
AND,
+
VSE WAIT COUNT AND,
+
VSE WAIT PERCENT
+ERPT237I END OF UNCAN EXPANSION
Chapter 5: Canned Reports 89
Canned Report Descriptions
The CANRPT VSE.DELAY.ANALYSIS command generates a report like the
following:
JOB
JOB
STEP
TOTAL
PCT
WAIT
WAIT
NAME
COUNT
COUNT
DURATION
WORK
ID
CODE
-------- -------- -------- -------- -------- -------- ---EXPRPT
8
8
00:05:11
56.3
IDLEWAIT 82
I/O-ACTV 82
FETCHBND 85
CPU-ACTV 83
PMRBND
87
CPU-WAIT 83
I/O-QUED 82
CPU-WSYS 83
AVRBND
7D
PGIOBND
86
LCKBND
68
-------- ---SUMMARY
-------- ---ALT
2
6
00:01:25
68.5
I/O-ACTV 82
IDLEWAIT 82
FETCHBND 85
I/O-QUED 82
CPU-ACTV 83
AVRBND
7D
CPU-WSYS 83
FDIRBND
72
PGIOBND
86
-------- ---SUMMARY
-------- ---.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
WAIT
COUNT
-------376
109
82
73
24
14
7
6
4
3
1
-------699
-------87
50
25
12
11
5
1
1
1
-------193
--------
WAIT
PCT
-------53.8
15.6
11.7
10.4
3.4
2.0
1.0
0.9
0.6
0.4
0.1
-------100.0
-------45.1
25.9
13.0
6.2
5.7
2.6
0.5
0.5
0.5
-------100.0
--------
VSE.DEVICE.STAT Report
The VSE.DEVICE.STAT report displays information about all active devices,
sorted by I/O count.
The following commands generate a VSE.DEVICE.STAT report:
CANRPT VSE.DEVICE.STAT
END
RUN
90 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.DEVICE.STAT command expands as follows:
CANRPT VSE.DEVICE.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS
*
+*
INFORMATION ON ALL ACTIVE DEVICES.
*
+*-----------------------------------------*
+TITLE2 DEVICE STATISTICS
+TAB
DEVID VSE DEVICE SIO
AND,
+
VSE DEVICE SIO PCT
+
VSE DEVICE SIO RATE HDR2(RATE) AND,
AND,
+
VSE DEVICE WRITES
AND,
+
VSE DEVICE READS
AND,
+
VSE DEVICE SENSES
AND,
+
VSE DEVICE BUSY
AND,
+
VSE DEVICE SERVTIME
AND,
+
VSE DEVICE Q-DEPTH
AND,
+
VSE DEVICE MAXQ-DEPTH
AND,
+
VSE DEVICE %FAIL-CB
AND,
+
VSE DEVICE %FAIL-DB
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.DEVICE.STAT command generates a report like the
following:
DEVICE
SIO
SIO
SIO
WRITE
READ
SENSE
DEVICE
SERVICE DEVICE
DEV MAX
%SIO
%SIO
CUU
COUNT
%COUNT
RATE
COUNT
COUNT
COUNT
%BUSY
TIME
Q-DEPTH Q-DEPTH FAIL-CB FAIL-DB
-------- ---------- -------- -------- ---------- ---------- ---------- -------- -------- -------- -------- -------- -------0350
16,967
48.9
3.02
1,155
13,941
1,871
8.8
0.026
1.3
2
0.0
0.0
0121
8,107
23.4
1.44
1,236
6,823
48
4.3
0.027
1.9
3
0.0
0.0
0351
5,503
15.9
0.98
1,737
3,766
0
2.6
0.025
0.9
2
0.0
0.0
0300
1,459
4.2
0.26
1,459
0
0
0.0
0.001
0.0
0
0.0
0.0
001F
1,282
3.7
0.23
1,280
2
0
0.1
0.003
3.6
15
0.0
0.0
000F
586
1.7
0.10
584
0
2
0.3
0.016
0.0
0
0.0
0.0
0280
396
1.1
0.07
282
11
104
1.2
0.054
1.5
2
0.0
0.0
000C
276
0.8
0.05
0
276
0
0.1
0.011
0.0
0
0.0
0.0
0553
34
0.1
0.01
2
32
0
0.3
0.025
0.0
0
0.0
0.0
0082
23
0.1
0.00
13
10
0
0.0
0.001
0.0
0
0.0
0.0
0EDE
19
0.1
0.00
23
0
1
1.6
0.254
0.0
0
0.0
0.0
0281
10
0.0
0.00
0
0
17
0.1
0.101
1.0
1
0.0
0.0
-------- ---------- -------- -------- ---------- ---------- ---------- -------- -------- -------- -------- -------- -------SUMMARY
34,662
100.0
6.18
7,771
24,861
2,043
2.4
0.024
1.1
15
0.0
0.0
-------- ---------- -------- -------- ---------- ---------- ---------- -------- -------- -------- -------- -------- --------
VSE.DISK.DSN.STAT Report
The VSE.DISK.DSN.STAT report displays information about all active disk
devices and corresponding data sets.
Chapter 5: Canned Reports 91
Canned Report Descriptions
DSN monitoring must be active for data to be displayed in this report. For
more information about instructions on setting the appropriate configuration
option, see the Online User Guide.
The following commands generate a VSE.DISK.DSN.STAT report:
CANRPT VSE.DISK.DSN.STAT
END
RUN
The CANRPT VSE.DISK.DSN.STAT command expands as follows:
CANRPT VSE.DISK.DSN.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT ALL ACTIVE
+*
DISK DEVICES AND CORRESPONDING DATASETS*
*
+*-----------------------------------------*
+TITLE2 DATASET STATISTICS BY VOLUME
+TAB VOLSER VSE DSN
SIO
AND,
+
VSE DSN
SIO PCT
+
VSE DSN
SIO RATE HDR2(RATE) AND,
+
VSE DSN
+TAB2 DSNID VSE DSN
AND,
SERVTIME
SIO
AND,
+
VSE DSN
SIO PCT
+
VSE DSN
SIO RATE HDR2(RATE) AND,
+
VSE DSN
SERVTIME
+ERPT237I END OF UNCAN EXPANSION
92 Report Reference Guide
AND,
Canned Report Descriptions
The CANRPT VSE.DISK.DSN.STAT command generates a report as follows:
Chapter 5: Canned Reports 93
Canned Report Descriptions
VOLSER
DSN
DSN
DSN
SERVICE
DSN
ID
SIO
% SIO
RATE
TIME
NAME
-------- ---------- -------- -------- -------- ------------------------------------------VSE002
928,728
66.3
2.36
0.020
VSE3TST.VSE2TST.SHARED.MON.PDS
DEVVSE.SYS$VIO.340.PDS
PROD.LIB.FOR.MSHP.INSTALL.VSE002
EVSE.FLSHBACK.DEVVSE
EVSEARC.BACKUP
.
.
------------------------------------------SUMMARY
------------------------------------------DOSRES
206,612
14.7
0.52
0.029
DOS.LABEL.FILE.FF4006899021.VAELABEL
VSE.POWER.QUEUE.FILE
DEVVSE.DCM.PROD.LIBRARY
VSE.SYSTEM.HISTORY.FILE
VSAM.MASTER.CATALOG
VSE.SYSRES.LIBRARY
.
.
------------------------------------------SUMMARY
-------------------------------------------
DSN
SIO
---------755,993
54,924
43,481
25,164
7,208
.
.
---------928,728
---------65,626
42,025
23,886
20,886
18,807
11,188
.
.
---------206,612
----------
DSN
% SIO
-------81.4
5.9
4.7
2.7
0.8
.
.
-------100.0
-------31.8
20.3
11.6
10.1
9.1
5.4
.
.
-------100.0
--------
DSN
RATE
-------1.92
0.14
0.11
0.06
0.02
.
.
-------2.36
-------0.17
0.11
0.06
0.05
0.05
0.03
.
.
-------0.52
--------
SERVICE
TIME
-------0.018
0.026
0.024
0.025
0.024
.
.
-------0.020
-------0.037
0.019
0.029
0.019
0.025
0.036
.
.
-------0.029
--------
SYSWK1
205,286
VSESYS
49,198
SYSWK9
6,549
VAID01
DEV136
DEVSQL
2,154
1,526
710
99,493
41,359
13,288
9,939
8,960
.
.
---------205,286
---------43,156
2,369
1,991
841
775
66
---------49,198
---------5,347
588
420
82
64
48
---------6,549
---------2,154
1,526
598
40
23
21
20
8
---------710
---------434
45
15
15
---------1,401,272
----------
48.5
20.1
6.5
4.8
4.4
.
.
-------100.0
-------87.7
4.8
4.0
1.7
1.6
0.2
-------100.0
-------81.6
9.0
6.4
1.3
1.0
0.7
-------100.0
-------100.0
100.0
84.2
5.6
3.2
3.0
2.8
1.1
-------100.0
-------100.0
100.0
100.0
100.0
-------100.0
--------
0.25
0.11
0.03
0.03
0.02
.
.
-------0.52
-------0.11
0.01
0.01
0.00
0.00
0.00
-------0.12
-------0.01
0.00
0.00
0.00
0.00
0.00
-------0.02
-------0.01
0.00
0.00
0.00
0.00
0.00
0.00
0.00
-------0.00
-------0.00
0.00
0.00
0.00
-------3.56
--------
0.026
0.022
0.025
0.025
0.030
.
.
-------0.026
-------0.024
0.025
0.025
0.027
0.030
0.026
-------0.024
-------0.026
0.017
0.026
0.039
0.016
0.007
-------0.025
-------0.018
0.016
0.019
0.017
0.016
0.016
0.008
0.025
-------0.018
-------0.019
0.011
0.022
0.018
-------0.022
--------
SQLIBS
434
DRS007
45
TSI154
15
TSI155
15
-------- ---------SUMMARY
1,401,272
-------- ----------
14.6
0.52
VSE.POWER.DATA.FILE
VSESP.USER.CATALOG
AXP.LOG1.KSDS
VSE.DOC.HARDCOPY.FILE
AXP.LOG1.KSDS.INDX
.
.
------------------------------------------SUMMARY
------------------------------------------3.5
0.12
0.024
DEVVSE.SYS$ARC.PDS
DEVVSE.ISM.DEV.LIBRARY
UNKN.209-26.213-19
VSESYS.VTOC
VSESYS.VOL1.LABEL
UNKN.112-27.117-29
------------------------------------------SUMMARY
------------------------------------------0.5
0.02
0.025
EPIC.PERM.DSN.DEVVSE
ALT.PHIL.TEST.USER.CATALOG
EPIC.PERM.REC.DEVVSE
SYSWK9.VTOC
ALT.PHIL.TEST.USER.CATALOG.INDX
SYSWK9.VOL1.LABEL
------------------------------------------SUMMARY
------------------------------------------0.2
0.01
0.018
VAID.USER.CATALOG
0.1
0.00
0.016
NETVIEW.LIBRARY
0.1
0.00
0.018
DEVVSE.CPR.PDS
SQL.USER.CATALOG
XXXXFBK.FLASHBK.NEW
SQL.USER.CATALOG.INDX
DEVSQL.VOL1.LABEL
DEVSQL.VTOC
------------------------------------------SUMMARY
------------------------------------------0.0
0.00
0.019
SQL.LIBRARIES
0.0
0.00
0.011
DRS007.VOL1.LABEL
0.0
0.00
0.022
TSI154.VOL1.LABEL
0.0
0.00
0.018
TSI155.VOL1.LABEL
-------- -------- -------- ------------------------------------------100.0
3.56
0.022
-------- -------- -------- -------------------------------------------
94 Report Reference Guide
0.026
Canned Report Descriptions
VSE.DISK.STAT Report
The VSE.DISK.STAT report displays information about all active disk devices,
sorted by I/O count.
The following commands generate a VSE.DISK.STAT report:
CANRPT VSE.DISK.STAT
END
RUN
The CANRPT VSE.DISK.STAT command expands as follows:
CANRPT VSE.DISK.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS
+*
INFORMATION ON ALL ACTIVE DISK DEVICES *
*
+*-----------------------------------------*
+TITLE2 DISK STATISTICS
+TAB VOLSER VSE DISK SIO
AND,
+
VSE DISK SIO PCT
AND,
+
VSE DISK SIO RATE HDR2(RATE) AND,
+
VSE DISK BUSY
AND,
+
VSE DISK SERVTIME
AND,
+
VSE DISK Q-DEPTH
AND,
+
VSE DISK MAXQ-DEPTH
AND,
+
VSE DISK RESERVES
AND,
+
VSE DISK %FAIL-CB
AND,
+
VSE DISK %FAIL-CUB
AND,
+
VSE DISK %FAIL-DB
AND,
+
VSE DISK %ZEROSEEKS
AND,
+
VSE DISK AVGSEEKD
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.DISK.STAT command generates a report like the following:
VOLSER
SIO
SIO
SIO
DEVICE
SERVICE DEVICE
DEV MAX DEVICE
%SIO
%SIO
%SIO
%ZERO
SEEK
ID
COUNT
%COUNT
RATE
%BUSY
TIME
Q-DEPTH Q-DEPTH RESERVES FAIL-CB FAIL-CUB FAIL-DB SEEKS
LENGTH
-------- ---------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------DOSRES
16,967
55.4
3.02
8.8
0.026
1.3
2
0
0.0
0.0
0.0
70.2
34.9
VSE002
8,107
26.5
1.44
4.3
0.027
1.9
3
0
0.0
0.0
0.0
45.4
45.3
SYSWK1
5,503
18.0
0.98
2.6
0.025
0.9
2
0
0.0
0.0
0.0
70.0
41.2
VAID01
34
0.1
0.01
0.3
0.025
0.0
0
0
0.0
0.0
0.0
70.6
0.7
-------- ---------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------- ------SUMMARY
30,611
100.0
5.46
5.1
0.026
1.3
3
0
0.0
0.0
0.0
63.2
39.0
-------- ---------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------- --------
Chapter 5: Canned Reports 95
Canned Report Descriptions
VSE.DSN.STAT Report
The VSE.DSN.STAT report displays information about all active data sets,
sorted by start I/O count.
The VTOC-Names and VSAM-Names columns on the Configure DASD I/O panel
must have the appropriate devices set to YES for data to be displayed in this
report. For more information about instructions on setting this configuration
option, see the Online User Guide. The following commands generate a
VSE.DSN.STAT report:
CANRPT VSE.DSN.STAT
EACH HOUR
FROM 03/02/04 10:00:00
TO
03/02/04 12:00:00
END
RUN
The CANRPT VSE.DSN.STAT command expands as follows:
CANRPT VSE.DSN.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS
*
+*
INFORMATION ON ALL ACTIVE DATASETS
*
+*-----------------------------------------*
+TITLE2 DATASET STATISTICS
+TAB DATETIME DSNID,
+
VSE DSN CUU
AND,
+
VSE DSN VOLID
AND,
+
VSE DSN SIO
AND,
+
VSE DSN SIO PCT
AND,
+
VSE DSN SIO RATE HDR2(RATE) AND,
+
VSE DSN SERVTIME
+
VSE DSN MAXSERVTIME
+ERPT237I END OF UNCAN EXPANSION
96 Report Reference Guide
AND,
Canned Report Descriptions
The CANRPT VSE.DSN.STAT command generates a report like the following:
DSN
DEVICE
VOLSER
DSN
DSN
DSN
SERVICE
MAX
NAME
CUU
ID
SIO
% SIO
RATE
TIME
SERVTIME
-------------------------------------------- -------- -------- ---------- -------- -------- -------- -------VSE.POWER.DATA.FILE
0351
SYSWK1
20,041
47.9
5.57
0.024
0.031
PROD.LIB.FOR.MSHP.INSTALL.VSE002
0121
VSE002
4,673
11.2
1.30
0.020
0.024
VSE.POWER.QUEUE.FILE
0350
DOSRES
2,442
5.8
0.68
0.019
0.025
DEVVSE.DCM.PROD.LIBRARY
0350
DOSRES
2,366
5.7
0.66
0.024
0.035
VSE3TST.VSE2TST.SHARED.MON.PDS
0121
VSE002
2,098
5.0
0.58
0.023
0.024
VSE.DOC.HARDCOPY.FILE
0351
SYSWK1
1,845
4.4
0.51
0.018
0.035
DOS.LABEL.FILE.FF4006899021.VAELABEL
0350
DOSRES
1,817
4.3
0.51
0.033
0.036
VSE.PRD2.LIBRARY
0351
SYSWK1
891
2.1
0.25
0.024
0.038
DEVVSE.RSD
0121
VSE002
890
2.1
0.25
0.018
0.034
VSE.PRD1.LIBRARY
0350
DOSRES
731
1.7
0.20
0.032
0.038
DOS.PAGING.FILE.FF4006899021
0351
SYSWK1
533
1.3
0.15
0.036
0.055
DEVVSE.USER.CATALOG
0121
VSE002
413
1.0
0.11
0.012
0.014
DEVVSE.SYS$VIO.340.PDS
0121
VSE002
386
0.9
0.11
0.022
0.026
VSE.SYSRES.LIBRARY
0350
DOSRES
311
0.7
0.09
0.038
0.051
VSESP.USER.CATALOG
0351
SYSWK1
298
0.7
0.08
0.017
0.028
DEVVSE.SYS$ARC.PDS
0550
VSESYS
205
0.5
0.06
0.022
0.023
SYSWK1.VTOC
0351
SYSWK1
167
0.4
0.05
0.040
0.040
EVSE.FLSHBACK.DEVVSE
0121
VSE002
142
0.3
0.04
0.034
0.044
VSE002.VOL1.LABEL
0121
VSE002
137
0.3
0.04
0.012
0.013
EPIC.PERM.DSN.DEVVSE
0152
SYSWK9
118
0.3
0.03
0.037
0.052
VSE002.VTOC
0121
VSE002
113
0.3
0.03
0.033
0.036
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
-------- ----- -------------------------------------------- -------- -------- ---------- -------- -------- -------- -------SUMMARY
41,813 100.0
11.62
0.024
0.194
-------- ----- -------------------------------------------- -------- -------- ---------- -------- -------- -------- -------03/02/04 11.00 VSE3TST.VSE2TST.SHARED.MON.PDS
0121
VSE002
7,181
30.6
2.00
0.036
0.048
DOS.LABEL.FILE.FF4006899021.VAELABEL
0350
DOSRES
2,934
12.5
0.82
0.034
0.036
PROD.LIB.FOR.MSHP.INSTALL.VSE002
0121
VSE002
2,076
8.8
0.58
0.027
0.039
VSESP.USER.CATALOG
0351
SYSWK1
1,922
8.2
0.53
0.044
0.112
AXP.LOG1.KSDS
0351
SYSWK1
1,659
7.1
0.46
0.020
0.061
DEVVSE.SYS$VIO.340.PDS
0121
VSE002
1,385
5.9
0.38
0.032
0.052
VSAM.MASTER.CATALOG
0350
DOSRES
1,051
4.5
0.29
0.022
0.027
VSE.POWER.DATA.FILE
0351
SYSWK1
804
3.4
0.22
0.055
0.078
AXP.LOG1.KSDS.INDX
0351
SYSWK1
687
2.9
0.19
0.023
0.058
VSE.POWER.QUEUE.FILE
0350
DOSRES
540
2.3
0.15
0.021
0.024
VSE.SYSRES.LIBRARY
0350
DOSRES
472
2.0
0.13
0.039
0.048
DEVVSE.DCM.PROD.LIBRARY
0350
DOSRES
280
1.2
0.08
0.034
0.047
VSESP.USER.CATALOG.INDX
0351
SYSWK1
256
1.1
0.07
0.043
0.097
DEVVSE.SYS$ARC.PDS
0550
VSESYS
209
0.9
0.06
0.030
0.050
EVSE.FLSHBACK.DEVVSE
0121
VSE002
197
0.8
0.05
0.037
0.048
SYSWK1.VTOC
0351
SYSWK1
178
0.8
0.05
0.058
0.123
DOSRES.VTOC
0350
DOSRES
166
0.7
0.05
0.047
0.087
VSE.DOC.HARDCOPY.FILE
0351
SYSWK1
153
0.7
0.04
0.051
0.068
DOSRES.VOL1.LABEL
0350
DOSRES
137
0.6
0.04
0.032
0.035
VSE.PRD1.LIBRARY
0350
DOSRES
127
0.5
0.04
0.028
0.037
VSAM.MASTER.CATALOG.INDX
0350
DOSRES
120
0.5
0.03
0.023
0.028
AXP.LOG3
0351
SYSWK1
117
0.5
0.03
0.076
0.076
DOS.PAGING.FILE.FF4006899021
0351
SYSWK1
100
0.4
0.03
0.047
0.070
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
-------- ----- -------------------------------------------- -------- -------- ---------- -------- -------- -------- -------SUMMARY
23,485 100.0
6.53
0.034
0.134
-------- ----- -------------------------------------------- -------- -------- ---------- -------- -------- -------- -------DATE
TIME
-------- ----03/02/04 10.00
VSE.GETVIS.STAT Report
The VSE.GETVIS.STAT report displays GETVIS information by partition and by
jobs for each partition.
Chapter 5: Canned Reports 97
Canned Report Descriptions
The following commands generate a VSE.GETVIS.STAT report:
CANRPT VSE.GETVIS.STAT
END
RUN
The CANRPT VSE.GETVIS.STAT command expands as follows:
CANRPT VSE.GETVIS.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY GETVIS UTILIZATION FOR ALL
*
+*
PARTITIONS AND CORRESPONDING JOBS
*
+*-----------------------------------------*
+TITLE2 GETVIS STATISTICS BY PARTITION AND JOB
+TAB PID SORT ALPHA,
+
VSE GETVIS MAXUSED
AND,
+
VSE GETVIS MAX%USED
AND,
+
VSE GETVIS USED
AND,
+
VSE GETVIS %USED
+TAB2 JOBID
VSE GETVIS MAXUSED
AND,
+
VSE GETVIS MAX%USED
AND,
+
VSE GETVIS USED
AND,
+
VSE GETVIS %USED
+ERPT237I END OF UNCAN EXPANSION
98 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.GETVIS.STAT command generates a report like the
following:
PART
MAX
MAX
GETVIS %GETVIS
JOB
ID
GETVIS %GETVIS
USED
USED
NAME
---- -------- -------- -------- -------- -------AR
660k
45.5
583k
40.2
SYSTEM
BG
3964k
99.8
91k
7.2
EXPRPT
DLITEST
GSAUDIT
S1TEST1
FAQSCICP
FAQSCICW
FAQSPWR4
ALTCTST1
.
.
.
-------SUMMARY
-------FA
696k
37.3
34k
6.7
EXPRPT
GSAUDIT
AXPI3N
S1FILEX2
CATALR
LISTMCAT
ALT
GSPDSU
EVSTAT
.
.
.
SUMMARY
-------F1
228k
49.1
144k
31.4
IPWPOWER
F2
1120k
58.1
486k
32.3
CICSMROA
PLMDATCL
ALT
SARDATCL
LIBRLISD
-------SUMMARY
-------F3
2712k
91.9
2622k
90.6
VTAMSTRT
F4
868k
43.7
281k
27.3
XXX/VTAM
ALT
GSDIR
GSAOGEM
ESALIBRM
JCLXCU
-------SUMMARY
-------.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
F9
692k
37.1
578k
31.5
EXPCDEV
---- -------- -------- -------- -------- -------SUM
3964k
99.8
642k
43.9
---- -------- -------- -------- -------- ----------- -------- -------- -------- -------- --------
MAX
GETVIS
-------660k
3964k
1576k
1104k
388k
356k
332k
328k
324k
.
.
.
-------3964k
-------696k
600k
328k
320k
200k
184k
164k
120k
108k
.
.
.
696k
-------228k
1120k
288k
276k
156k
44k
-------1120k
-------2712k
868k
284k
156k
148k
120k
60k
-------868k
-------.
.
.
692k
-------3964k
---------------
MAX
%GETVIS
-------45.5
99.8
42.9
27.9
9.8
9.3
8.7
8.6
8.2
.
.
.
-------99.8
-------37.3
32.6
18.6
17.4
13.7
9.5
8.5
6.2
7.4
.
.
.
37.3
-------49.1
58.1
28.5
4.6
15.4
4.3
-------58.1
-------91.9
43.7
14.9
10.2
9.7
7.9
3.9
-------43.7
-------.
.
.
37.1
-------99.8
---------------
GETVIS
USED
-------583k
803k
365k
236k
72k
356k
166k
141k
162k
.
.
.
-------91k
-------262k
592k
66k
160k
39k
92k
49k
72k
108k
.
.
.
34k
-------146k
607k
223k
51k
156k
42k
-------486k
-------2643k
665k
67k
78k
148k
120k
30k
-------281k
-------.
.
.
585k
-------642k
---------------
%GETVIS
USED
-------40.2
30.3
19.5
14.8
4.4
9.3
8.7
5.6
8.2
.
.
.
-------7.2
-------23.3
32.2
18.6
17.4
4.9
9.5
5.9
6.2
7.4
.
.
.
6.7
-------31.4
34.6
26.4
3.2
15.4
4.2
-------32.3
-------90.6
33.9
8.8
10.2
9.7
7.9
3.9
-------27.3
-------.
.
.
31.5
-------43.9
---------------
Chapter 5: Canned Reports 99
Canned Report Descriptions
VSE.JOB.STAT Report
The VSE.JOB.STAT report displays job information, sorted by the number of
times a job has been executed.
The following commands generate a VSE.JOB.STAT report:
CANRPT VSE.JOB.STAT
END
RUN
The CANRPT VSE.JOB.STAT command expands as follows:
CANRPT VSE.JOB.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS
*
+*
INFORMATION BY JOBNAME
*
+*-----------------------------------------*
+TITLE2 JOB RELATED STATISTICS
+TAB
VSE JOB COUNT
AND,
+
JOBID
VSE STEP COUNT
AND,
+
VSE STEP DURATIONT
AND,
+
VSE STEP DURATION
AND,
+
VSE STEP TCPU
AND,
+
VSE STEP CPU
AND,
+
VSE DISK IO HDR1(DISK) HDR2(SIO) AND,
+
VSE DISK SERVTIME
AND,
+
VSE TAPE IO
AND,
+
VSE PACCNT EXNLN
AND,
+
VSE PACCNT EXNPG
AND,
+
VSE GETVIS MAXUSED
AND,
+
VSE GETVIS MAX%USED
+ERPT237I END OF UNCAN EXPANSION
100 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.JOB.STAT command generates a report like the following:
JOB
JOB
STEP
TOTAL
AVERAGE
TCPU
CPU
DISK
SERVICE
TAPE
LINES
PAGES
MAX
MAX
NAME
COUNT
COUNT
DURATION DURATION TIME
TIME
SIO
TIME
IO
SPOOLED
SPOOLED
GETVIS %GETVIS
-------- -------- -------- -------- -------- -------- -------- --------- -------- -------- ---------- ---------- -------- ------COMPLK
3
3
00:00:47 00:00:15 1.667
0.417
930
0.040
0
577
25
348K
7.6
CREADS
2
2
00:01:37 00:00:48 0.860
0.430
232
0.046
0
4,816
122
72K
1.7
PHIL
2
2
00:00:17 00:00:08 0.424
0.212
491
0.029
0
100
8
60K
1.5
CATALR
2
2
00:00:14 00:00:07 0.249
0.124
256
0.043
0
76
4
48K
1.2
SMASHER
2
2
00:00:02 00:00:01 0.127
0.063
56
0.047
0
70
4
24K
0.6
AXPHJ6F
1
5
00:00:39 00:00:07 0.616
0.123
732
0.040
0
108
9
312K
1.5
AXPHJ6B
1
5
00:00:25 00:00:05 0.548
0.110
710
0.030
0
107
9
296K
1.5
GSJOBCTL
1
3
00:00:25 00:00:08 0.539
0.179
655
0.029
0
88
4
308K
8.1
CICSMROA
1
2
01:32:51 00:46:25 7.741
0.860
763
0.036
0
55,875
1,692
472K
11.9
ERRM
1
1
00:01:39 00:01:39 7.875
7.875
685
0.055
0
6,224
157
68K
1.8
EVSEBKUP
1
1
00:00:28 00:00:28 1.242
1.242
656
0.032
0
58
2
204K
5.0
FAQSDSPL
1
1
00:00:08 00:00:08 0.560
0.560
276
0.024
0
65
3
296K
7.8
LIBR
1
1
00:00:08 00:00:08 0.141
0.141
86
0.057
0
276
10
16K
0.4
PAUSE
1
0
00:00:00 00:00:00 0.000
0.000
0
0.000
0
29
1
0
0.0
NICK2
1
0
00:00:00 00:00:00 0.000
0.000
0
0.000
0
14
2
0
0.0
SETSDL
1
0
00:00:00 00:00:00 0.000
0.000
0
0.000
0
7
1
0
0.0
*JOBCTL*
0
19
00:34:03 00:01:47 1.324
0.070
1,815
0.049
0
0
0
60K
0.7
INSTALL
0
12
00:01:46 00:00:08 1.785
0.149
2,077
0.040
2
85
8
268K
0.5
JCLSCHED
0
0
01:25:00 00:00:00 31.47
4.497
9,193
0.029
0
0
0
1260K
61.4
SYSTEM
0
0
01:25:00 00:00:00 13.02
1.861
978
0.043
22
0
0
716K
49.3
IPWPOWER
0
0
01:25:00 00:00:00 3.668
0.524
2,015
0.033
21
0
0
176K
37.1
VTAMSTRT
0
0
01:25:00 00:00:00 0.908
0.130
2
0.031
0
0
0
2664K
90.2
FAQSAO
0
0
01:25:00 00:00:00 0.608
0.122
882
0.047
0
0
0
100K
3.3
NO NAME
0
0
00:16:48 00:00:00 0.025
0.006
164
0.042
0
0
0
60K
0.3
-------- -------- -------- -------- -------- -------- -------- --------- -------- -------- ---------- ---------- -------- ------SUMMARY
22
61
09:37:26 00:09:27 75.41
0.711
23,654
0.036
45
68,575
2,061
2664K
90.2
-------- -------- -------- -------- -------- -------- -------- --------- -------- -------- ---------- ---------- -------- -------
VSE.LOCK.STAT
The VSE.LOCK.STAT report displays a tabular report of lock activity organized
by lock resource name and partition ID.
The following commands generate a VSE.LOCK.STAT report:
CANRPT VSE.LOCK.STAT
END
RUN
Chapter 5: Canned Reports 101
Canned Report Descriptions
The VSE.LOCK.STAT command expands as follows:
ERPT237I CANNED REPORT EXPANSION
+*--------------------------------------------------*
+* Display various lock statistics organized by
*
+* lock resource name and pid
*
+*--------------------------------------------------*
+TITLE2 LOCK STATISTICS
+HEADER(95,14) --- UNLOCK --+DEFINE ID TEMPID LOCKID LOCKTYPE
+TAB
TEMPID FORMAT(12C),
+
VSE LOCK HEXNAME
AND,
+
VSE LOCK TYPE SORT
AND,
+
VSE LOCK REQUESTS FORMAT(0N)
+TAB2 PID,
+
VSE LOCK REQUESTS
AND,
+
VSE LOCK REQ-SUCCESS
AND,
+
VSE LOCK REQ-FAIL-RSCE
AND,
+
VSE LOCK REQ-FAIL-OTHER
AND,
+
VSE LOCK UNLOCK RIGHT(3),
+
+
+
HDR1(REQ) HDR2(SUCCESS) AND,
VSE LOCK UNLOCK-FAIL,
HDR1(FAIL) HDR2(NOT-LOCKED)
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.LOCK.STAT command generates a report like the following:
LOCK
LOCK
LOCK
NAME
HEX NAME
TYPE
------------ ------------------------ -------PLODCALL
D7D3D6C4C3C1D3D340404040 INTERNAL
CLCTABLES
C3D3C3E3C1C2D3C5E2404040 INTERNAL
IJSYSDS
C9D1E2E8E2C4E24040404040 EXTERNAL
102 Report Reference Guide
PART
ID
---F2
P1
---SUM
---BG
FA
F8
F5
C2
F6
W1
P1
F2
---SUM
----
LOCK
REQS
-------3306
376
-------3682
-------441
188
101
96
86
73
62
6
2
-------1055
--------
LOCK
SUCCESS
-------3306
376
-------3682
-------361
146
80
67
51
56
31
3
1
-------796
--------
LOCK
LOCK
FAIL-RSC FAIL-OTH
-------- --------
-------- --------------- -------80
42
1
20
29
35
17
31
3
1
-------- -------1
258
-------- --------
BG
416
208
208
FA
142
71
71
F8
38
19
19
F6
34
17
17
C2
12
6
6
F2
6
3
3
---- -------- -------- -------- -------SUM
648
324
324
---- -------- -------- -------- --------
REQ
SUCCESS
-------3306
376
-------3682
-------551
254
141
96
102
109
62
6
2
-------1323
--------
FAIL
NOT-LOCKED
----------
------------------190
108
61
29
51
53
31
3
1
---------527
----------
208
71
19
17
6
3
-------- ---------324
-------- ----------
Canned Report Descriptions
VSE.LPAR.CPU.STAT Report
The VSE.LPAR.CPU.STAT report displays LPAR CPU activity, sorted by partition
name and logical processor address.
The following commands generate a VSE.LPAR.CPU.STAT report:
CANRPT VSE.LPAR.CPU.STAT
END
RUN
The VSE.LPAR.CPU.STAT command expands as follows:
CANRPT VSE.LPAR.CPU.STAT
ERPT237I CANNED REPORT EXPANSION
+*--------------------------------------------------*
+* DISPLAY VARIOUS LPAR CPU STATISTICS ORGANIZED
*
+* BY PARTITION NAME AND LOGICAL PROCESSOR ADDRESS. *
+*--------------------------------------------------*
+TITLE2 LPAR CPU STATISTICS
+TAB TIME LPARID VSE LPAR PROCESSORS
+TAB2 CPUPID SORT ALPHA,
+
VSE LPAR NUMBER
AND,
+
VSE LPAR WEIGHT
AND,
+
VSE LPAR ACTIVE
AND,
+
VSE LPAR %ACTIVE
AND,
+
VSE LPAR OVERHEAD
AND,
+
VSE LPAR %OVERHEAD
AND,
+
VSE LPAR TOTAL-TIME AND,
+
VSE LPAR %TOTAL-TIME
+ERPT237I END OF UNCAN EXPANSION
Chapter 5: Canned Reports 103
Canned Report Descriptions
The VSE.LPAR.CPU.STAT command generates a report like the following:
TIME
----10.00
--------10.15
---------
LPAR
#OF
CPU
ID
CPUS
ID
-------- -------- --VM TOTAL
4
00
--SUM
--DEVTST2
4
00
--SUM
---------- -------- --SUMMARY
4
-------- -------- --VM TOTAL
4
00
--SUM
--DEVTST2
4
00
--SUM
---------- -------- --SUMMARY
4
-------- -------- ---
LPAR
NUM
---02
------01
------------02
------01
-------------
LPAR
LPAR
LPAR
WEIGHT
ACTIVE
%ACTIVE
-------- -------- -------001
00:34:02 227.0
-------- -------- -------00:34:02 227.0
-------- -------- -------001
00:00:15
1.7
-------- -------- -------00:00:15
1.7
-------- -------- --------------- -------- -------00:34:17 114.3
-------- -------- -------001
00:38:09 254.3
-------- -------- -------00:38:09 254.3
-------- -------- -------001
00:00:24
2.7
-------- -------- -------00:00:24
2.7
-------- -------- --------------- -------- -------00:38:33 128.5
-------- -------- --------
LPAR
OVERHEAD
-------00:17:43
-------00:17:43
-------00:00:04
-------00:00:04
--------------00:17:46
-------00:20:25
-------00:20:25
-------00:00:09
-------00:00:09
--------------00:20:35
--------
LPAR
%OVRHEAD
-------118.1
-------118.1
-------0.4
-------0.4
--------------59.3
-------136.2
-------136.2
-------1.0
-------1.0
--------------68.6
--------
LPAR
TOTAL
-------00:51:45
-------00:51:45
-------00:00:19
-------00:00:19
--------------00:52:03
-------00:58:34
-------00:58:34
-------00:00:34
-------00:00:34
--------------00:59:08
--------
LPAR
%TOTAL
-------345.1
-------345.1
-------2.1
-------2.1
--------------173.6
-------390.5
-------390.5
-------3.7
-------3.7
--------------197.1
--------¶
VSE.PACCNT.STAT Report
The VSE.PACCNT.STAT report displays VSE/POWER job accounting data.
The POWRACCT configuration option must be set to YES or YNO for data to be
displayed in this report. For more information about instructions on setting
this configuration option, see the Online User Guide. The following commands
generate a VSE.PACCNT.STAT report:
CANRPT VSE.PACCNT.STAT
END¶RUN
104 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.PACCNT.STAT command expands as follows:
ERPT237I CANNED REPORT EXPANSION
+*-------------------------------------------*
+* DISPLAY ALL VSE/POWER EXECUTE RECORDS
*
+*-------------------------------------------*
+TITLE2 VSE/POWER JOB LOG¶ +DEFINE VAR VSE PACCNT EXCPUPCT = ,
+
+
( VSE PACCNT EXCPUTM * 1000 ) / ,
VSE PACCNT EXJDUR
+TAB ACNUMB ACIDEN(E),
+
VSE PACCNT ACSTRT
SORT ASCENDING AND,
+
VSE PACCNT ACSTOP
AND,
+
VSE PACCNT ACDATE
AND,
+
VSE PACCNT ACNAME
AND,
+
VSE PACCNT ACUSER
AND,
+
VSE PACCNT EXPID
AND,
+
VSE PACCNT EXSTPCNT FORMAT(NNNN),
+
HDR1(STEP) HDR2(CNT) AND,
+
VSE PACCNT EXJDUR
AND,
+
VSE PACCNT EXCPUTM
AND,
+
VSE PACCNT EXCPUTM
NXTIME AND,
+
VSE PACCNT EXCPUPCT FORMAT(NN.N),
+
HDR1(CPU) HDR2(PCT) AND,
+
VSE PACCNT EXSIO AND,
+
VSE PACCNT EXNLN NXTND AND,
+
VSE PACCNT EXNPG NXTND
+ERPT237I END OF UNCAN EXPANSION
Chapter 5: Canned Reports 105
Canned Report Descriptions
The CANRPT VSE.PACCNT.STAT command generates a report like the
following:
POWER
JOB
-------26212
27158
27167
27109
27168
27169
27170
27171
27172
27173
27174
27175
27176
27177
27178
27179
27180
27181
27182
27183
27184
27185
27186
27187
27188
27189
27190
27191
27192
27193
27194
27195
27196
27197
27198
27199
27201
27202
27203
27204
27205
27206
.
.
.
-------SUMMARY
--------
START
TIME
-------02.12.21
09.59.31
10.03.27
10.03.36
10.07.47
10.09.47
10.26.28
10.52.03
10.54.06
10.55.58
11.01.05
11.07.15
11.23.05
11.23.57
11.24.50
11.40.03
11.40.44
11.41.21
11.42.39
11.43.12
11.47.39
11.52.19
11.56.39
11.59.44
12.00.06
12.05.06
12.21.25
12.23.17
12.24.56
12.29.25
12.30.07
12.31.19
12.32.10
12.34.27
12.35.31
12.51.39
13.12.08
13.12.22
13.15.35
13.17.17
13.18.07
13.18.25
.
.
.
--------
STOP
TIME
-------12.34.26
09.59.47
10.03.58
10.03.39
10.08.08
10.10.26
10.26.56
10.52.28
10.55.48
11.05.45
11.01.27
11.08.43
11.23.39
11.24.50
11.25.15
11.40.44
11.41.08
11.41.38
11.43.11
11.43.44
11.48.34
11.52.55
11.57.35
12.01.00
12.02.50
12.06.21
12.21.37
12.23.27
12.25.11
12.29.41
12.30.18
12.31.29
12.33.43
13.00.32
12.36.59
12.51.57
13.18.07
13.12.57
13.15.50
13.18.07
14.18.41
13.19.07
.
.
.
--------
USER
PART STEP
INFO
ID CNT
--------------- ---- ---F7
1
F8
1
F8
1
BG
2
TO DYNBUF
F8
1
TO DYNBUF
F8
1
F8
1
BG
1
TO FAQS
BG
1
TO FAQS
BG
2
F9
1
TO FAQS
BG
1
BG
1
BG
1
BG
1
BG
1
BG
1
BG
1
BG
1
BG
1
BG
1
TO FAQS
BG
1
BG
1
TO FAQS
BG
1
TO NICK
F4
1
TO FAQS
BG
1
F8
2
F8
2
F8
2
F8
1
F8
2
F8
1
TO FAQS
BG
1
F7
1
BG
1
BG
2
F2
4
F4
1
F8
1
BG
1
F2
4
TO TJK
F4
1
.
.
.
.
.
.
.
.
.
--------------- ---- ---103
-------- -------- -------- -------- --------------- ---- ---DATE
-------12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
12/06/03
.
.
.
--------
POWER
NAME
-------JCLSCHED
ALRTVVVI
ALRTRPT
DYNTIME
EXHOOK
EXHOOK
ALRTVVSC
FAQSUTIL
FAQSINST
FAQSINST
BACKUP
FAQSINST
EXPRDT
EXPRPT
EXPDATA
EXPRPT1
EXPRPT2
EXPRPT3
RPTVVSE
RPTVCPER
EXPRPT
FAQSINST
EXPRPT
FAQSINST
NICK
FAQSINST
FAQSVSAM
FAQSVSAM
FAQSVSAM
FAQSVSAM
FAQSVSAM
FAQSVSAM
FAQSINST
JCLSCHED
EXPRPT
FAQSCICP
CICSMROA
JCLRCICS
ALRTVVAU
FAQSUTIL
CICSMROA
EVSEBKUP
.
.
.
--------
JOB
DURATION
-------10:22:01
00:00:15
00:00:30
00:00:02
00:00:20
00:00:38
00:00:27
00:00:24
00:01:41
00:09:47
00:00:21
00:01:28
00:00:33
00:00:53
00:00:25
00:00:40
00:00:23
00:00:17
00:00:31
00:00:32
00:00:54
00:00:36
00:00:55
00:01:16
00:02:44
00:01:14
00:00:12
00:00:09
00:00:14
00:00:15
00:00:11
00:00:10
00:01:33
00:26:04
00:01:27
00:00:18
00:05:59
00:00:34
00:00:15
00:00:49
01:00:33
00:00:41
.
.
.
-------40:45:28
--------
CPU
CPU
CPU
SIO
LINES
PAGES
TIME
TIME
PCT
COUNT
SPOOLED SPOOLED
-------- -------- ---- -------- -------- -------00:00:36 36.99
0.1 57181
38268
1157
00:00:00 0.283
1.8
866
74
3
00:00:01 1.367
4.4
3829
1494
33
00:00:00 0.047
1.8
102
7
1
00:00:00 0.057
0.3
216
87
5
00:00:00 0.166
0.4
2371
2265
70
00:00:00 0.303
1.1
971
74
3
00:00:00 0.420
1.7
1786
89
3
00:00:00 0.170
0.2
2764
2707
82
00:00:01 1.650
0.3
3656
57
3
00:00:00 0.420
1.9
464
34
4
00:00:01 1.413
1.6
3426
40
2
00:00:00 0.510
1.5
2660
65
3
00:00:00 0.636
1.2
2853
235
9
00:00:00 0.397
1.6
1840
64
3
00:00:00 0.850
2.1
3369
407
13
00:00:00 0.606
2.5
2185
328
11
00:00:00 0.383
2.1
1457
99
3
00:00:00 0.870
2.7
3312
597
19
00:00:00 0.730
2.3
2802
401
13
00:00:04 4.463
8.2
2363
396
12
00:00:00 0.313
0.9
4290
4109
126
00:00:04 4.103
7.4
2284
247
10
00:00:01 1.426
1.9
3422
40
2
00:00:02 2.786
1.7
7323
34
1
00:00:01 1.430
1.9
3428
40
2
00:00:00 0.153
1.3
446
87
3
00:00:00 0.146
1.5
424
87
3
00:00:00 0.243
1.6
734
94
3
00:00:00 0.040
0.3
106
28
2
00:00:00 0.186
1.7
503
85
3
00:00:00 0.187
1.8
509
77
2
00:00:01 1.880
2.0
3422
40
2
00:00:02 2.253
0.1
1704
255
9
00:00:14 14.35
16.4
2840
5039
104
00:00:00 0.319
1.7
730
83
4
00:00:06 6.982
1.9 18547
9462
274
00:00:00 0.243
0.7
569
64
3
00:00:00 0.320
2.0
1223
78
3
00:00:00 0.403
0.8
1730
100
3
00:00:20 20.73
0.6
112K
94724
2849
00:00:00 0.550
1.3
542
58
2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
-------- -------- ---- -------- -------- -------00:04:03 243.2
0.2
481K
304K
8639
-------- -------- ---- -------- -------- --------
VSE.PAGE.STAT Report
The VSE.PAGE.STAT report displays paging statistics on all page data set
extents, sorted by page extent number.
106 Report Reference Guide
Canned Report Descriptions
The following commands generate a VSE.PAGE.STAT report:
CANRPT VSE.PAGE.STAT
END
RUN
The CANRPT VSE.PAGE.STAT command expands as follows:
CANRPT VSE.PAGE.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS
*
+*
PAGING STATISTICS BY PAGE EXTENT #
*
+*-----------------------------------------*
+TITLE2 PAGE STATISTICS
+TAB PAGEID VSE PAGE CUU
AND,
+
VSE PAGE VOLID
AND,
+
VSE PAGE STARTADDR
AND,
+
VSE PAGE ENDADDR
AND,
+
VSE PAGE IO
AND,
+
VSE PAGE IO RATE HDR2(RATE)
AND,
+
VSE PAGE IN
AND,
+
VSE PAGE IN RATE,
+
HDR1(PAGE IN) HDR2(RATE)
+
VSE PAGE OUT
+
VSE PAGE OUT RATE,
+
AND,
AND,
HDR1(PAGE OUT) HDR2(RATE)
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.PAGE.STAT command generates a report like the following:
PAGE
DEVICE
VOLSER
EXTENT #
CUU
ID
-------- -------- -------001
0351
SYSWK1
003
0350
DOSRES
002
0350
DOSRES
-------- -------- -------SUMMARY
-------- -------- --------
STARTING ENDING
PAGE
PAGE
PAGE
PAGE IN
PAGE
PAGE OUT
CCC-HH
CCC-HH
IO
RATE
IN
RATE
OUT
RATE
-------- -------- -------- -------- -------- -------- -------- -------529- 00 553- 29
1135
0.00
336
0.00
799
0.00
485- 00 503- 09
56
0.00
0
0.00
56
0.00
350- 00 399- 29
1770
0.00
614
0.00
1156
0.00
-------- -------- -------- -------- -------- -------- -------- -------2961
0.01
950
0.00
2011
0.01
-------- -------- -------- -------- -------- -------- -------- --------
VSE.PID.CPU Report
The VSE.PID.CPU report displays CPU use by partition.
The following commands generate a VSE.PID.CPU report:
CANRPT VSE.PID.CPU
END
RUN
Chapter 5: Canned Reports 107
Canned Report Descriptions
The CANRPT VSE.PID.CPU command expands as follows:
CANRPT VSE.PID.CPU
ERPT237I CANNED REPORT EXPANSION
+TITLE2 SYSTEM/PARTITION CPU UTILIZATION
+TITLE3 -PARTITION CPU DERIVED FROM CPU SAMPLE COUNTS+TAB DATETIME VSE CPU BUSYV ,',
+
HDR1(CPU)
+VSE CPU %BUSYV
HDR1(%CPU) HDR2(-TIMER-)
HDR2(-SYSTEM-)
+VSE STEP %CPUBUSYS HDR1(%CPU) HDR2(-SAMPLE-)
AND,
AND,
AND,
+VSE STEP %CPUBUSYS PID(AR) HDR1(%CPU) HDR2(-AR-) AND,
+VSE STEP %CPUBUSYS PID(BG) HDR1(%CPU) HDR2(-BG-) AND,
+VSE STEP %CPUBUSYS PID(F1) HDR1(%CPU) HDR2(-F1-) AND,
+VSE STEP %CPUBUSYS PID(F2) HDR1(%CPU) HDR2(-F2-) AND,
+VSE STEP %CPUBUSYS PID(F3) HDR1(%CPU) HDR2(-F3-) AND,
+VSE STEP %CPUBUSYS PID(F4) HDR1(%CPU) HDR2(-F4-) AND,
+VSE STEP %CPUBUSYS PID(F5) HDR1(%CPU) HDR2(-F5-) AND,
+VSE STEP %CPUBUSYS PID(F6) HDR1(%CPU) HDR2(-F6-) AND,
+VSE STEP %CPUBUSYS PID(F7) HDR1(%CPU) HDR2(-F7-) AND,
+VSE STEP %CPUBUSYS PID(F8) HDR1(%CPU) HDR2(-F8-)
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.PID.CPU command generates a report like the following:
DATE
-------02/12/04
02/12/04
02/12/04
-------PERIOD
--------
TIME
----13.00
14.00
15.00
---------
CPU
-SYSTEM-------00:01:46
00:06:46
00:00:39
-------00:09:12
--------
%CPU
-TIMER-------11.9
10.4
13.0
-------10.8
--------
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
-SAMPLE-AR-BG-F1-F2-F3-F4-F5-F6-F7-------- -------- -------- -------- -------- -------- -------- -------- -------- -------6.2
1.3
0.6
0.3
0.2
0.2
0.0
0.0
0.0
3.5
7.2
0.4
1.5
1.0
0.1
0.3
0.1
0.0
0.0
3.8
32.0
0.7
16.2
2.4
4.5
0.3
0.3
0.0
0.0
7.6
-------- -------- -------- -------- -------- -------- -------- -------- -------- -------8.5
0.6
2.2
1.0
0.4
0.3
0.1
0.0
0.0
4.0
-------- -------- -------- -------- -------- -------- -------- -------- -------- --------
%CPU
-F8----0.0
0.0
0.0
----0.0
-----
VSE.PRINT.FORMS.STAT Report
The VSE.PRINT.FORMS.STAT report displays printing statistics.
The POWRACCT configuration option must be set to YES or YNO for data to be
displayed in this report. For more information about instructions on setting
this configuration option, see the Online User Guide. The following commands
generate a VSE.PRINT.FORMS.STAT report:
CANRPT VSE.PRINT.FORMS.STAT
END
RUN
108 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.PRINT.FORMS.STAT command expands as follows:
CANRPT VSE.PRINT.FORMS.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS
*
+*
PRINT STATISTICS BY PRINT-FORMS ID.
*
+*
** EXTRACTED - POWER LIST ACCOUNT RECORD **
*
+*-----------------------------------------------*
+TITLE2 PRINTER STATISTICS
+TAB
LSTFOR VSE PACCNT LSTCOP
AND,
+
VSE PACCNT LSTPAG
AND,
+
VSE PACCNT LSTEXP
AND,
+
VSE PACCNT LSTNUM
AND,
+
VSE PACCNT LSTEXR
AND,
+
VSE PACCNT LSTRINS
AND,
+
VSE PACCNT LSTRDEL
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.PRINT.FORMS.STAT command generates a report like the
following:
FORM
PRINTED
PAGES
EXTRA
LINES
EXTRA
RECORDS
RECORDS
ID
COPIES PRINTED
PAGES
PRINTED
RECORDS
INSERTED
DELETED
-------- -------- ---------- ---------- ---------- ---------- ---------- ---------1485
1099
30,909
3,577
1,423,935 127,022
0
0
SHLF
671
354
21,604
3,276 200,403
0
0
PLU
604
72
5,371
2,880 214,816
0
0
162
3,693
72
107,290
2,088
0
0
1185
41
505
105
18,150
3,493
0
0
PC
40
1,431
314
66,383
10,536
0
0
1811
17
700
95
27,924
2,372
0
0
1411
15
5,350
8
322,253
232
0
0
2485
10
1,304
8
41,729
232
0
0
3811
7
35
0
1,148
0
0
0
5X3
6
4,904
0
117,651
0
0
0
CDPL
5
2,499
0
37,500
0
0
0
3485
3
344
212
15,653
8,423
0
0
2811
3
0
0
0
0
0
0
4485
2
252
0
7,440
0
0
0
INVO
2
96
4
2,398
116
0
0
6HLE
2
6
12
118
292
0
0
APCK
1
754
0
9,858
0
0
0
LADE
1
62
0
1,860
0
0
0
3/UP
1
17
0
104
0
0
0
3185
1
7
0
137
0
0
0
PICK
1
0
4
0
20
0
0
-------- -------- ---------- ---------- ---------- ---------- ---------- ---------SUMMARY
2694
53,294
31,386
2,207,687 570,045
0
0
-------- -------- ---------- ---------- ---------- ---------- ---------- ----------
VSE.PROGRAM.LOAD.STAT
The VSE.PROGRAM.LOAD.STAT report displays program load statistics by
jobname.
Chapter 5: Canned Reports 109
Canned Report Descriptions
The MONPGMLD configuration option must be set to YES for data to be
displayed in this report. For more information about instructions on setting this
configuration option, see the Online User Guide.
The VSE.PROGRAM.LOAD.STAT report can be very long. We recommend that
you use the SELECT command to limit the report to the particular jobs you
want program load statistics about.
The following commands generate a VSE.PROGRAM.LOAD.STAT report:
CANRPT VSE.PROGRAM.LOAD.STAT
SELECT JOBID(EXPRPT)
END
RUN
The CANRPT VSE.PROGRAM.LOAD.STAT command expands as follows:
CANRPT VSE.PROGRAM.LOAD.STAT
ERPT237I CANNED REPORT EXPANSION
+*-------------------------------------------*
+* DISPLAY PROGRAM LOAD STATISTICS BY
*
+* INDIVIDUAL JOB EXECUTIONS
*
+*-------------------------------------------*
+DEFINE ID UNIQUEKEY JOBID ' ' STEPID ACNUMB
+DEFINE ID PHASEID PHASEID ' ' PGMTID
+TAB UNIQUEKEY FORMAT(17C),
+
VSE STEP STARTDATE AND,
+
VSE STEP STARTTIME AND,
+
VSE STEP ENDTIME AND,
+
VSE PHASE LOADS SORT DESCENDING
+TAB2 PHASEID VSE PHASE LOADS AND,
+
VSE PHASE LIBRARY AND,
+
VSE PHASE SUBLIB AND,
+
VSE PHASE ADDRESS AND,
+
VSE PHASE TIME
+
VSE PHASE CPUSAMP AND,
+
VSE PHASE LENGTH
SORT ASCENDING AND,
+ERPT237I END OF UNCAN EXPANSION
110 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.PROGRAM.LOAD.STAT command generates a report like the
following:
JOB
STEP
START
START
END
LOAD
PHASE
LOAD
LOAD
LIBRARY
NAME
NAME
DATE
TIME
TIME
COUNT
NAME
TID
COUNT
NAME
----------------- -------- -------- -------- -------- ------------- -------- -------CICSTS
DFHSIP
13/11/08 05.06.28 05.19.00
1570
DFHSIP31 0023
1
PRD1
IKQVTMS 0023
1
SVA
IKQVRBA 0023
1
SVA
DFHPAIO 0023
1
PRD1
DFHEVAS 0023
1
PRD1
IKQVTMX 0023
1
SVA
DFHPASYL 0023
1
PRD1
IKQVCHK 0023
1
IJSYSR2
DFHSITSP 0023
1
L2LIB
DFHDSAUT 0023
1
PRD1
DFHDTXS 0023
1
PRD1
CEEYDI0 0023
1
PRD2
CAKSGRSA 0023
1
L2LIB
CAS8LCAM 0023
1
CAI2
TSSCPRM 0023
1
L2LIB
CAKSMSGF 0023
1
L2LIB
CAKSVSEV 0023
1
L2LIB
DFHEVCL 0023
1
PRD1
TSSCMSG2 0023
1
L2LIB
CAKSR411 0023
1
L2LIB
TSSCMSGE 0023
1
L2LIB
DFHEVOP 0023
1
PRD1
DFHLDSVC 0074
1
PRD1
DFHAPDM 0074
1
PRD1
DFHSMSVC 0023
1
PRD1
DFHIEDML 0074
1
PRD1
DFHSTDML 0074
1
PRD1
DFHMNDML 0074
1
PRD1
DFHSODML 0074
1
PRD1
DFHDHDML 0074
1
PRD1
DFHPGDM 0074
1
PRD1
DFHMET1E 0023
1
PRD1
.
.
.
.
.
.
.
.
.
.
.
.
------------- -------- -------SUMMARY
1570
------------- -------- --------
SUBLIB
NAME
-------BASE
SDL
SDL
BASE
BASE
SDL
BASE
SYSLIB
CONFIG
BASE
BASE
SCEEBASE
TOPSEC
CA90S14
TOPSEC
TOPSEC
TOPSEC
BASE
TOPSEC
TOPSEC
TOPSEC
BASE
BASE
BASE
BASE
BASE
BASE
BASE
BASE
BASE
BASE
BASE
.
.
.
--------
LOAD
ADDR
-------040EE000
001CC480
001AA350
00623000
00604000
07EE3FC0
0405A880
0062B000
04059F00
0405F800
0846A8A0
00643580
04061300
0062B000
04043F00
04046800
04055100
00648000
04048B80
0403E380
0404D780
0062B000
0060A180
02200000
03FDB300
0221AE20
0226D810
0221FF40
02257AC0
022014E0
022320E0
03FE4D00
.
.
.
-------00ED9000
-------- --------
LOAD
CPU
PHASE
TIME
SAMP
LENGTH
-------- ------- -------05.06.28
3
783k
05.06.29
1k
05.06.29
3k
05.06.29
5k
05.06.29
6k
05.06.29
12k
05.06.29
18k
05.06.29
39k
05.06.30
2k
05.06.30
2k
05.06.30
2k
05.06.30
3k
05.06.30
3k
05.06.30
4k
05.06.30
4k
05.06.30
6k
05.06.30
8k
05.06.30
15k
05.06.30
17k
05.06.30
19k
05.06.30
26k
05.06.30
97k
05.06.31
2k
05.06.31
5k
05.06.31
11k
05.06.31
20k
05.06.31
30k
05.06.31
72k
05.06.31
87k
05.06.31
102k
05.06.31
150k
05.06.31
277k
.
.
.
.
.
.
-------- ------- ------6
21k
-------- ------- --------
VSE.SAMCPU.BUSYR.STAT Report
The VSE.SAMCPU.BUSYR.STAT report displays real CPU activity based on oneminute CPU samples. The following commands generate a
VSE.SAMCPU.BUSYR.STAT report:
CANRPT VSE.SAMCPU.BUSYR.STAT
EACH HOUR
END
RUN
Chapter 5: Canned Reports 111
Canned Report Descriptions
The VSE.SAMCPU.BUSYR.STAT command expands as follows:
CANRPT VSE.SAMCPU.BUSYR.STAT
112 Report Reference Guide
Canned Report Descriptions
ERPT237I CANNED REPORT EXPANSION
+*--------------------------------------------------*
+* Display the real CPU utilization distribution.
*
+* The data used to create this report is extracted *
+* from the SAMPLE record and represents 1 minute
*
+* intervals.
*
+*--------------------------------------------------*
+TITLE2 Real CPU utilization distribution
+TITLE3 1 minute intervals
+RANGE VSE SAMPLE %CPUREAL 0-10
ID RCPU00
+RANGE VSE SAMPLE %CPUREAL 10-20
ID RCPU10
+RANGE VSE SAMPLE %CPUREAL 20-30
ID RCPU20
+RANGE VSE SAMPLE %CPUREAL 30-40
ID RCPU30
+RANGE VSE SAMPLE %CPUREAL 40-50
ID RCPU40
+RANGE VSE SAMPLE %CPUREAL 50-60
ID RCPU50
+RANGE VSE SAMPLE %CPUREAL 60-70
ID RCPU60
+RANGE VSE SAMPLE %CPUREAL 70-80
ID RCPU70
+RANGE VSE SAMPLE %CPUREAL 80-90
ID RCPU80
+RANGE VSE SAMPLE %CPUREAL 90+
ID RCPU90
+DEFINE VAR VSE SAMPLE CPUREAL%0-10
+
+
= ,
( VSE COUNT ESMFSAM RANGE(RCPU00) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUREAL%10-20 = ,
+
+
( VSE COUNT ESMFSAM RANGE(RCPU10) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUREAL%20-30 = ,
+
+
( VSE COUNT ESMFSAM RANGE(RCPU20) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUREAL%30-40 = ,
+
+
( VSE COUNT ESMFSAM RANGE(RCPU30) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUREAL%40-50 = ,
+
+
( VSE COUNT ESMFSAM RANGE(RCPU40) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUREAL%50-60 = ,
+
+
( VSE COUNT ESMFSAM RANGE(RCPU50) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUREAL%60-70 = ,
+
+
( VSE COUNT ESMFSAM RANGE(RCPU60) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUREAL%70-80 = ,
+
+
( VSE COUNT ESMFSAM RANGE(RCPU70) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUREAL%80-90 = ,
+
+
( VSE COUNT ESMFSAM RANGE(RCPU80) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUREAL%90+
+
= ,
( VSE COUNT ESMFSAM RANGE(RCPU90) * 100 ) / ,
Chapter 5: Canned Reports 113
Canned Report Descriptions
+
VSE COUNT ESMFSAM
+TAB DATETIME,
+VSE SAMPLE %CPUREAL HDR1(TOTAL) HDR2(%CPU) AND,
+VSE SAMPLE %CPUREAL MAX HDR1(MAX) HDR2(%CPU) AND,
+VSE SAMPLE %CPUREAL MAXTIME,
+
FORMAT(5C) HDR1(MAXTIME) HDR2(OCCURED) AND,
+VSE SAMPLE CPUREAL%0-10
HDR1(%CPU) HDR2(0-10%)
AND,
+VSE SAMPLE CPUREAL%10-20 HDR1(%CPU) HDR2(10-20%) AND,
+VSE SAMPLE CPUREAL%20-30 HDR1(%CPU) HDR2(20-30%) AND,
+VSE SAMPLE CPUREAL%30-40 HDR1(%CPU) HDR2(30-40%) AND,
+VSE SAMPLE CPUREAL%40-50 HDR1(%CPU) HDR2(40-50%) AND,
+VSE SAMPLE CPUREAL%50-60 HDR1(%CPU) HDR2(50-60%) AND,
+VSE SAMPLE CPUREAL%60-70 HDR1(%CPU) HDR2(60-70%) AND,
+VSE SAMPLE CPUREAL%70-80 HDR1(%CPU) HDR2(70-80%) AND,
+VSE SAMPLE CPUREAL%80-90 HDR1(%CPU) HDR2(80-90%) AND,
+VSE SAMPLE CPUREAL%90+
HDR1(%CPU) HDR2(90-100%)
+ERPT237I END OF UNCAN EXPANSION
The VSE.SAMCPU.BUSYR.STAT command generates a report like the following:
DATE
-------08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
-------PERIOD
--------
TIME
----08.00
09.00
10.00
11.00
12.00
13.00
14.00
15.00
16.00
---------
TOTAL
MAX
MAXTIME
%CPU
%CPU
%CPU
OCCURED 0-10%
-------- -------- ------- -------63.4
79.5
08.18
0
70.1
84.2
09.09
0
63.5
84.5
10.06
0
67.4
83.6
11.13
0
50.0
82.8
12.08
0
36.0
75.0
13.14
0
26.2
42.3
14.35
0
18.4
45.4
15.00
3
14.3
36.4
16.05
40
-------- -------- ------- -------45.5
84.5
10.06
5
-------- -------- ------- --------
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
10-20%
20-30%
30-40%
40-50%
50-60%
60-70%
70-80%
80-90% 90-100%
------- ------- -------- -------- -------- -------- -------- -------- -------0
0
0
12
18
48
22
0
0
0
0
0
0
12
47
27
15
0
0
0
0
13
28
30
18
10
0
0
0
0
0
25
37
32
7
0
0
5
25
13
33
17
5
2
0
27
28
12
3
10
15
5
0
0
30
35
27
8
0
0
0
0
0
65
20
8
3
0
0
0
0
0
40
12
8
0
0
0
0
0
0
-------- ------ -------- -------- -------- -------- -------- -------- -------18
11
9
6
14
21
12
4
0
-------- ------ -------- -------- -------- -------- -------- -------- --------
VSE.SAMCPU.BUSYV.STAT Report
The VSE.SAMCPU.BUSYV.STAT report displays virtual CPU activity based on
one-minute CPU samples.
The following commands generate a VSE.SAMCPU.BUSYV.STAT report:
CANRPT VSE.SAMCPU.BUSYV.STAT
EACH HOUR
END
RUN
114 Report Reference Guide
Canned Report Descriptions
The VSE.SAMCPU.BUSYV.STAT command expands as follows:
CANRPT VSE.SAMCPU.BUSYV.STAT
Chapter 5: Canned Reports 115
Canned Report Descriptions
ERPT237I CANNED REPORT EXPANSION
+*--------------------------------------------------*
+* Display the virtual CPU utilization distribution.*
+* The data used to create this report is extracted *
+* from the SAMPLE record and represents 1 minute
*
+* intervals.
*
+*--------------------------------------------------*
+TITLE2 Virtual CPU utilization distribution
+TITLE3 1 minute intervals
+RANGE VSE SAMPLE %CPUVIRT 0-10
ID VCPU00
+RANGE VSE SAMPLE %CPUVIRT 10-20
ID VCPU10
+RANGE VSE SAMPLE %CPUVIRT 20-30
ID VCPU20
+RANGE VSE SAMPLE %CPUVIRT 30-40
ID VCPU30
+RANGE VSE SAMPLE %CPUVIRT 40-50
ID VCPU40
+RANGE VSE SAMPLE %CPUVIRT 50-60
ID VCPU50
+RANGE VSE SAMPLE %CPUVIRT 60-70
ID VCPU60
+RANGE VSE SAMPLE %CPUVIRT 70-80
ID VCPU70
+RANGE VSE SAMPLE %CPUVIRT 80-90
ID VCPU80
+RANGE VSE SAMPLE %CPUVIRT 90+
ID VCPU90
+DEFINE VAR VSE SAMPLE CPUVIRT%0-10
+
+
= ,
( VSE COUNT ESMFSAM RANGE(VCPU00) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUVIRT%10-20 = ,
+
+
( VSE COUNT ESMFSAM RANGE(VCPU10) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUVIRT%20-30 = ,
+
+
( VSE COUNT ESMFSAM RANGE(VCPU20) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUVIRT%30-40 = ,
+
+
( VSE COUNT ESMFSAM RANGE(VCPU30) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUVIRT%40-50 = ,
+
+
( VSE COUNT ESMFSAM RANGE(VCPU40) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUVIRT%50-60 = ,
+
+
( VSE COUNT ESMFSAM RANGE(VCPU50) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUVIRT%60-70 = ,
+
+
( VSE COUNT ESMFSAM RANGE(VCPU60) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUVIRT%70-80 = ,
+
+
( VSE COUNT ESMFSAM RANGE(VCPU70) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUVIRT%80-90 = ,
+
+
( VSE COUNT ESMFSAM RANGE(VCPU80) * 100 ) / ,
VSE COUNT ESMFSAM
+DEFINE VAR VSE SAMPLE CPUVIRT%90+
+
116 Report Reference Guide
= ,
( VSE COUNT ESMFSAM RANGE(VCPU90) * 100 ) / ,
Canned Report Descriptions
+
VSE COUNT ESMFSAM
+TAB DATETIME,
+VSE SAMPLE %CPUVIRT HDR1(TOTAL) HDR2(%CPU) AND,
+VSE SAMPLE %CPUVIRT MAX HDR1(MAX) HDR2(%CPU) AND,
+VSE SAMPLE %CPUVIRT MAXTIME,
+
FORMAT(5C) HDR1(MAXTIME) HDR2(OCCURED) AND,
+VSE SAMPLE CPUVIRT%0-10
HDR1(%CPU) HDR2(0-10%)
AND,
+VSE SAMPLE CPUVIRT%10-20 HDR1(%CPU) HDR2(10-20%) AND,
+VSE SAMPLE CPUVIRT%20-30 HDR1(%CPU) HDR2(20-30%) AND,
+VSE SAMPLE CPUVIRT%30-40 HDR1(%CPU) HDR2(30-40%) AND,
+VSE SAMPLE CPUVIRT%40-50 HDR1(%CPU) HDR2(40-50%) AND,
+VSE SAMPLE CPUVIRT%50-60 HDR1(%CPU) HDR2(50-60%) AND,
+VSE SAMPLE CPUVIRT%60-70 HDR1(%CPU) HDR2(60-70%) AND,
+VSE SAMPLE CPUVIRT%70-80 HDR1(%CPU) HDR2(70-80%) AND,
+VSE SAMPLE CPUVIRT%80-90 HDR1(%CPU) HDR2(80-90%) AND,
+VSE SAMPLE CPUVIRT%90+
HDR1(%CPU) HDR2(90-100%)
+ERPT237I END OF UNCAN EXPANSION
The VSE.SAMCPU.BUSYV.STAT command generates a report like the following:
DATE
-------08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
-------PERIOD
--------
TIME
----08.00
09.00
10.00
11.00
12.00
13.00
14.00
15.00
16.00
---------
TOTAL
MAX
MAXTIME %CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
OCCURED 0-10%
10-20%
20-30%
30-40%
40-50%
50-60%
60-70%
70-80%
80-90% 90-100%
-------- -------- ------- ------- -------- -------- -------- -------- -------- -------- -------- -------- ------85.3
99.8
08.55
0
0
0
0
3
3
8
12
13
60
99.2
99.9
09.20
0
0
0
0
0
0
0
0
0
100
84.7
99.5
10.59
0
0
0
0
0
2
13
23
15
47
89.0
99.6
11.24
0
0
0
0
0
0
3
13
27
57
64.8
97.0
12.08
0
0
0
18
5
15
15
23
10
13
46.7
98.1
13.12
0
2
43
12
7
5
7
2
7
17
31.4
51.2
14.22
0
22
22
28
25
3
0
0
0
0
19.0
49.0
15.00
3
60
25
5
7
0
0
0
0
0
14.9
38.8
16.05
38
38
13
10
0
0
0
0
0
0
-------- -------- ------- ------- -------- -------- -------- -------- -------- -------- -------- -------- ------56.4
99.9
09.20
5
14
11
8
5
3
5
8
8
33
-------- -------- ------- ------- -------- -------- -------- -------- -------- -------- -------- -------- -------
VSE.SAMPLE.COUNT.STAT Report
The VSE.SAMPLE.COUNT.STAT report displays all CA Explore PM for z/VSE
sample fields, which contain system statistics collected at one-minute
intervals. These data are presented as counts. Use the
VSE.SAMPLE.RATE.STAT canned report to display the same information as
rates.
The following commands generate a VSE.SAMPLE.COUNT.STAT report:
CANRPT VSE.SAMPLE.COUNT.STAT
FROM 02/06/04 11.45.00
TO
02/06/04 11.59.59
EACH 1 MINUTE
END
RUN
Chapter 5: Canned Reports 117
Canned Report Descriptions
The CANRPT VSE.SAMPLE.COUNT.STAT command expands as follows:
CANRPT VSE.SAMPLE.COUNT.STAT
ERPT237I CANNED REPORT EXPANSION
+*-------------------------------------------*
+* DISPLAY ALL CA-EXPLORE/VSE SAMPLE FIELDS
*
+*-------------------------------------------*
+TAB DATETIME VSE SAMPLE %CPUVIRT
AND,
+
VSE SAMPLE CPUVIRT
AND,
+
VSE SAMPLE CPUCONT
AND,
+
VSE SAMPLE SVC
AND,
+
VSE SAMPLE VMPF
AND,
+
VSE SAMPLE PAGF
AND,
+
VSE SAMPLE SIO
AND,
+
VSE SAMPLE DSIO
AND,
+
VSE SAMPLE PAGEIN
AND,
+
VSE SAMPLE PAGEOUT
AND,
+
VSE SAMPLE RSTOR-USED
AND,
+
VSE SAMPLE RSTOR-%USED
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.SAMPLE.COUNT.STAT command generates a report like the
following:
DATE
-------02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
-------PERIOD
--------
TIME
----11.45
11.46
11.47
11.48
11.49
11.50
11.51
11.52
11.53
11.54
11.55
11.56
11.57
11.58
11.59
---------
VCPU
VCPU
CPU
SVC
VM PAGE
PAGE
SIO
DISK
PAGE
PAGE
RSTOR
RSTOR
BUSY
TIME
CONT
COUNT
FAULT
FAULT
COUNT
SIO
IN
OUT
USED
%USED
-------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -----0.2
2.093
4.672
1829
0
0
19
2
0
0
16372k
99.9
0.3
3.134
5.518
2072
20
3
70
62
0
0
16368k
99.9
0.3
2.734
12.48
2007
89
0
19
15
0
0
16368k
99.9
0.3
2.670
6.660
1993
7
1
37
30
0
0
16372k
99.9
0.3
2.402
2.276
1895
0
0
3
2
0
0
16372k
99.9
0.3
2.466
4.550
1916
0
0
3
2
0
0
16372k
99.9
0.3
2.704
5.886
1910
77
0
7
3
0
0
16372k
99.9
0.3
2.543
4.924
1907
11
0
3
2
0
0
16372k
99.9
0.3
2.998
12.89
2160
3
0
25
5
0
0
16372k
99.9
0.3
2.550
4.639
1974
0
0
34
27
0
0
16372k
99.9
0.3
2.402
7.516
1910
5
0
6
2
0
0
16372k
99.9
0.2
2.342
2.718
1875
1
0
3
2
0
0
16372k
99.9
0.6
5.327
50.26
2882
190
76
228
154
4
0
13780k
84.1
5.6
37.37
301.4
19401
282
302
2865
2207
13
0
14228k
86.8
4.1
28.79
267.5
19679
36
143
2274
1864
1
0
14380k
87.8
-------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -----0.8
102.5
693.9
65410
721
525
5596
4379
18
0
15923k
97.2
-------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------- ------
VSE.SAMPLE.RATE.STAT Report
The VSE.SAMPLE.RATE.STAT displays all CA Explore PM for z/VSE sample
fields, which contain system statistics collected at one-minute intervals. These
data are presented as rates. Use the VSE.SAMPLE.COUNT.STAT canned report
to display the same information as counts.
118 Report Reference Guide
Canned Report Descriptions
The following commands generate a VSE.SAMPLE.RATE.STAT report:
CANRPT VSE.SAMPLE.RATE.STAT
FROM 02/06/04 11.45.00
TO
02/06/04 11.59.59
EACH 1 MINUTE
END
RUN
The CANRPT VSE.SAMPLE.RATE.STAT command expands as follows:
CANRPT VSE.SAMPLE.RATE.STAT
ERPT237I CANNED REPORT EXPANSION
+*-------------------------------------------*
+* DISPLAY ALL CA-EXPLORE/VSE SAMPLE FIELDS
*
+*-------------------------------------------*
+TAB DATETIME VSE SAMPLE CPUVIRT
AND,
+
VSE SAMPLE CPUREAL
+
VSE SAMPLE CPUCONT
+
VSE SAMPLE SVC RATE
+
VSE SAMPLE VMPF RATE HDR1(VM P-FLT),
+
+
AND,
AND,
HDR2(RATE) AND,
HDR2(RATE) AND,
VSE SAMPLE PAGF RATE HDR1(P-FLT),
+
HDR2(RATE) AND,
+
VSE SAMPLE SIO RATE
+
VSE SAMPLE DSIO RATE HDR1(DISK-SIO),
+
+
HDR2(RATE) AND,
VSE SAMPLE PAGEIN RATE HDR1(PAGE-IN),
+
+
HDR2(RATE) AND,
HDR2(RATE) AND,
VSE SAMPLE PAGEOUT RATE HDR1(PAGE-OUT),
+
HDR2(RATE) AND,
+
VSE SAMPLE RSTOR-USED
+
VSE SAMPLE RSTOR-%USED
AND,
+ERPT237I END OF UNCAN EXPANSION
Chapter 5: Canned Reports 119
Canned Report Descriptions
The CANRPT VSE.SAMPLE.RATE.STAT command generates a report like the
following:
DATE
-------02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
02/06/04
-------PERIOD
--------
TIME
----11.45
11.46
11.47
11.48
11.49
11.50
11.51
11.52
11.53
11.54
11.55
11.56
11.57
11.58
11.59
---------
VCPU
RCPU
%CPU
SVC
BUSY
BUSY
CONT
RATE
-------- -------- -------- -------0.2
0.0
0.5
31.00
0.3
0.0
0.6
35.12
0.3
0.0
1.3
34.02
0.3
0.0
0.7
33.22
0.3
0.0
0.2
32.12
0.3
0.0
0.5
32.47
0.3
0.0
0.6
32.37
0.3
0.0
0.5
31.78
0.3
0.0
1.3
36.61
0.3
0.0
0.5
33.46
0.3
0.0
0.8
32.37
0.2
0.0
0.3
31.78
0.6
0.0
5.2
48.03
5.6
0.2
31.2
328.8
4.1
0.2
27.6
333.5
-------- -------- -------- -------0.8
0.0
4.8
72.76
-------- -------- -------- --------
VM P-FLT P-FLT
SIO
DISK-SIO
RATE
RATE
RATE
RATE
-------- -------- -------- -------0.00
0.00
0.32
0.03
0.34
0.05
1.19
1.05
1.51
0.00
0.32
0.25
0.12
0.02
0.62
0.50
0.00
0.00
0.05
0.03
0.00
0.00
0.05
0.03
1.31
0.00
0.12
0.05
0.18
0.00
0.05
0.03
0.05
0.00
0.42
0.08
0.00
0.00
0.58
0.46
0.08
0.00
0.10
0.03
0.02
0.00
0.05
0.03
3.17
1.27
3.80
2.57
4.78
5.12
48.56
37.41
0.61
2.42
38.54
31.59
-------- -------- -------- -------0.80
0.58
6.22
4.87
-------- -------- -------- --------
PAGE-IN
RATE
-------0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.07
0.22
0.02
-------0.02
--------
PAGE-OUT
RSTOR
RSTOR
RATE
USED
%USED
-------- -------- -----0.00
16372k
99.9
0.00
16368k
99.9
0.00
16368k
99.9
0.00
16372k
99.9
0.00
16372k
99.9
0.00
16372k
99.9
0.00
16372k
99.9
0.00
16372k
99.9
0.00
16372k
99.9
0.00
16372k
99.9
0.00
16372k
99.9
0.00
16372k
99.9
0.00
13780k
84.1
0.00
14228k
86.8
0.00
14380k
87.8
-------- -------- -----0.00
15923k
97.2
-------- -------- ------
VSE.SEEK.STAT Report
The VSE.SEEK.STAT report produces a vertical plot for each disk device. The
vertical axis of the plot represents the number of seek I/Os to the device. The
horizontal axis represents the cylinders of the device.
The Seeks-by-Cyl column on the Configuration DASD I/O panel must be set to
Y for data to be displayed in this report. For more information about
instructions on setting this configuration option, see the Online User Guide.
The following commands generate a VSE.SEEK.STAT report:
CANRPT VSE.SEEK.STAT
END
RUN
The CANRPT VSE.SEEK.STAT command expands as follows:
CANRPT VSE.SEEK.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN A VERTICAL PLOT FORMAT
*
+*
THE SEEKS BY CYLINDER PER DISK DEVICE
*
+*-----------------------------------------*
+VPLOT VSE DISK SEEKS CYLINDER XDSN
+ERPT237I END OF UNCAN EXPANSION
120 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.SEEK.STAT command generates a report like the following:
DEVICE 3330B
WM08RS – 0150
VSCALE 1497
SEEK COUNTS
HSCALE 8
SEEK
COUNT
-------22451
I
J
I
I
J
I
I
J
I
I
J
I
I
J
I
14968
I
J
I
I
J
I
I
J
I
I
H J
I
I
H J
I
7484
I
H J
I
I
H J
I
I
C
H J
I
I
A
C
H J
I
IA
A
B
CD
GG
H J LL
Q R I
0
II --------I---------I---------I---------I---------I---------I---------I---------I---------I---------I--I
000
080
160
240
320
400
480
560
640
720
800
AAAAAAAAAAAAAAAABBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBCDDD
EEFFF
GGGGGHIJKLLMNOO PQQR
SYMBOLS:
"X" = SEEK COUNTS
A - VSE2TST.SYSRES.SYSLIB
000-131
G - VSE2TST.POWER.DATA.FILE
651-689
M - CICSVSE2.S1SCTY.VSAM
B - VSE2TST.SYSRES.PRD2
132-481
H - VSE.HARDCOPY.FILE.S
*691-691
N - STATS.MARTIN.MCMASTER
C - DOS.LABEL.FILE.FF03004730 482-484
J - VSE2TST.POWER.QUEUE.FILE *706-706
P - UNKN.03080000.03080012
D - VSE3TST.VSE.SHARED.PDS.FL 485-508
K - ALERT.XP.TEST.SECURITY.FI *713-714
Q - STATS.MARTIN.MCMASTER
E - BU.PDS.MON
566-581
L - VSE2TST.MASTER.CATALOG
*725-725
R - WM08RS.VTOC
SEEK
COUNT
-------22451
14968
7484
0
739-740
*745-746
776-776
*784-784
*807-807
VSE.SVC.STAT Report
The VSE.SVC.STAT report displays SVC activity by SVC code. The following
commands generate a VSE.SVC.STAT report:
CANRPT VSE.SVC.STAT
END
RUN
Chapter 5: Canned Reports 121
Canned Report Descriptions
The CANRPT VSE.SVC.STAT command expands as follows:
CANRPT VSE.SVC.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS VSE
*
+*
SVC INFORMATION
*
+*-----------------------------------------*
+TITLE2 SVC STATISTICS
+TAB
SVCID SORT ALPHA VSE SVC HEXCODE
AND,
+
VSE SVC NAME
AND,
+
VSE SVC DESCRIPTION
AND,
+
VSE SVC COUNT
AND,
+
VSE SVC COUNT PCT
AND,
+
VSE SVC COUNT RATE HDR2(RATE)
+ERPT237I END OF UNCAN EXPANSION
122 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.SVC.STAT command generates a report like the following:
SVC
CODE
-------000
001
002
003
004
005
006
007
008
009
010
011
012
013
014
015
016
017
018
019
020
021
022
024
025
026
029
030
033
034
036
037
038
039
040
041
042
044
046
048
049
051
052
053
057
058
060
061
062
065
.
.
.
-------SUMMARY
--------
SVC
ID (HEX)
-------X'00'
X'01'
X'02'
X'03'
X'04'
X'05'
X'06'
X'07'
X'08'
X'09'
X'0A'
X'0B'
X'0C'
X'0D'
X'0E'
X'0F'
X'10'
X'11'
X'12'
X'13'
X'14'
X'15'
X'16'
X'18'
X'19'
X'1A'
X'1D'
X'1E'
X'21'
X'22'
X'24'
X'25'
X'26'
X'27'
X'28'
X'29'
X'2A'
X'2C'
X'2E'
X'30'
X'31'
X'33'
X'34'
X'35'
X'39'
X'3A'
X'3C'
X'3D'
X'3E'
X'41'
.
.
.
--------
SVC
SVC
SVC
SVC
SVC
NAME
DESCRIPTION
COUNT
% COUNT
RATE
-------- --------------------------------------------- ---------- -------- -------EXCP
EXECUTE CHANNEL PROGRAM
2,094,675
9.0
5.33
FETCH
FETCH NON-$$B PHASE
6
0.0
0.00
FETCH $$B PHASE
40,468
0.2
0.10
QUIESCE I/O
647
0.0
0.00
LOAD
LOAD PHASE
69,922
0.3
0.18
MVCOM
MODIFY COMREG OR FETCH $$A PHASE
641
0.0
0.00
CANCEL
CANCEL A PROBLEM PROGRAM OR A TASK
4
0.0
0.00
WAIT
WAIT FOR THE POSTING OF CCB OR TECB
3,041,341
13.1
7.73
PASS CONTROL FROM $$B-TRANSIENT
6
0.0
0.00
LBRET
RETURN TO A $$B-TRANSIENT
6
0.0
0.00
SETIME
SET INTERVAL TIMER
663,607
2.9
1.69
RETURN FROM A $$B-TRANSIENT
18,500
0.1
0.05
RESET COMREG SWITCHES
2,117,400
9.1
5.38
SET COMREG SWITCHES
2,245,230
9.7
5.71
EOJ
END A JOB
812
0.0
0.00
SYSIO
HEADQUEUE AN I/O AND EXCP
180,836
0.8
0.46
STXIT PC ESTABLISH PROGRAM CHECK EXIT
52
0.0
0.00
EXIT PC RETURN FROM PROGRAM CHECK EXIT
4
0.0
0.00
STXIT IT ESTABLISH INTERVAL TIMER EXIT
11
0.0
0.00
EXIT IT RETURN FROM INTERVAL TIMER EXIT
398,686
1.7
1.01
STXIT OC ESTABLISH OPERATOR COMMAND EXIT
1,173
0.0
0.00
EXIT OC RETURN FROM OPERATOR COMMAND EXIT
8
0.0
0.00
SEIZE/RELEASE THE SYSTEM
139,703
0.6
0.36
SETIME
ESTABLISH LINKAGE TO A TIMER EVENT
2,219,623
9.6
5.64
ISSUE HALT IO FOR A DEVICE
18
0.0
0.00
VALIDATE ADDRESS LIMITS
3,083
0.0
0.01
WAITM
WAIT ON MULTIPLE EVENTS
4,871,573
21.0
12.39
1E UNKNOWN
13
0.0
0.00
FORCE TASK SELECTION
899,002
3.9
2.29
GETIME
GET THE TIME OF DAY
95,021
0.4
0.24
FREE
FREE A HELP TRACK
647
0.0
0.00
STXIT AB ESTABLISH ABNORMAL TERMINATION EXIT
1,419
0.0
0.00
ATTACH
INITIALIZE A SUBTASK
162
0.0
0.00
DETACH
TERMINATE A SUBTASK
165
0.0
0.00
POST
POST EVENT COMPLETED
79,663
0.3
0.20
DEQ
DEQUEUE A RESOURCE
138
0.0
0.00
ENQ
ENQUEUE A RESOURCE
138
0.0
0.00
CREATE A UNIT CHECK RECORD
3
0.0
0.00
ALLOW OLTEP TO RUN IN SUPERVISOR STATE
145,968
0.6
0.37
FETCH A CRT-TRANSIENT
83,500
0.4
0.21
ALLOW VTAM EXCP
2,649
0.0
0.01
RETRIEVE PHASE DIRECTORY INFO
1,134
0.0
0.00
TTIMER
RETRIEVE OR CANCEL A TIME INTERVAL
43,876
0.2
0.11
ALLOW VTAM TO SCHEDULE A USER EXIT
191,712
0.8
0.49
SETPRTY RETRIEVE OR SET PARTITION PRIORITIES
3,475
0.0
0.01
INVPART ACQUIRE ADDESS SPACE
1,090
0.0
0.00
GETDADR RETURN ADDR OF IO AREA
77,895
0.3
0.20
GETVIS
GETVIS REQUEST FOR STORAGE
1,205,450
5.2
3.06
FREEVIS FREEVIS RELEASE OF STORAGE
1,171,907
5.1
2.98
CDLOAD
LOAD A PHASE INTO THE GETVIS AREA
58,841
0.3
0.15
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
-------- --------------------------------------------- ---------- -------- -------23,196,720 100.0
58.98
-------- -------- --------------------------------------------- ---------- -------- --------
Chapter 5: Canned Reports 123
Canned Report Descriptions
VSE.SYSCPU.BUSYR.STAT Report
The VSE.SYSCPU.BUSYR.STAT report displays real CPU activity based on realtime system statistics. The data collection interval is based on SYSTIMEI.
The following commands generate a VSE.SYSCPU.BUSYR.STAT report:
CANRPT VSE.SYSCPU.BUSYR.STAT
EACH HOUR
END
RUN
124 Report Reference Guide
Canned Report Descriptions
The VSE.SYSCPU.BUSYR.STAT command expands as follows:
CANRPT VSE.SYSCPU.BUSYR.STAT
Chapter 5: Canned Reports 125
Canned Report Descriptions
ERPT237I CANNED REPORT EXPANSION
+*--------------------------------------------------*
+* Display the real CPU utilization distribution.
*
+* The data used to create this report is extracted *
+* from the SYSTEM record and is collected based on *
+* SYSTIMEI.
*
+*--------------------------------------------------*
+TITLE2 Real CPU utilization distribution
+TITLE3 15 minute intervals
+RANGE VSE CPU %BUSYR 0-10
ID RCPU00
+RANGE VSE CPU %BUSYR 10-20
ID RCPU10
+RANGE VSE CPU %BUSYR 20-30
ID RCPU20
+RANGE VSE CPU %BUSYR 30-40
ID RCPU30
+RANGE VSE CPU %BUSYR 40-50
ID RCPU40
+RANGE VSE CPU %BUSYR 50-60
ID RCPU50
+RANGE VSE CPU %BUSYR 60-70
ID RCPU60
+RANGE VSE CPU %BUSYR 70-80
ID RCPU70
+RANGE VSE CPU %BUSYR 80-90
ID RCPU80
+RANGE VSE CPU %BUSYR 90+
ID RCPU90
+DEFINE VAR VSE CPU REAL%0-10
+
+
= ,
( VSE COUNT ESMFSYS RANGE(RCPU00) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU REAL%10-20 = ,
+
+
( VSE COUNT ESMFSYS RANGE(RCPU10) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU REAL%20-30 = ,
+
+
( VSE COUNT ESMFSYS RANGE(RCPU20) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU REAL%30-40 = ,
+
+
( VSE COUNT ESMFSYS RANGE(RCPU30) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU REAL%40-50 = ,
+
+
( VSE COUNT ESMFSYS RANGE(RCPU40) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU REAL%50-60 = ,
+
+
( VSE COUNT ESMFSYS RANGE(RCPU50) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU REAL%60-70 = ,
+
+
( VSE COUNT ESMFSYS RANGE(RCPU60) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU REAL%70-80 = ,
+
+
( VSE COUNT ESMFSYS RANGE(RCPU70) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU REAL%80-90 = ,
+
+
( VSE COUNT ESMFSYS RANGE(RCPU80) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU REAL%90+
+
126 Report Reference Guide
= ,
( VSE COUNT ESMFSYS RANGE(RCPU90) * 100 ) / ,
Canned Report Descriptions
+
VSE COUNT ESMFSYS
+TAB DATETIME,
+
VSE CPU %BUSYR HDR1(TOTAL) HDR2(%CPU) AND,
+
VSE CPU %BUSYR MAX HDR1(MAX) HDR2(%CPU) AND,
+
VSE CPU %BUSYR MAXTIME,
+
FORMAT(5C) HDR1(MAXTIME) HDR2(OCCURED) AND,
+
VSE CPU REAL%0-10
+
VSE CPU REAL%10-20 HDR1(%CPU) HDR2(10-20%) AND,
HDR1(%CPU) HDR2(0-10%)
AND,
+
VSE CPU REAL%20-30 HDR1(%CPU) HDR2(20-30%) AND,
+
VSE CPU REAL%30-40 HDR1(%CPU) HDR2(30-40%) AND,
+
VSE CPU REAL%40-50 HDR1(%CPU) HDR2(40-50%) AND,
+
VSE CPU REAL%50-60 HDR1(%CPU) HDR2(50-60%) AND,
+
VSE CPU REAL%60-70 HDR1(%CPU) HDR2(60-70%) AND,
+
VSE CPU REAL%70-80 HDR1(%CPU) HDR2(70-80%) AND,
+
VSE CPU REAL%80-90 HDR1(%CPU) HDR2(80-90%) AND,
+
VSE CPU REAL%90+
HDR1(%CPU) HDR2(90-100%)
+ERPT237I END OF UNCAN EXPANSION
The VSE.SYSCPU.BUSYR.STAT command generates a report like the following:
DATE
-------08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
-------PERIOD
--------
TOTAL
MAX
MAXTIME
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
TIME
%CPU
%CPU
OCCURED 0-10%
10-20%
20-30%
30-40%
40-50%
50-60%
60-70%
70-80%
80-90% 90-100%
----- -------- -------- ------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -----08.00
63.4
68.9
08.45
0
0
0
0
0
25
75
0
0
0
09.00
70.1
75.7
09.15
0
0
0
0
0
0
50
50
0
0
10.00
63.5
72.7
10.00
0
0
0
0
0
50
25
25
0
0
11.00
67.4
71.1
11.30
0
0
0
0
0
0
75
25
0
0
12.00
50.0
59.9
12.00
0
0
0
25
0
75
0
0
0
0
13.00
36.0
62.5
13.00
0
0
50
25
0
0
25
0
0
0
14.00
26.2
34.6
14.45
0
25
50
25
0
0
0
0
0
0
15.00
18.4
23.3
15.00
0
75
25
0
0
0
0
0
0
0
16.00
14.3
25.7
16.00
25
50
25
0
0
0
0
0
0
0
----- -------- -------- ------- -------- -------- -------- -------- -------- -------- -------- -------- -------- ------45.5
75.7
09.15
3
17
17
8
0
17
28
11
0
0
----- -------- -------- ------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------
VSE.SYSCPU.BUSYV.STAT Report
The VSE.SYSCPU.BUSYV.STAT report displays virtual CPU activity based on
real-time system statistics. The data collection interval is based on SYSTIMEI.
The following commands generate a VSE.SYSCPU.BUSYV.STAT report:
CANRPT VSE.SYSCPU.BUSYV.STAT
EACH HOUR
END
RUN
Chapter 5: Canned Reports 127
Canned Report Descriptions
The VSE.SYSCPU.BUSYV.STAT command expands as follows:
CANRPT VSE.SYSCPU.BUSYV.STAT
128 Report Reference Guide
Canned Report Descriptions
ERPT237I CANNED REPORT EXPANSION
+*--------------------------------------------------*
+* Display the virtual CPU utilization distribution.*
+* The data used to create this report is extracted *
+* from the SYSTEM record and is collected based on *
+* SYSTIMEI.
*
+*--------------------------------------------------*
+TITLE2 Virtual CPU utilization distribution
+TITLE3 15 minute intervals
+RANGE VSE CPU %BUSYV 0-10
ID VCPU00
+RANGE VSE CPU %BUSYV 10-20
ID VCPU10
+RANGE VSE CPU %BUSYV 20-30
ID VCPU20
+RANGE VSE CPU %BUSYV 30-40
ID VCPU30
+RANGE VSE CPU %BUSYV 40-50
ID VCPU40
+RANGE VSE CPU %BUSYV 50-60
ID VCPU50
+RANGE VSE CPU %BUSYV 60-70
ID VCPU60
+RANGE VSE CPU %BUSYV 70-80
ID VCPU70
+RANGE VSE CPU %BUSYV 80-90
ID VCPU80
+RANGE VSE CPU %BUSYV 90+
ID VCPU90
+DEFINE VAR VSE CPU VIRT%0-10
+
+
= ,
( VSE COUNT ESMFSYS RANGE(VCPU00) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU VIRT%10-20 = ,
+
+
( VSE COUNT ESMFSYS RANGE(VCPU10) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU VIRT%20-30 = ,
+
+
( VSE COUNT ESMFSYS RANGE(VCPU20) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU VIRT%30-40 = ,
+
+
( VSE COUNT ESMFSYS RANGE(VCPU30) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU VIRT%40-50 = ,
+
+
( VSE COUNT ESMFSYS RANGE(VCPU40) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU VIRT%50-60 = ,
+
+
( VSE COUNT ESMFSYS RANGE(VCPU50) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU VIRT%60-70 = ,
+
+
( VSE COUNT ESMFSYS RANGE(VCPU60) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU VIRT%70-80 = ,
+
+
( VSE COUNT ESMFSYS RANGE(VCPU70) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU VIRT%80-90 = ,
+
+
( VSE COUNT ESMFSYS RANGE(VCPU80) * 100 ) / ,
VSE COUNT ESMFSYS
+DEFINE VAR VSE CPU VIRT%90+
+
= ,
( VSE COUNT ESMFSYS RANGE(VCPU90) * 100 ) / ,
Chapter 5: Canned Reports 129
Canned Report Descriptions
+
VSE COUNT ESMFSYS
+TAB DATETIME,
+
VSE CPU %BUSYV HDR1(TOTAL) HDR2(%CPU) AND,
+
VSE CPU %BUSYV MAX HDR1(MAX) HDR2(%CPU) AND,
+
VSE CPU %BUSYV MAXTIME,
+
FORMAT(5C) HDR1(MAXTIME) HDR2(OCCURED) AND,
+
VSE CPU VIRT%0-10
+
VSE CPU VIRT%10-20 HDR1(%CPU) HDR2(10-20%) AND,
HDR1(%CPU) HDR2(0-10%)
AND,
+
VSE CPU VIRT%20-30 HDR1(%CPU) HDR2(20-30%) AND,
+
VSE CPU VIRT%30-40 HDR1(%CPU) HDR2(30-40%) AND,
+
VSE CPU VIRT%40-50 HDR1(%CPU) HDR2(40-50%) AND,
+
VSE CPU VIRT%50-60 HDR1(%CPU) HDR2(50-60%) AND,
+
VSE CPU VIRT%60-70 HDR1(%CPU) HDR2(60-70%) AND,
+
VSE CPU VIRT%70-80 HDR1(%CPU) HDR2(70-80%) AND,
+
VSE CPU VIRT%80-90 HDR1(%CPU) HDR2(80-90%) AND,
+
VSE CPU VIRT%90+
HDR1(%CPU) HDR2(90-100%)
+ERPT237I END OF UNCAN EXPANSION
The VSE.SYSCPU.BUSYV.STAT command generates a report like the following:
DATE
-------08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
08/12/04
-------PERIOD
--------
TOTAL
MAX
TIME
%CPU
%CPU
----- -------- -------08.00
85.3
95.7
09.00
99.2
99.6
10.00
84.7
95.0
11.00
89.0
96.4
12.00
64.8
75.8
13.00
46.7
82.7
14.00
31.4
39.7
15.00
19.0
24.4
16.00
14.9
27.8
----- -------- -------56.4
99.6
----- -------- --------
MAXTIME
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
%CPU
OCCURED 0-10%
10-20%
20-30%
30-40%
40-50%
50-60%
60-70%
70-80%
80-90% 90-100%
------- -------- -------- -------- -------- -------- -------- -------- -------- -------- ------08.45
0
0
0
0
0
0
0
50
0
50
09.00
0
0
0
0
0
0
0
0
0
100
10.00
0
0
0
0
0
0
0
50
0
50
11.15
0
0
0
0
0
0
0
0
50
50
12.00
0
0
0
0
25
0
25
50
0
0
13.00
0
0
50
0
0
25
0
0
25
0
14.45
0
0
50
50
0
0
0
0
0
0
15.00
0
75
25
0
0
0
0
0
0
0
16.00
25
50
25
0
0
0
0
0
0
0
------- -------- -------- -------- -------- -------- -------- -------- -------- -------- ------09.00
3
14
17
6
3
3
3
17
8
28
------- -------- -------- -------- -------- -------- -------- -------- -------- -------- -------
VSE.SYSTEM.STAT Report
The VSE.SYSTEM.STAT report displays system activity such as CPU, paging,
and disk activity. Include the EACH HOUR command to limit the report to
hourly statistics.
The following commands generate a VSE.SYSTEM.STAT report:
CANRPT VSE.SYSTEM.STAT
EACH HOUR
FROM 05/07/04 06:00:00
TO
END
RUN
130 Report Reference Guide
05/07/04 22:00:00
Canned Report Descriptions
The CANRPT VSE.SYSTEM.STAT command expands as follows:
CANRPT VSE.SYSTEM.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS
*
+*
SYSTEM VARIABLES
*
+*-----------------------------------------*
+TITLE2 VSE SYSTEM STATISTICS
+TAB DATETIME VSE CPU BUSYVIRT XTIME
AND,
+
VSE CPU %BUSYVIRT
AND,
+
VSE CPU %PROBLEM
AND,
+
VSE CPU %SUPERVISOR
AND,
+
VSE PAGE FAULTS RATE,
+
HDR1(P-FAULT) HDR2(RATE)
+
VSE PAGE IN RATE,
+
HDR1(PAGE IN) HDR2(RATE)
+
VSE PAGE OUT RATE,
+
HDR1(PAGE OUT) HDR2(RATE)
+
VSE DEVICE SIO,
+
HDR1(TOTAL) HDR2(IO)
+
VSE DEVICE SIO RATE,
+
HDR1(TOT-IO) HDR2(RATE)
AND,
+
VSE DISK SIO HDR1(DISK) HDR2(IO)
AND,
+
VSE DISK SIO RATE,
+
HDR1(DISK-IO) HDR2(RATE)
+
VSE DISK SERVTIME,
+
HDR1(DISK) HDR2(SERVTIME)
AND,
AND,
AND,
AND,
AND,
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.SYSTEM.STAT command generates a report like the
following:
DATE
-------05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
05/07/04
-------PERIOD
--------
TIME
----07.00
08.00
09.00
10.00
11.00
12.00
13.00
14.00
15.00
16.00
17.00
18.00
19.00
20.00
21.00
---------
VIRTUAL
VIRTUAL %PROBLEM %SUPVSOR
CPU
%CPU
STATE
STATE
-------- -------- -------- -------00:00:20
0.5
0.7
0.1
00:00:32
0.9
1.0
0.2
00:00:56
1.6
2.3
0.6
00:01:16
2.1
3.4
0.7
00:01:44
3.3
5.4
1.1
00:01:19
2.3
4.2
1.1
00:01:22
2.3
4.2
0.8
00:01:38
3.5
7.2
1.4
00:01:59
3.5
7.4
0.8
00:01:26
2.5
5.0
0.7
00:01:32
2.6
4.1
0.6
00:00:45
1.3
2.2
0.2
00:00:27
0.8
1.3
0.1
00:00:32
0.9
1.5
0.2
00:00:25
0.7
1.2
0.1
-------- -------- -------- -------00:16:12
1.9
3.4
0.6
-------- -------- -------- --------
P-FAULT
RATE
-------0.08
0.48
1.13
1.66
2.61
1.45
1.36
2.49
1.55
1.36
1.20
0.31
0.13
0.14
0.07
-------1.04
--------
PAGE IN
RATE
-------0.00
0.00
0.06
0.05
0.00
0.00
0.00
0.04
0.00
0.00
0.07
0.01
0.00
0.00
0.00
-------0.02
--------
PAGE OUT
TOTAL
TOT-IO
DISK
RATE
IO
RATE
IO
-------- ---------- -------- ---------0.00
3,226
0.90
2,975
0.01
12,488
3.47
11,181
0.08
30,234
8.40
26,047
0.06
44,290 12.31
38,103
0.00
84,501 25.25
74,741
0.00
66,676 18.54
59,675
0.00
71,372 19.84
65,039
0.06
79,296 26.41
68,793
0.00
108,565 30.18
93,135
0.00
82,847 23.03
72,135
0.08
89,477 24.88
85,638
0.02
39,333 10.94
37,855
0.00
18,410
5.12
18,222
0.00
31,924
8.88
31,659
0.00
18,315
5.09
18,139
-------- ---------- -------- ---------0.02
780,954 14.70
703,337
-------- ---------- -------- ----------
DISK-IO
RATE
-------0.83
3.11
7.24
10.59
22.33
16.59
18.08
22.99
25.89
20.05
23.81
10.53
5.06
8.80
5.04
-------13.24
--------
DISK
SERVTIME
-------0.021
0.023
0.026
0.027
0.031
0.032
0.028
0.033
0.031
0.025
0.022
0.020
0.019
0.022
0.018
-------0.027
--------
Chapter 5: Canned Reports 131
Canned Report Descriptions
VSE.THRESHOLD.LOG.STAT
You set the performance thresholds for CA Explore PM for z/VSE. The
VSE.THRESHOLD.LOG.STAT report displays information about the performance
thresholds that have triggered.
The following commands generate a VSE.THRESHOLD.LOG.STAT report:
CANRPT VSE.THRESHOLD.LOG.STAT
END
RUN
The CANRPT VSE.THRESHOLD.LOG.STAT command expands as follows:
CANRPT VSE.THRESHOLD.LOG.STAT
ERPT237I CANNED REPORT EXPANSION
+*-------------------------------------------*
+* DISPLAY A LIST OF ALL VSE THRESHOLDS
*
+* IN CHRONOLOGICAL ORDER
*
+*-------------------------------------------*
+TITLE2 THRESHOLD LOG
+TAB ENDTIME FORMAT(0C),
+
VSE THRESHOLD DATE SORT ASCENDING
AND,
+
VSE THRESHOLD TIME XTIMEM
AND,
+
VSE THRESHOLD NAME RIGHT(3)
AND,
+
VSE THRESHOLD TYPE
AND,
+
VSE THRESHOLD CLASS
AND,
+
VSE THRESHOLD LIMIT HDR1() RIGHT(3) AND,
+
VSE THRESHOLD VALUE HDR1()
AND,
+
VSE THRESHOLD RESOURCE RIGHT(3)
AND,
+
VSE THRESHOLD JOBNAME
AND,
+
VSE THRESHOLD STEPNAME
AND,
+
VSE THRESHOLD PID
AND,
+
VSE THRESHOLD TASKNAME
AND,
+
VSE THRESHOLD TID
+ERPT237I END OF UNCAN EXPANSION
132 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.THRESHOLD.LOG.STAT command generates a report like the
following:
DATE
-------02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
02/16/04
TIME
-----------11.08.24.143
11.09.23.912
12.46.03.586
12.46.57.063
12.47.04.403
12.48.01.027
12.49.21.767
13.01.20.041
13.02.05.130
13.02.24.005
13.02.34.490
13.03.23.773
15.20.09.929
17.42.42.115
17.45.01.576
17.46.03.442
NAME
-------SCPUBUSY
SCPUBUSY
PCPUBUSY
PCPUBUSY
PCPUBUSY
PCPUBUSY
PCPUBUSY
PCPUBUSY
PCPUBUSY
PCPUBUSY
PCPUBUSY
PCPUBUSY
PCPUBUSY
SDEVIO
SCPUBUSY
SDEVIO
TYPE
----UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
UPPER
CLASS LIMIT
VALUE
RSCS
JOBNAME STEPNAME PID TASKNAME TID
----- -------- -------- -------- -------- -------- --- -------- ---PCT
5
6
PCT
5
9
PCT
5
12
EVSETEST EVSETEST EVSESBAT W1
0032
PCT
5
11
POWSTART POWSTART AXPL9
F1
0022
PCT
5
5
EVSETEST EVSETEST EVSESBAT W1
0032
PCT
5
7
POWSTART POWSTART AXPL9
F1
0022
PCT
5
5
POWSTART POWSTART AXPL9
F1
0022
PCT
5
14
CICSICCF CICSICCF DFHSIP
F2
0023
PCT
5
5
SYSTEM
SYSTEM
SYSSTEP AR
0020
PCT
5
8
CICSICCF CICSICCF DFHSIP
F2
0023
PCT
5
6
IBMTAPE IBMTAPE MSHP
F8
0029
PCT
5
5
CICSICCF CICSICCF DFHSIP
F2
0023
PCT
5
5
POWSTART POWSTART AXPL9
F1
0022
RATE
10
11
022D
PCT
5
16
RATE
10
67
022B
VSE.THRESHOLD.STAT Report
The VSE.THRESHOLD.STAT report displays information about the CA Explore
PM for z/VSE performance thresholds you have set from the online Configure
Thresholds panel.
The following commands generate a VSE.THRESHOLD.STAT report:
CANRPT VSE.THRESHOLD.STAT
END
RUN
Chapter 5: Canned Reports 133
Canned Report Descriptions
The CANRPT VSE.THRESHOLD.STAT command expands as follows:
CANRPT VSE.THRESHOLD.STAT
ERPT237I CANNED REPORT EXPANSION
+*-------------------------------------------*
+* DISPLAY IN TABULAR FORMAT ALL VSE
*
+* THRESHOLDS AND CORRESPONDING RESOURCES
*
+*-------------------------------------------*
+TITLE2 THRESHOLD STATISTICS
+TAB
THRSID
VSE THRESHOLD RESOURCE AND,
+
VSE THRESHOLD TYPE
AND,
+
VSE THRESHOLD CLASS
AND,
+
VSE THRESHOLD COUNT
AND,
+
VSE THRESHOLD LIMIT
AND,
+
VSE THRESHOLD VALUE
AND,
+
VSE THRESHOLD MAXVALUE AND,
+
VSE THRESHOLD MINVALUE
+TAB2 TRSCEID VSE THRESHOLD COUNT
AND,
+
VSE THRESHOLD VALUE
AND,
+
VSE THRESHOLD MAXVALUE AND,
+
VSE THRESHOLD MINVALUE
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.THRESHOLD.STAT command generates a report like the
following:
THRSHOLD
THRSHOLD THRSHOLD THRSHOLD THRSHOLD THRSHOLD THRSHOLD
ID
RSCS
TYPE CLASS COUNT
LIMIT
VALUE
MAXVALUE MINVALUE RESOURCE
-------- -------- ----- ----- -------- -------- -------- -------- -------- -------PDIO
UPPER RATE
16
5
9
22
5
0121
0351
0350
000F
SUMMARY
PDSVDISK
UPPER TIME
14
150
4696
33416
157
0350
0121
0351
SUMMARY
PDSV
UPPER TIME
9
300
3392
13964
341
0281
0081
0280
001F
0121
SUMMARY
SDEVSERV
UPPER TIME
5
200
370
795
231
0281
001F
0081
0EDE
SUMMARY
SCHANIO
UPPER RATE
5
20
27
32
24
03
SDEVIO
UPPER RATE
3
15
22
23
21
0351
0350
SUMMARY
SPAGEIO
UPPER COUNT
2
20
38
38
38
PCPUBUSY
UPPER PCT
1
40
40
40
40
IPWPOWER
TCPUBUSY
UPPER PCT
1
40
40
40
40
AXPL9
-------- -------- ----- ----- -------- -------- -------- -------- -------- -------SUMMARY
56
300
1761
33416
5
-------- -------- ----- ----- -------- -------- -------- -------- -------- --------
134 Report Reference Guide
THRSHOLD THRSHOLD THRSHOLD THRSHOLD
COUNT
VALUE
MAXVALUE MINVALUE
-------- -------- -------- -------6
6
9
5
4
15
22
6
3
10
15
5
3
10
12
7
16
9
22
5
11
5901
33416
359
2
322
488
157
1
192
192
192
14
4696
33416
157
4
3649
10595
404
2
341
341
341
1
13964
13964
13964
1
797
797
797
1
488
488
488
9
3392
13964
341
2
231
231
231
1
795
795
795
1
341
341
341
1
253
253
253
5
370
795
231
5
27
32
24
2
22
23
21
1
23
23
23
3
22
23
21
2
38
38
38
1
40
40
40
1
40
40
40
-------- -------- -------- --------------- -------- -------- --------
Canned Report Descriptions
VSE.VERSION4.DATA Report
The CANRPT VSE.VERSION4.DATA command generates a number of tabular,
graph, and plot reports with data from CA Explore PM for z/VSE Version 4.
You must use the INPUT(TAPV4xx) command to run this report.
The following commands generate a VSE.VERSION4.DATA report:
CANRPT VSE.VERSION4.DATA
END
RUN
Chapter 5: Canned Reports 135
Canned Report Descriptions
The CANRPT VSE.VERSION4.DATA command expands as follows:
CANRPT VSE.VERSION4.DATA
136 Report Reference Guide
Canned Report Descriptions
ERPT237I CANNED REPORT EXPANSION:
+*--------------------------------------------------*
+*
THE FOLLOWING REPORTS CAN BE GENERATED WITH
*
+*
CA-EXPLORE FOR VSE VERSION 4.XX DATA
*
+*
IE...INPUT(TAPV4XX)
*
+*--------------------------------------------------*
+TITLE3 PAGE IO (IN/OUT) COUNTS BY PARTITION
+GRAF VSE PAGE FAULTS PID
+END
+TITLE3 SIO COUNTS BY PARTITION
+GRAF VSE OTHER IO
PID
+END
+TAB PID VSE CPU %BUSYS,
+HDR1(----------) HDR2(CPU ACTIVE)
AND,
+VSE CPU %WAITS,
+HDR1(-----------) HDR2(WAIT ON CPU) AND,
+VSE PAGE FAULTS,
+HDR1(------------) HDR2(PAGE
IN/OUT) AND,
+VSE OTHER IO,
+HDR1(---------------) HDR2(SUCCESSFUL SIOS)
+END
+TAB JOBID VSE CPU %BUSYS,
+HDR1(----------) HDR2(CPU ACTIVE)
AND,
+VSE CPU %WAITS,
+HDR1(-----------) HDR2(WAIT ON CPU) AND,
+VSE PAGE FAULTS,
+HDR1(------------) HDR2(PAGE
IN/OUT) AND,
+VSE OTHER IO,
+HDR1(---------------) HDR2(SUCCESSFUL SIOS)
+END
+TITLE3 PAGE IO (IN/OUT) COUNTS BY JOB
+GRAF VSE PAGE FAULTS JOBID
+END
+TITLE3 SIO COUNTS BY JOB
+GRAF VSE OTHER IO JOBID
+END
+TAB DATETIME VSE CPU %BUSYS
AND,
+
VSE CPU %WAITS
AND,
+
VSE CPU %PROBLEM
AND,
+
VSE CPU %SUPERVISOR AND,
+
VSE PAGE IN
AND,
+
VSE PAGE IN
RATE HDR1(PAGE-IN)
+
VSE PAGE OUT
AND,
+
VSE PAGE OUT RATE HDR1(PAGE-OUT) HDR2(RATE) AND,
+
VSE PAGE IO
+
VSE PAGE IO
HDR2(RATE) AND,
AND,
RATE HDR1(PAGE-IO) HDR2(RATE)
+END
+TAB DATETIME VSE CHANNEL SIO AND,
Chapter 5: Canned Reports 137
Canned Report Descriptions
+
VSE CHANNEL SIO RATE HDR2(RATE)
+END
+TAB CHNID VSE CHANNEL BUSY AND VSE CHANNEL SIO
+END
+TAB CPUID VSE CPU %BUSYS AND VSE PAGE IO AND,
+VSE CHANNEL SIO AND VSE CHANNEL BUSY
+END
+TAB CPUMOD VSE CPU %BUSYS AND VSE PAGE IO AND,
+VSE CHANNEL SIO AND VSE CHANNEL BUSY
+END
+
+TITLE3 CHANNEL 00 UTILIZATION
+PLOT VSE CHANNEL BUSY CHNID(00) CHAR1(0) ALONE
+END
+TITLE3 CHANNEL 01 UTILIZATION
+PLOT VSE CHANNEL BUSY CHNID(01) CHAR1(1) ALONE
+END
+TITLE3 CHANNEL 02 UTILIZATION
+PLOT VSE CHANNEL BUSY CHNID(02) CHAR1(2) ALONE
+END
+TITLE3 CHANNEL 03 UTILIZATION
+PLOT VSE CHANNEL BUSY CHNID(03) CHAR1(3) ALONE
+END
+TITLE3 CHANNEL 04 UTILIZATION
+PLOT VSE CHANNEL BUSY CHNID(04) CHAR1(4) ALONE
+END
+TITLE3 CHANNEL 05 UTILIZATION
+PLOT VSE CHANNEL BUSY CHNID(05) CHAR1(5) ALONE
+END
+TITLE3 CHANNEL 00 SIO COUNT
+PLOT VSE CHANNEL SIO CHNID(00) CHAR1(0) ALONE
+END
+TITLE3 CHANNEL 01 SIO COUNT
+PLOT VSE CHANNEL SIO CHNID(01) CHAR1(1) ALONE
+END
+TITLE3 CHANNEL 02 SIO COUNT
+PLOT VSE CHANNEL SIO CHNID(02) CHAR1(2) ALONE
+END
+TITLE3 CHANNEL 03 SIO COUNT
+PLOT VSE CHANNEL SIO CHNID(03) CHAR1(3) ALONE
+END
+TITLE3 CHANNEL 04 SIO COUNT
+PLOT VSE CHANNEL SIO CHNID(04) CHAR1(4) ALONE
+END
+TITLE3 CHANNEL 05 SIO COUNT
+PLOT VSE CHANNEL SIO CHNID(05) CHAR1(5) ALONE
+END
+PLOT VSE CPU %ACTIVESAMPLE
+END
138 Report Reference Guide
Canned Report Descriptions
+PLOT
VSE CPU %SUPERVISOR CHAR2(S)
+PLOT2 VSE CPU %PROBLEM CHAR2(P)
+END
+PLOT
VSE PAGE IN
CHAR2(I)
+PLOT2 VSE PAGE OUT CHAR2(O) SCALE(COMMON)
+END
+TITLE2 VSE PAGE IN / OUT RATES
+PLOT
VSE PAGE IN
RATE CHAR2(I) SCALE(1.00)
+PLOT2 VSE PAGE OUT RATE CHAR2(O) SCALE(1.00)
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.VERSION4.DATA command generates a report too large to
display here.
VSE.VM.CPU.STAT
The VSE.VM.CPU.STAT report displays VM CPU statistics sorted by time and
VM machine ID.
The following commands generate a VSE.VM.CPU.STAT report:
CANRPT VSE.VM.CPU.STAT
EACH 15 MINUTES
END
RUN
The VSE.VM.CPU.STAT command expands as follows:
CANRPT VSE.VM.CPU.STAT
ERPT237I CANNED REPORT EXPANSION
+*--------------------------------------------------*
+* DISPLAY VARIOUS VM CPU STATISTICS ORGANIZED BY
*
+* VM MACHINE ID.
*
+*--------------------------------------------------*
+TITLE2 VM CPU STATISTICS
+TAB TIME VMID VSE VM PROCESSORS AND,
+
VSE VM VTIME
AND,
+
VSE VM %VTIME
AND,
+
VSE VM STIME
AND,
+
VSE VM %STIME
AND,
+
VSE VM TTIME
AND,
+
VSE VM %TTIME
+ERPT237I END OF UNCAN EXPANSION
Chapter 5: Canned Reports 139
Canned Report Descriptions
The VSE.VM.CPU.STAT command generates a report like the following:
TIME
----10.00
--------10.15
--------10.30
--------10.45
---------
MACHINE
ID
-------VM TOTAL
DEVTST2
-------SUMMARY
-------VM TOTAL
DEVTST2
-------SUMMARY
-------VM TOTAL
DEVTST2
-------SUMMARY
-------VM TOTAL
DEVTST2
-------SUMMARY
--------
#OF
CPUS
-------4
4
-------4
-------4
4
-------4
-------4
4
-------4
-------4
4
-------4
--------
VM
VTIME
-------00:34:02
00:00:15
-------00:34:17
-------00:38:09
00:00:24
-------00:38:33
-------00:41:39
00:00:23
-------00:42:02
-------00:40:11
00:00:09
-------00:40:21
--------
VM
%VTIME
-------227.0
1.7
-------114.3
-------254.3
2.7
-------128.5
-------277.8
2.6
-------140.2
-------267.7
1.0
-------134.3
--------
VM
STIME
-------00:17:43
00:00:04
-------00:17:46
-------00:20:25
00:00:09
-------00:20:35
-------00:17:28
00:00:04
-------00:17:33
-------00:18:55
00:00:02
-------00:18:56
--------
VM
%STIME
-------118.1
0.4
-------59.3
-------136.2
1.0
-------68.6
-------116.6
0.5
-------58.5
-------125.9
0.2
-------63.1
--------
VM
TTIME
-------00:51:45
00:00:19
-------00:52:03
-------00:58:34
00:00:34
-------00:59:08
-------00:59:07
00:00:28
-------00:59:35
-------00:59:06
00:00:11
-------00:59:17
--------
VM
%TTIME
-------345.1
2.1
-------173.6
-------390.5
3.7
-------197.1
-------394.3
3.1
-------198.7
-------393.6
1.2
-------197.4
--------
VSE.XA.DEVICE.STAT Report
The VSE.XA.DEVICE.STAT report displays information about all active disk
devices.
Use the VSE.XA.DEVICE.STAT report only if you are using CA Explore PM for
z/VSE to monitor devices that support the XA I/O channel monitoring
subsystem.
The following commands generate a VSE.XA.DEVICE.STAT report:
CANRPT VSE.XA.DEVICE.STAT
EACH HOUR
FROM 09/24/03
TO
09/24/03
SHIFT 08:00:00 12:00:00
END
RUN
140 Report Reference Guide
Canned Report Descriptions
The CANRPT VSE.XA.DEVICE.STAT command expands as follows:
CANRPT VSE.XA.DEVICE.STAT
ERPT237I CANNED REPORT EXPANSION
+*-----------------------------------------*
+*
DISPLAY IN TABULAR FORMAT VARIOUS XA
+*
INFORMATION ON ALL ACTIVE DISK DEVICES *
*
+*-----------------------------------------*
+TITLE2 XA DEVICE STATISTICS
+TAB DATETIME VOLSER DISKID,
+
VSE DISK XA-SSCH
AND,
+
VSE DISK XA-SSCH RATE HDR2(RATE)
AND,
+
VSE DISK XA-SAMPLES
AND,
+
VSE DISK XA-CONNECT
FORMAT(NN.NNNNN) AND,
+
VSE DISK XA-PENDING
FORMAT(NN.NNNNN) AND,
+
VSE DISK XA-DISCONNECT FORMAT(NN.NNNNN) AND,
+
VSE DISK XA-UTIL
FORMAT(NN.NNNNN)
+ERPT237I END OF UNCAN EXPANSION
The CANRPT VSE.XA.DEVICE.STAT command generates a report as follows:
VOLSER DISK
SSCH
SSCH
SAMPLE
CONN
PEND
DISC
SERV
DATE
TIME
ID
CUU
COUNT
RATE
COUNT
TIME
TIME
TIME
TIME
-------- ----- -------- ---- -------- -------- -------- -------- -------- -------- -------09/24/03 08.00 DEV12E
012E
308
0.09
308
0.00282 0.00026 0.01766 0.02074
DEV12B
012B
107
0.03
107
0.00205 0.00102 0.01587 0.01869
DOSRES
012C
9
0.00
9
0.00614 0.00026 0.02125 0.02765
SQLE31
0133
4
0.00
4
0.00256 0.00026 0.01408 0.01664
-------- ----- -------- ---- -------- -------- -------- -------- -------- -------- -------SUMMARY
428
0.12
428
0.00256 0.00051 0.01715 0.02022
-------- ----- -------- ---- -------- -------- -------- -------- -------- -------- -------09/24/03 09.00 DEV12E
012E
324
0.09
324
0.00333 0.00026 0.01664 0.02048
DEV12B
012B
223
0.06
223
0.00205 0.00077 0.01459 0.01715
SYSWK1
012D
106
0.03
106
0.00154 0.00026 0.01536 0.01715
DOSRES
012C
54
0.02
54
0.00358 0.00026 0.01357 0.01741
SQLE31
0133
4
0.00
4
0.00256 0.00077 0.01894 0.02227
DEVBBB
0124
4
0.00
4
0.00128 0.00026 0.02355 0.02483
VSM127
0127
2
0.00
2
0.00154 0.00026 0.02458 0.02611
DVSQL3
0134
2
0.00
2
0.00128 0.00026 0.01920 0.02048
-------- ----- -------- ---- -------- -------- -------- -------- -------- -------- -------SUMMARY
719
0.20
719
0.00256 0.00051 0.01562 0.01869
-------- ----- -------- ---- -------- -------- -------- -------- -------- -------- -------09/24/03 10.00 DEV12E
012E
320
0.09
320
0.00384 0.00026 0.01664 0.02074
DVSQL3
0134
234
0.07
234
0.00512 0.00051 0.01126 0.01664
DOSRES
012C
218
0.06
218
0.01152 0.00026 0.01101 0.02278
DEV12B
012B
73
0.02
73
0.00205 0.00154 0.01638 0.01997
DEVBBB
0124
60
0.02
60
0.00128 0.00026 0.01434 0.01587
SYSWK1
012D
42
0.01
42
0.00256 0.00026 0.01946 0.02253
VSM127
0127
30
0.01
30
0.00128 0.00026 0.01690 0.01843
-------- ----- -------- ---- -------- -------- -------- -------- -------- -------- -------SUMMARY
977
0.27
977
0.00538 0.00026 0.01408 0.01971
-------- ----- -------- ---- -------- -------- -------- -------- -------- -------- -------09/24/03 11.00 DEV12B
012B
300
0.08
300
0.00205 0.00051 0.01562 0.01818
DEV12E
012E
269
0.07
269
0.00256 0.00026 0.01946 0.02227
DOSRES
012C
92
0.03
92
0.00717 0.00102 0.01818 0.02637
DEVBBB
0124
65
0.02
65
0.00154 0.00026 0.01638 0.01818
SYSWK1
012D
47
0.01
47
0.00205 0.00051 0.01434 0.01690
VSM127
0127
9
0.00
9
0.00128 0.00026 0.01510 0.01638
SQLE31
0133
4
0.00
4
0.00230 0.00026 0.01050 0.01306
-------- ----- -------- ---- -------- -------- -------- -------- -------- -------- -------SUMMARY
786
0.22
786
0.00282 0.00051 0.01715 0.02048
-------- ----- -------- ---- -------- -------- -------- -------- -------- -------- --------
Chapter 5: Canned Reports 141
Canned Report Descriptions
142 Report Reference Guide
Chapter 6: Commands
This chapter describes all the report writer commands and explains their
syntax.
Some commands require you to specify at least one variable. For more
information about report writer variables, see the chapter "Variables."
Some commands allow you to specify one or more ID options either with the
command or with the variables specified with the command. For more
information about complete list of ID options and an explanation of how to use
them, see the chapter "ID Options." For more information about valid ID
options for each class of variable, see the chapter "Variables."
This section contains the following topics:
Understanding Syntax Rules (see page 143)
Command Syntax Conventions (see page 145)
Using Global Commands (see page 146)
Using Report Commands (see page 147)
Command Descriptions (see page 149)
Structure of Variable Names (see page 217)
Variable Descriptions (see page 218)
VSE/POWER Accounting Variables (see page 284)
Understanding Syntax Rules
CA Explore PM for z/VSE history reporting commands must follow certain
syntax rules. If the report writer encounters a syntax error, it displays a dollar
sign ($) underneath the unexpected word or character, along with a message
describing the error. The report writer continues to read your commands to
look for more syntax errors, but it does not generate a report.
Case
Commands and their operands can be entered in either uppercase or
lowercase letters.
One Command Per Line
Each command must be written in a new line. Do not write more than one
command in a single line.
Chapter 6: Commands 143
Understanding Syntax Rules
Line Position
Commands must be the first (leftmost) word on a line. You can start a
command in any column, but it must always be the first word on the line.
Command Continuation
If you run out of space on one line for a command and its operands, you can
continue it onto the next line by typing a comma after the last (rightmost)
word on the line. You cannot split words with a continuation comma or a
hyphen. When you continue a command, you can start the continued part of
the command anywhere, as long as it is the first (leftmost) word on the line.
Word Separation
Operands and commands must be separated by blanks, commas, or
parentheses to be considered as different words. Use one or more blanks to
separate all words, which are not separated by commas or parentheses. If you
must use commas or parentheses, you do not have to separate words with
blanks. Multiple blank spaces are treated as single blank spaces. You can type
as many blanks as you want between words.
Blank Lines
Blank lines are ignored. You can include blank lines anywhere, any number of
times, even between a command and its continuation.
Processing Order
Control statements are processed in the order in which they are read. Reports
are printed in the order in which you request them.
Comments
Any line whose first (leftmost) nonblank character is an asterisk (*) is a
comment. The asterisk may be in any column. Any text after the asterisk is
ignored.
You can embed comments anywhere except between a command and its
continuation lines. You cannot continue a comment with a continuation
comma; to continue a comment, repeat the asterisk for each line of the
comment.
144 Report Reference Guide
Command Syntax Conventions
Command Syntax Conventions
In this guide, command syntax is shown using the following conventions:
Convention
Explanation
Sample Syntax
Uppercase
PLOT
Uppercase letters
indicate that you
must enter the entire
word.
Lowercase
Variables are
presented in
lowercase letters.
You must substitute
specific information
for each variable.
PLOT variable
Mixed case
Mixed case indicates
that you can enter
either the uppercase
portion or the entire
word.
PerCenT
{}
Braces enclose
options that you are
required to enter.
Enter exactly one of
the items listed
vertically. Enter one
or more of the items
listed horizontally.
Sample Entry
PLOT
PLOT VSE JOB
idoption(identifier) COUNT JOBID(J1)
PCT
SCALE({mX},{n},{COMM SCALE(3X,COMMON)
ON})
[]
[ALONE] [SCALE({mX}, ALONE CHAR1(X)
Brackets enclose
{n})]
options that you are
not required to enter. [CHAR1(x)]
You can enter one or
none of the options
listed vertically. You
can enter more than
one of the options
listed horizontally, in
the order indicated.
()
Parentheses indicate
that you must enter
parentheses around
the item as shown.
|
[SCALE({mX},{n},{COM SCALE(3X)
MON})]
An or-sign indicates a [PGMSTOR=[NO|YES]]
choice between
PGMSTOR=NO
Chapter 6: Commands 145
Using Global Commands
Convention
Explanation
Sample Syntax
Sample Entry
related items. Enter
only one of the
items.
__
...
INPUT {(TAPEIN) }
Underscoring
{(EVSEFBK)}
indicates the default.
If you want a
command's
underscored
parameters only, you
do not have to
specify the
command.
An ellipsis indicates
that the preceding
item can be
repeated.
No command
needed to
specify
INPUT(TAPEIN)
TAB variable
TAB VSE JOB
[AND,...]
COUNT AND,
VSE JOB
DURATION
Using Global Commands
Global commands set values that stay in effect for all the reports printed in
one run. For example, if you use the LINECOUNT command at the beginning of
a run to tell the report writer how many lines are on one page, that number of
lines applies to all reports in that run.
You can insert global commands anywhere among the report commands. Most
global commands affect all reports in the run without regard to placement. The
exceptions are the DEFINE command, the GLOBAL command, and some
operands of the OPTION command, which affect only reports that come after
them.
The following table briefly describes the history reporting global commands:
Command
Function
CARDLEN
Sets the number of characters in each line that the
report writer will read. This is useful when you want the
report writer to ignore sequence numbers.
COUNT
Specifies the number of input records that the report
writer will read. This command is useful for testing new
reports.
DEFINE
Creates new ID options and variables.
GLOBAL
Applies a command to all the subsequent reports. This
146 Report Reference Guide
Using Report Commands
Command
Function
command helps you to avoid duplicating code when you
create multiple reports.
GOTO
Causes the report writer to ignore all subsequent
commands until the specified label is read.
IF
Creates new identifiers based on other identifiers, or
resets existing identifiers.
INPUT
Defines the input files to be used for the report.
LINECOUNT
Specifies the number of lines to be printed per page of
the report.
OPTION
Specifies global report options, such as how dates, null
identifiers, and zero values are to be represented,
whether summary lines, storage statistics, or dumps are
produced, and whether messages are printed.
OUTPUT
Specifies a file for report output.
RUN
Starts printing the reports.
Using Report Commands
Report commands apply to a single report. These commands can be divided
into two groups: primary report commands, which define the type of report,
and secondary report commands, which alter or enhance the report.
The primary report commands are described as follows:
Command
Function
CANRPT
Produces a canned report.
FLASHBACK
Prints detailed information about each job, jobstep, or job
pseudo end-of-step executed.
GRAF
Produces a graph report that shows the value of a
variable for each resource of a single type (job, disk,
volume, and so forth).
GRAF2
Produces a second graph under each graph line created
by the GRAF command.
HPLOT
Produces a distribution plot of one variable against
another.
INVOICE
Produces a tabular invoice report using the cost factors
you specify, including a separate invoice for each
Chapter 6: Commands 147
Using Report Commands
Command
Function
identifier included in the report and an optional summary
for all identifiers.
MPLOT
Plots multiple variables across time.
PLOT
Plots a variable across time.
PLOT2
Creates a second plot below each plot line created by the
PLOT command.
TAB
Produces a table of the values of the variables you
specify.
TAB2
Produces a second table for each row of a table created
by the TAB command.
VPLOT
Plots a variable vertically across time.
VPLOT2
Plots a second variable on top of a plot created by the
VPLOT command.
List of Secondary Report Commands
The secondary report commands are described following:
Command
Function
COMMENT
Prints a comment at the bottom of each page of the
report.
COST
Assigns cost values to resources for charge-back.
EACH
EACH Defines a time period from seconds to years in
which report data is to be displayed or organized
END
Indicates the end of the current report description.
EXCLUDE
Defines a time range to be excluded from the report.
EXITRTN
Specifies the name of a user exit to be called after each
record is read and before it is processed.
FROM
Defines the starting date and time of the report.
GROUP
Combines resources into performance groups.
HEADER
Assigns a header to appear above the column headings
in a tabular report.
INCLUDE
Defines a time range to be included in the report.
PERIOD
Produces a summary of the plotted resource's average
activity.
148 Report Reference Guide
Command Descriptions
Command
Function
PRTEXIT
Specifies the name of a user exit to be called before
each line is printed.
RANGE
Defines a value range for any variable.
SELECT
Restricts a report to the specified identifiers.
SHIFT
Limits the report to a part of each day, typically a
production shift.
TITLE1
TITLE3
TITLE2
TO
Replaces the default title lines of a report with up to
three lines of text that you specify.
Defines the ending date and time of the report.
Command Descriptions
The following sections provide information on command usage, syntax, and
operands.
CANRPT Command
The CANRPT command generates a canned report. For more information about
a detailed description of this command, see the chapter "Canned Reports".
Command Syntax and Operand
CANRPT reportname
Operand
Meaning
reportname
Name of the canned report that you want to create.
CARDLEN Command
The CARDLEN command is a global command used to set the number of
characters in each line that the report writer reads. This is useful when you
want the report writer to ignore the sequence numbers. Entering it once sets
the line length for all the reports in the run. If you use this command, it should
be the first command in your command stream; otherwise, the lines before it
are treated as 80 characters long.
Chapter 6: Commands 149
Command Descriptions
Command Syntax and Operand
CARDLEN nn
The following table describes the nn operand.
Operand
Meaning
Default
nn
Maximum number of columns (characters) per line
the report writer reads. nn must be an integer less
than or equal to 80.
80
The following command specifies that the report writer will read only 71
characters per line:
CARDLEN 71
COMMENT Command
The COMMENT command creates a comment line at the bottom of each page
of the report.
Command Syntax and Operand
COMMENT commentline
Operand
Meaning
commentline
Comment that you assign to the report. The comment can
be up to 60 characters long. Every character in commentline
must be on the same line as the COMMENT command.
COST Command
The COST command makes charge-back statistics available for any resource.
Command Syntax and Operand
COST [variable cost-factor [idoption(identifiers)]
[RANGE(min,max)] [SELECT(name)]]
[variable cost-factor [DEFERRED]]
[DISTRIBution value]
150 Report Reference Guide
Command Descriptions
The following table describes the operands:
Operand
Meaning
variable
Any valid variable keyword. You can use variables
defined with the DEFINE command if you specify
the DEFERRED operand.
cost-factor
Monetary value associated with this resource.
This value can include up to five decimal
positions.
idoption(identifiers)
Any valid ID option, specified with any valid
identifiers.
RANGE(min,max)
Allows multiple cost factors for the same resource
based on specified value ranges. (min,max)
defines the value range. Specify a separate COST
command for each range.
SELECT(name)
Allows you to apply a time period specified with
an INCLUDE or EXCLUDE command. name is the
name assigned by the ID operand of the INCLUDE
or EXCLUDE command. This operand functions
similar to the SELECT option. For more
information about using the SELECT option and
the ID operand of the INCLUDE command, see
the chapter "Tabular Reports."
DEFERRED
By default, the cost-factor is applied to the data
immediately, as each record is read. Specifying
DEFERRED causes the report writer to apply the
cost factor after all the data has been read. If you
specify DEFERRED, you cannot specify the
idoption, RANGE, or SELECT operands.
DISTRIBution value
Use to create a distributed cost report. value
defines the cost that you want the report rows to
total. Specify the REPORT COST DISTRIBution
variable to include a column in your report that
shows the adjusted total cost for each row, with
all rows adding up to the amount defined by
value.
If you use the COST command with a variable you created using the DEFINE
command, you must specify the DEFERRED operand.
Related Variables
Use the variable REPORT COST TOTAL to create a column showing total cost
for each row in your report.
Chapter 6: Commands 151
Command Descriptions
To create a column showing proportional total cost for each row in your report,
use the variable REPORT COST DISTRIBution. Use this variable only if you
specified the DISTRIBution operand.
Related Option
Use the COST option with a variable to show its cost value, computed using
the cost factor you specify with the COST command. For example, you might
specify a cost factor for the variable VSE DEVICE IO using the COST
command. Then you could specify the variable and option VSE DEVICE IO
COST with the TAB command to create a column in the report showing the
cost for device I/Os for each identifier or time period in the report.
Related Command
Use the command OPTION MONETARY=x to specify a one-character symbol for
the monetary unit. The default setting is the dollar sign ($).
Example
The COST commands in this example define the following cost factors: 10
cents per job and step, 25 cents per CPU second consumed, 1 cent per tape
I/O, and 0.1 cent per disk I/O. The TAB command makes use of the four cost
factors, creating a tabular report with a column showing the value of each
variable for each user. The HDR1 and HDR2 operands assign those columns
appropriate headings. The last variable, REPORT COST TOTAL, creates a
column that shows the sum of the costs for each row in the report.
COST VSE JOB COUNT
.10
COST VSE STEP COUNT .10
COST VSE STEP TCPU
.25
COST VSE TAPE IO
.01
COST VSE DISK IO
.001
TAB USERID VSE JOB COUNT
VSE JOB COUNT
AND,
COST HDR1(JOB)
VSE STEP COUNT
AND,
VSE STEP COUNT COST HDR1(STEP)
VSE STEP TCPU
VSE STEP TCPU
RUN
152 Report Reference Guide
HDR2(COST) AND,
AND,
COST HDR1(CPU)
HDR2(COST) AND,
VSE TAPE IO
AND,
VSE TAPE IO
COST HDR1(TAPE I/O) HDR2(COST) AND,
VSE DISK IO
AND,
VSE DISK IO
COST HDR1(DISK I/O) HDR2(COST) AND,
REPORT COST TOTAL
END
HDR2(COST) AND,
Command Descriptions
The preceding commands create a report like the following:
SHIFT NONE
EACH
DAY
PERIOD NONE
USER
JOB
JOB
STEP
STEP
TCPU
CPU
SIO
TAPE I/O
SIO
DISK I/O
TOTAL
ID
COUNT
COST
COUNT
COST
TIME
COST
COUNT
COST
COUNT
COST
COST
-------- -------- -------- -------- -------- -------- -------- ---------- ---------- ---------- ----------- -------------NO-USER
104
$10.40
139
$13.90
513.3
$128.35
6,022
$60.22
324,309
$3,243.09
$3,455.96
GOALOPER
74
$7.40
130
$13.00
167.4
$41.87
0
$0.00
275,424
$2,754.24
$2,816.51
FAVERDLI
36
$3.60
36
$3.60
5.266
$1.32
0
$0.00
12,599
$125.99
$134.51
AXPVSE
33
$3.30
43
$4.30
24.25
$6.06
87
$0.87
13,870
$138.70
$153.23
GSEDITPS
21
$2.10
21
$2.10
1.979
$0.49
0
$0.00
6,816
$68.16
$72.85
BATCH4
20
$2.00
59
$5.90
8.801
$2.20
0
$0.00
21,546
$215.46
$225.56
FRED
15
$1.50
25
$2.50
11.14
$2.78
0
$0.00
17,382
$173.82
$180.60
SMASHD
11
$1.10
11
$1.10
1.539
$0.38
0
$0.00
3,730
$37.30
$39.88
PHIL
9
$0.90
11
$1.10
5.557
$1.39
0
$0.00
11,768
$117.68
$121.07
A
7
$0.70
9
$0.90
1.557
$0.39
0
$0.00
2,559
$25.59
$27.58
BCP
3
$0.30
5
$0.50
407.2
$101.82
0
$0.00
24,525
$245.25
$347.87
TJK
3
$0.30
3
$0.30
82.60
$20.65
0
$0.00
26,475
$264.75
$286.00
JCB
3
$0.30
3
$0.30
38.79
$9.70
0
$0.00
14,108
$141.08
$151.38
DRS
3
$0.30
3
$0.30
0.614
$0.15
0
$0.00
1,711
$17.11
$17.86
KJM
3
$0.30
1
$0.10
580.6
$145.15
0
$0.00
686,160
$6,861.60
$7,007.15
ALXP
2
$0.20
5
$0.50
1.322
$0.33
0
$0.00
2,777
$27.77
$28.80
EKEHLER
1
$0.10
4
$0.40
0.537
$0.13
44
$0.44
978
$9.78
$10.85
MFH
1
$0.10
1
$0.10
51.67
$12.92
0
$0.00
38,188
$381.88
$395.00
EDP
1
$0.10
1
$0.10
0.639
$0.16
0
$0.00
315
$3.15
$3.51
SYSTEM
0
$0.00
0
$0.00
632.9
$158.23
51
$0.51
13,283
$132.83
$291.57
BOBSM
0
$0.00
0
$0.00
12.77
$3.19
0
$0.00
124
$1.24
$4.43
R000
0
$0.00
0
$0.00
0.072
$0.02
0
$0.00
129
$1.29
$1.31
-------- -------- -------- -------- -------- -------- -------- ---------- ---------- ---------- ----------- -------------SUMMARY
350
$35.00
510
$51.00
2550
$637.70
6,204
$62.04
1,498,776 $14,987.76
$15,773.50
-------- -------- -------- -------- -------- -------- -------- ---------- ---------- ---------- ----------- --------------
COUNT Command
The COUNT is a global command that defines a maximum number of input
records to be read for a report. Entering it once sets the maximum number of
input records to be read for each report in the run. After the specified number
of records are read, an end-of-file condition is forced. You can use this
command to experiment with new reports that might generate more output
than you want.
If a FROM command is specified, the counting of records begins with the first
record meeting the earliest time specified in the FROM command. Otherwise,
the counting of records begins with the first record read.
Command Syntax and Operand
COUNT nnnnnn [SELECTED]
Operand
Meaning
nnnnnn
Maximum number of records to read.
SELECTED
Specifies that only records that pass at least one selection
Chapter 6: Commands 153
Command Descriptions
criterion are counted when determining if nnnnnn records
were read.
The following command specifies that the report writer will stop reading
records after reading fifty records that meet any selection criterion:
COUNT 50 SELECTED
DEFINE Command
The DEFINE command is a global command used to create new ID options and
variables for use in reports created with the TAB, TAB2, HPLOT, MPLOT,
VPLOT, and VPLOT2 commands. Any variables or ID options that you define
are in effect for all reports in the run.
Important! When you use the DEFINE command to create variables, you may
need to specify the FORMAT variable option with the variable in your report
command. If you do not specify the FORMAT option, variable values will not
include a decimal point.
Formatting Identifiers
The FORMAT option can be used with the ID options to control the number of
characters printed for each identifier. For more information about using the
DEFINE command and the FORMAT option to format identifiers, see the
chapter "ID Options".
Defining ID Options Using Existing ID Options
Use the following syntax to define new ID options using existing ID options:
DEFINE ID newid [oldid [(start,length)]] ['string'] ...
Operand
Meaning
ID
Requests the definition of a new ID option.
newid
Name of the new ID option that you want to
define.
oldid
Name of an existing ID option that you want to
be a component of the new ID option.
start,length
Specify the starting position (start) and length
(length) of the part of it that you want to include
if you do not want to include the entire existing
ID option in the new ID option.
string
A character string that you want to be a
154 Report Reference Guide
Command Descriptions
Operand
Meaning
component of the new ID option. You must
enclose the string in single quotes. The string
can be more than one character in length, and it
can include or consist entirely of blanks.
When defining a new ID option, you can include multiple character strings or
existing ID options, in any order. When printed, components are concatenated
without intervening spaces.
Defining New Variables Using Existing Variables
Use the following syntax to define new variables using existing variables:
DEFINE VAR newvar = expression
Operand
Meaning
VAR
Requests the definition of a new variable.
newvar
Name of the new variable that you want to define.
expression
Any arithmetic expression, the result of which is the value of
the new variable. You can use the following to create the
expression:
■
Existing variables
■
The MAX, MIN, TOTAL, and RANGE variable options
■
Valid ID options
■
Constants
You must delimit all variables, operands, and parentheses
with blanks. You can use the following operators in the
expression:
■
Addition
■
Subtraction
■
Multiplication
■
Division
■
Exponentiation
■
( ) Parentheses
Chapter 6: Commands 155
Command Descriptions
Defining New ID Options or Variables without Using Existing ID Options or Variables
Use the following syntax to define new ID options or variables without using
existing ID options or variables. This method allows you to report on any data
field located in any record. The syntax is shown on several lines with a
continuation comma at the end of each line except the last.
DEFINE XID|XVAR
name PRODUCT=prod RECORD=rectype [SUBTYPE=subtype]
OFFSET=data-offset LENGTH=data-length, [TRIPLET=triplet-
offset]
[TYPE=data-type] [HDR1=header1] [HDR2=header2],
[OFFSET2=data-offset2] [LENGTH2=data-length2]
[TRIPLET2=triplet-offset2], [VALUE=expression]
[FORMAT(output-format)] [CLASS=class]
The following table describes all the operands:
Operand
Meaning
XID
Requests the definition of a new ID option.
XVAR
Requests the definition of a new variable.
name
Name given to the new ID option or variable you are
creating. For DEFINE XID commands, name must be
a single word. For DEFINE XVAR commands, name
must conform to the structure described in the
"Variables" chapter in this guide.
PRODUCT=EVSE
Identifies the CA Explore PM for z/VSE product for
which an ID option or variable is being defined. You
can omit this operand if you use the PRODUCT
operand of the OPTION command.
rectype
Record type. To specify a value in hexadecimal,
prefix the value with the letter x, as in
RECORD=x3C. You can omit this operand if you use
the RECORD operand of the OPTION command.
subtype
Record subtype.
data-offset
Offset to the data field from the beginning of the
record. To specify a value in hexadecimal, prefix the
value with the letter x, as in OFFSET=x3C.
data-length
Length of the data field. If you specified XVAR, the
maximum length is 4.
triplet-offset
Offset from the beginning of the record to the triplet
information. To specify a value in hexadecimal,
prefix the value with the letter x, as in
TRIPLET=x3C.
156 Report Reference Guide
Command Descriptions
Operand
Meaning
data-type
For DEFINE XID commands, one of the following
data types:
■
BINARY—Binary.
■
CHARACTER—Character. This is the default for
DEFINE XID commands.
■
HEX—Hexadecimal.
For DEFINE XVAR commands, one of the following
data types:
■
BINARY—Binary. This is the default for DEFINE
XVAR commands.
■
CHARACTER—Character.
■
DECIMAL—Decimal numbers in character
format.
■
HEX—Hexadecimal.
■
STCK—Converts a store-clock TOD field into
mm/dd/yy hh:mm:ss format.
■
STCK-DATE—Converts a store-clock TOD field
into mm/dd/yy format.
■
STCK-TIME—Converts a store-clock TOD field
into hh:mm:ss format.
■
STCK-TIMEM—Converts a store-clock TOD field
into hh:mm:ss:mmm format.
header1
A string of up to 8 characters to be used as the top
column heading. The default is the null string.
header2
A string of up to 8 characters to be used as the
bottom column heading. The default is the null
string.
data-offset2
Offset to the data field from the beginning of the
record. To specify a value in hexadecimal, prefix the
value with the letter x, as in OFFSET=x3C.
data-length2
Length of the data field. If you specified XVAR, the
maximum length is 4.
triplet-offset2
Offset from the beginning of the record to the triplet
information. To specify a value in hexadecimal,
prefix the value with the letter x, as in
TRIPLET=x3C.
expression
Any arithmetic expression using V1, V2, +, -, *, and
/, where V1 represents the first data field (defined
by OFFSET, LENGTH, TRIPLET) and V2 represents
Chapter 6: Commands 157
Command Descriptions
Operand
Meaning
the second data field (defined by OFFSET2,
LENGTH2, and TRIPLET2). The expression is
processed left to right.
output-format
Default output pattern. Use the same syntax as the
FORMAT variable option.
The following examples show ways to enter the DEFINE command and the
result of each:
Sample entry
Result
DEFINE ID DSNID DSNID(1,30)
Redefines the length of the ID option
DSNID from 44 characters to 30,
starting with position 1.
DEFINE ID ACUSER ACUSER(3,4)
Redefines the ID option ACUSER to
use only 4 characters, starting with
position 3.
DEFINE ID CHNID 'Channel ' CHNID
Redefines the ID option CHNID to
include the word Channel and a blank
before the channel ID.
DEFINE ID MYKEY DISKID ' ' VOLSER
Creates a new ID option called
MYKEY with components DISKID and
VOLSER and places a blank between
the two components.
DEFINE VAR VSE DISK %READS = ,
Creates the new variable VSE DISK
%READS by multiplying VSE DISK
READS by 100 and then dividing the
result by VSE DISK SIO. The
continuation comma allows the
command to be continued on a
second line.
( VSE DISK READS * 100 ) / VSE
DISK SIO
DEFINE VAR VSE PACCNT PRTPAGE =
,
VSE PACCNT LSTPAG + VSE PACCNT
XSPPGE
DEFINE VAR VSE DEVICE QTIMEMAX
= ,VSE DEVICE Q-TIME MAX
158 Report Reference Guide
Creates the new variable VSE
PACCNT PRTPAGE by adding the
variables VSE PACCNT LSTPAG and
VSE PACCNT XSPPGE. The
continuation comma allows the
command to be continued on a
second line.
Creates the new variable VSE DEVICE
QTIMEMAX that yields the maximum
length of time that the I/O request
was on the channel queue. The
continuation comma allows the
Command Descriptions
Sample entry
Result
command to be continued on a
second line.
DEFINE XID KEY19 PRODUCT=EVSE
RECORD=19, OFFSET=X14
LENGTH=8 TYPE=HEX
Creates the new ID option KEY19,
which is of record type 19, at offset
X'14', of length 8, and of type
hexadecimal. The continuation
comma allows the command to be
continued on a second line.
DEFINE XVAR EVSE DEVICE CUU,
Creates the new variable EVSE
DEVICE CUU. The continuation
commas allow the command to be
continued on subsequent lines.
PRODUCT=EVSE RECORD=19
OFFSET=X28, LENGTH=2
TYPE=HEX HDR2=cuu
EACH Command
The EACH command defines a time period, from seconds to years, in which
report data should be organized. The effects of the EACH command depend on
the report type, as follows:
■
With tabular reports, the EACH command defines the time interval at
which the table should be repeated. You must allow for a DAY, DATE, or
TIME column if you use the EACH command. For more information about
creating such a column, see the chapter "Tabular Reports."
■
For plot reports, use the EACH command to define the length of time
represented by each line in the plot. You can plot by the hour, day, week,
or month using the EACH command. The default is one day.
■
Graph reports break down activity by identifier during a given time period.
If you do not specify an EACH command, the result is a single graph for
the whole time period covered in the report. Specifying an EACH command
causes the report writer to produce a separate graph for each time period
specified by the EACH command.
You must have the appropriate amount of data in your input file for the EACH
value you specify. For example, you cannot specify EACH YEAR if your input
file has less than one year's data. If the input file does not have enough data,
you may not receive a complete report.
Important! The report writer cannot report on a smaller time interval than
the data in the input file. For example, if the input file contains data that was
logged at half-hour intervals, you cannot specify an EACH value of less than
30 minutes. Generally, the EACH value you specify should be the same as, or
a multiple of, your SYSTIMEI interval.
Chapter 6: Commands 159
Command Descriptions
Specifying the First Day of a Week
By default, a week is Monday through Sunday. If you specify the EACH WEEK
or EACH nnn WEEKs command and want weeks to begin on a different
weekday, use the OPTION(WEEK=weekday) command, to specify the first day
of a week.
EACH [time-period | RECORD] [AVERAGED] [SUMMARIZE]
Command Syntax and Operand
Operand
Meaning
time-period
One of the following base time units. nnn is the
number of time intervals (up to 999) in the time
unit you select.
The default is DAY.
■
SECOND
■
nnn SECONDS
■
MINUTE
■
nnn MINUTES
■
HOUR
■
nnn Hours
■
DAY
■
nnn DAYS
■
WEEK
■
nnn WEEKS
■
MONTH
■
nnn MONTHS
■
YEAR
■
nnn YEARS
RECORD
Defines the sample interval as each record,
rather than as a time interval. This operand is
valid only for HPLOT reports; if you specify
EACH RECORD for any other report, the
command will be ignored. If you specify EACH
RECORD for an HPLOT report, you must use the
SCALE operand to specify a scale for the HPLOT
variable.
AVERAGED
Produces a report with one detail line for each
time period specified by the EACH command.
160 Report Reference Guide
Command Descriptions
Operand
Meaning
The variable values in each line represent the
average value of the variable for that time
period for all the input data.
For example, if you create a tabular report and
specify EACH 1 HOUR AVERAGED, the report will
include 24 rows, one for each hour of the day.
The first row would show the average value for
each variable for the hour of midnight to 1 a.m.
for all the days of input data.
When you use the AVERAGED operand, the
EACH value must be 24 hours or less.
SUMMARIZE
Similar to the AVERAGED operand, except that
the data is totaled instead of averaged. Use this
operand only with variables that represent
counts (not averages).
For example, if you specify EACH 1 HOUR
SUMMARIZE for a tabular report, the report will
include 24 rows, one for each hour of the day.
The first row would show the total value for
each variable for the hour of midnight to 1 a.m.
for all the days of input data.
To plot the value of a variable for each half-hour period, enter the following
commands:
PLOT variable
EACH 30 MINUTES
END
RUN
The following commands create a distribution plot using each record as the
sample interval:
VPLOT variable1
HPLOT variable2 SCALE(nn)
EACH RECORD
END
RUN
Chapter 6: Commands 161
Command Descriptions
END Command
You must use the END command to end each report. Any command after the
END command is interpreted as applying to the next report. If you do not
enter the END command between reports, the report writer issues a message
that you are using multiple report commands for one report.
Command Syntax and Operand
END
The following is an example of the use of the END command:
TITLE1 REPORT1
PLOT variable1 AND variable2
FROM 02/01/04 00.00.01
TO
02/15/04 23.59.59
END
TITLE1 REPORT2
PLOT variable
SHIFT 17:00:00 01:00:00
END
.
.
.
RUN
EXCLUDE Command
The EXCLUDE command defines time ranges to be excluded from a report.
You cannot use both INCLUDE and EXCLUDE commands in the same report.
You can use multiple EXCLUDE commands to exclude multiple time ranges.
Command Syntax and Operand
EXCLUDE [day] [time - time] [ID name]
[date]
[date time - date time]
[month]
Operand
Meaning
day
Day of the week (SUNday, MONday, TUESday,
WEDnesday, THURsday, FRIday, or SATurday).
time
Time of day in hh:mm:ss format.
162 Report Reference Guide
Command Descriptions
Operand
Meaning
date
Date in mm/dd/yy format.
ID name
An identifying name to be associated with a
specific setting of the EXCLUDE command, for use
with the SELECT variable option (For more
information about SELECT operand of the COST
command, see the chapter "Tabular Reports").
month
Month (JANuary, FEBruary, MARch, APRil, MAY,
JUNe, JULy, AUGust, SEPTember, OCTober,
NOVember, or DECember).
The following are examples of the EXCLUDE command:
EXCLUDE SATURDAY
EXCLUDE SUNDAY
EXCLUDE 07/04/04
EXCLUDE 12:00:00 - 13:00:00
EXCLUDE FRIDAY 16:00:00 - 17:00:00
EXCLUDE 16:00:00 - 23:59:59 ID 2NDSHIFT
EXCLUDE 00:00:00 - 07:59:59 ID 3RDSHIFT
EXCLUDE JULY
EXITRTN Command
The EXITRTN command defines a user exit to call after each record is read and
before the report writer processes the record.
Supplied User Exit
The user exit EVSEGUX is predefined for your use. For more information about
EVSEGUX, see the appendix, "User Exits."
Command Syntax and Operand
EXITRTN(user-exit)
Operand
Meaning
user-exit
Name of the user exit.
Chapter 6: Commands 163
Command Descriptions
FLASHBACK Command
The FLASHBACK command generates detailed reports on jobs. It produces one
line of output per job, jobstep, or job pseudo end-of-step in chronological
order of ending time. You cannot sort flashback reports.
You can run flashback reports against the flashback file, the archive file, or a
backup of the archive file (a log file). For more information about detailed
description of FLASHBACK Command, see the chapter "Flashback Reports."
Important! Each flashback report must be run as a single report in a separate
run. You cannot specify another primary report command (such as TAB or
PLOT or another FLASHBACK command) in a jobstream with the FLASHBACK
command.
Output Considerations
The FLASHBACK command can generate enormous amounts of output if run
against a very large input file. To avoid problems, use either the FROM and TO
commands, the COUNT command, or the SELECT command to limit the
output.
Command Syntax and Operand
FLASHBACK type [[period] idoption[(identifiers)] [variable [options] [HDR1(text)]
[HDR2(text)]] [AND,
variable [options] [HDR1(text)] [HDR2(text)]] [AND,...]
Operand
Meaning
type
Specify one of the following:
period
164 Report Reference Guide
■
VSEEXEC—Prints one line for every
VSE/POWER execution record. Each execution
record represents one jobstep.
■
VSEJOB—Prints one line for every job
executed.
■
VSELIST—Prints one line for every VSE/POWER
list record.
■
VSESAMP—Prints one line for every step and
pseudo end-of-step executed. A pseudo
end-of-step record is created by CA Explore PM
for z/VSE for each step that is running at the
end of a SYSTIMEI interval.
■
VSESTEP—Prints one line for every step
executed.
One of the following to indicate the first column or
Command Descriptions
Operand
Meaning
columns in the report:
■
DATETIME—Creates columns for the date and
time of the record
■
DATE—Creates a column for the date of the
record
■
TIME—Creates a column for the time of the
record
■
DAY—Creates a column for the day of the
record (MONDAY, TUESDAY, and so forth)
You can use one of the DATE, TIME, DAY, or
DATETIME operands only if you create a
specialized flashback report by specifying one or
more ID options and any desired variables with the
FLASHBACK command.
idoption(identifiers)
Lists all the resources (or just those specified by
identifiers) for an ID option. You can specify
multiple ID options.
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID
option that you specify must include at least one
identifier.
HDR1
Overrides the default top heading for a column.
Replace text with the new column heading.
HDR2
Overrides the default bottom heading for a column.
Replace text with the new column heading.
AND,
Signals that another variable will be specified. The
comma after AND lets you to continue to the next
line.
FROM and TO Commands
The FROM and TO commands specify the time period that a report will cover.
The FROM command tells the report writer to exclude data less recent than the
specified date and time. The TO command tells the report writer to exclude
data more recent than the specified date and time. The TO date and time must
be later than the FROM date and time.
The dates and times a report covers are printed at the top of each page,
following the FROM and TO headings.
Chapter 6: Commands 165
Command Descriptions
Command Syntax and Operand
FROM
TO
time
time
Operand
Meaning
time
Date and time that you specify, in either of two formats. You
can specify an actual date and time, or you can specify a
relative date and time.
How FROM and TO Relate to the Log and Flashback Files
Reports cannot start earlier or end later than the data in the input file used. If
the FROM and TO dates or times are outside the range of the data in the input
file, the report covers the data in the file closest to the dates and times
specified.
Default Dates and Times
If no FROM and TO dates are specified, the report covers all records in the
input file. If dates but no times are specified in the FROM and TO commands,
the report covers all records within the specified dates.
Specifying an Actual Date and Time
The format for specifying an actual date and time is as follows:
mm/dd/yy hh:mm:ss
The operands for the actual date and time format are shown following:
Operand
Meaning
mm/dd/yy
Date in decimal digits, where mm is the month, dd is the day,
and yy is the year. If a value is less than 10, you must
include a leading zero (for example, specify 03/04/04 rather
than 3/4/04). If your operating system uses the European
date format or you specified it using the DATEFRMT operand
of the OPTION command, you must enter dates in the format
dd/mm/yy.
hh:mm:ss
Time in hours, minutes, and seconds. You can use periods
instead of colons (hh.mm.ss). The hours are in military
format, from 01 to 23 hours. The values for mm and ss
cannot exceed 59. The default is 00:00:01.
166 Report Reference Guide
Command Descriptions
Specifying a Relative Date and Time
If you specify actual dates and times in a report that you plan to run
frequently, you have to change all of the dates in the job every time you run
it. The alternative is to use the relative date and time format, which creates
reports that start or end a certain number of minutes, hours, days, weeks, or
months before the current date and time. The date and time you specify is
always relative to the time that you run the report. Any INCLUDE and
EXCLUDE commands preceding the report are honored.
The relative date and time format is as follows:
-n
[MINUTES]
[HOURS
]
[DAYS
] [AT hh:mm:ss]
[WEEKS
] [AT hh:mm:ss]
[MONTHS ]
The operands for the relative date and time format are as follows:
Operand
Meaning
-n
Number of minutes, hours, days, weeks or months to
subtract from the time at which the report writer starts
running. It must be an integer, prefixed by a minus sign (-).
You can specify zero (-0).
MINUTES
Subtracts n minutes from the time at which the report writer
starts running, rounded down to the nearest minute for FROM
commands, and rounded up to the nearest minute for TO
commands. If -n is zero (-0), the report writer rounds the
current time down to the nearest minute.
HOURS
Subtracts n hours from the time at which the report writer
starts running, rounded down to the nearest hour for FROM
commands, and rounded up to the nearest hour for TO
commands. If -n is zero (-0), the report writer rounds the
current time down to the nearest hour.
DAYS
Subtracts n days from the current date and time, rounded
down to the nearest day for FROM commands, and rounded
up to the nearest day for TO commands. If -n is zero (-0),
the report writer rounds the current date and time down to
the start of the current day.
WEEKS
Subtracts n weeks from the current date and time, rounded
down to the nearest week for FROM commands, and rounded
up to the nearest week for TO commands. A week begins on
Monday morning at 00:00:00. If -n is zero (-0), the report
writer rounds the current date and time down to the start of
Chapter 6: Commands 167
Command Descriptions
the current week.
MONTHS
Subtracts n months from the current date and time, rounded
down to the nearest month for FROM commands, and
rounded up to the nearest month for TO commands. If -n is
zero (-0), the report writer rounds the current date and time
down to the start of the current month.
AT hh:mm:ss
Begins (or ends) the report at the time specified by
hh:mm:ss on the day the report is run. The value is rounded
down to the nearest day or week for both FROM and TO
commands. Valid only with the DAYS and WEEKS operands.
Actual Dates and Times
To report from December 25, 2003, at 8:00 a.m. to January 1, 2004, use the
following commands:
FROM 12/25/03 08:00:00
TO
01/01/04 00:00:00
Relative Dates and Times
To report from the start of the current week (Monday morning at 00:00:00),
use the following command:
FROM -0 WEEKS
To report from yesterday at 00:00:00 to the current time, use the following
commands. The report is rounded to the last hour.
FROM -1 DAYS
TO
-0 HOURS
To report from yesterday at 8:00 a.m. to today at 8:00 a.m., use the FROM
and TO commands and the AT hh:mm:ss operand as follows:
FROM -1 DAYS AT 08:00:00
TO
-0 DAYS AT 08:00:00
To report from yesterday at 8:00 a.m. to yesterday at 4:00 p.m., use the
following commands:
FROM -1 DAYS AT 08:00:00
TO
168 Report Reference Guide
-1 DAYS AT 16:00:00
Command Descriptions
GLOBAL Command
The GLOBAL command assigns values to parameters of history reporting
commands to be applied to all remaining reports in the run until another
GLOBAL command resets the value. The value set by the GLOBAL command
does not apply to subsequent reports in which the same history reporting
command appears.
Command Syntax and Operand
GLOBAL command
Operand
Meaning
command
One of the following commands, specified with any of its
operands (for descriptions of command operands, see the
specific section for that command in this chapter).
■
COMMENT
■
COST
■
EACH
■
EXCLUDE
■
EXITRTN
■
FROM
■
GROUP
■
INCLUDE
■
PERIOD
■
PRTEXIT
■
SHIFT
■
TITLE1
■
TITLE2
■
TITLE3
■
TO
Temporarily Overriding a Global Value
To override a global value for one report, issue the command before the END
command for that report. For example, if GLOBAL EACH 2 HOURS were set,
you can override it within a report by specifying the report command EACH 4
HOURS with the commands for that report.
Chapter 6: Commands 169
Command Descriptions
Removing a Global Value
You can remove a global value by issuing a GLOBAL command without
operands. For example, specifying the command GLOBAL FROM removes any
global value previously set for the FROM command.
GOTO Command
The GOTO command causes the report writer to ignore all subsequent
commands until the specified label is read.
Command Syntax and Operand
GOTO .label
Operand
Meaning
.label
A period followed by a one- to eight-character label. You must
also specify a period followed by this label on a separate line
later in the jobstream to indicate where the report writer should
resume processing commands.
The following commands produce the canned reports VSE.DEVICE.STAT and
VSE.PAGE.STAT. The commands between GOTO .MYLABEL1 and .MYLABEL1
are ignored by the report writer, so the canned report VSE.DSN.STAT is not
produced and no syntax error is generated for the missing operand for the
EACH command.
CANRPT VSE.DEVICE.STAT
END
GOTO .MYLABEL1
CANRPT VSE.DSN.STAT
EACH
END
.MYLABEL1
CANRPT VSE.PAGE.STAT
END
RUN
170 Report Reference Guide
Command Descriptions
GRAF Command
The GRAF command produces a single-line bar graph of the performance of
each identifier associated with a variable. For example, using the GRAF
command with a DISK variable produces a bar graph of the variable for each
disk. For more information about GRAF command, see the chapter "Graph
Reports."
Command Syntax and Operand
GRAF [idoption[(identifiers)]] variable [options] [SCALE({n},{mX})] [SORT
order] [FOR n] CHAR1(x)
Operand
Meaning
idoption(identifiers)
Any ID option that is valid for the
variable, specified with or without
identifiers. Specifying this operand
causes the resulting report to be
organized by the specified ID option
and limited to the identifiers specified
by identifiers. If you do not specify an
ID option, all identifiers of the type
associated with the variable are
included in the report.
For example, a graph of a DISK
variable by default graphs the value
of that variable for each disk.
Specifying the ID option and identifier
DISKID(0860) graphs the value of the
variable for disk 0860 only; specifying
the ID option VOLSER graphs the
value for each volume.
variable
Any report writer variable.
options
Any valid variable options or ID
options. Each ID option that you
specify must include at least one
identifier.
SCALE(n)
By default, the highest value of a bar
graph's axis is set to the highest
value of the graphed variables. For
variables that represent percentages,
the default maximum value is 100%.
or
SCALE(mX)
or
SCALE(n,mX)
To override this dynamic scale,
specify n as the maximum value. If
the variable that you choose produces
integers, n must be an integer. You
Chapter 6: Commands 171
Command Descriptions
Operand
Meaning
cannot use more than three digits to
the right of the decimal point when
specifying n.
In some cases, bar graphs in a graph
report will be too short to appear. To
display these graphs, you can cause
each plot character to appear as m
characters by specifying the multiplier
mX, where m is an integer. Since the
resulting bar graphs will no longer
correspond numerically to the scale,
this is useful only for determining
relative performance.
FOR n
Limits the report to the n identifiers in
each time period that would appear
first in the report. For reports sorted
in descending order, these are the n
most active identifiers; for reports
sorted in ascending order, these are
the n least active identifiers. n must
be an integer.
CHAR1(x)
Sets the plot character. Replace x
with any valid EBCDIC character.
GRAF2 Command
Use the GRAF2 command to produce one or more subgraphs for each
individual resource included by the GRAF command. These subgraphs can do
either of the following:
■
Graph the performance of a second, related set of resources. For example,
if your GRAF command graphs by disk, a GRAF2 command could list each
data set used on each disk and show the SIO count for each.
■
Graph the values of one or more variables for each resource. For example,
if your GRAF command graphs the number of SIOs by each disk, a GRAF2
command could show the number of reads, writer, and senses for each of
those disks.
You cannot use the GRAF2 command without the GRAF command. For more
information about GRAF2 command, see the chapter "Graph Reports."
172 Report Reference Guide
Command Descriptions
Command Syntax and Operand
GRAF2 [VARS] [idoption[(identifiers)]] variable [options] [HDR(text)] [CHAR1(x)]
LE({n},{mX},{COMMON})] [SORT order] [FOR n] [AND,
variable [options] [HDR(text)] [CHAR1(x)]] [AND,...]
Operand
Meaning
VARS
Indicates that there is more than one variable in
this GRAF2 report.
idoption(identifiers)
Any ID option that is valid for the variable,
specified with or without identifiers. Specifying
this operand causes the resulting subgraphs to
be organized by the specified ID option and
limited to the identifiers specified by identifiers.
If you do not specify an ID option, all identifiers
of the type associated with the variable are
included in the subgraphs. You can use this
operand only if you specify a single variable with
the GRAF2 command.
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID
option that you specify must include at least one
identifier.
HDR(text)
Overrides the default heading for the variable.
Replace text with a heading of 15 or fewer
characters.
CHAR1(x)
Sets the plot character for the variable. Replace
x with any valid EBCDIC character.
FOR n
Limits the report to the n identifiers in each time
period that would appear first in the report,
where n is an integer. For reports sorted in
descending order, these are the n most active
identifiers; for reports sorted in ascending
order, these are the n least active identifiers.
You can specify the FOR operand only with the
first variable you specify with the GRAF2
command.
AND,
Signals that another variable will be specified.
The comma after AND lets you to continue to
the next line. If you specify multiple variables,
you must use the VARS operand.
Chapter 6: Commands 173
Command Descriptions
The following commands produce a report showing the average service time
for the 10 disks with the highest service times each day, and the service times
of the 20 data sets on each with the highest service times:
GRAF
VSE DISK SERVTIME FOR 10
GRAF2 VSE DSN SERVTIME
FOR 20
EACH DAY
END
RUN
GROUP Command
The GROUP command lets you to combine resources into performance groups.
You can use GROUP with the TAB command, the GRAF command, or any of the
plot commands.
Command Syntax and Operand
GROUP idoption group-name(identifiers) [INCLUDE] [RANGE(rangeid)]
Operand
Meaning
idoption
An ID option identifying the type of resources to
be included in the group being defined. For
example, specify the ID option JOBID if the
group should consist of jobs defined by
jobnames.
group-name(identifiers)
Any 1- to 44-character name. If you use blanks
in the group name, you must enclose the group
name in single quotes. Replace identifiers with
the identifiers to be included in the group (for
example, jobnames), separated by commas.
You can use generic characters in the identifiers.
After you define a group, you can use the group
name as you would any predefined report writer
ID option. That is, you can use a group name
together with commands or variables to do the
following:
Organize the data in a tabular or graph report
by group. For example, if you define a set of
jobs with the group name MYJOBS, you can
specify MYJOBS as an ID option with the TAB or
GRAF commands to produce a report on just
those jobs.
Limit the value of a variable to the activity of
one or more members in the group (for
example, to the jobs in the group PAYROLL
174 Report Reference Guide
Command Descriptions
Operand
Meaning
beginning with AC or to all jobs in the group).
INCLUDE
Includes this group in the report even if it is not
included with the identifiers specified with the
TAB command. The value for this group is not
included in the average or total value.
RANGE(rangeid)
Tells the report writer to include in the group
only those resources that fall within the range
rangeid. Replace rangeid with the ID assigned
with the RANGE command that assigns the
range criteria that you want members of the
defined group to meet.
The following commands define groups by jobname and produce a report
listing each group and showing the number of times jobs in the group were
run:
GROUP JOBID DEPT.PAYROLL(PAY*)
GROUP JOBID DEPT.ACCOUNTING(ACC*)
GROUP JOBID DEPT.DEVELOPMENT(DEV*)
TAB JOBID(DEPT*) VSE JOB COUNT
END
RUN
The following GROUP commands define groups by jobname. The GLOBAL
command is specified to let the defined groups to be used in more than one
report. The PLOT command produces a horizontal plot of the number of times
jobs in the group PAYROLL were executed, and the VPLOT command produces
a vertical plot of the total number of times jobs from any of the three defined
groups were executed.
GLOBAL GROUP JOBID PAYROLL(PAY*)
GLOBAL GROUP JOBID ACCOUNTING(ACC*)
GLOBAL GROUP JOBID DEVELOPMENT(DEV*)
PLOT
JOBID(PAYROLL) VSE JOB COUNT
END
VPLOT JOBID(PAYROLL,ACCOUNTING,DEVELOPMENT) VSE JOB COUNT
END
RUN
Chapter 6: Commands 175
Command Descriptions
The following example defines groups of steps by their CPU usage and
produces a report on those groups of steps:
GROUP EXPHASE 'CPU CONSUMED: 0 - 1'(*)
RANGE(CPU0)
GROUP EXPHASE 'CPU CONSUMED: 1 - 5'(*)
RANGE(CPU1)
GROUP EXPHASE 'CPU CONSUMED: 5 - 10'(*)
RANGE(CPU5)
GROUP EXPHASE 'CPU CONSUMED: 10+'(*)
RANGE(CPU10)
RANGE VSE PACCNT EXCPUTM 0-1
ID CPU0
RANGE VSE PACCNT EXCPUTM 1-5
ID CPU1
RANGE VSE PACCNT EXCPUTM 5-10
ID CPU5
RANGE VSE PACCNT EXCPUTM 10+
ID CPU10
TAB EXPHASE(CPU*) HDR1(STEP CPU) HDR2(DISTRIBUTION),
ACIDEN(E) SORT ALPHA,
VSE PACCNT EXSTPCNT
AND,
VSE PACCNT EXSTPCNT PCT
AND,
VSE PACCNT EXCPUTM NXTND
AND,
VSE PACCNT EXNPG
END
RUN
HEADER Command
The HEADER command specifies a title to appear in a tabular report above the
column headings and to the right of the PERIOD field. The HEADER command
is only valid with tabular reports.
You can specify multiple HEADER commands for one tabular report.
Command Syntax and Operand
HEADER(nn,mm) text
Operand
Meaning
nn
The print column where you want the first character of your
heading to appear. Since headings appear on the same line as
the PERIOD field, nn must be 20 or greater.
mm
The length of the heading.
text
The heading that you want to appear in your report. Do not use
string delimiters.
176 Report Reference Guide
Command Descriptions
Related Variable Option
You can use the RIGHT variable option to shift variable columns to the right so
they do not begin before print column 20, where headings controlled by the
HEADER command can begin.
The following commands create a report showing total disk SIO, plus statistics
on two particular disks:
HEADER(24,26) -------DISK 0122--------HEADER(53,26) -------DISK 0550--------TAB DAY
VSE DISK SIO
HDR1(TOTAL SIO) AND,
VSE DISK SIO
DISKID(0122) AND,
VSE DISK SERVTIME
DISKID(0122) AND,
VSE DISK UTILIZATION DISKID(0122) AND,
VSE DISK SIO
DISKID(0550) AND,
VSE DISK SERVTIME
DISKID(0550) AND,
VSE DISK UTILIZATION DISKID(0550)
END
RUN
The preceding commands create a report like the following:
SHIFT NONE
EACH
DAY
PERIOD NONE
-------DISK 0122---------------DISK 0550--------TOTAL SIO
SIO
SERVICE DEVICE
SIO
SERVICE DEVICE
WEEKDAY
COUNT
COUNT
TIME
%BUSY
COUNT
TIME
%BUSY
--------- ---------- ---------- -------- -------- ---------- -------- -------Sunday
24,261
529 0.003
21,995 0.003
Monday
861,603
29,219 0.005
0.1
794,892 0.003
0.2
Tuesday
346,432
6,363 0.007
317,481 0.004
0.2
Wednesday
211,540
2,586 0.018
0.1
188,596 0.005
0.3
--------- ---------- ---------- -------- -------- ---------- -------- -------PERIOD
1,443,836
38,697 0.006
0.1
1,322,964 0.004
0.2
--------- ---------- ---------- -------- -------- ---------- -------- --------
HPLOT Command
The HPLOT command plots the distribution of one variable based on the value
of another variable. The variable you specify with the HPLOT command is
plotted along the horizontal axis. The second variable, specified with either the
VPLOT or the MPLOT command, is plotted along the vertical axis.
You cannot use the HPLOT command without either the MPLOT or VPLOT
command. The HPLOT command must follow the MPLOT or VPLOT command.
To set the plot character for an HPLOT report, specify the CHAR1 operand with
the MPLOT or VPLOT command. For more information, about HPLOT command,
see the chapter "Plot Reports."
Chapter 6: Commands 177
Command Descriptions
Command Syntax and Operand
HPLOT variable [options] [SCALE(n)] [SCATTER]
Operand
Meaning
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID option that
you specify must include at least one identifier.
SCALE(n)
By default, the highest value of a plot's horizontal axis is set to
the highest value of the graphed variables. For variables that
represent percentages, the default maximum value is 100%.
To override this dynamic scale, specify n as the maximum
value. If the variable that you choose produces integers, n
must be an integer. You cannot use more than three digits to
the right of the decimal point when specifying n.
If you use the RECORD option of the EACH command, you
must use SCALE(n), specifying a value for n appropriate for
the activity you are plotting. For example, 600 seconds might
be an appropriate scale for plotting step duration, whereas 20
seconds might be more appropriate for graphing step CPU
usage.
SCATTER
Prints a scatter plot showing how many times each point in the
plot is reached.
The following commands plot the disk SIO rate along the vertical axis against
disk service time along the horizontal axis, for each 15-minute interval:
VPLOT VSE DISK SIO RATE CHAR1(*)
HPLOT VSE DISK SERVTIME
EACH 15 MINUTES
END
RUN
IF Command
The IF command lets you to assign new values to identifiers or create new
identifiers based on existing identifiers.
178 Report Reference Guide
Command Descriptions
Command Syntax and Operand
IF idoption1=(identifier[,identifier,identifier...])
THEN idoption2=newvalue
[ELSE idoption3=newvalue]
Operand
Meaning
idoption1
The ID option whose value is being tested.
identifier
An ID option or one or more identifiers to be compared
to idoption1.
idoption2
The ID option whose identifiers are to be assigned a
new value if the IF clause is true. This can be the same
as idoption1.
newvalue
The new value to be assigned to the identifier. Replace
newvalue with either an ID option or a character string.
If you specify a character string, enclose it in single
quotes.
The following command replaces the value of JOBID with the value of STEPID
whenever the value of JOBID is equal to TESTJOB:
IF JOBID=(TESTJOB) THEN JOBID=STEPID
The following command replaces the value of JOBID with the character string
production whenever the value of JOBID begins with PROD and with the string
test otherwise:
IF JOBID=(PROD*) THEN JOBID='production' ELSE JOBID='test'
The following command creates the new ID option DEPARTMENT. Whenever
the value of JOBID begins with PROD, DEPARTMENT is assigned the value
production:
IF JOBID=(PROD*) THEN DEPARTMENT='production'
INCLUDE Command
The INCLUDE command defines time ranges to be included in a report.
You cannot use both INCLUDE and EXCLUDE commands in the same report.
You can use multiple INCLUDE commands to include multiple time ranges.
Chapter 6: Commands 179
Command Descriptions
Command Syntax and Operand
INCLUDE [day] [time - time] [ID name]
[date]
[date time - date time]
[month]
The following table describes the command operands
Operand
Meaning
day
The day of the week (SUNday, MONday, TUESday,
WEDnesday, THURsday, FRIday, or SATurday)
time
The time of day in hh:mm:ss format
date
The date in mm/dd/yy format
ID name
An identifying name to be associated with a specific
setting of the INCLUDE command, for use with the
SELECT variable option (For more information about
SELECT operand of the COST command, see the chapter
"Tabular Reports.")
month
The month (JANuary, FEBruary, MARch, APRil, MAY,
JUNe, JULy, AUGust, SEPTember, OCTober, NOVember,
or DECember)
The following are examples of the INCLUDE command:
INCLUDE SATURDAY
INCLUDE SUNDAY
INCLUDE 07/04/04
INCLUDE 12:00:00 - 13:00:00
INCLUDE 08:00:00 - 15:59:59 ID 1STSHIFT
INCLUDE 16:00:00 - 23:59:59 ID 2NDSHIFT
INCLUDE 00:00:00 - 07:59:59 ID 3RDSHIFT
INCLUDE JULY
INPUT Command
The INPUT command communicates three pieces of information:
■
Whether the report writer will read the performance data from the
flashback file, the archive file, or the log file
■
The names of the files that you need to access in order to write your
reports
■
How many input files do you want to read for one run
180 Report Reference Guide
Command Descriptions
Command Syntax and Operand
INPUT(filename[(options)])
The following table describes the command operands
Operand
Meaning
filename
The filenames of the input files as specified in the TLBL
or DLBL statements. Special input filenames are
described on the following page.
Options
Use one or more of the following:
■
SYSnnn—SYS number assigned to this input file.
The default is SYS004.
■
UNBLOCKED—Records are not logically blocked.
Records in all CA Explore PM for z/VSE log files are
logically blocked.
■
UNTIMED—Records do not contain a datetime field.
Default
If you do not specify a filename using the INPUT command, or if you specify a
filename using the INPUT command that does not match any name defined to
the report writer, the report writer expects input from tape and processes the
file as if you had specified the filename TAPEIN.
Input Files and Descriptions
The following table describes special input filenames for CA Explore PM for
z/VSE:
Input File
File Description
DISKxxx
A CA Explore PM for z/VSE disk log file.
Replace xxx with any alphanumeric characters.
EVSEARC
The CA Explore PM for z/VSE archive file.
EVSEFBK
The CA Explore PM for z/VSE flashback file.
EVSExxx
A CA Explore PM for z/VSE flashback file. These
filenames are provided in case you have
multiple VSE machines writing to different sets
of files. Replace xxx with any alphanumeric
characters except ARC.
TAPPWRx
A tape input file that is a power accounting
data set created with the POWER JA command.
Chapter 6: Commands 181
Command Descriptions
Input File
File Description
Replace x with any alphanumeric character.
Note that you should use the
OPTION(PWRPREFIX=YES) command with the
TAPPWRx setting.
TAPV4xxx
A tape log file from CA Explore PM for z/VSE
version 4. Replace xxx with any alphanumeric
characters.
xxxxxxx
If you specify a filename using the INPUT
command that does not match any name
defined to the report writer, the report writer
expects input from tape and processes the file
as if you had specified the filename TAPEIN.
Do not use the following names for CA Explore
PM for z/VSE tape log files:
■
DISKxxx
■
EXPCxxx
■
EVSExxx
■
GSIHIST
■
TAPC3xx
■
TAPELOG
Using Other CA Explore PM for z/VSE Input Files
If in addition to CA Explore PM for z/VSE, you run CA Explore PM for CICS you
can produce tabular and plot reports containing data collected by two or more
of those CA Explore PM for z/VSE systems. You can mix variables from
different CA Explore PM for z/VSE systems only in reports generated by the
TAB command or any of the plot commands.
To use more than one type of CA Explore PM for z/VSE variable, you must use
the INPUT command to tell the report writer to read input data from flashback
or log files from each CA Explore PM for z/VSE system whose data you want to
use. Include a DLBL or TLBL statement for each file that you want to use as
input.
For more information about how to create a tabular report using both CICS
and VSE variables, see the chapter "Tabular Reports."
For more information about input files and variables valid for a CA Explore PM
for z/VSE system, see the History Reporting Guide for that system.
182 Report Reference Guide
Command Descriptions
INVOICE Command
The INVOICE command produces a tabular invoice report using the cost
factors you specify. A separate invoice will be created for each identifier
included in the report. Each invoice will begin on a new page and will include a
row for each variable you specify, showing the value of the variable for the
identifier and the cost associated with it.
When using the INVOICE command, you must use the COST command to
specify a cost factor for each variable that you want included in the invoice.
Then, following the INVOICE command, specify each variable twice, once
without the COST option and once with it.
If you want the report to include a summary page showing the total value and
cost for each variable for all identifiers in the report, specify the variable
REPORT COST TOTAL as the last variable with the INVOICE command.
Command Syntax and Operand
INVOICE [idoption[(identifiers)]] variable [options] [HDR(text)][SORT order]
[AND, variable[options][HDR(text)]][AND,...]
Operand
Meaning
idoption(identifiers)
Any ID option that is valid for the variables you
specify. You can specify one or more identifiers
(separated by commas) to limit the report to a
subset of the identifiers associated with the ID
option. You can use generic characters when
specifying identifiers.
variable
Any report writer variable. Each invoice in the
report includes a row for each variable you
specify.
options
Any valid variable options. To get complete
invoices, you must specify each variable once
without the COST option and once with it.
HDR(text)
Overrides the default description for the row
for a variable. Replace text with the new
description.
SORT order
Sorts the report. Replace order with one of the
following:
■
DESCENDING—Variables are sorted in
descending order starting with the variable
the SORT operand is specified with, and,
when the value is the same for two entries,
from left to right. This is the default sorting
Chapter 6: Commands 183
Command Descriptions
Operand
Meaning
order.
AND,
184 Report Reference Guide
■
ASCENDING—Variables are sorted in
ascending order starting with the variable
the SORT operand is specified with, and,
when the value is the same for two entries,
from left to right.
■
ALPHA—Variables are sorted in
alphanumeric order with respect to the
specified identifier (for example, by job or
disk).
Signals that another variable will be specified.
The comma after AND lets you to continue to
the next line.
Command Descriptions
The following commands create an INVOICE report containing one page for
each of the six groups defined by the GROUP commands. Because the variable
REPORT COST TOTAL is specified, the report also includes a summary page
showing the total costs for all groups.
COST VSE JOB
COUNT 0.20
COST VSE STEP COUNT 0.10
COST VSE STEP DURT
0.00138
COST VSE STEP TCPU
0.25
COST VSE DISK IO
0.005
COST VSE TAPE IO
0.001
GROUP JOBID '- PRODUCTION'(A*)
GROUP JOBID '- TEST JOBS'(B*)
GROUP JOBID '- DEVELOPMENT'(C*)
GROUP JOBID '- PAYROLL'(D*)
GROUP JOBID '- ACCOUNTING'(E*)
GROUP JOBID '- OTHER'(¬A*,¬B*,¬C*,¬D*,¬E*)
INVOICE JOBID(-*),
VSE JOB
COUNT
AND,
VSE JOB
COUNT COST
AND,
VSE STEP COUNT
AND,
VSE STEP COUNT COST
AND,
VSE STEP DURT
HDR(PARTITION OCCUPANCY)
AND,
VSE STEP DURT
COST
AND,
VSE STEP TCPU
HDR(CPU TIME - ss.mmm)
AND,
VSE STEP TCPU
COST
AND,
VSE STEP TCPU
XTIME
VSE STEP TCPU
XTIMEM HDR(CPU TIME - hh:mm:ss:mmm) AND,
VSE DISK IO
HDR(DISK I/O COUNT)
AND,
VSE DISK IO
COST
AND,
VSE TAPE IO
HDR(TAPE I/O COUNT)
AND,
VSE TAPE IO
COST
AND,
HDR(CPU TIME - hh:mm:ss)
AND,
REPORT COST TOTAL
END
RUN
Chapter 6: Commands 185
Command Descriptions
The following is one page of the report created by the preceding commands:
DESCRIPTION
-----------------------------JOB EXECUTION COUNT
STEP EXECUTION COUNT
PARTITION OCCUPANCY
CPU TIME - ss.mmm
CPU TIME - hh:mm:ss
CPU TIME - hh:mm:ss:mmm
DISK I/O COUNT
TAPE I/O COUNT
------------------------------
------------------------------------ PAYROLL
-----------------------------------VALUE
CHARGE
-----------------------21
$4.20
20
$2.00
07:24:26
$36.80
31.47
$7.87
00:00:31
00:00:31.474
35,190
$175.95
0
$0.00
-----------------------$226.82
LINECOUNT Command
The LINECOUNT command is a global command that sets the number of
printed lines allowed per report page. Entering it once sets the line count for
all reports. To avoid printing across page creases, LINECOUNT should be one
of the first commands in your list of commands.
Command Syntax and Operand
LINECOUNT n
Operand
Meaning
n
The maximum number of printed lines per page. The minimum
value is 20, and the maximum value depends on the size of the
paper. The default is 60.
To set your line count at 72 lines per page, use the following command:
LINECOUNT 72
MPLOT Command
The MPLOT command produces a vertical plot similar to that produced by the
VPLOT command, but only the outline of the detail lines is printed. You can
specify as many variables per MPLOT report as you want. For more
information, see the chapter "Plot Reports".
186 Report Reference Guide
Command Descriptions
Command Syntax and Operand
MPLOT variable [options] [SCALE({n},{mX})] [CHAR1(x)][HDR1(text)]
[HDR2(text)] [HDR(text)] [AND,
variable [options] [SCALE({n},{mX})] [CHAR1(x)] [HDR1(text)]
[HDR2(text)] [HDR(text)]] [AND,...]
Operand
Meaning
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID option that
you specify must include at least one identifier.
SCALE(n)
By default, the highest value of a plot's horizontal axis is set
to the highest value of the graphed variables. For variables
that represent percentages, the default maximum value is
100%.
or
SCALE(mX)
or
SCALE(n,mX)
To override this dynamic scale, specify n as the maximum
value. If the variable that you choose produces integers, n
must be an integer. You cannot use more than three digits to
the right of the decimal point when specifying n.
You can also widen the outline of the plot by using the
multiplier mX, where m is an integer.
CHAR1(x)
Sets the plot character. Replace x with any valid EBCDIC
character.
HDR1(text)
Overrides the default top heading for the scale of the plot.
Replace text with the new heading. To remove the header,
replace text with a null string, as in HDR1().
HDR2(text)
Overrides the default bottom heading for the scale of the
plot. Replace text with the new column heading. To remove
the header, replace text with a null string, as in HDR2().
HDR(text)
Overrides the default description beside the SYMBOLS:
heading that describes the plotted variables. Replace text
with the new description, not to exceed 30 characters.
AND,
Signals that another variable will be specified. The variable
will be plotted on the top of the preceding variables. The
comma after AND lets you to continue to the next line.
OPTION Command
The OPTION command is a global command that defines a variety of options
for all reports. Entering it once sets options for all reports.
Chapter 6: Commands 187
Command Descriptions
Command Syntax and Operand
OPTION ([AVERAGE=[NO | YES | n ]
[DEFERRED | DNW | IMMEDIATE]],
[CASE=UPPER],
[DATAONLY=[NO | YES]],
[DATEFRMT=[MM/DD/YY | DD/MM/YY]],
[DEFEREXT=[NO | YES]],
[DELAY=nnn%,DINT=mm]
[DUMP=[NO | YES]][CORRUPT],
[ECHO=[YES | NO]],
[HEXID=[NO | YES]],
[IOERR=[NO | YES | BYPASS]],
[JOBZONE=[nWEST | nEAST]],
[MAXTO=YES | NO]],
[MONETARY=n],
[NULLID=[BLANK | 'xxxx' | n/a]],
[NULLINE=[YES | NO]],
[PERIOD=WEIGHTED]],
[PGMSTOR=[NO | YES]],
[PRODUCT=EVSE|EXPC]
[PWRDATE=[MM/DD/YY | DD/MM/YY]],
[PWRPREFIX=[NO | YES]],
[RANGE=WEIGHTED],
[RECAP=[NO | YES],
[RECORD=n]
[RECSTAT=[NO | YES]],
[REWIND=UNLOAD],
[RPTSTAT=[NO | YES | xxxxx]],
[SEEKCHAR=NUMERIC]
[STORAGE=[BELOW | ABOVE]],
[STORSTAT=[NO | YES]],
[SUMMARY=YES | NO | n],
[TAB2SKIP=[n | PAGE]],
[TRACE=[NO | STORAGE | LOADS]],
[WEEK=weekday]
[XMSG=[nnn | ALL]],
[ZEROFLD=[BLANK | ZERO | 'xxxx']])
The following table describes the command Operrands:
Operand
Meaning
Default
AVERAGE
Specifies whether a line giving
averages of the items listed in the
report should be printed. If you set
AVERAGE=n, the averages are printed
only if the report contains n or more
detail lines.
NO (no average
line)
188 Report Reference Guide
For graph reports,
IMMEDIATE
Command Descriptions
Operand
Meaning
Default
For graph reports, you can specify
when the average is calculated and if it
is weighted. AVERAGE=IMMEDIATE
calculates the average line during data
accumulation. The average is
weighted. AVERAGE=DEFERRED
calculates the average line just prior to
printing the report. The average is
weighted. This setting is useful when
you use the FOR operand or RANGE
DEFERRED command and want the
average line to reflect only the lines
being printed. AVERAGE=DNW
(Deferred Not Weighted) calculates the
average line just prior to printing the
report, but the average is not
weighted.
CASE
Specify CASE=UPPER to force all
output to uppercase. You can also use
the PARM= parameter of your // EXEC
statement to perform this function.
Output is in mixed
case
DATAONLY
Specify YES to print only those lines,
which contain the report data.
Otherwise, all lines are printed. You
can also use the PARM= parameter of
your // EXEC statement to perform
this function.
NO
DATEFRMT
Sets the format of dates in the report
output. You can combine the following
elements in any order:
MM/DD/YY
■
YY or YYYY for year
■
MM for month
■
DD for day
Characters other than those listed
above are assumed to be separators
and appear as entered. For example,
YYYY.MM.DD displays a four-digit year,
a two-digit month, and a two-digit day
separated by periods.
You can also use the PARM=
parameter of your // EXEC statement
to perform this function, as explained
in the "Writing Your Report" chapter in
this guide.
Chapter 6: Commands 189
Command Descriptions
Operand
Meaning
DEFEREXT
NO
Specifies when a user exit should be
called. DEFEREXT=NO passes control
to the exit before any processing is
done with the current record.
DEFEREXT=YES defers the user exit
call until after all selection criteria
have been applied and passes to the
user exit only those records passing all
selection criteria (such as ID options
and RANGE commands).
DELAY
Delays report processing to lessen the DELAY=0% and
DINT=30
impact of the CPU-intensive report
writer. Replace nnn with the
percentage of time that you want to
delay processing. Replace mm with the
interval, in seconds, for which the
percentage is calculated. For example,
if you specify
OPTION(DELAY=50%,DINT=30),
report writer processing will be
delayed 15 seconds every 30 seconds.
DUMP
Specifies whether to print a diagnostic
dump of input records. DUMP=YES
dumps all used records.
DUMP=CORRUPT dumps all records
with detected corruption.
ECHO
YES
Specifies whether to list your report
commands before printing the report.
Set the value to NO only after you
verify the report commands are
correct. Any report commands
preceding the ECHO=NO command in
the jobstream will appear with the
report. You can also use the PARM=
parameter of your // EXEC statement
to perform this function, as explained
in the "Writing Your Report" chapter in
this guide.
HEXID
Specifies whether to allow
nonprintable characters in
identification fields. HEXID=NO treats
any identification field that contains a
nonprintable character as invalid. All
information regarding the resource is
saved and printed under the identifier
190 Report Reference Guide
Default
YES
Command Descriptions
Operand
Meaning
Default
INVALID. HEXID=YES deactivates the
test for nonprintable characters. When
the report is printed, all nonprintable
characters are printed as periods.
IOERR
Determines what happens if the report NO
writer encounters an I/O error in input
data. If IOERR=NO, the report writer
stops and no reports are printed.
IOERR=YES causes the report writer to
treat the error as an end-of-file and
produces reports defined up to that
point. If IOERR=BYPASS, the report
writer will attempt to bypass the error
condition and continue processing
input.
JOBZONE
Sets the job zone (the number of
hours east or west of Greenwich Mean
Time). Specify nEAST or nWEST,
where n is an integer.
MAXTO
YES
Applies only if every report in the run
includes a TO command. By default,
an end-of-file condition is forced when
the maximum TO time specified with
any report is exceeded. If the input file
is not in chronological order, specify
MAXTO=NO to force the entire file to
be read.
MONETARY
$ (dollar sign)
Specifies the character to precede
currency numbers. You can specify any
single character.
NULLID
Defines a four-character string to be
printed in any identifier field for which
no identifier exists. Specify
NULLID=BLANK to print blanks in
fields for which no identifier exists.
The characters n/a
NULLINE
Specifies whether lines with all zero
values should print.
YES for plot
reports; NO for
tabular reports
PERIOD
For a plot report, controls whether the Not weighted for
period line is a weighted value; that is, plot reports.
the average of all the detail lines.
YES for tabular
reports.
PERIOD=WEIGHTED converts the
period line into a weighted value that
Value set by ZONE
parameter of the
IPL SET command
Chapter 6: Commands 191
Command Descriptions
Operand
Meaning
Default
represents a true average over the
period.
For a tabular report, controls whether
period lines are printed.
PGMSTOR
Controls whether the diagnostic
storage analysis facility displays the
storage acquired by each report writer
internal program.
NO
PRINT
For tabular reports only, specify
OTHERS to insert a line above the
summary line that represents all the
data excluded by the FOR operand.
No default
For tabular reports only, specify
GROUP to restrict the report output to
the groups specified by the GROUP
command.
PRINTLEN
Specifies the printed line length.
133
PRODUCT
Specifies the CA Explore PM for z/VSE
product for DEFINE XID or DEFINE
XVAR commands. Specify EVSE for CA
Explore PM for z/VSE or EXPC for CA
Explore PM for CICS.
No default
PWRDATE
Specifies the format of dates in input
VSE/POWER accounting records.
MM/DD/YY
PWRPREFIX
Use only when you are reading raw
VSE/POWER accounting data. If you
have a shared POWER environment
and INPUT(TAPPWRx) is specified,
then you must specify
POWRPREFIX=YES to obtain valid
results.
NO
RANGE
Not weighted
Controls whether the range line of a
plot report is a weighted value; that is,
the average of all the detail lines.
RANGE=WEIGHTED converts the range
line into a weighted value.
RECAP
NO
Specifies whether to produce a
summary value for each identifier in
the report. Depending on the variable,
the summary line includes the total,
average, maximum, or minimum
values of the variable. This option is
valid only for tabular reports organized
192 Report Reference Guide
Command Descriptions
Operand
Meaning
Default
by identifier and time.
No default
RECORD
Specifies the decimal value of the
record type for DEFINE XID or DEFINE
XVAR commands.
RECSTAT
NO
Specifies whether to print statistics
about CA Explore PM for z/VSE records
following your report. RECSTAT=YES
prints information including the
average length of each record, the
percentage of the total disk space that
each record comprises, and the time
period covered by each. This
information can help you to determine
the resources for which CA Explore PM
for z/VSE should collect the data. In
particular, if a given component
contains a large amount of data, but
you rarely run reports on this data,
you may choose to stop collecting that
data in order to reduce the storage
required for the flashback and archive
files.
REWIND
Pertains only when a single tape input Rewind only
file has been specified with the
INPUT(xxxxxxx) command.
REWIND=UNLOAD specifies that the
input tape will rewind and unload when
it reaches an end-of-file or end-ofvolume condition. If you have specified
multiple tape input files, all tapes
automatically rewind and unload.
RPTSTAT
Controls how often the following
message is issued to the console:
NO (no such
messages are
ERPT274I STATUS: CNT - nnnnn. TIME issued)
- mm/dd/yy hh:mm:ss
nnnnn is the current number of input
records processed. mm/dd/yy
hh:mm:ss is the timestamp of the
current record.
RPTSTAT=YES produces a status
message every 10,000 records.
RPTSTAT=nnnnn produces a status
message every nnnnn records. You
can also specify HOUR, DAY, or WEEK
to generate the status message on an
Chapter 6: Commands 193
Command Descriptions
Operand
Meaning
Default
hourly, daily, or weekly interval.
SEEKCHAR
Pertains only to seek analysis reports,
which by default use alphabetic
characters to define data set blocks.
Specify SEEKCHAR=NUMERIC to use a
2-digit identification number if more
than 26 data set blocks exist for any
disk.
Alphabetic
characters
STORAGE
If 31-bit addressing is available,
specifies whether storage is acquired
above or below the 16M line.
ABOVE
STORSTAT
Specifies whether to print storage
statistics following the last report.
STORSTAT=YES prints the storage
amounts allocated to each report and
the total amount of unused virtual
storage.
NO
SUMMARY
YES
Pertains only to tabular reports using
an ID option. SUMMARY=YES prints a
summary line. If you specify
SUMMARY=n, summary lines for the
secondary table in a TAB2 report are
printed only if the secondary table
contains at least n lines. Depending on
the variable, the summary line
includes the total, average, maximum,
or minimum values of the variable.
TAB2SKIP
For TAB2 reports only, controls how
much space is left between identifiers
listed by the TAB command. Either
specify TAB2SKIP=n, where n is the
number of lines to be skipped, or
specify TAB2SKIP=PAGE to generate a
page break after each identifier.
0 (no space)
TRACE
Controls the diagnostic tracing facility.
TRACE=STORAGE causes message
ERPT267I to print every time an
internal storage request is processed.
This message shows the name of the
internal program requesting storage
and shows how much storage the
program is requesting. TRACE=LOADS
causes message ERPT283I to be
printed whenever a report writer
NO
194 Report Reference Guide
Command Descriptions
Operand
Meaning
Default
module is loaded or freed. This
message shows the name of the
module.
WEEK
Specifies the first day of the week
(SUNday, MONday, TUESday,
WEDnesday, THURsday, FRIday, or
SATurday). If you specify the EACH
nnn WEEKs command, you can use
this operand to specify whether a
week is Monday through Sunday,
Tuesday through Monday, and so on.
MONday
XMSG
Excludes messages from printing and
from displaying on the console.
XMSG=nnn excludes message
ERPTnnn from output. XMSG=ALL
excludes all messages.
No messages are
excluded
ZEROFLD
Defines a value to replace any zero
values. ZEROFLD=BLANK replaces any
zero value with a blank.
ZEROFLD=ZERO prints a zero.
ZEROFLD=xxxx replaces each zero
value with xxxx.
BLANK for tabular
reports; ZERO for
graph and plot
reports
The following sample OPTION command does the following:
■
Prints a zero for each zero value in the report
■
Prints lines with all zero values
■
Prints a line showing the average values of the items in the report if the
report contains five or more detail lines
OPTION(ZEROFLD=ZERO,NULLINE=YES,AVERAGE=5)
OUTPUT Command
Use the OUTPUT command to send the report output to the disk or tape file
that you specify. When you use the OUTPUT command to send the report
output to a file, you must include the following statements in your JCL:
Chapter 6: Commands 195
Command Descriptions
Output to a Disk File
For output to a disk file, include the following statements in your JCL:
//ASSGN SYS005,DISK,VOL=volser,SHR
//DLBL filename
Replace volser with the volume ID of your disk device, and replace filename
with the output filename.
Output to a Tape File
For output to a tape file, include the following statements in your JCL:
//ASSGN SYS005,cuu
//TLBL filename
Replace cuu with the CUU of your tape device, and replace filename with the
output filename.
Command Syntax and Operand
OUTPUT{(filename,[SYSnnn],[DATA],[DISK|TAPE],[NOHDR],[NODICT])}
Operand
Meaning
filename
An output TLBL or DLBL name. Specify filename
without any other operands to send your report
output to a sequential output disk file.
SYSnnn
The SYS number corresponding to the ASSGN and
EXTENT cards. The default is SYS005.
DATA
Converts the report output into formatted output
records, which can be processed by a non-CA
product. This operand is valid only for tabular
reports.
DISK
Specifies that the output file will be on disk. This is
the default. This operand is valid only for tabular
reports.
TAPE
Specifies that the output file will be on tape. This
operand is valid only for tabular reports.
NOHDR
Exclude the CA Explore PM for z/VSE standard SMF
record header. This operand is valid only for tabular
reports.
NODICT
Exclude the dictionary record. This operand is valid
only for tabular reports.
196 Report Reference Guide
Command Descriptions
In the following example, the report output is written to the disk file RPTCPU:
//ASSGN SYS000,DISK,VOL=volser,SHR
//DLBL RPTDSA
//OUTPUT(RPTCPU,SYS000)
PERIOD Command
The PERIOD command produces one report per time period, including a
summary of the average activity of variables during a specified time. It can be
used with the PLOT and TAB commands.
You must have the appropriate amount of data in your input file for the time
period you specify. For example, you cannot specify PERIOD YEAR if your input
file has less than one year's data.
Command Syntax and Operand
PERIOD time-period [SKIP=n]
Operand
Meaning
time-period
One of the following base time units. nnn is the
number of time intervals (up to 999) in the time
unit you select. The default is 1.
SKIP=n
■
MINUTE
■
nnn MINUTES
■
HOUR
■
nnn HOURS
■
DAY
■
nnn DAYS
■
WEEK
■
nnn WEEKS
■
MONTH
■
nnn MONTHS
■
YEAR
■
nnn YEARS
Defines the number of lines to skip between
reports for each period. n can range from 1 to 9.
If you do not specify SKIP= n, a page break
occurs between periods.
Chapter 6: Commands 197
Command Descriptions
To request a summary of a resource's average daily activity, use the following
commands:
PLOT variable
PERIOD DAY
END
RUN
For a summary of a resource's average activity every three months, use the
following commands:
TAB variable
PERIOD 3 MONTHS
END
RUN
PLOT Command
The PLOT command produces reports that plot resource usage horizontally
across time. For more information, see the chapter "Plot Reports."
Command Syntax and Operand
PLOT variable [options] [ALONE] [SCALE({n},{mX})] [CHAR1(x)]
[CHAR2(x)]
Operand
Meaning
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID option that
you specify must include at least one identifier.
ALONE
Prevents the display of the global (system-wide) value of the
variable. To use this operand, you must restrict the variable
with an ID option.
SCALE(n)
By default, the highest value of a plot's horizontal axis equals
the highest value reached by a variable in the plot or, for
variables representing percentages, 100%.
or
SCALE(mX)
or
SCALE(n,mX)
To override this dynamic scale, specify n as the maximum
value. If the variable that you choose produces integers, n
must be an integer.
In some cases, bar graphs in a plot report will be too short to
appear. To display these graphs, you can cause each plot
character to appear as m characters by specifying the
multiplier mX, where m is an integer. Since the resulting bar
graphs will no longer correspond numerically to the scale,
this is useful only for determining relative performance.
198 Report Reference Guide
Command Descriptions
Operand
Meaning
CHAR1(x)
Sets the plot character that represents the restricted
variable. Replace x with any valid EBCDIC character.
CHAR2(x)
Sets the plot character that represents the global variable.
Replace x with any valid EBCDIC character.
The following commands plot the value of the variable VSE DISK SIO for disk
0220 and the value for all disks, using a scale of 0 to 5000. The character X
will be used to plot the activity of disk 0220 and a plus sign (+) will be used to
plot the activity of all disks.
PLOT VSE DISK SIO DISKID(0220) SCALE(5000) CHAR1(X) CHAR2(+)
END
RUN
PLOT2 Command
The PLOT2 command is used with the PLOT command to plot two variables
across time. This lets you to compare the performance of two variables sideby-side in a single report to see if a cause-and-effect relationship exists
between the two.
You cannot use the PLOT2 command without the PLOT command. For more
information about PLOT2 command, see the chapter "Plot Reports."
Command Syntax and Operand
PLOT2 variable [options] [ALONE] [SCALE({n},{mX},{COMMON})] [CHAR1(x)]
[CHAR2(x)]
The operands for the PLOT2 command are the same as for the PLOT command
except for the COMMON option of the SCALE operand. Specify
SCALE(COMMON) if you want the same scale to be used to plot both variables.
In the following example, the PLOT and PLOT2 commands are used to
compare the number of SIOs for disk 0220 against its service time, using the
same scale for both variables. Because the ALONE operand is specified, global
activity (the values of the variables for all disks) will not be plotted.
PLOT
VSE DISK SIO
DISKID(0220) ALONE
PLOT2 VSE DISK SERVTIME DISKID(0220) ALONE SCALE(COMMON)
END
RUN
Chapter 6: Commands 199
Command Descriptions
Option Syntax and Operands
The syntax of the PLOT2 command is as follows:
PLOT2 variable [options] [ALONE] [SCALE({n},{mX},{COMMON})] [CHAR1(x)]
[CHAR2(x)]
The operands for the PLOT2 command are the same as for the PLOT command
except for the COMMON option of the SCALE operand. Specify
SCALE(COMMON) if you want the same scale to be used for both the PLOT and
PLOT2 variables.
For more information about the meaning of the other PLOT2 operands, see the
explanations of the PLOT operands in the chapter "Tabular Reports."
Creating a Simple PLOT2 Report
The following commands generate a report that plots the number of disk SIOs
and the disk service time for disk 0550 without plotting the values of those
variables for all disks:
PLOT
VSE DISK SIO
DISKID(0550) ALONE
PLOT2 VSE DISK SERVTIME DISKID(0550) ALONE
EACH HOUR
FROM 03/05/04 10:00:00
TO
END
RUN
200 Report Reference Guide
03/05/04 16:00:00
Command Descriptions
The preceding commands generate a report like the following:
SHIFT NONE
EACH
HOUR
PERIOD NONE
DEVICE I/O SERVICE TIME
0
3421
6843
10265
13687
17109
20530
23952
27374
30796
34218
0
0.003
0.007
0.010
0.013
0.016
0.020
0.023
0.026
0.030
0.033
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
03/05/04 10.00.00 .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.
.
.****************************************************************************************************
11.00.00 .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.****************************************************************
.
.
.
.
12.00.00 .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.****************************************************************
.
.
.
.
13.00.00 .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.*************************************************************
.
.
.
.
14.00.00 .X
.
.
.
.
.
.
.
.
.
.
.******************************************************************* .
.
.
.
15.00.00 .XXX
.
.
.
.
.
.
.
.
.
.
.**********************************************************************
.
.
.
SUMMARY:
.
.
.
.
.
.
.
.
.
.
.
RANGE:
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.****************************************************************
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
0.003
0.007
0.010
0.013
0.016
0.020
0.023
0.026
0.030
0.033
0
3421
6843
10265
13687
17109
20530
23952
27374
30796
34218
SYMBOLS: "X" = DEVICE SIO COUNT
"*" = DEVICE I/O SERVICE TIME
X
*
13449
0.033
25312
0.021
34218
0.021
23026
0.020
295
0.022
1037
0.023
SUMMARY:
12179
0.021
*
X
Converting Counts to Rates
Use the RATE option to plot a rate (number per second) rather than a count.
In the following example, the PLOT command plots the number of SIOs for
disk 0550 against the number of SIOs for all disks, and the PLOT2 command
plots the SIO rate for disk 0550 against the SIO rate for all disks. The CHAR1
and CHAR2 operands assign the plot characters.
PLOT
VSE DISK SIO
DISKID(0550) CHAR1(5) CHAR2(T)
PLOT2 VSE DISK SIO RATE DISKID(0550) CHAR1(r) CHAR2(R)
EACH HOUR
FROM 03/05/04 10:00:00
TO
03/05/04 16:00:00
END
RUN
Chapter 6: Commands 201
Command Descriptions
The preceding commands generate a report like the following:
SHIFT NONE
EACH
HOUR
PERIOD NONE
SYSTEM RECORD RATE PROCESSOR
0
10670
21341
32011
42682
53353
64023
74694
85364
96035 107K
0
2.97
5.93
8.90
11.86
14.83
17.80
20.76
23.73
26.69 29.66
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.....+
03/05/04 10.00.00 .5555555555555TTTTTTTTTTTTTTTTTTTTTTTTTT.
.
.
.
.
.
.
.rrrrrrrrrrrrrRRRRRRRRRRRRRRRRRRRRRRRRRR.
.
.
.
.
.
.
11.00.00 .555555555555555555555555TTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTT
.
.
.
.
.rrrrrrrrrrrrrrrrrrrrrrrrRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
.
.
.
.
12.00.00 .55555555555555555555555555555555TTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTT
.rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
13.00.00 .5555555555555555555555TTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTT .
.
.
.
.
.rrrrrrrrrrrrrrrrrrrrrrRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR .
.
.
.
.
14.00.00 .TTTTTTTTTTTTTTTTTTTTTTTTTTTTTTT
.
.
.
.
.
.
.
.RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
.
.
.
.
.
.
.
15.00.00 .5TTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTT
.
.
.rRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
.
.
SUMMARY:
.
.
.
.
.
.
.
.
.
.
.
RANGE:
.55555555555TTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTT .
.
.
.
.
.
.rrrrrrrrrrrRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.....+
0
2.97
5.93
8.90
11.86
14.83
17.80
20.76
23.73
26.69 29.66
0
10670
21341
32011
42682
53353
64023
74694
85364
96035 107K
SYMBOLS: "5" = DEVICE SIO COUNT
"T" = GLOBAL DEVICE SIO COUNT
"r" = SYSTEM RECORD RATE PROCESSOR
"R" = GLOBAL SYSTEM RECORD RATE PROCESSOR
5
r
T
R
13449 41235
3.74 11.46
25312 68769
7.03 19.11
34218 107K
9.51 29.66
23026 60415
6.40 16.80
295 33056
0.08 9.19
1037 88404
0.29 24.57
SUMMARY:
12179 51479
3.38 14.77
r
5
R
T
In the 3600 seconds between 10:00 and 11:00 a.m., disk 0550 completed
13449 SIOs, which is a rate of 3.74 SIOs per second. Globally, 41235 SIOs
were completed in that period, for a rate of 11.46 SIOs per second.
PRTEXIT
The PRTEXIT command defines a user exit to be called before each line is
printed.
Supplied User Exit
The user exit PRTGUX is predefined for your use.
Command Syntax and Operand
PRTEXIT(user-exit)
Operand
Meaning
user-exit
The name of the user exit
202 Report Reference Guide
Command Descriptions
RANGE Command
The RANGE command sets criteria that must be met before data is included in
a report.
You can use the RANGE command only with report writer variables that have
numeric values.
Command Syntax and Operand
RANGE variable [RATE] min1-max1,min2-max2,... [ALONE] [DEFERRED] [ID rangeid]
[UNDERLINE]
[HIGHLIGHT]
The following table describes the command operrands:
Operand
Meaning
variable
Any numeric report writer variable, to which
the range criteria are to be applied.
RATE
Allows you to specify range values as rates
(number per second). RATE is valid only
when DEFERRED is specified.
min1-max1, min2-max2, ...
Up to 10 minimum and maximum values for
the variable chosen. You can specify a single
value, or a single value followed by a plus
sign (+) to signify no upper boundary. When
you specify a pair, records are included if
the variable value that you specify is greater
than or equal to the minimum value and
less than the maximum value.
ALONE
Applies only if multiple RANGE commands
are used in a single report. If more than one
RANGE command is used, all range criteria
must be satisfied before a record is
accepted. If one range value fails, the
record is discarded. If the ALONE operand is
specified with one RANGE command and the
record passes its range criteria, the record is
accepted and all other RANGE commands
are ignored.
DEFERRED
Waits to apply the range criteria until after
all the input data is read, and then discards
lines having values that do not meet those
range criteria. For example, you would need
to use the DEFERRED operand to report only
Chapter 6: Commands 203
Command Descriptions
Operand
Meaning
those jobs that were executed 10 or more
times, since the report writer is able to
determine this only after it reads all the
input data. The RATE option is valid for the
RANGE command when you use the
DEFERRED operand.
UNDERLINE
Like the DEFERRED operand, waits to apply
range criteria until after all the input data is
read. However, instead of discarding lines
having values that do not meet the range
criteria, the UNDERLINE option prints all
lines and underlines those values that meet
a range criterion.
HIGHLIGHT
Similar to UNDERLINE but prints values
meeting the range criteria in boldface rather
than underlining them. If the report is
printed on a laser printer, these values may
not appear to have been bolded; in that
case, use the UNDERLINE operand instead
of the HIGHLIGHT operand.
ID rangeid
In a tabular report, assigns an identifier to
the specified range of values for the
variable. Rangeid must be 1-8 characters.
You can use the GROUP command specify a
group that includes only those resources
that fall within the range named rangeid.
The GROUP command is explained earlier in
this chapter.
To plot the average duration of jobs that were executed at least three times,
use the following commands:
PLOT VSE JOB DURATION
RANGE VSE JOB DURATION 3+ DEFERRED
END
RUN
204 Report Reference Guide
Command Descriptions
The following example defines groups of steps by their CPU usage and
produces a report on those groups of steps:
GROUP EXPHASE 'CPU CONSUMED: 0 - 1'(*)
RANGE(CPU0)
GROUP EXPHASE 'CPU CONSUMED: 1 - 5'(*)
RANGE(CPU1)
GROUP EXPHASE 'CPU CONSUMED: 5 - 10'(*)
RANGE(CPU5)
GROUP EXPHASE 'CPU CONSUMED: 10 - 20'(*) RANGE(CPU10)
GROUP EXPHASE 'CPU CONSUMED: 20 - 30'(*) RANGE(CPU20)
GROUP EXPHASE 'CPU CONSUMED: 30 - 40'(*) RANGE(CPU30)
GROUP EXPHASE 'CPU CONSUMED: 40 - 50'(*) RANGE(CPU40)
GROUP EXPHASE 'CPU CONSUMED: 50+'(*)
RANGE VSE PACCNT EXCPUTM 0-1
ID CPU0
RANGE VSE PACCNT EXCPUTM 1-5
ID CPU1
RANGE VSE PACCNT EXCPUTM 5-10
ID CPU5
RANGE(CPU50)
RANGE VSE PACCNT EXCPUTM 10-20 ID CPU10
RANGE VSE PACCNT EXCPUTM 20-30 ID CPU20
RANGE VSE PACCNT EXCPUTM 30-40 ID CPU30
RANGE VSE PACCNT EXCPUTM 40-50 ID CPU40
RANGE VSE PACCNT EXCPUTM 50+
ID CPU50
TAB EXPHASE(CPU*),
HDR1(STEP CPU DISTRIBUTION) HDR2(IN SECONDS),
ACIDEN(E) SORT ALPHA,
VSE PACCNT EXSTPCNT
AND,
VSE PACCNT EXSTPCNT PCT
AND,
VSE PACCNT EXCPUTM
AND,
VSE PACCNT EXCPUTM NXTND
AND,
VSE PACCNT EXNLN
AND,
VSE PACCNT EXNPG
END
RUN
RUN Command
The RUN command ends the interpretation of commands and begins the
processing and printing of reports.
The RUN command should be the last command in your jobstream. Any
command after the RUN command is ignored.
Chapter 6: Commands 205
Command Descriptions
Command Syntax
RUN
The following is an example of the RUN command in a jobstream:
TITLE1 REPORT1
PLOT variable
FROM 02/01/04 00.00.01
TO
02/15/04 23.59.59
END
*
TITLE1 REPORT2
PLOT variable
SHIFT 17:00:00 01:00:00
END
.
RUN
SELECT Command
Use the SELECT command to specify the identifiers to be included in or
excluded from a report. This command is particularly useful in restricting the
following types of reports:
■
Canned reports, which cannot otherwise be restricted to specific resources.
The only alternative to using the SELECT command is to use the
commands in the expansion rather than the CANRPT command, tailoring
the report commands as required.
■
Tabular reports not organized by resource, which can otherwise be
restricted only by specifying the ID option and identifiers with every
variable included in the report.
Command Syntax and Operand
SELECT idoption(identifiers)
Operand
Meaning
idoption(identifiers)
Any ID option followed by one or more identifiers of
the appropriate type. You can use generic characters
when specifying identifiers. Separate multiple
identifiers by commas.
206 Report Reference Guide
Command Descriptions
The following commands generate a VSE.DEVICE.STAT canned report. The
SELECT command limits the report to devices not on channel 01.
SELECT DEVID(¬01++)
CANRPT VSE.DEVICE.STAT
END
RUN
The following commands generate a tabular report organized by time but not
by resource. The SELECT command restricts the report to three volumes, an
alternative to specifying the ID option and identifiers
VOLSER(VSE001,VSE002,VSE003) with each variable.
SELECT VOLSER(VSE001,VSE002,VSE003)
TAB TIME VSE DISK SIO
AND,
VSE DISK SIO RATE HDR2(RATE)
AND,
VSE DISK SIO DIFF HDR2(%CHANGE) AND,
VSE DISK SERVTIME
AND,
VSE DISK MAXSERVTIME
AND,
VSE DISK SEEK
AND,
VSE DISK %FAIL
AND,
VSE DISK %ARMMOVE
EACH HOUR
END
RUN
SHIFT Command
The SHIFT command restricts the hours of the day covered by a report.
Like most secondary commands, the SHIFT command cannot be used twice for
the same report, even if two different time periods are specified.
The following figure shows an incorrect use of SHIFT commands in a command
stream and the corrected command stream:
Incorrect Command Stream
Corrected Command Stream
GRAF variable
GRAF variable
SHIFT 08:00:00 12:00:00
SHIFT 13:00:00 17:00:00
SHIFT 08:00:00 17:00:00
END
END
RUN
GRAF variable
SHIFT 13:00:00 17:00:00
END
RUN
Chapter 6: Commands 207
Command Descriptions
Command Syntax and Operand
SHIFT start-time end-time
Operand
Meaning
start-time
Earliest time to include in the report, in hh:mm:ss format,
where hh is hours, mm is minutes, and ss is seconds. You
can use periods instead of colons to separate the hours,
minutes, and seconds.
end-time
Latest time to include in the report, in the same format as
start-time.
To graph only the activity that occurs between 8:00 a.m. and 5:00 p.m., enter
the following:
GRAF variable
SHIFT 08:00:00 17:00:00
END
RUN
Shifts can cross midnight. For example, to write a tabular report that covers
the hours between 11:00 p.m. and 7:00 a.m., use the following commands:
TAB variable
SHIFT 23:00:00 07:00:00
END
RUN
TABulate Command
The TAB command produces tabular reports. The variables you specify with
the TAB command determine the columns in your report and the order in
which they appear. The operands you specify determine:
■
How the report is organized: by time, by classes of or individual identifiers
(such as jobs, disks, or data sets), or by the relationship between
identifiers.
■
How the report is sorted.
■
The column headings that appear in the report.
For more information, see the chapter "Tabular Reports."
208 Report Reference Guide
Command Descriptions
Command Syntax and Operand
TAB [period] [idoption[(identifiers)]] variable [options]
[HDR1(text)] [HDR2(text)] [SORT order] [FOR n] [AND,
variable [options] [HDR1(text)] [HDR2(text)]] [AND,... ]
Operand
Meaning
period
Sets the first column or columns in the report to one of
the following:
■
DATETIME—The date and time
■
DATE—The date
■
TIME—The time
■
DAY—The day (MONDAY, TUESDAY, and so on)
idoption(identifiers
)
Any ID option that is valid for the variable, specified
with or without identifiers. Specifying this operand
causes the resulting report to be organized by the
specified ID option and limited to the identifiers specified
by identifiers. Identifiers are listed in the first column
following any date or time columns.
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID option
that you specify must include at least one identifier.
HDR1(text)
Overrides the default top heading for a column. (Each
column has two default eight-character lines.) Replace
text with the new column heading. To remove the
header, replace text with a null string, as in HDR1().
HDR2(text)
Overrides the default bottom heading for a column.
Replace text with the new column heading. To remove
the header, replace text with a null string, as in HDR2().
SORT order
Sorts the report. Replace order with one of the
following:
■
DESCENDING—Variables are sorted in descending
order starting with the variable the SORT operand is
specified with, and, when the value is the same for
two entries, from left to right. This is the default
sorting order.
■
ASCENDING—Variables are sorted in ascending
order starting with the variable the SORT operand is
specified with, and, when the value is the same for
two entries, from left to right.
■
ALPHA—Variables are sorted in alphanumeric order
Chapter 6: Commands 209
Command Descriptions
Operand
Meaning
with respect to the specified identifier (for example,
by job or disk).
You can use SORT only for reports organized by
identifier (for example, by job). If a report is organized
by time, then it is already sorted.
FOR n
For Reports Organized by:
■
Identifier
■
Identifier and Time or Date
Limits reports to the n identifiers in each time period
that would appear first in the report, where n is an
integer. For reports sorted in descending order, these
are the n most active identifiers. For reports sorted in
ascending order, these are the n least active identifiers.
For reports sorted in alphanumeric order, these are the
n identifiers coming first alphanumerically.
For Reports Organized by Time or Date: Limits reports
to the n times or dates with the highest values for the
first variable specified. For reports sorted by a variable
in descending order, these are the n times or dates with
the highest value for that variable. For reports sorted by
a variable in ascending order, these are the n times or
dates with the lowest value for that variable.
AND,
Signals that another variable will be specified. The
comma after AND lets you to continue to the next line.
The following commands create a tabular report organized by date and time
that shows the number of jobs and steps executed each hour:
TAB DATETIME VSE JOB COUNT
AND,
VSE STEP COUNT
EACH HOUR
END
RUN
The following commands create a tabular report organized by date and time
that shows the five one-hour intervals for which the VSE machine was the
busiest:
TAB DATETIME VSE CPU %BUSYV FOR 5
EACH HOUR
END
RUN
210 Report Reference Guide
Command Descriptions
Command Syntax and Operands
The syntax of the TAB command is as follows:
TAB [period] [idoption[(identifiers)]] variable [options] [HDR1(text)]
[HDR2(text)]
[SORT order] [FOR n] [AND,
variable [options] [HDR1(text)] [HDR2(text)] [AND,...]]
Operands for the TAB command are as follows:
Operand
Meaning
period
Sets the first column or columns in the report to
one of the following:
■
DATETIME—Date and time
■
DATE—Date
■
TIME—Time
■
DAY—Day (MONDAY, TUESDAY, and so on)
idoption(identifiers)
Any ID option that is valid for the variable,
specified with or without identifiers. Specifying
this operand causes the resulting report to be
organized by the specified ID option and limited
to the identifiers specified by identifiers.
Identifiers are listed in the first column following
any date or time columns.
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID
option you specify must include at least one
identifier.
HDR1(text)
Overrides the default top heading for a column.
(Each column has two default eight-character
lines.) Replace text with the new column
heading.
HDR2(text)
Overrides the default bottom heading for a
column. Replace text with the new column
heading.
SORT order
Sorts the report. Replace order with one of the
following:
■
DESCENDING—Variables are sorted in
descending order starting with the variable
the SORT operand is specified with, and,
when the value is the same for two entries,
Chapter 6: Commands 211
Command Descriptions
Operand
Meaning
from left to right. This is the default sorting
order.
■
ASCENDING—Variables are sorted in
ascending order starting with the variable the
SORT operand is specified with, and, when
the value is the same for two entries, from
left to right.
■
ALPHA—Variables are sorted in alphanumeric
order with respect to the specified identifier
(for example, by job or disk).
You can use SORT only if the report is organized
by identifier (for example, by data set). If the
report is organized by time, then it is already
sorted.
FOR n
For Reports Organized by:
■
Identifier
■
Identifier and Time or Date
Identifier: Limits reports to the n identifiers in
each time period that would appear first in the
report, where n is an integer. For reports sorted
in descending order, these are the n most active
identifiers. For reports sorted in ascending order,
these are the n least active identifiers. For reports
sorted in alphanumeric order, these are the n
identifiers coming first alphanumerically.
For Reports Organized by Time or Date: Limits
reports to the n times or dates with the highest
values for the first variable specified. For reports
sorted by a variable in descending order, these
are the n times or dates with the highest value
for that variable. For reports sorted by a variable
in ascending order, these are the n times or dates
with the lowest value for that variable.
AND,
Signals that another variable will be specified.
The comma after AND lets you continue to the
next line.
TAB2 Command
The TAB2 command builds a secondary table for each row of the table created
by the TAB command. For more information, see the chapter "Tabular
Reports."
212 Report Reference Guide
Command Descriptions
Command Syntax and Operand
TAB2 [period | idoption[(identifiers)]] variable [options]
[HDR1(text)] [HDR2(text)] [SORT order] [FOR n] [AND,
variable [options] [HDR1(text)] [HDR2(text)]] AND,...]
The TAB2 command uses the same operands as the TAB command, except
that you cannot specify both a period operand (DATETIME, DATE, TIME, or
DAY) and an ID option.
You cannot use the TAB2 command without the TAB command.
You can use the TAB2 command only if you also specify the TAB command
with an ID option. You can specify a period option (DATETIME, DATE, TIME,
and DAY) with either the TAB command or the TAB2 command, but not with
both. The following commands create a tabular report organized first by the
jobname and then by the date:
TAB
JOBID VSE JOB COUNT
TAB2 DATE
VSE JOB COUNT
EACH 1 DAY
END
RUN
Option Syntax and Operand
The syntax of the TAB2 command is as follows:
TAB2 [period] [idoption[(identifiers)]] variable [options] [HDR1(text)]
[HDR2(text)] [SORT order] [FOR n] [AND,
variable [options] [HDR1(text)] [HDR2(text)]] [AND,...]
The TAB2 command uses the same operands as the TAB command, except
you cannot specify both a period operand (DATETIME, DATE, TIME, or DAY)
and an ID option. You cannot use the TAB2 command without the TAB
command.
You can use the TAB2 command only if you also specify the TAB command
with an ID option. You can specify a period option (DATETIME, DATE, TIME,
and DAY) with either the TAB command or the TAB2 command, but not with
both.
TITLE1, TITLE2, and TITLE3 Commands
Three 60-character lines at the top of each page are reserved for titles. The
TITLE1, TITLE2, and TITLE3 commands write titles on the first, second, and
third lines, respectively. If you do not use the TITLE commands, the report
writer assigns its own title lines to the report.
Chapter 6: Commands 213
Command Descriptions
Titles are printed only for the report in which the TITLE commands occur. Use
the GLOBAL TITLEn command to print the same title for all reports in one run.
The TITLE1 title is printed first, the TITLE2 title is printed below it, and the
TITLE3 title appears last. You must specify the TITLE1, TITLE2, and TITLE3
commands in that order. You can use none, one, or all of these commands in
any combination.
Command Syntax and Operand
TITLE1 titletext
TITLE2 titletext
TITLE3 titletext
Operand
Meaning
titletext
Title that you assign to the report, up to 60 characters. Every
character in titletext must be on the same line as the TITLE1,
TITLE2, or TITLE3 command; you cannot continue titles with a
continuation character.
To dynamically insert dates and times into titletext, use the
keywords described in the next section.
Keywords
You can use keywords to dynamically place dates and times in your report
titles. Keywords have the following format:
&SourceRangeFormat
Replace the variables as shown following:
Replace
With
&Source
One of the following to determine the origin of the
dates and times:
Range
214 Report Reference Guide
■
C—Uses report command specifications
■
R—Uses the starting and ending times for the data
in the report
■
E—Uses the EACH command specifications
■
P—Uses the PERIOD command specifications
One of the following to determine whether to take data
from the FROM command or the TO command:
■
F— Uses the FROM command specification
■
T—Uses the TO command specification
T
Command Descriptions
Replace
With
Format
One of the following to determine the format of the
date and time:
■
WEEKDAY—Monday, Tuesday, and so on
■
DATE—mm/dd/yy or dd/mm/yy (European format)
■
DAY—dd
■
EDAY—dd, if your dates are in European format
■
MONTH—mm
■
EMONTH—mm, if your dates are in European
format
■
YEAR—yy
■
TIME—hh:mm:ss
■
HOUR— hh
■
MINUTE—mm
■
SECOND—ss
■
CALMONTH—January, February, and so on
■
JDAY—ddd (Julian date)
To have the title CPU Utilization by Hour appear on title line 2, enter the
following command:
TITLE2 CPU Utilization by Hour
The following commands dynamically create a date and time on title lines 2
and 3, determined by the data in the report and the FROM and TO commands:
TITLE2 FROM:
TITLE3 TO:
&RFWEEKDAY, &RFCALMONTH &RFDAY, 19&RFYEAR
&RTWEEKDAY, &RTCALMONTH &RTDAY, 19&RFYEAR
at
at
&RFTIME
&RTTIME
The following is sample output for the preceding commands:
FROM: Wednesday, January 28, 2004
TO:
Monday, February 02, 2004
at
at
02.58.00
11.23.59
VPLOT Command
The VPLOT command plots resource usage in vertical columns. The horizontal
axis of the plot represents time. For more information, see the chapter "Plot
Reports."
Chapter 6: Commands 215
Command Descriptions
Command Syntax and Operand
VPLOT var [options] [SCALE({n},{mX})] [STACK=id] [CHAR1(x)]
[HDR1(txt)] [HDR2(txt)] [HDR(txt)] [CYLINDER] [XDSN]
Operand
Meaning
var
Any report writer variable.
options
Any valid variable options or ID options. Each ID option must include
at least one identifier.
SCALE(n)
By default, the highest value of a plot's vertical axis equals the
highest value reached by a variable in the plot or, for variables
representing percentages, 100%.
or
SCALE(mX)
or
SCALE(n,mX)
To override this dynamic scale, specify n as the maximum value. If
the variable that you choose produces integers, n must be an integer.
You can also widen each plot column by using the multiplier mX,
where m is an integer.
STACK=id
Replaces the plot character with the identifiers being plotted, from
most active to least active starting at the bottom of the graph. You
can specify the mX option of the SCALE operand to print more
characters of each identifier.
CHAR1(x)
Sets the plot character. Replace x with any valid EBCDIC character.
HDR1(txt)
Overrides the default top heading for the scale to the left of the plot.
Replace txt with the new heading. To remove the header, replace txt
with a null string, as in HDR1().
HDR2(txt)
Overrides the default bottom heading for the scale to the left of the
plot. Replace txt with the new heading. To remove the header, replace
txt with a null string, as in HDR2().
HDR(txt)
Overrides the default description beside the SYMBOLS: heading that
describes the plotted variable. Replace txt with the new description,
not to exceed 30 characters.
CYLINDER
Changes the horizontal axis from time to cylinders. This option is valid
only when plotting disk seeks. For more information, see the chapter
"Plot Reports."
XDSN
Prints extended data set information after the plot. This option is valid
only when plotting disk seeks. For more information, see the chapter
"Plot Reports."
216 Report Reference Guide
Structure of Variable Names
The following commands plot CPU utilization against time using the letter T as
the plot character:
T
VPLOT VSE CPU UTILIZATION CHAR1(T)
END
RUN
VPLOT2 Command
The VPLOT2 command is used with the VPLOT command to plot two variables
across time. This lets you to compare the performance of two variables sideby-side in a single report to see if a cause-and-effect relationship exists
between them. The VPLOT2 variable is printed directly over the VPLOT
variable. For more information, see the chapter "Plot Reports."
You cannot use the VPLOT2 command without the VPLOT command.
Command Syntax and Operand
VPLOT2 variable [options] [SCALE({n},{mX},{COMMON})] [CHAR1(x)]
[HDR1(text)] [HDR2(text)] [HDR(text)]
The operands for the VPLOT2 command are the same as for the VPLOT
command except that the VPLOT2 command does not support the CYLINDER,
XDSN, or STACK operands, and it does support the COMMON option of the
SCALE operand. Specify SCALE(COMMON) if you want the same scale to be
used to plot both variables. The following commands plot the disk SIO rate
with Os and CPU utilization with Xs:
VPLOT
VSE DISK SIO RATE
VPLOT2 VSE CPU UTILIZATION
CHAR1(O)
CHAR1(X)
END
RUN
Structure of Variable Names
Report-writer variables have the following structure:
system variable-class variable-name
Report-writer variables have the following parts:
Part
Description
system
Use the following to identify the source of the variable's
data:
Chapter 6: Commands 217
Variable Descriptions
■
VSE—Data collected by CA Explore PM for z/VSE
variable-class
One of the variable classes listed in the next section (for
VSE variables). For example, CPU and DISK are both
valid variable classes for VSE variables.
variable-name
A variable name from the variable class selected. For
example, both BYPASS-REQ and CACHE-TO-DASD are
valid variable names for the variable class CACHE.
Variable Descriptions
The following sections list and describe all report-writer variables except for
VSE/POWER accounting (PACCNT) variables. The variables are presented
alphabetically according to record type.
Variable Class
Variable Class
CACHE
LTA
CHANNEL
MCPU
CONTENTION
OPERATOR
COUNT
OTHER
CPU
PAGE
DATASPACE
PHASE
DEVICE
REAL
DISK, RDISK, VDISK
SAMPLE
DSN
SGETVIS
DYNAMIC
STEP
GETVIS
SVC
INTERRUPT
SYSTEM
INTERVAL
TAPE
JOB
THRESHOLD
LOCK
VM
LPAR
WAIT
Units of Measure
All variables that represent time are displayed in seconds.
218 Report Reference Guide
Variable Descriptions
Explanation of the Data Column Heading
In the following tables, the words in the Data column indicate that the
variables represent one or more of the following data types:
Data Type
Meaning
System
Total system values that cannot be used in a jobrelated, step-related, or task-related report.
Both
Supported on both the system level as well as the joblevel, step-level, or task-level.
Job
Job-related report data available.
Step
Step-related report data available.
Task
Task-related report data available.
CACHE Variable Class
The following table describes each variable:
Syste
m
Class
VSE
Variable Name
Data
Description
CACHE BYPASS-REQ
System
Number of operations
specifying BYPASS CACHE.
VSE
CACHE CACHE-TO-DASD
System
Number of cache-to-DASD
transfer operations.
VSE
CACHE DASD-TO-CACHE
System
Number of DASD-to-cache
transfer operations.
VSE
CACHE DASDFW-FORCED System
Number of DASD fast-write
operations that were forced to
access DASD directly because
of the constraints on
nonvolatile storage space.
VSE
CACHE DASDFW-HITS
System
Number of DASD fast-write
request hits.
VSE
CACHE DASDFW-NORMWRITE
System
Number of normal writes to a
device in DASD fast write
mode.
VSE
CACHE DASDFW-SEQHITS
System
Number of sequential write
cache hits to a device in DASD
fast write mode.
Chapter 6: Commands 219
Variable Descriptions
Syste
m
Class
VSE
Data
Description
CACHE DASDFW-SEQWRITE
System
Number of sequential writes
to a device in DASD fast write
mode.
VSE
CACHE INHIBIT-LOADREQ
System
Number of operations
specifying INHIBIT CACHE
LOAD.
VSE
CACHE READ-CFW-HITS
System
Number of CACHE FAST
WRITE read cache hits.
VSE
CACHE READ-CFW-REQS
System
Number of CACHE FAST
WRITE read operations.
VSE
CACHE READ-NORM-HITS System
Number of normal read cache
hits.
VSE
CACHE READ-NORMREQS
System
Number of normal read
operations.
VSE
CACHE READ-SEQ-HITS
System
Number of sequential read
cache hits.
VSE
CACHE READ-SEQ-REQS
System
Number of sequential read
operations.
VSE
CACHE SEQ-DASD-TOCACHE
System
Number of sequential DASDto-cache transfer operations.
VSE
CACHE SEQ-DETECTEDREQS
System
Number of sequentialdetected sequential access
read requests.
VSE
CACHE SSID
System
Subsystem identifier.
VSE
CACHE STATUS-GROUP2
System
Device status, group 2.
VSE
CACHE STATUS1
System
Byte 1 of the device status,
group 1.
VSE
CACHE STATUS2
System
Byte 2 of the device status,
group 1.
VSE
CACHE UNIT
System
Device unit address.
VSE
CACHE WRITE-CFW-HITS
System
Number of CACHE FAST
WRITE write cache hits.
VSE
CACHE WRITE-CFW-REQS System
Number of CACHE FAST
WRITE write operations.
VSE
CACHE WRITE-NORMREQS
Number of normal write
operations.
220 Report Reference Guide
Variable Name
System
Variable Descriptions
Syste
m
Class
Variable Name
Data
Description
VSE
CACHE WRITE-SEQ-REQS System
Number of sequential write
operations.
VSE
CACHE WRITE-SEQ-REQS System
Number of sequential write
operations.
ID Options
The following ID options can be used with any CACHE variable:
■
CACHSSID
■
ENDTIME
■
CACHUNIT
■
PNET
■
CPUID
■
STARTTIME
■
CPUMOD
■
VMID
■
DISKID
■
VOLSER
For more information about cache statistics, see the IBM's, 3390 Storage
Control Reference (GA32-0090).
CHANNEL Variable Class
The following table describes each variable:
System
Class
Variable Name
Data
Description
VSE
CHANNEL
%CPUDEV-NOOVERLAP
System
Percentage of time that the
CPU was waiting while at least
one outstanding I/O to a tape
or disk device was on the
channel, based on sample
counts. The sum of
%CPUDEV-NOOVERLAP and
%CPU-OVERLAP equals 100.
VSE
CHANNEL
%CPUDEV-OVERLAP
System
Percentage of time that the
CPU was busy while at least
Chapter 6: Commands 221
Variable Descriptions
System
Class
Variable Name
Data
Description
one outstanding I/O to a tape
or disk device was on the
channel, based on sample
counts. The sum of
%CPUDEV-OVERLAP and
%CPU-NOOVERLAP is 100.
VSE
CHANNEL
%DEVBUSY
System
Percentage of time that at least
one outstanding I/O to a tape
or disk device was on the
channel, based on sample
counts.
VSE
CHANNEL
%DEVCPUBUSY
System
Percentage of time that the
CPU was busy and at least one
outstanding I/O to a device
was on the channel, based on
sample counts. The sum of
%DEVCPUBUSY and
%DEVCPUWAIT equals
%DEVBUSY.
VSE
CHANNEL
%DEVCPUWAIT
System
Percentage of time that the
CPU was waiting and at least
one outstanding I/O to a
device was on the channel,
based on sample counts. The
sum of %DEVCPUWAIT and
%DEVCPUBUSY equals
%DEVBUSY.
VSE
CHANNEL
%FAIL
System
Percentage of SIOs that failed.
VSE
CHANNEL
%FAIL-CB
System
Percentage of SIOs that failed
because of channel busy.
VSE
CHANNEL
%WAITIDLE
System
Percentage of time the CPU
was waiting and no I/Os to
tape or disk devices on the
channel were outstanding,
based on the number of times
the CPU was sampled in a wait
state.
VSE
CHANNEL
%WAITIO
System
Percentage of time the CPU
was waiting and at least one
I/O to a tape or disk device on
the channel was outstanding,
based on the number of times
the CPU was sampled in a wait
222 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
state.
VSE
CHANNEL
BUSY|
System
Percentage of channel busy
samples prior to SIO. Valid
only for native VSE.
UTILization
VSE
CHANNEL
BUSYS
System
Percentage of channel busy
samples for a time interval.
Valid only for native VSE.
VSE
CHANNEL
DEVBUSY
System
Average active device count.
Valid only for 370 and VM
modes.
VSE
CHANNEL
FAIL
System
Number of SIOs that failed.
VSE
CHANNEL
FAIL-CB
System
Number of SIOs that failed
because of channel busy.
VSE
CHANNEL
INTERRUPTs
System
Number of I/O interrupts.
VSE
CHANNEL
IOs|SIO
System
I/O count.
VSE
CHANNEL
MAXQ-DEPTH
System
Maximum queue depth.
VSE
CHANNEL
MAXDEVBUSY
System
Maximum active device count.
Valid only for 370 and VM
modes.
VSE
CHANNEL
Q-DEPTH
System
Average maximum queue
depth.
VSE
CHANNEL
TYPE
System
Channel type (block, byte, or
SEL).
VSE
CHANNEL
XABUSYS
System
Channel path utilization (XA
I/O).
ID Options
The following ID options can be used with any CHANNEL variable except VSE
CHANNEL XABUSYS:
■
CHNID
■
PNET
■
CPUID
■
STARTTIME
■
CPUMOD
■
VMID
■
ENDTIME
Chapter 6: Commands 223
Variable Descriptions
The following ID options can be used with the variable VSE CHANNEL
XABUSYS:
■
CHPID
■
PNET
■
CPUID
■
STARTTIME
■
CPUMOD
■
VMID
■
ENDTIME
If You Are Using XA I/O
If you are using the XA I/O channel-monitoring subsystem, for CHANNEL
variables other than VSE CHANNEL XABUSYS, the channel that the value of
the variable is attributed to comes from the first two digits of the device ID.
For example, if the device ID begins with 01, then the variable value is
attributed to channel 01.
CONTENTION Variable Class
The following table describes each variable of this class:
Syste
m
Class
Variable
Name
Data
VSE
CONTENTIO
N
CODE
Job, Step, Task VSE wait code, in
hexadecimal.
VSE
CONTENTIO
N
COUNT
Job, Step, Task Number of times
contention occurred.
VSE
CONTENTIO
N
JOBNAME Job, Step, Task Name of the job that
owned the resource (for
VSE 1.3 or later).
VSE
CONTENTIO
N
PID
VSE
CONTENTIO
N
STEPNAM Job, Step, Task Name of the step that
E
owned the resource (for
VSE 1.3 or later).
VSE
CONTENTIO
N
TID
Job, Step, Task Task ID that owned the
resource.
VSE
CONTENTIO
TYPE
Job, Step, Task Eight-character wait
224 Report Reference Guide
Description
Job, Step, Task Partition ID that owned
the resource.
Variable Descriptions
N
description.
ID Options
The following ID options can be used with any CONTENTION variable:
■
CONJOBID
■
PNET
■
CONPID
■
STARTTIME
■
CONSTEPID
■
STEPID
■
CONTID
■
STEPSEQ#
■
CPUID
■
TASKID
■
CPUMOD
■
TASKNAME
■
ENDTIME
■
USERID
■
JOBID
■
VMID
■
PID
■
WAITID
COUNT Variable Class
The COUNT variable class displays the number of input records that have been
read.
System
Class
Variable Name
Data
Description
VSE
COUNT
ESMFCAC
System
System disk cache record.
VSE
COUNT
ESMFCHN
System
System channel record.
VSE
COUNT
ESMFCHP
System
System channel path record.
VSE
COUNT
ESMFCONT
Job, Step, Task
End-of-step task contention analysis
record.
Chapter 6: Commands 225
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
COUNT
ESMFDELY
Job, Step, Task
End-of-step task delay analysis record.
VSE
COUNT
ESMFDEV
System
System device record.
VSE
COUNT
ESMFDSNX
Job, Step, Task
End-of-step task disk DSN record.
VSE
COUNT
ESMFEOJ
Job, Step
End-of-job record.
VSE
COUNT
ESMFEOS
Job, Step
End-of-step record.
VSE
COUNT
ESMFJAC
Job, Step
End-of-step job accounting record.
VSE
COUNT
ESMFLCK
Job, Step, Task
End-of-step task lock record.
VSE
COUNT
ESMFORPH
Job, Step, Task
End-of-step orphaned storage record.
VSE
COUNT
ESMFPAG
System
System paging record.
VSE
COUNT
ESMFPOWA
Job, Step
VSE/POWER accounting record.
VSE
COUNT
ESMFPRSM
System
LPAR or VM CPU activity record.
VSE
COUNT
ESMFSAM
System
System one-minute interval record.
VSE
COUNT
ESMFSDS
System
System data set record.
VSE
COUNT
ESMFSDSK
Job, Step, Task
End-of-step task disk record.
VSE
COUNT
ESMFSEK
System
System disk cylinder activity record.
VSE
COUNT
ESMFSJS
Job, Step
Start-of-job or -step record.
VSE
COUNT
ESMFSOIO
Job, Step, Task
End-of-step task non-disk device record.
VSE
COUNT
ESMFSPHS
Job, Step, Task
End-of-step task phase record.
VSE
COUNT
ESMFSPSV
Job, Step, Task
End-of-step task phase SVC record.
VSE
COUNT
ESMFSSV
System
System SVC record.
VSE
COUNT
ESMFSTSK
Job, Step, Task
End-of-step task record.
VSE
COUNT
ESMFSTSV
Job, Step, Task
End-of-step task SVC record
VSE
COUNT
ESMFSXA
System
System XA device record
VSE
COUNT
ESMFSYS
System
System interval record
VSE
COUNT
ESMFTHR
System
Threshold record
226 Report Reference Guide
Variable Descriptions
ID Options
Each of the variable names for the COUNT variable class has a different set of
valid ID options. Each set of ID options is identical to the ID options for a
related variable class.
The following table lists the COUNT variable name, the variable class with
which it shares ID options, and the page number where those ID options are
listed:
Variable Name
Variable Class Having Identical ID Options
ESMFCAC
CACHE
ESMFCHN
CHANNEL
ESMFCHP
The variable VSE CHANNEL XABUSYS
ESMFCONT
CONTENTION
ESMFDELY
Non-system WAIT variables
ESMFDEV
System DEVICE variables
ESMFDSNX
Non-system DSN variables
ESMFEOJ
STEP, excluding the ID option STEPID
ESMFEOS
STEP
ESMFJAC
STEP
ESMFLCK
LOCK
ESMFORPH
Non-system SGETVIS variables
ESMFPAG
System PAGE variables
ESMFLCK
LOCK
ESMFORPH
Non-system SGETVIS variables
ESMFPAG
System PAGE variables
ESMFPOWA
PACCNT, only ID options beginning with AC
ESMFPRSM
LPAR
ESMFSAM
SAMPLE
ESMFSDS
System DSN variables
ESMFSDSK
Non-system DISK variables
ESMFSEK
System DISK variables
ESMFSJS
STEP
ESMFSOIO
Non-system DEVICE variables
Chapter 6: Commands 227
Variable Descriptions
Variable Name
Variable Class Having Identical ID Options
ESMFSPHS
PHASE
ESMFSPSV
Non-system SVC variables
ESMFSSV
System SVC variables
ESMFSTSK
Non-system CPU variables
ESMFSTSV
Non-system SVC variables
ESMFSXA
System DEVICE variables
ESMFSYS
System CPU variables
ESMFTHR
THRESHOLD
CPU Variable Class
For more information about CPU variable class when you are using the
VSE/ESA Turbo Dispatcher environment, see MCPU Variable Class.
System
Class
Variable Name
Data
Description
VSE
CPU
%BUSYReal
System
Percentage of time that a VSE machine was
running using the real processor. For an LPAR
or VM environment, use VSE LPAR %TOTAL
or VSE VM %TTIME for a more accurate
representation of the real CPU utilization.
VSE
CPU
%BUSYSample| Both
%ACTIVESample
Percentage of time CPU was sampled as busy.
This can be used by users who do not use job
accounting.
VSE
CPU
%BUSYVirt|
System
Percentage of time CPU was running using
the CPU timer. This is the preferred variable
for system CPU busy for all users. For VM or
PR/SM users, it gives the percentage as if the
VSE machine were running stand-alone on
the real processor.
System
Percentage of time a VSE machine wanted to
run but could not because of higher priority
virtual machines or LPARS. Valid for VM and
PR/SM users. Its value is defined as the total
length of time in the interval minus the length
of time the VSE machine was allowed to run,
divided by the length of time in the interval.
Increasing the priority of this machine
reduces this number.
UTILization
VSE
CPU
%CONTention
228 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
CPU
%LTA
Both
Percentage of time CPU was sampled as
active and running in the LTA.
VSE
CPU
%PROBLEM
Both
Percentage of time CPU was sampled as
active and running in problem state. This
variable is not available in the VSE Turbo
Dispatcher environment or if more than one
CPU is active.
VSE
CPU
%SUPERVISOR
Both
Percentage of time CPU was sampled as
active and running in supervisor state. This
variable is not available in the VSE Turbo
Dispatcher environment or if more than one
CPU is active.
VSE
CPU
%WAITV
System
Percentage of time CPU was inactive using
the CPU timer.
VSE
CPU
%WAITIDLE
System
Percentage of CPU wait time when no I/Os to
tape or disk were outstanding. The sum of
%WAITIDLE and %WAITIO is 100.
VSE
CPU
%WAITIDLE-TOT System
Percentage of time the CPU was waiting when
there were no I/Os to tape or disk
outstanding. The sum of %WAITIDLE-TOT,
%BUSYV, and %WAITIO-TOT is 100.
VSE
CPU
%WAITIO
System
Percentage of CPU wait time when at least
one I/O to tape or disk was outstanding. The
sum of %WAITIO and %WAITIDLE is 100.
VSE
CPU
%WAITIO-TOT
System
Percentage of time the CPU was waiting when
at least one I/O to tape or disk was
outstanding. The sum of %WAITIO-TOT,
%BUSYV, and %WAITIDLE-TOT is 100.
VSE
CPU
%WAITSample
Both
Percentage of time CPU was sampled as
waiting.
VSE
CPU
BUSYVirt
System
Length of time CPU was running using the
CPU timer. This is the preferred variable for
system CPU busy for all users. For VM or
PR/SM users, it gives the number of CPU
seconds as if the VSE machine were running
stand-alone on the real processor.
VSE
CPU
CONTention
System
Length of time a VSE machine wanted to run
but could not because of higher priority
virtual machines or LPARS. Valid for VM and
PR/SM users. Its value is defined as the total
length of time in the interval minus the length
of time the VSE machine was allowed to run,
Chapter 6: Commands 229
Variable Descriptions
System
Class
Variable Name
Data
Description
divided by the amount of time in the interval.
Increasing the priority of this machine
reduces this value. On native VSE systems,
this is the length of time the CPU was
manually stopped.
VSE
CPU
WAITV
System
Total time the CPU was inactive using the
CPU timer.
VSE
CPU
WAITIDLE
System
Length of time the CPU was waiting and there
were no I/Os to tape or disk outstanding.
VSE
CPU
WAITIO
System
Length of time the CPU was waiting and at
least one I/O to tape or disk was outstanding.
ID Options
The following ID options can be used with any system CPU variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system CPU variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
230 Report Reference Guide
Variable Descriptions
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
DATASPACE Variable Class
The DATASPACE variable class is valid only for VSE 1.3 or later.
Syste
m
Class
Variable
Name
Data
Description
VSE
DATASPAC
E
COUNT
System,
Job, Step
Number of data spaces, in K,
on the system. Sampling is
performed at the end of the
SYSTIMEI interval.
VSE
DATASPAC
E
SIZE
System,
Job, Step
Amount of virtual storage, in
K, used for all data spaces in
the system. Sampling is
Chapter 6: Commands 231
Variable Descriptions
performed at the end of the
SYSTIMEI interval.
ID Options
The following ID options can be used with any DATASPACE variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
DEVICE Variable Class
The following table describes each variable of this class:
Syste
m
Class
VSE
Data
Description
DEVICE %FAIL
System
Percentage of SIOs that failed.
VSE
DEVICE %FAIL-CB
System
Percentage of SIOs that failed
because of channel busy. Valid
for 370 mode only.
VSE
DEVICE %FAIL-CUB
System
Percentage of SIOs that failed
because of control unit busy.
Valid for 370 mode only.
VSE
DEVICE %FAIL-DB
System
Percentage of SIOs that failed
because of device busy. Valid for
370 mode only.
VSE
DEVICE BUSY|UTILizat Both
ion
Percentage of time device is
active.
VSE
DEVICE DESCRIPTION
System
25-character description of
device.
VSE
DEVICE FAIL
System
Number of SIOs that failed.
VSE
DEVICE FAIL-CB
System
Number of SIOs that failed
because of channel busy. Valid
for 370 mode only.
VSE
DEVICE FAIL-CUB
System
Number of SIOs that failed
because of control unit busy.
232 Report Reference Guide
Variable
Name
Variable Descriptions
Syste
m
Class
Variable
Name
Data
Description
Valid for 370 mode only.
VSE
DEVICE FAIL-DB
System
Number of SIOs that failed
because of device busy. Valid for
370 mode only.
VSE
DEVICE IOTIME|I/OTI
ME
Both
Total active time.
VSE
DEVICE MAXQ-DEPTH
System
Maximum queue depth.
VSE
DEVICE MAXSERVTIM
E
Both
Maximum I/O service time.
VSE
DEVICE Q-DEPTH
System
Average maximum queue depth.
VSE
DEVICE Q-TIME
Both
Average length of time the I/O
request was on the channel
queue.
VSE
DEVICE READS
System
Number of read CCW
commands.
VSE
DEVICE SENSE
System
Number of sense or diagnostic
CCW commands.
VSE
DEVICE SERVTIME
Both
Average I/O service time.
VSE
DEVICE SIOs|I/O|IO
Both
SIO count.
VSE
DEVICE TYPE
System
Device type and model (eight
characters).
VSE
DEVICE UTILTIME
Both
Device utilization time (the
average amount of time between
the start I/O and I/O interrupt).
VSE
DEVICE WRITES
System
Number of write CCW
commands.
ID Options
The following ID options can be used with any system DEVICE variable:
■
CPUID
■
CPUMOD
■
DEVID
Chapter 6: Commands 233
Variable Descriptions
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system DEVICE variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DEVID
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
234 Report Reference Guide
Variable Descriptions
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
DISK Variable Class
The following table describes each variable of this class:
Syste
m
Class Variable
Name
Data
VSE
DISK
%ARMMOVE
System Percentage of seeks causing arm
movement. (Cache hits do not
cause arm movement.)
VSE
DISK
%FAIL
System Percentage of SIOs that failed.
VSE
DISK
%FAIL-CB
System Percentage of SIOs that failed
because of channel busy. Valid for
370 mode only.
VSE
DISK
%FAIL-CUB
System Percentage of SIOs that failed
because of control unit busy. Valid
for 370 mode only.
VSE
DISK
%FAIL-DB
System Percentage of SIOs that failed
because of device busy. Valid for
370 mode only.
VSE
DISK
%QUEUED
System Percentage of times that an I/O
request to a device had to be
queued because another I/O was
already active.
VSE
DISK
%ZEROSEEK
System Percentage of seeks not causing an
arm move. (Cache hits do not
cause arm movement.)
VSE
DISK
ARMMOVE
System Number of seeks causing arm
movement. (Cache hits do not
cause arm movement.)
VSE
DISK
AVGSEEKD
System Average seek distance. (Cache hits
do not cause arm movement.)
Description
Chapter 6: Commands 235
Variable Descriptions
Syste
m
Class Variable
Name
VSE
DISK
BUSY|UTILizat Both
ion
VSE
DISK
FAIL
System Number of SIOs that failed.
VSE
DISK
FAIL-CB
System Number of SIOs that failed because
of channel busy. Valid for 370
mode only.
VSE
DISK
FAIL-CUB
System Number of SIOs that failed because
of control unit busy. Valid for 370
mode only.
VSE
DISK
FAIL-DB
System Number of SIOs that failed because
of device busy. Valid for 370 mode
only.
VSE
DISK
MAXQ-DEPTH
System Maximum queue depth.
VSE
DISK
MAXSERVTIME Both
VSE
DISK
NOSEEK
System Number of I/Os with no seek data.
VSE
DISK
NOSEEKUTILTIME
System Disk utilization time (the average
amount of time between the start
I/O and I/O interrupt), restricted to
I/Os with no seek data.
VSE
DISK
Q-DEPTH
System Average maximum queue depth.
VSE
DISK
Q-LENgth
System Average device queue length.
VSE
DISK
Q-TIME
Both
VSE
DISK
QUEUED
System Number of times that an I/O
request to a device had to be
queued because another I/O was
already active.
VSE
DISK
READS
System Number of read CCW commands.
VSE
DISK
RESERVEs
System Number of disk reserves (number
of times the CCW command was
used to prevent other CPUs from
writing to a specified disk—
normally, the disk containing the
lock file).
VSE
DISK
SEEKs
System Seek count.
236 Report Reference Guide
Data
Description
Percentage of time disk is active.
Maximum I/O service time (the
time between the I/O request
being queued on the channel and
the I/O interrupt).
Average length of time I/O request
was on the channel queue.
Variable Descriptions
Syste
m
Class Variable
Name
Data
VSE
DISK
SEEKUTILTIME
System Disk utilization time (the average
amount of time between the start
I/O and I/O interrupt), restricted to
I/Os with seek data.
VSE
DISK
SENSE
System Number of sense or diagnostic
CCW commands.
VSE
DISK
SERVTIME
Both
Average I/O service time (the time
between the I/O request being
queued on the channel and the I/O
interrupt).
VSE
DISK
SIOs|I/O|IO
Both
SIO count.
VSE
DISK
SUBSYSTEM
System Number of I/O operations that
change or request information from
a cache controller, such as the IBM
3990 model 3 and 6.
VSE
DISK
TOTSEEKD
System Total seek distance.
VSE
DISK
TYPE
System Disk type and model (eight
characters).
VSE
DISK
UTILTIME
Both
VSE
DISK
WRITES
System Number of write CCW commands.
VSE
DISK
ZEROSEEK
System Number of seeks not causing an
arm move.
Description
Disk utilization time (the average
amount of time between the start
I/O and I/O interrupt).
Variables Valid For XA I/O Users Only
The following variables are valid only if you are using the XA I/O channelmonitoring subsystem. For more information about the XA I/O channelmonitoring subsystem, see IBM's ESA/390 Principles of Operations (SA227201-00).
Syste
m
Class
Variable
Name
Data
Description
VSE
DISK
ACTIVE
System Average disk service time (total
of VSE DISK CONNect, VSE DISK
DISConnect, and VSE DISK
PENDing). This value should
approximately equal VSE DISK
Chapter 6: Commands 237
Variable Descriptions
UTILTIME.
VSE
DISK
CONNect
System Average time, in seconds, spent
transferring commands and data
between the subchannel and the
channel subsystem.
VSE
DISK
DISConnect
System Average time, in seconds, that
the disk was logically
disconnected from the channel
subsystem while the subchannel
was active, including seek time,
latency, and RPS reconnect time.
VSE
DISK
PENDing
System Average time, in seconds,
between VSE issuing the start
subchannel and the first CCW
command being executed on the
actual subchannel.
VSE
DISK
SAMPLEs
System Number of start/resume
subchannels issued that had valid
times.
VSE
DISK
SSCH
System Number of start/resume
subchannels issued.
RDISK and VDISK for VSE Users
The following additional variable classes are available for users of VSE 1.3 or
later:
Use this Class in
Place of DISK:
To Report on:
RDISK
Disk devices known to VSE as real (non-virtual).
VDISK
Disk devices that are virtual data spaces.
ID Options
The following ID options can be used with any system DISK, RDISK, or VDISK
variable:
■
CPUID
■
CPUMOD
■
DISKID
■
ENDTIME
■
PNET
238 Report Reference Guide
Variable Descriptions
■
STARTTIME
■
VMID
■
VOLSER
In addition to the preceding ID options, the following ID option can be used
only with the system variables VSE DISK SEEKS, VSE RDISK SEEKS, and VSE
VDISK SEEKS:
CYLID
The following ID options can be used with any non-system DISK, RDISK, or
VDISK variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DISKID
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
Chapter 6: Commands 239
Variable Descriptions
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
■
VOLSER
DSN Variable Class
The following table describes each variable of this class:
Syste
m
Class Variable
Name
Data
Description
VSE
DSN
BUSY
Both
Percentage of time data set is active.
VSE
DSN
CUU
Both
Address of device in which the data
set resides.
VSE
DSN
ENDADDR
Both
Data set end address.
VSE
DSN
IOTIME|I/OTI Both
ME
Total active/busy time.
VSE
DSN
MAXSERVTIM Both
E
Maximum I/O service time (the time
between the I/O request being
queued on the channel and the I/O
interrupt).
VSE
DSN
READs
Both
Number of read SIOs.
VSE
DSN
SERVTIME
Both
Average I/O service time (the time
between the I/O request being
queued on the channel and the I/O
interrupt).
240 Report Reference Guide
Variable Descriptions
Syste
m
Class Variable
Name
Data
Description
VSE
DSN
SIOs|I/O|IO
Both
SIO count.
VSE
DSN
SIZE
Both
Number of tracks or blocks allocated
to the data set.
VSE
DSN
STARTADDR
Both
Data set start address.
VSE
DSN
VOLSER
Both
VOLSER of device in which the data
set resides.
VSE
DSN
WRITEs
Both
Number of write SIOs.
VSE
DSN
WRITESERVti Both
me
Average I/O service time for writes.
ID Options
The following ID options can be used with any system DSN variable:
■
CPUID
■
CPUMOD
■
DISKID
■
DSNID
■
ENDADDR
■
ENDTIME
■
PNET
■
STARTADDR
■
STARTTIME
■
VMID
■
VOLSER
The following ID options can be used with any non-system DSN variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
Chapter 6: Commands 241
Variable Descriptions
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DISKID
■
DSNID
■
ENDADDR
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTADDR
■
STARTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
■
VOLSER
242 Report Reference Guide
Variable Descriptions
Reports using the DSNID ID option use data set statistics. To ensure accurate
data set statistics between initializations, you should execute the disk-mapping
program EVSEDBAT when you make significant changes in disk-mapping
configuration options, data set names, or data set locations. For more
information about running EVSEDBAT, see the Utilities Guide.
DYNAMIC Variable Class
DYNAMIC variables are valid only for VSE/ESA systems running in 370 mode
with dynamic partitions. For more information about the XA I/O channelmonitoring subsystem, see the IBM's ESA/390 Principles of Operations (SA227201-00).
Syste
m
Class
Variable
Name
Data
Description
VSE
DYNAMIC
%USED
Job,
Step
Percentage of dynamic GETVIS
used.
VSE
DYNAMIC
MAX%USED
Job,
Step
Maximum percentage of
dynamic GETVIS used.
VSE
DYNAMIC
MAXUSED
Job,
Step
Maximum dynamic GETVIS
used, in KB.
VSE
DYNAMIC
SIZE
Job,
Step
Dynamic partition GETVIS size,
in KB.
VSE
DYNAMIC
UNUSED
Job,
Step
Dynamic GETVIS available (not
used), in KB.
VSE
DYNAMIC
USED
Job,
Step
Dynamic GETVIS used, in KB.
ID Options
The following ID options can be used with any DYNAMIC variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
Chapter 6: Commands 243
Variable Descriptions
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
GETVIS Variable Class
The following table describes each variable of this class:
Syste
m
Class
Variable
Name
Data
Description
VSE
GETVI
S
%USED
Job, Step
Percentage of 24-bit GETVIS
used.
VSE
GETVI
S
MAX%USED
Job, Step
Maximum percentage of 24-bit
GETVIS used.
VSE
GETVI
S
MAXUSED
Job, Step
Maximum 24-bit GETVIS used,
in KB.
VSE
GETVI
S
REQUESTs
Job,
Step,
Task
Number of 24-bit partition
GETVIS requests.
VSE
GETVI
S
SIZE
Job, Step
24-bit GETVIS size, in KB.
VSE
GETVI
S
TUSED
Job,
Step,
Task
Amount of 24-bit partition
GETVIS used.
VSE
GETVI
UNUSED
Job, Step
24-bit GETVIS available (not
244 Report Reference Guide
Variable Descriptions
S
used), in KB.
VSE
GETVI
S
USED
Job, Step
24-bit GETVIS used, in KB.
VSE
GETVI
S
31-%USED
Job, Step
Percentage of 31-bit GETVIS
used.
VSE
GETVI
S
31MAX%USED
Job, Step
Maximum percentage of 31-bit
GETVIS used.
VSE
GETVI
S
31-MAXUSED
Job, Step
Maximum 31-bit GETVIS used,
in KB.
VSE
GETVI
S
31-REQUESTs
Job,
Step,
Task
Number of 31-bit partition
GETVIS requests.
VSE
GETVI
S
31-SIZE
Job, Step
31-bit GETVIS size, in KB.
VSE
GETVI
S
31-TUSED
Job,
Step,
Task
Amount of 31-bit partition
GETVIS used.
VSE
GETVI
S
31-UNUSED
Job, Step
31-bit GETVIS available (not
used), in KB.
VSE
GETVI
S
31-USED
Job, Step
31-bit GETVIS used, in KB.
Configuration Requirement
The following variables must have full partition GETVIS monitoring active in
order to display valid data. For complete instructions on setting these
configuration options, see the Online User Guide.
■
VSE GETVIS REQUESTs
■
VSE GETVIS TUSED
■
VSE GETVIS 31-REQUESTs
■
VSE GETVIS 31-TUSED
ID Options
The following ID options can be used with any GETVIS variable:
■
ACCANC
■
ACDATE
■
ACIDEN
Chapter 6: Commands 245
Variable Descriptions
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
USERID
■
VMID
246 Report Reference Guide
Variable Descriptions
INTERRUPT Variable Class
The following table describes each variable of this class:
Syste
m
Class
Variable Name Data
VSE
INTERRUP
T
CLOCKCOMParator
System Number of clock comparator
external interrupts.
VSE
INTERRUP
T
CPU-TIMER
System Number of CPU timer
external interrupts.
VSE
INTERRUP
T
OTHER
System Number of external
interrupts excluding CLOCKCOMParator, CPU-TIMER,
and VMCF-IUCV interrupts.
VSE
INTERRUP
T
VMCF-IUCV
System Number of VMCF/IUCV
external interrupts.
Description
ID Options
The following ID options can be used with any INTERRUPT variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
INTERVAL Variable Class
The INTERVAL variable class displays the total interval that the input record
represents.
System Class
Variable
Name
Data
Description
VSE
INTERVAL
ESMFCAC
System
System disk cache record.
VSE
INTERVAL
ESMFCHN
System
System channel record.
VSE
INTERVAL
ESMFCHP
System
System channel path record.
VSE
INTERVAL
ESMFCONT
Job, Step, Task
End-of-step task contention analysis
Chapter 6: Commands 247
Variable Descriptions
System Class
Variable
Name
Data
Description
record.
VSE
INTERVAL
ESMFDELY
Job, Step, Task
End-of-step task delay analysis record.
VSE
INTERVAL
ESMFDEV
System
System device record.
VSE
INTERVAL
ESMFDSNX
Job, Step, Task
End-of-step task disk DSN record.
VSE
INTERVAL
ESMFEOJ
Job, Step
End-of-job record.
VSE
INTERVAL
ESMFEOS
Job, Step
End-of-step record.
VSE
INTERVAL
ESMFJAC
Job, Step
End-of-step job accounting record.
VSE
INTERVAL
ESMFLCK
Job, Step, Task
End-of-step task lock record.
VSE
INTERVAL
ESMFORPH
Job, Step, Task
End-of-step orphaned storage record.
VSE
INTERVAL
ESMFPAG
System
System paging record.
VSE
INTERVAL
ESMFPOWA
Job, Step
VSE/POWER accounting record.
VSE
INTERVAL
ESMFPRSM
System
LPAR or VM activity record.
VSE
INTERVAL
ESMFSAM
System
System one-minute interval record.
VSE
INTERVAL
ESMFSDS
System
System data set record.
VSE
INTERVAL
ESMFSDSK
Job, Step, Task
End-of-step task disk record.
VSE
INTERVAL
ESMFSEK
System
System disk cylinder activity record.
VSE
INTERVAL
ESMFSJS
Job, Step
Start-of-job or -step record.
VSE
INTERVAL
ESMFSOIO
Job, Step, Task
End-of-step task non-disk device record.
VSE
INTERVAL
ESMFSPHS
Job, Step, Task
End-of-step task phase record.
VSE
INTERVAL
ESMFSEK
System
System disk cylinder activity record.
VSE
INTERVAL
ESMFSJS
Job, Step
Start-of-job or -step record.
VSE
INTERVAL
ESMFSOIO
Job, Step, Task
End-of-step task non-disk device record.
VSE
INTERVAL
ESMFSPHS
Job, Step, Task
End-of-step task phase record.
VSE
INTERVAL
ESMFSPSV
Job, Step, Task
End-of-step task phase SVC record.
VSE
INTERVAL
ESMFSSV
System
System SVC record.
VSE
INTERVAL
ESMFSTSK
Job, Step, Task
End-of-step task record.
VSE
INTERVAL
ESMFSTSV
Job, Step, Task
End-of-step task SVC record.
VSE
INTERVAL
ESMFSXA
System
System XA device record.
VSE
INTERVAL
ESMFSYS
System
System interval record.
VSE
INTERVAL
ESMFTHR
System
Threshold record.
248 Report Reference Guide
Variable Descriptions
ID Options
Each of the variable names for the INTERVAL variable class has a different set
of valid ID options. Each set of ID options is identical to the ID options for a
related variable class.
The following table lists the INTERVAL variable name, and the variable class
with which it shares ID options:
Variable Name
Variable Class Having Identical ID Options
ESMFCAC
CACHE
ESMFCHN
CHANNEL
ESMFCHP
CHANNEL, XABUSYS variable only
ESMFCONT
CONTENTION
ESMFDELY
WAIT, non-system variable
ESMFDEV
DEVICE, system variable
ESMFDSNX
DSN, non-system variable
ESMFEOJ
STEP, excluding STEPID
ESMFEOS
STEP
ESMFJAC
STEP
ESMFLCK
LOCK
ESMFORPH
SGETVIS, non-system variable
ESMFPAG
PAGE, system variable
ESMFPOWA
PACCNT, all ID options beginning with AC
ESMFPRSM
LPAR
ESMFSAM
SAMPLE
ESMFSDS
DSN, system variable
ESMFSDSK
DISK, non-system variable
ESMFSEK
DISK, system variable
ESMFSJS
STEP
ESMFSOIO
DEVICE, non-system variable
ESMFSPHS
PHASE
ESMFSPSV
SVC, non-system variable
ESMFSSV
SVC, system variable
Chapter 6: Commands 249
Variable Descriptions
Variable Name
Variable Class Having Identical ID Options
ESMFSTSK
CPU, non-system variable
ESMFSTSV
SVC, non-system variable
ESMFSXA
DEVICE, system variable
ESMFSYS
CPU, system variable
ESMFTHR
THRESHOLD
JOB Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
JOB
COST
Job, Step, Total cost for the row in the report. This is the
Task
same as the variable REPORT COST TOTAL. For
more information, see the chapter "Command
Descriptions and Syntax."
VSE
JOB
COUNT
Job
Number of jobs executed.
VSE
JOB
DURATION
Job
Average job execution time.
ID Options
The following ID options can be used with any JOB variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
250 Report Reference Guide
Variable Descriptions
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
USERID
■
VMID
LOCK Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
LOCK
HEXNAME
Job, Step, Task
Resource name displayed in
hexadecimal format.
VSE
LOCK
NAME
Job, Step, Task
Resource name.
VSE
LOCK
REQ-FAIL-OTHER
Job, Step, Task
Number of lock requests failed for
reasons other than the resource
was unavailable.
VSE
LOCK
REQ-FAIL-RSCE
Job, Step, Task
Number of lock requests that failed
because the resource was
unavailable.
VSE
LOCK
REQ-SUCCESS
Job, Step, Task
Number of successful lock
Chapter 6: Commands 251
Variable Descriptions
requests.
VSE
LOCK
REQuests
Job, Step, Task
Number of lock requests.
VSE
LOCK
TYPE
Job, Step, Task
Lock type (INTERNAL or
EXTERNAL).
VSE
LOCK
UNLOCK
Job, Step, Task
Number of unlock requests.
VSE
LOCK
UNLOCK-FAIL
Job, Step, Task
Number of unlock requests that
failed because the resource was
not locked.
ID Options
The following ID options can be used with any LOCK variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDJOB
■
EXDFRNO
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
252 Report Reference Guide
Variable Descriptions
■
EXTYPE
■
EXXNODE
■
JOBID
■
LOCKHEXID
■
LOCKID
■
LOCKTYPE
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
THRDID
■
USERID
■
VMID
LPAR Variable Class
The LPAR variable class is valid only for VSE 1.3 or greater.
System
Class
Variable Name
Data
Description
VSE
LPAR
ACTIVE
System
CPU time used by the partition.
VSE
LPAR
%ACTIVE
System
Percentage of CPU time used by the partition.
VSE
LPAR
CPU
System
Logical CPU address.
VSE
LPAR
NAME
System
Logical partition name.
VSE
LPAR
NUMBER
System
Logical partition number.
VSE
LPAR
OVERHEAD
System
CPU time associated with LPAR overhead.
VSE
LPAR
%OVERHEAD
System
Percentage of CPU time associated with LPAR
overhead.
VSE
LPAR
PROCessors
System
Number of physical CPUs.
VSE
LPAR
TOTAL-time
System
Total CPU time (ACTIVE + OVERHEAD).
VSE
LPAR
%TOTAL-time
System
Percentage of total CPU time.
Chapter 6: Commands 253
Variable Descriptions
VSE
LPAR
WEIGHT
System
CPU weight factor.
ID Options
The following ID options can be used with any system LPAR variable:
■
CPUPID
■
ENDTIME
■
LPARID
■
LPID
■
STARTTIME
Important! Use LPAR data from one system only. If you are collecting LPAR
data from multiple systems, do not merge this data before reporting on it.
If you receive an error message saying there is no matching data, or if the
overhead numbers are zero, then either your hardware does not support this
function or you need a higher level of microcode.
LTA Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
LTA
%BUSY
Job, Step, Task Percentage of time spent in LTA.
VSE
LTA
BUSY
Job, Step, Task Total time spent in LTA.
VSE
LTA
LOAD
Both
Number of LTA load requests.
VSE
LTA
TIME
System
Total time spent in LTA.
VSE
LTA
USE
Both
Number of times LTA was used.
ID Options
The following ID options can be used with any system LTA variable:
■
CPUID
■
CPUMOD
■
ENDTIME
254 Report Reference Guide
Variable Descriptions
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system LTA variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
Chapter 6: Commands 255
Variable Descriptions
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
MCPU Variable Class
The MCPU variable class applies only to a VSE Turbo Dispatcher environment.
System
Class
Variable Name
Data
Description
VSE
MCPU
%BUSYReal
System
Percentage of time that a VSE machine
was running using the real processor. For
an LPAR or VM environment, use VSE
LPAR %TOTAL or VSE VM %TTIME for a
more accurate representation of the real
CPU utilization. This value includes spin
time in a multiple-CPU environment.
VSE
MCPU
%BUSYVirt|
UTILization
System
Percentage of time CPU was running
using the CPU timer. This is the preferred
variable for system CPU busy for all
users. For VM or PR/SM users, it gives
the percentage as if the VSE machine
were running stand-alone on the real
processor. This value includes spin time
in a multiple-CPU environment.
VSE
MCPU
%CONTention
System
Percentage of time a VSE machine
wanted to run but could not because of
higher priority virtual machines or LPARS.
Valid for VM and PR/SM users. Its value is
defined as the total length of time in the
interval minus the length of time the VSE
machine was allowed to run, divided by
the length of time in the interval.
Increasing the priority of this machine
reduces this number.
VSE
MCPU
%NON-PARallel
System
Percentage of time spent in a non-parallel
state.
VSE
MCPU
%PARallel
System
Percentage of time spent in a parallel
state.
256 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
MCPU
%SPIN
System
Percentage of unproductive time the
system spent waiting for a resource to be
freed.
VSE
MCPU
%WAITV
System
Percentage of time CPU was inactive
using the CPU timer.
VSE
MCPU
BUSYVirt
System
Length of time CPU was running using the
CPU timer. This is the preferred variable
for system CPU busy for all users. For VM
or PR/SM users, it gives the number of
CPU seconds as if the VSE machine were
running stand-alone on the real
processor. This value includes spin time
in a multiple-CPU environment.
VSE
MCPU
CONTention
System
Length of time a VSE machine wanted to
run but could not because of higher
priority virtual machines or LPARS. Valid
for VM and PR/SM users. Its value is
defined as the total length of time in the
interval minus the length of time the VSE
machine was allowed to run, divided by
the amount of time in the interval.
Increasing the priority of this machine
reduces this value. On native VSE
systems, this is the length of time the
CPU was manually stopped.
VSE
MCPU
NON-PARallel
System
Amount of time spent in a non-parallel
state.
VSE
MCPU
PARallel
System
Amount of time spent in a parallel state.
VSE
MCPU
SPIN
System
Amount of unproductive time the system
spent waiting for a resource to be freed.
VSE
MCPU
WAITV
System
Total time the CPU was inactive using the
CPU timer.
ID Options
The following ID options can be used with any system MCPU variable:
■
CPUID
■
CPUMOD
■
CPUPID
Chapter 6: Commands 257
Variable Descriptions
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
OPERATOR Variable Class
The OPERATOR variable class is valid only for VSE 1.3 or later.
System
Class
Variable Name
Data
Description
VSE
OPERATOR
REQUESTS
Job, Step, Task Number of operator replies satisfied.
Accumulated when the operator
request is satisfied.
VSE
OPERATOR
TIME
Job, Step, Task Total time spent waiting for an
operator reply. Accumulated each
SYSTIMEI interval.
VSE
OPERATOR
RESPonse
Job, Step, Task Average time spent waiting for an
operator reply. Accumulated when
the operator request is satisfied.
Important! The setting of the SAMPSECS configuration option determines the
intervals at which outstanding operator replies are sampled. The shorter the
interval, the greater the number of samples taken, and the more accurate
your samplings.
ID Options
The following ID options can be used with any OPERATOR variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
258 Report Reference Guide
Variable Descriptions
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
OTHER Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
OTHER
I/O|IO
Job, Step, Task
Number of SIOs to non-tape and
non-disk devices.
VSE
OTHER
IOTIME|I/OTIME
Job, Step, Task
Total I/O time for non-tape and
non-disk devices.
Chapter 6: Commands 259
Variable Descriptions
VSE
OTHER
SERVICE|SERVTIME
Job, Step, Task
Average service time for non-tape
and non-disk devices.
ID Options
The following ID options can be used with any OTHER variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
260 Report Reference Guide
Variable Descriptions
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
PAGE Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
PAGE
CUU
System
Device where page data set
resides.
VSE
PAGE
ENDADDR
System
Page data set end address.
VSE
PAGE
FAULTs
Both
Total number of page faults.
VSE
PAGE
INs
System
Total number of page-ins.
VSE
PAGE
IO
System
Total number of page I/Os.
VSE
PAGE
OUTs
System
Total number of page-outs.
VSE
PAGE
VMFAULTs
Both
Number of VM pseudo page
faults.
VSE
PAGE
VMI/OTIME|VMIOTIME
Job, Step, Task
Total VM pseudo page I/O
time.
VSE
PAGE
VMSERVICE|VMSERVTIM
E
Job, Step, Task
Average VM pseudo page
service time.
VSE
PAGE
VOLID|VOLSER
System
Device volume ID.
VSE
PAGE
STARTADDR
System
Page data set start address.
ID Options
The following ID options can be used with PAGE variables with data type Both
in the preceding table:
■
CPUID
■
CPUMOD
■
ENDTIME
Chapter 6: Commands 261
Variable Descriptions
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any system PAGE variable:
■
CPUID
■
CPUMOD
■
DISKID
■
ENDTIME
■
PAGEID
■
PNET
■
STARTTIME
■
VMID
■
VOLSR
The following ID options can be used with any non-system PAGE variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DISKID
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
262 Report Reference Guide
Variable Descriptions
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PAGEID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
■
VOLSER
PHASE Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
PHASE
ADDRESS
Job, Step, Task
Address in storage where phase was
loaded.
VSE
PHASE
CPUSAMP
Job, Step, Task
Number of samples with CPU active
in this phase.
VSE
PHASE
LENGTH|SIZE
Job, Step, Task
Length of phase, in KB.
VSE
PHASE
LIBRARY
Job, Step, Task
Library from which phase was
loaded.
VSE
PHASE
LOAD
Job, Step, Task
Load count.
VSE
PHASE
SUBLIB
Job, Step, Task
Sublibrary from which phase was
loaded.
Chapter 6: Commands 263
Variable Descriptions
VSE
PHASE
TID
Job, Step, Task
Task ID that loaded the phase.
VSE
PHASE
TIME
Job, Step, Task
Time of day the phase was loaded.
ID Options
The following ID options can be used with any PHASE variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CONTID
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRUS
■
EXFRM
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
LIBRARY
■
PGMTID
264 Report Reference Guide
Variable Descriptions
■
PHASEID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
SUBLIB
■
TASKID
■
TASKNAME
■
USERID
■
VMID
REAL Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
REAL
%AVAILABLE
System
Percentage of real storage not in use.
VSE
REAL
%USED
System
Percentage of real storage in use.
VSE
REAL
AVAILABLE
System
Amount of real storage not in use, in KB.
VSE
REAL
DATASPAC
System
Amount of real storage used for data spaces
(VSE 1.3 or later).
VSE
REAL
PMR-PFTE
System
Amount of real storage used by the page
management system task and the real storage
taken for page frame table entries (PFTE), in
KB (VSE 1.3 or later).
VSE
REAL
SIZE
System
Amount of real storage, in KB.
VSE
REAL
USED
System
Amount of real storage in use in KB.
ID Options
The following ID options can be used with any REAL variable:
■
CPUID
■
CPUMOD
■
ENDTIME
Chapter 6: Commands 265
Variable Descriptions
■
PNET
■
STARTTIME
■
VMID
SAMPLE Variable Class
SAMPLE variables represent system statistics collected at one-minute
intervals.
System
Class
Variable Name
Data
Description
VSE
SAMPLE
%CPUCONT
System
Percentage of time the VSE machine
wanted to run but could not because of
higher priority machines.
VSE
SAMPLE
%CPUREAL
System
Percentage of time the VSE machine
was using the real processor.
VSE
SAMPLE
%CPUVIRT
System
Percentage of time the CPU was running
using the CPU timer.
VSE
SAMPLE
CPUCONT
System
Length of time the VSE machine wanted
to run but could not because of higher
priority machines.
VSE
SAMPLE
CPUREAL
System
Length of time the VSE machine was
using the real processor.
VSE
SAMPLE
CPUVIRT
System
Length of time the CPU was running
using the CPU timer.
VSE
SAMPLE
DSIO
System
Number of disk SIOs.
VSE
SAMPLE
LPAR-NAME
System
Logical partition name (VSE 1.3 or
later).
VSE
SAMPLE
LPAR-ACTIVE
System
CPU time used by the logical partition
(VSE 1.3 or later).
VSE
SAMPLE
LPAR-%ACTIVE
System
Percentage of CPU time used by the
logical partition (VSE 1.3 or later).
VSE
SAMPLE
LPAR-OVERHEAD
System
CPU time associated with LPAR overhead
(VSE 1.3 or later).
VSE
SAMPLE
LPAR-%OVERHEAD
System
Percentage of CPU time associated with
LPAR overhead (VSE 1.3 or later).
VSE
SAMPLE
LPAR-TOTAL-time
System
Total CPU time used (ACTIVE +
OVERHEAD) (VSE 1.3 or later).
VSE
SAMPLE
LPAR-%TOTAL-time
System
Percentage of total CPU time used (VSE
266 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
1.3 or later).
VSE
SAMPLE
PAGF
System
Number of 370/ECPS page faults.
VSE
SAMPLE
PAGEIN
System
Number of page-in requests issued.
VSE
SAMPLE
PAGEOUT
System
Number of page-out requests issued.
VSE
SAMPLE
RSTOR-%AVAIL
System
Percentage of real storage not in use.
VSE
SAMPLE
RSTOR-%USED
System
Percentage of real storage in use.
VSE
SAMPLE
RSTOR-AVAIL
System
Amount of unused real storage, in KB.
VSE
SAMPLE
RSTOR-USED
System
Amount of used real storage, in KB.
VSE
SAMPLE
SIO
System
Number of SIOs.
VSE
SAMPLE
SVC
System
Number of supervisor call requests.
VSE
SAMPLE
VMPF
System
Number of VM pseudo page faults.
VSE
SAMPLE
VM-NAME
System
VM machine name (VSE 1.3 or later).
VSE
SAMPLE
VM-VTIME
System
Virtual CPU used (VSE 1.3 or later).
VSE
SAMPLE
VM-%VTIME
System
Percentage of virtual CPU used (VSE 1.3
or later).
VSE
SAMPLE
VM-STIME
System
CPU simulation used (VSE 1.3 or later).
VSE
SAMPLE
VM-%STIME
System
Percentage of CPU simulation used (VSE
1.3 or later).
VSE
SAMPLE
VM-TTIME
System
Total time the CPU used (VSE 1.3 or
later).
VSE
SAMPLE
VM-%TTIME
System
Percentage of total time the CPU used
(VSE 1.3 or later).
Variables Valid For XA I/O Users Only
The following variables are valid only if you are using the XA I/O channelmonitoring subsystem. For more information about the XA I/O channelmonitoring subsystem, see the IBM's Principles of Operation (SA22-7201-00).
System
Class
Variable Name
Data
Description
VSE
SAMPLE
DEVICE-ACTIVE
System
Average device service time.
VSE
SAMPLE
DEVICE-CONN
System
Average time in seconds spent in transferring
commands and data between the subchannel
Chapter 6: Commands 267
Variable Descriptions
System
Class
Variable Name
Data
Description
and the channel subsystem for all XA I/O disk
devices.
VSE
SAMPLE
DEVICE-DISC
System
Average time, in seconds, that a device was
logically disconnected from the channel
subsystem while the subchannel was active,
including seek time, latency, and RPS reconnect
time.
VSE
SAMPLE
DEVICE-PEND
System
Average time in seconds between VSE issuing
the start subchannel and the first CCW
command being executed on the actual
subchannel for all XA I/O disk devices.
VSE
SAMPLE
DEVICE-SAMP
System
Number of start/resume subchannels issued.
ID Options
The following ID options can be used with any SAMPLE variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The VSE SAMPLE LPAR-variables can also be used with the LPARID ID option.
SGETVIS Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
SGETVIS
%USED
Both
Average of the highest
percentage of system 24-bit
GETVIS used for each SYSTIMEI
interval. To obtain the maximum
of all intervals, use the MAX
option.
VSE
SGETVIS
ORPHAN-ADDRess
Job, Step, Task
Address of orphaned storage.
VSE
SGETVIS
ORPHAN-GVSADDRess
Job, Step, Task
Address of system GETVIS
268 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
request.
VSE
SGETVIS
ORPHAN-LENGTH
Job, Step, Task
VSE
SGETVIS
ORPHAN-PFIXED
Job, Step, Task
Length of orphaned storage, in
bytes.
One of the following:
YES—Storage was PFIXED
NO—Storage was not PFIXED
VSE
SGETVIS
ORPHAN-PGMNAME
Job, Step, Task
Program that acquired the
storage.
VSE
SGETVIS
ORPHAN-PGMOFFset
Job, Step, Task
Offset within the program that
acquired the storage.
VSE
SGETVIS
ORPHAN-PROTECT
Job, Step, Task
One of the following:
YES—Storage was fetch
protected
NO—Storage was not fetch
protected
VSE
SGETVIS
ORPHAN-SUBPOOL
Job, Step, Task
GETVIS subpool name.
VSE
SGETVIS
ORPHAN-SUPervisor
Job, Step, Task
One of the following:
YES—Storage was acquired by a
supervisor service
NO—Storage was acquired by a
GETVIS macro
VSE
SGETVIS
ORPHAN-TIME
Job, Step, Task
Date and time storage was
allocated.
VSE
SGETVIS
REQUESTS
Both
Number of system 24-bit GETVIS
requests.
VSE
SGETVIS
SIZE
System
System 24-bit GETVIS size, in
KB.
VSE
SGETVIS
STEP-USED
Job, Step
Average of the highest amount
of system 24-bit GETVIS used by
the step for each SYSTIMEI
interval. To obtain the maximum
of all intervals, use the MAX
option.
VSE
SGETVIS
STEP-%USED
Job, Step
Average of the highest
percentage of system 24-bit
GETVIS used by the step for
each SYSTIMEI interval. To
obtain the maximum of all
intervals, use the MAX option.
Chapter 6: Commands 269
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
SGETVIS
STEP-31-USED
Job, Step
Average of the highest amount
of system 31-bit GETVIS used by
the step for each SYSTIMEI
interval. To obtain the maximum
of all intervals, use the MAX
option.
VSE
SGETVIS
STEP-31-%USED
Job, Step
Average of the highest
percentage of system 31-bit
GETVIS used by the step for
each SYSTIMEI interval. To
obtain the maximum of all
intervals, use the MAX option.
VSE
SGETVIS
USED
Both
Average of the highest amount
of system 24-bit GETVIS used
for each SYSTIMEI interval. To
obtain the maximum of all
intervals, use the MAX option.
VSE
SGETVIS
31-%USED
Both
Average of the highest
percentage of system 31-bit
GETVIS used for each SYSTIMEI
interval. To obtain the maximum
of all intervals, use the MAX
option.
VSE
SGETVIS
31-REQUESTS
Both
Number of system 31-bit GETVIS
requests.
VSE
SGETVIS
31-SIZE
System
System 31-bit GETVIS size, in
KB.
VSE
SGETVIS
31-USED
Both
Average of the highest amount
of system 31-bit GETVIS used
for each SYSTIMEI interval. To
obtain the maximum of all
intervals, use the MAX option.
ID Options
The following ID options can be used with any system SGETVIS variable:
■
CPUID
■
CPUMOD
■
ENDTIME
270 Report Reference Guide
Variable Descriptions
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system SGETVIS variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
STEPID
■
SEPSEQ#
■
SUBPOOL
■
TASKID
■
TASKNAME
■
VMID
The following ID options can be used with any SGETVIS ORPHAN- variable:
■
ENDTIME
■
ORPHADDR
■
PHASEID
■
STARTTIME
STEP Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
STEP
%BUSY
Job, Step
Percentage of time step was
sampled as busy from the time it
started until it ended. Users can use
this variable without job accounting
for CPU utilization while the step was
running.
VSE
STEP
%CPUBUSYS
Job, Step
Percentage of time step was
sampled during the interval. Users
can use this variable without job
Chapter 6: Commands 271
Variable Descriptions
System
Class
Variable Name
Data
Description
accounting for CPU utilization by
step.
VSE
STEP
%RSTOR
Job, Step
Maximum percentage of real page
frames occupied.
VSE
STEP
%TCPU
Job, Step
Percentage of CPU time this step
used during the interval. This is the
preferred variable for job accounting
users. The sum of all the steps in the
interval will approximately total CPU
%BUSYVirt.
VSE
STEP
%TCPUINTerval
Job, Step
Percentage of total CPU time this
step consumed during the interval.
The total of all steps in the interval
equals 100% during the interval.
VSE
STEP
%WORK
Job, Step
Percentage of samples taken when
tasks were not delayed. For
example, the resources that the
system needed were available and
there was no contention between
tasks for resources being accessed.
A high value for this variable
indicates that resources generally
were available for tasks when they
were needed.
VSE
STEP
COUNT
Job, Step
Number of steps executed.
VSE
STEP
CPU
Job, Step
Average amount of CPU seconds this
step used.
VSE
STEP
DURATION
Job, Step
Average duration.
VSE
STEP
DURATIONT|DURT
Job, Step
Total duration.
VSE
STEP
ENDDATE
Job, Step
Step end date.
VSE
STEP
ENDTIME
Job, Step
Step end time.
VSE
STEP
JOBNAME
Job, Step
VSE jobname.
VSE
STEP
PAGE-IO
Job, Step
Number of page I/Os.
VSE
STEP
PAGE-IN
Job, Step
Number of page-in I/Os.
VSE
STEP
PAGE-OUT
Job, Step
Number of page-out I/Os.
VSE
STEP
PARTITION
Job, Step
Partition ID in which the step was
run.
SE
STEP
RSTOR
Job, Step
Maximum number of real page
272 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
frames occupied.
VSE
STEP
SAMPLE
Job, Step
Number of pseudo end-of-steps
executed.
VSE
STEP
SGETVIS-31-USED
Job, Step
The average of the highest amount
of system 31-bit GETVIS used by the
step for each SYSTIMEI interval. To
obtain the maximum of all intervals,
use the MAX option.
VSE
STEP
SGETIVS-31-%USED
Job, Step
The average of the highest
percentage of system 31-bit GETVIS
used by the step for each SYSTIMEI
interval. To obtain the maximum of
all intervals, use the MAX option.
VSE
STEP
STARTDATE
Job, Step
Step start date.
VSE
STEP
STARTTIME
Job, Step
Step start time.
VSE
STEP
STEPNAME
Job, Step
Step name from the //EXEC
statement.
VSE
STEP
TCPU
Job, Step
Amount of CPU time while this step
was running during the interval. The
sum of all steps in the interval will
approximately total CPU BUSYVirt.
ID Options
The following ID options can be used with any STEP variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
Chapter 6: Commands 273
Variable Descriptions
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
THRSID
■
USERID
■
VMID
SVC Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
SVC
COUNT
Both
Number of supervisor calls issued.
VSE
SVC
DESCRIPTION
Both
Description of supervisor call.
VSE
SVC
HEXCODE
Both
Supervisor call code, in hexadecimal.
VSE
SVC
NAME
Both
Macro name associated with supervisor call.
VSE
SVC
TCOUNT
Job, Step,
Task
Number of supervisor calls issued.
274 Report Reference Guide
Variable Descriptions
ID Options
The following ID options can be used with any system SVC variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
SVCID
■
VMID
The following ID options can be used with any non-system SVC variable:
■
CONTID
■
CPUID
■
CPUMOD
■
ENDTIME
■
JOBID
■
LIBRARY
■
PGMTID
■
PHASEID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
SUBLIB
■
SVCID
■
TASKID
■
TASKNAME
■
THRSID
■
USERID
■
VMID
Chapter 6: Commands 275
Variable Descriptions
The following ID options are not valid with the VSE SVC TCOUNT variable:
■
ENDTIME
■
PGMTID
■
PHASEID
■
STARTTIME
SYSTEM Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
SYSTEM
CHANQ
System
Number of channel queue entries defined to
the system through the IPL SYS CHANQ
option.
VSE
SYSTEM
CHANQ-%USE
System
Average maximum percentage of channel
queue entries in use.
VSE
SYSTEM
CHANQ-USE
System
Average maximum channel queue entries in
use.
VSE
SYSTEM
COPY-BLOCK
System
Number of copy blocks defined to the
system.
VSE
SYSTEM
COPY-BLOCK-%US
System
Average percentage of copy blocks in use.
VSE
SYSTEM
COPY-BLOCK-USE
System
Average number of copy blocks in use.
VSE
SYSTEM
TIME
System
System CPU timer. This is the length of time
in seconds that VM has allocated to VSE.
This variable is used in the denominator for
calculation of the variable VSE CPU
%BUSYV.
ID Options
The following ID options can be used with any SYSTEM variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
276 Report Reference Guide
Variable Descriptions
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDUSER
■
EXFRM
■
EXFRNO
■
EXFRUS
■
EXICL
■
EXIPR
■
EXJOB
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
Chapter 6: Commands 277
Variable Descriptions
TAPE Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
TAPE
%FAIL
System
Percentage of SIOs that failed.
VSE
TAPE
%FAIL-CB
System
Percentage of SIOs that failed because of
channel busy.
VSE
TAPE
%FAIL-CUB
System
Percentage of SIOs that failed because of
control unit busy.
VSE
TAPE
%FAIL-DB
System
Percentage of SIOs that failed because of
device busy.
VSE
TAPE
%USAGE
Job, Step,
Task
Percentage of time the tape unit is
assigned.
VSE
TAPE
BUSY|UTILization
Both
Percentage of time device is active.
VSE
TAPE
FAIL
System
Number of SIOs that failed.
VSE
TAPE
FAIL-CB
System
Number of SIOs that failed because of
channel busy.
VSE
TAPE
FAIL-CUB
System
Number of SIOs that failed because of
control unit busy.
VSE
TAPE
FAIL-DB
System
Number of SIOs that failed because of
device busy.
VSE
TAPE
IOTIME|I/OTIME
Both
Total active time.
VSE
TAPE
MAXQ-DEPTH
System
Maximum queue depth.
VSE
TAPE
MAXSERVTIME
Both
Maximum I/O service time.
VSE
TAPE
Q-DEPTH
System
Average maximum queue depth.
VSE
TAPE
Q-TIME
System
Average length of time the I/O request was
on the channel queue.
VSE
TAPE
READS
System
Number of read CCW commands.
VSE
TAPE
SENSE
System
Number of sense or diagnostic CCW
commands.
VSE
TAPE
SERVTIME
Both
Average I/O service time.
VSE
TAPE
SIOs|I/O|IO
Both
SIO count.
VSE
TAPE
USAGE
Job, Step,
Task
Length of time, in seconds, that the tape
unit is assigned.
VSE
TAPE
UTILTIME
System
Device utilization time (the average amount
278 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
of time between the start I/O and I/O
interrupt).
VSE
TAPE
WRITES
System
Number of write CCW commands.
ID Options
The following ID options can be used with any system TAPE variable:
■
CPUID
■
CPUMOD
■
DEVID
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system TAPE variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DEVID
■
ENDTIME
■
EXDCANC
■
EXDUSER
■
EXFRM
Chapter 6: Commands 279
Variable Descriptions
■
EXFRNO
■
EXFRUS
■
EXICL
■
EXIPR
■
EXJOB
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
THRESHOLD Variable Class
The following table describes each variable of this class:
System
Class
Variable
Name
Data
Description
VSE
THRESHOLD
CLASS
System
Threshold class (count, rate,
percentage, or time).
VSE
THRESHOLD
COUNT
System
Number of thresholds triggered.
VSE
THRESHOLD
DATE
System
Date the threshold was triggered.
VSE
THRESHOLD
JOBNAME
System
Jobname that triggered the threshold.
VSE
THRESHOLD
LIMIT
System
Threshold limit value.
VSE
THRESHOLD
MAXVALUE
System
Maximum value that triggered the
threshold.
280 Report Reference Guide
Variable Descriptions
System
Class
Variable
Name
Data
Description
VSE
THRESHOLD
MINVALUE
System
Minimum value that triggered the
threshold.
VSE
THRESHOLD
NAME
System
Name of the threshold.
VSE
THRESHOLD
PID
System
Partition ID that triggered the
threshold.
VSE
THRESHOLD
RESOURCE
System
Threshold resource.
VSE
THRESHOLD
STEPNAME
System
Step name that triggered the
threshold.
VSE
THRESHOLD
TASKNAME
System
Task name that triggered the
threshold.
VSE
THRESHOLD
TID
System
Task ID that triggered the threshold.
VSE
THRESHOLD
TIME
System
Time the threshold was triggered.
VSE
THRESHOLD
TYPE
System
Threshold type (upper or lower).
VSE
THRESHOLD
VALUE
System
Average value that triggered the
threshold.
ID Options
The following ID options can be used with any THRESHOLD variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
THRSID
■
VMID
Chapter 6: Commands 281
Variable Descriptions
VM Variable Class
The VM variable class is valid only for VSE 1.3 or greater. If you are running
under VM and get an error message saying there is no matching data, the
version of VM you are running does not support this function. You may be able
to obtain support for this function from an IBM maintenance tape.
System
Class
Variable
Name
Data
Description
VSE
VM
PROCessors
System
Number of CPUs.
VSE
VM
VTIME
System
Virtual CPU used.
VSE
VM
%VTIME
System
Percentage of virtual CPU used.
VSE
VM
STIME
System
CPU simulation used.
VSE
VM
%STIME
System
Percentage of CPU simulation used.
VSE
VM
TTIME
System
Total time the CPU used
VSE
VM
%TTIME
System
Percentage of total time the CPU used.
ID Options
The following ID option can be used with any VM variable:
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
Important! Use VM CPU data from one system only. If you are collecting VM
CPU data from multiple systems, do not merge this data before reporting on it.
WAIT Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
WAIT
CODE
Both
VSE wait code, in hexadecimal. For more
information, see the Online User Guide.
VSE
WAIT
COUNT
Both
Number of times tasks were sampled to
determine if they were waiting and the
282 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
task was waiting.
VSE
WAIT
CPU-ACTIVE
System
Number of CPU active samples.
VSE
WAIT
CPU-WAIT
System
Number of CPU wait samples.
VSE
WAIT
I/O-ACTIVE
System
Number of I/O active samples.
VSE
WAIT
I/O-QUEUED
System
Number of I/O queued samples.
VSE
WAIT
IDLE
System
Number of idle samples.
VSE
WAIT
PCT
Both
Percentage of wait samples taken in
which the task was waiting (VSE WAIT
COUNT / VSE WAIT SAMPLE).
VSE
WAIT
SAMPLE
Both
Number of times tasks were sampled to
determine if they were waiting.
VSE
WAIT
TOT-SAMPLEs
System
Total number of samples taken.
VSE
WAIT
TYPE
Both
Eight-character wait description.
ID Options
The following ID options can be used with any system WAIT variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system WAIT variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPSEQ#
■
TASKID
Chapter 6: Commands 283
VSE/POWER Accounting Variables
■
TASKNAME
■
TEPID
■
USERID
■
VMID
■
WAITID
VSE/POWER Accounting Variables
The report writer supports the VSE/POWER accounting record types described
in the following table. To restrict a VSE/POWER accounting report or variable
to one of these record types, specify the ID option ACIDEN and the listed
identifier with either the TAB command or the variable, as explained in the
chapter "VSE/POWER Reports".
Variables that apply to
ACIDEN
Identifie
r
All VSE/POWER accounting record types.
n/a
A
Advanced function printing (AFP) records, which contain
information for a device driving system (DDS) whenever the DDS
sends an account record order that contains a valid AFP account
record.
RJE (remote job entry) bisynch (BSC) records, which are created
when a user session signs off or terminates.
T
Execution (EXEC) records, which contain information about every
VSE jobstep.
E
List (LIST) records, which contain information about printer
activity.
L
Network (PNET) records, which contain information about
communication path activity.
N
Punch (PUNCH) records, which contain information about punchqueue activity.
P
Reader (READER) records, which contain information about every R
VSE/POWER job submitted for spooling.
NJE (network job entry) receiver (RECV) records, which are
created for every job or output received from another node.
V
RJE (remote job entry) system network architecture (SNA)
records, which are created when a user session signs off or
terminates.
S
284 Report Reference Guide
VSE/POWER Accounting Variables
Variables that apply to
ACIDEN
Identifie
r
VSE/POWER system-up (SYS) records, which are created on
completion of VSE/POWER startup.
U
NJE (network job entry) transmitter (TRANS) records, which are
created for every job or output transmitted to another node.
M
Spool-access-connect (XCONN) records, which contain
information about spool-access-connection paths.
C
Spool-access-operation (XSPOOL) records, which contain
information about spool-access-connection operations and which
are commonly used to report on some types of laser printer
activity.
X
Definitions
The following terms are used in the descriptions of the variables that apply to
VSE/POWER accounting records:
Term
Meaning
Job accounting
Activated by specifying JA=YES on the IPL SYS card. (Job
accounting must also be specified in POWER generation.)
CPU timer
Active when the CPU is running or waiting. For VM or PR/SM
users, this time is simulated for the virtual machine or LPAR
to reflect the total amount of time the virtual machine or
LPAR was actually running or waiting.
General PACCNT Variables
The following variables apply to all types of VSE/POWER accounting records
supported by CA Explore PM for z/VSE:
System
Class
Variable
Name
Description
VSE
PACCNT
ACCANC
VSE/POWER cancel code.
VSE
PACCNT
ACDATE
Record date, in the format defined
for the system.
VSE
PACCNT
ACIDEN
Record ID.
Chapter 6: Commands 285
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
ACNAME
Current VSE/POWER jobname.
VSE
PACCNT
ACNUMB
Job number assigned by
VSE/POWER.
VSE
PACCNT
ACSTOP
Record stop time, in the format
hh.mm.ss
VSE
PACCNT
ACSTRT
Record start time, in the format
hh.mm.ss
VSE
PACCNT
ACUSER
16 bytes of user information from
the $$ JOB card.
VSE
PACCNT
DURATION
Total duration of VSE/POWER
accounting records. Designed to be
used with the ACIDEN ID option.
VSE
PACCNT
RECCNT
Number of VSE/POWER accounting
records.
ID Options
The following ID options can be used with any general PACCNT variable in the
preceding table:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
286 Report Reference Guide
VSE/POWER Accounting Variables
PACCNT Advanced Function Printing (AFP) Variables
System
Class
Variable Name
Description
VSE
PACCNT
ACAPPLID
XPCC application identifier of the
device driving system (DDS).
ID Options
The following ID options can be used with the PACCNT AFP variable:
■
ACAPPLIC
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
PACCNT RJE Bisynch (BSC) Variables
The following table describes each variable:
System
Class
Variable Name
Description
VSE
PACCNT
BSCDTE
Date, in the format
defined for the system.
VSE
PACCNT
BSCERR
Error count.
VSE
PACCNT
BSCIDN
Record ID.
VSE
PACCNT
BSCIRS
Number of invalid
responses during
Chapter 6: Commands 287
VSE/POWER Accounting Variables
System
Class
Variable Name
Description
transmission.
VSE
PACCNT
BSCLAD
Line address.
VSE
PACCNT
BSCPAS
Line password.
VSE
PACCNT
BSCRID
Remote ID.
VSE
PACCNT
BSCSFC
Sign-off code.
VSE
PACCNT
BSCSGF
Sign-off time.
VSE
PACCNT
BSCSGN
Sign-on time.
VSE
PACCNT
BSCSOD
Sign-off date, in the
format defined for the
system.
VSE
PACCNT
BSCTCNT
Time-out count.
VSE
PACCNT
BSCTEC
Terminal or work station
error count.
VSE
PACCNT
BSCTRAN
Transmission count.
VSE
PACCNT
BSCUSE
Sign-on command user
information.
ID Options
The following ID options can be used with any PACCNT BSC variable:
■
ACAPPLIC
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACSTOP
■
ACSTRT
■
ACUSER
■
BSCIDN
■
BSCLAD
■
BSCPAS
■
BSCRID
288 Report Reference Guide
VSE/POWER Accounting Variables
■
BSCSFC
■
BSCSGF
■
BSCSGN
■
BSCSOD
■
BSCUSE
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
PACCNT Execution (EXEC) Variables
The following table describes each variable:
System
Class
Variable Name
Description
VSE
PACCNT
EXALLTM
Total system wait time allocated to the jobstep.
VSE
PACCNT
EXCPUTM
Processor time the jobstep used.
VSE
PACCNT
EXDCANC
VSE cancel code.
VSE
PACCNT
EXDJOB
VSE jobname from the JOB card.
VSE
PACCNT
EXDUSER
16 bytes of user information from the JOB card.
VSE
PACCNT
EXFRM
FROM remote ID.
VSE
PACCNT
EXFRNO
Name of originating (FROM) node.
VSE
PACCNT
EXFRUS
ID of originating user.
VSE
PACCNT
EXICL
Class.
VSE
PACCNT
EXIPR
Priority.
VSE
PACCNT
EXJDUR
Duration of the jobstep.
VSE
PACCNT
EXJOBCNT
Number of VSE jobs executed.
VSE
PACCNT
EXNCD
Number of cards spooled.
VSE
PACCNT
EXNLN
Number of lines spooled.
VSE
PACCNT
EXNPG
Number of pages spooled.
VSE
PACCNT
EXOJ#
Original job number.
Chapter 6: Commands 289
VSE/POWER Accounting Variables
System
Class
Variable Name
Description
VSE
PACCNT
EXOVHTM
Overhead time allocated to the jobstep.
VSE
PACCNT
EXPASZ
The amount of storage used, in bytes.
VSE
PACCNT
EXPHASE
Phase name from the EXEC card.
VSE
PACCNT
EXPID
Partition ID.
VSE
PACCNT
EXPJOBCNT
Number of VSE/POWER jobs executed.
VSE
PACCNT
EXSIO
Number of SIOs.
VSE
PACCNT
EXSTPCNT
Number of steps executed.
VSE
PACCNT
EXTYPE
Record type:
VSE
PACCNT
EXXNODE
■
S—Step
■
L—Last step
Name of execution node.
ID Options
The following ID options can be used with any PACCNT EXEC variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDJOB
■
EXDUSER
■
EXFRM
290 Report Reference Guide
VSE/POWER Accounting Variables
■
EXFRNO
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PNET
■
STARTIEM
■
STEPID
■
USERID
■
VMID
ACCNT List (LIST) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCN
T
LSTACCT
Network account number.
VSE
PACCN
T
LSTADR
Printer or RJE-line address.
VSE
PACCN
T
LSTCOP
Number of printed copies.
VSE
PACCN
T
LSTCPYG
Copy grouping.
VSE
PACCN
T
LSTEXP
Number of extra pages printed because
of PRESTART, PSETUP, separator cards,
or extra copies.
VSE
PACCN
T
LSTEXR
Number of extra records printed because
of a restart, separator pages, or extra
copies.
VSE
PACCN
LSTEPGN
Number of extra pages printed.
Chapter 6: Commands 291
VSE/POWER Accounting Variables
System
Class
Variable
Name
T
Description
Overflows to zero after 65,535. Valid for
VSE 1.3 or later.
VSE
PACCN
T
LSTFLSH
Flash ID (for laser printers).
VSE
PACCN
T
LSTFOR
Print-form ID.
VSE
PACCN
T
LSTFRNO
Name of originating (FROM) node.
VSE
PACCN
T
LSTFRUS
ID of originating user.
VSE
PACCN
T
LSTNODE
Name of your node in the network.
VSE
PACCN
T
LSTNUM
Number of lines printed.
VSE
PACCN
T
LSTOCL
Printed output class.
VSE
PACCN
T
LSTOJ#
Original job number.
VSE
PACCN
T
LSTOPR
Printed output priority number.
VSE
PACCN
T
LSTPAG
Number of pages printed.
VSE
PACCN
T
LSTPGN
Number of pages printed. Overflows to
zero after 65,535. Valid for VSE 1.3 or
later.
VSE
PACCN
T
LSTRDEL
Number of records deleted by OUTEXIT
routine.
VSE
PACCN
T
LSTRINS
Number of records inserted by OUTEXIT
routine.
VSE
PACCN
T
LSTSUF
Job suffix number assigned by
VSE/POWER.
VSE
PACCN
T
LSTTO
TO remote ID.
VSE
PACCN
T
LSTTOUS
ID of destination user.
VSE
PACCN
T
LSTTRK
Number of DBLK groups for output
storage.
292 Report Reference Guide
VSE/POWER Accounting Variables
ID Options
The following ID options can be used with any PACCNT LIST variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
ISTTOUS
■
LSTACCT
■
LSTADR
■
LSTCPYG
■
LSTFLSH
■
LSTFOR
■
LSTFRM
■
LSTFRNO
■
LSTFRUS
■
LSTNODE
■
LSTOPR
■
LSTTO
■
PNET
■
STARTIME
■
VMID
Chapter 6: Commands 293
VSE/POWER Accounting Variables
PACCNT Network (PNET) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
NETDTE
Date, in the format defined for the
system.
VSE
PACCNT
NETERR
Error count.
VSE
PACCNT
NETICNT
Number of invalid responses.
VSE
PACCNT
NETIDEN
Record ID.
VSE
PACCNT
NETLAD
Line address.
VSE
PACCNT
NETNODE
Connected node ID.
VSE
PACCNT
NETNPAS
Node password.
VSE
PACCNT
NETPSW
Line password.
VSE
PACCNT
NETRCVE
Number of buffers received during
session.
VSE
PACCNT
NETSGF
Sign-off time.
VSE
PACCNT
NETSGN
Sign-on time.
VSE
PACCNT
NETSOD
Sign-off date, in the format defined for
the system.
VSE
PACCNT
NETTCNT
Time-out count.
VSE
PACCNT
NETTERM
ACF/VTAM cancel code.
VSE
PACCNT
NETTRAN
Number of buffers transmitted
ID Option
The following ID options can be used with any PACCNT PNET variable:
■
ACDATE
■
ACIDEN
■
ACSTOP
■
ACSTRT
■
CPUID
■
CPUMOD
294 Report Reference Guide
VSE/POWER Accounting Variables
■
ENDTIME
■
NETDTE
■
NETIDEN
■
NETLAD
■
NETNODE
■
NETNPAS
■
NETPSW
■
NETSGF
■
NETSGN
■
NETSOD
■
NETTERM
■
PNET
■
STARTIME
■
VMID
PACCNT PUNCH Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
PUNACCT
Network account number.
VSE
PACCNT
PUNADR
Punch device or RJE-line address (CUU).
VSE
PACCNT
PUNCOP
Number of punched copies.
VSE
PACCNT
PUNEXR
Number of additional cards punched.
VSE
PACCNT
PUNFOR
Punch-form ID.
VSE
PACCNT
PUNFRM
FROM remote ID.
VSE
PACCNT
PUNFRNO
Originating node name.
VSE
PACCNT
PUNFRUS
Originating-user ID.
VSE
PACCNT
PUNNODE
Own node ID.
VSE
PACCNT
PUNNUM
Number of records punched.
VSE
PACCNT
PUNOCL
Punched output class.
VSE
PACCNT
PUNOJ#
Original job number.
Chapter 6: Commands 295
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
PUNOPR
Punched output priority number.
VSE
PACCNT
PUNRDEL
Number of records deleted by OUTEXIT
routine.
VSE
PACCNT
PUNRINS
Number of records inserted by OUTEXIT
routine
VSE
PACCNT
PUNSUF
Job suffix number assigned by
VSE/POWER.
VSE
PACCNT
PUNTO
TO remote ID.
VSE
PACCNT
PUNTOUS
Destination-user ID.
VSE
PACCNT
PUNTRK
Number of DBLK groups for output
storage.
ID Options
The following ID options can be used with any PACCNT PUNCH variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
PUNACCT
■
PUNADR
■
PUNFOR
■
PUNFRM
■
PUNFRUS
■
PUNNODE
296 Report Reference Guide
VSE/POWER Accounting Variables
■
PUNOCL
■
PUNOPR
■
PUNTO
■
PUNTOUS
■
STARTIME
■
VMID
PACCNT READER Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
RDRACCT
Network account number.
VSE
PACCNT
RDRADD
Reader device or line address (CUU).
VSE
PACCNT
RDRDUR
Total time in reader queue.
VSE
PACCNT
RDRFRM
FROM remote ID.
VSE
PACCNT
RDRFRUS
Originating node name.
VSE
PACCNT
RDRICL
Input class.
VSE
PACCNT
RDRIPR
Input priority number.
VSE
PACCNT
RDRNODE
Own node ID.
VSE
PACCNT
RDRNUM
Number of records read.
VSE
PACCNT
RDRTRK
Number of DBLK groups for input
storage.
ID Options
The following ID options can be used with any PACCNT READER variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
Chapter 6: Commands 297
VSE/POWER Accounting Variables
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PDRADD
■
PNET
■
PUNFRM
■
RDRACCT
■
RDRFRUS
■
RDRICL
■
RDRIPR
■
RDRNODE
■
STARTIME
■
VMID
PACCNT Receiver (RECV) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
NACACCT
Network account number.
VSE
PACCNT
NACADJ
Adjacent node name.
VSE
PACCNT
NACCLAS
Class of job output.
VSE
PACCNT
NACCNTC
Control record count.
VSE
PACCNT
NACCNTD
Data record count.
VSE
PACCNT
NACCOP
Number of copies.
VSE
PACCNT
NACCURR
Own node name.
VSE
PACCNT
NACLAD
Line address (CUU).
VSE
PACCNT
NACON
Originating node name.
VSE
PACCNT
NACORGJ#
Original job number from job reader.
VSE
PACCNT
NACOUS
Remote originator user ID.
298 Report Reference Guide
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
NACPR
Priority.
VSE
PACCNT
NACQTYP
Queue type.
VSE
PACCNT
NACSUF
Job suffix (segment) number.
VSE
PACCNT
NACTN
Destination node name.
VSE
PACCNT
NACTUS
Destination user ID.
ID Options
The following ID options can be used with any PACCNT RECV variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
NACACCT
■
NACADJ
■
NACCLAD
■
NACCLAS
■
NACCURR
■
NACON
■
NACOUS
■
NACPR
■
NACQTYP
■
NACTN
Chapter 6: Commands 299
VSE/POWER Accounting Variables
■
NACTUS
■
PNET
■
STARTIME
■
VMID
PACCNT System Network Architecture (SNA) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
SNADTE
Date, in the format defined for the
system.
VSE
PACCNT
SNAIDEN
Record ID.
VSE
PACCNT
SNALUN
Logical unit name.
VSE
PACCNT
SNARID
Remote ID.
VSE
PACCNT
SNASGF
Sign-off time.
VSE
PACCNT
SNASGN
Sign-on time.
VSE
PACCNT
SNATERM
Session termination code.
VSE
PACCNT
SNAUSE
Sign-on command user information.
ID Option
The following ID options can be used with any PACCNT SNA variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
300 Report Reference Guide
VSE/POWER Accounting Variables
■
ENDTIME
■
PNET
■
SNADTE
■
SNAIDEM
■
SNALUN
■
SNARID
■
SNASGF
■
SNASGN
■
SNATERM
■
SNAUSE
■
STARTIME
■
VMID
PACCNT System-up (SYS) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
PWRATRK
Number of tracks or blocks in the
account file.
VSE
PACCNT
PWRDTE
Date, in the format defined for the
system.
VSE
PACCNT
PWRDTRK
Number of tracks or blocks in the data
file.
VSE
PACCNT
PWRDXTN
Number of data file extents.
VSE
PACCNT
PWRFLAG
Feature flags.
VSE
PACCNT
PWRGETSZ
GETVIS size, in KB.
VSE
PACCNT
PWRIDEN
Record ID.
VSE
PACCNT
PWRLEV
Level ID.
VSE
PACCNT
PWRPARSZ
Partition size.
VSE
PACCNT
PWRPART
Partition ID.
VSE
PACCNT
PWRQTRK
Number of tracks or blocks in the
queue file.
Chapter 6: Commands 301
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
PWRRELSZ
Reserved processor (real) storage size.
VSE
PACCNT
PWRSGN
Startup time.
VSE
PACCNT
PWRVER
Version or modification level.
ID Option
The following ID options can be used with any PACCNT SYS variable:
■
ACDATE
■
ACIDEN
■
ACSTRT
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
PWRDTE
■
PWRIDEN
■
PWRLEV
■
PWRPART
■
PWRSGN
■
SNAVER
■
STARTIME
■
VMID
PACCNT NJE Transmitter (TRANS) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
NACACCT
Network account number.
VSE
PACCNT
NACADJ
Adjacent node name.
VSE
PACCNT
NACCLAS
Class of job output.
302 Report Reference Guide
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
NACCNTC
Control record count.
VSE
PACCNT
NACCNTD
Data record count.
VSE
PACCNT
NACCOP
Number of copies.
VSE
PACCNT
NACCURR
Own node name.
VSE
PACCNT
NACLAD
Line address (CUU).
VSE
PACCNT
NACON
Originating node name.
VSE
PACCNT
NACORGJ#
Original job number from job reader.
VSE
PACCNT
NACOUS
Remote originator user ID.
VSE
PACCNT
NACPR
Priority.
VSE
PACCNT
NACQTYP
Queue type.
VSE
PACCNT
NACSUF
Job suffix (segment) number.
VSE
PACCNT
NACTN
Destination node name.
VSE
PACCNT
NACTUS
Destination user ID.
ID Options
The following ID options can be used with any PACCNT TRANS variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
NACACCT
Chapter 6: Commands 303
VSE/POWER Accounting Variables
■
NACADJ
■
NACCLAD
■
NACCLAS
■
NACCURR
■
NACON
■
NACOUS
■
NACPR
■
NACQTYP
■
NACTN
■
NACTUS
■
PNET
■
STARTIME
■
VMID
PACCNT Spool-Access-Connect (XCONN) Variables
The following table describes each variable:
Syste
m
Class
Variable
Name
Description
VSE
PACCNT
XCOAPPL
XPCC application ID.
VSE
PACCNT
XCOCTL#
Number of CTL requests.
VSE
PACCNT
XCODATE
Date, in the format defined for the
system.
VSE
PACCNT
XCODEVN
Device name.
VSE
PACCNT
XCOIDEN
Account-record ID.
VSE
PACCNT
XCOMSG#
Number of messages returned in
response to a CTL or PUT request.
VSE
PACCNT
XCOSTOP
Connection stop time.
VSE
PACCNT
XCOSTRT
Connection start time.
VSE
PACCNT
XCOTERM
Connection-termination code.
304 Report Reference Guide
VSE/POWER Accounting Variables
ID Options
The following ID options can be used with any PACCNT XCONN variable:
■
ACDATE
■
ACIDEN
■
ACSTOP
■
ACSTRT
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTIME
■
VMID
■
XCOAPPL
■
XCODATE
■
XCODEVN
■
XCOIDEN
■
XCOSTOP
■
XCOSTRT
■
XCOTERM
PACCNT Spool-Access-Operation (XSPOOL) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
XSPACCT
Network account number.
VSE
PACCNT
XSPCANC
VSE/POWER cancel code.
VSE
PACCNT
XSPCLSS
Class.
VSE
PACCNT
XSPCOPY
Number of copies.
VSE
PACCNT
XSPCPYG
Copy grouping.
VSE
PACCNT
XSPDATE
Date, in the format defined for the
system.
Chapter 6: Commands 305
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
XSPDISP
Disposition, as specified with the DISP=
parameter.
VSE
PACCNT
XSPEXL#
Number of extra lines or cards because
of separator pages or restarts.
VSE
PACCNT
XSPEXP#
Number of extra pages.
VSE
PACCNT
XSPEXR#
Number of extra records.
VSE
PACCNT
XSPFLSH
Flash ID (for laser printers).
VSE
PACCNT
XSPFORM
Form ID.
VSE
PACCNT
XSPIDEN
Account-record ID.
VSE
PACCNT
XSPJSUF
Job suffix number assigned by
VSE/POWER.
VSE
PACCNT
XSPLNE#
Total number of lines or cards.
VSE
PACCNT
XSPNAME
Name of job or report.
VSE
PACCNT
XSPNODE
Name of your node.
VSE
PACCNT
XSPNUMB
Job number assigned by VSE/POWER.
VSE
PACCNT
XSPOJ#
Original job number.
VSE
PACCNT
XSPPGE#
Total number of pages.
VSE
PACCNT
XSPRDEL
Records deleted by OUTEXIT routine.
VSE
PACCNT
XSPRINS
Records inserted by OUTEXIT routine.
VSE
PACCNT
XSPPRIO
Priority.
VSE
PACCNT
XSPQUID
Queue type.
VSE
PACCNT
XSPREC#
Number of records.
VSE
PACCNT
XSPREQT
Request type.
VSE
PACCNT
XSPRQAP
Requesting XPCC application ID.
VSE
PACCNT
XSPRQUS
Requesting user ID.
VSE
PACCNT
XSPSTOP
Stop time of processing.
VSE
PACCNT
XSPSTRT
Start time of processing.
VSE
PACCNT
XSPTONM
Name of destination node.
VSE
PACCNT
XSPTOUS
Destination user ID.
VSE
PACCNT
XSPTRK#
Number of DBLK groups occupied on
disk.
306 Report Reference Guide
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
XSPUSER
16 bytes of user information.
ID Options
The following ID options can be used with any PACCNT XSPOOL variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
■
XSPACCT
■
XSPCANC
■
XSPCLASS
■
XSPDATE
■
XSPFLSH
■
XSPFORM
■
XSPIDEN
■
XSPNODE
■
XSPNUMB
■
XSPQUID
■
XSPCPYG
■
XSPRIO
■
XSPRQAP
Chapter 6: Commands 307
VSE/POWER Accounting Variables
■
XSPRQUS
■
XSPSTOP
■
XSPNAME
■
XSPTONM
■
XSPTOUS
■
XSPUSER
■
XSPREQT
■
XSPSTRT
308 Report Reference Guide
Chapter 7: Variables
This section contains the following topics:
Structure of Variable Names (see page 309)
Variable Descriptions (see page 309)
VSE/POWER Accounting Variables (see page 375)
Structure of Variable Names
Report-writer variables have the following structure:
system variable-class variable-name
Report-writer variables have the following parts:
Part
Description
system
Use the following to identify the source of the variable's
data:
■
VSE—Data collected by CA Explore PM for z/VSE
variable-class
One of the variable classes listed in the next section (for
VSE variables). For example, CPU and DISK are both
valid variable classes for VSE variables.
variable-name
A variable name from the variable class selected. For
example, both BYPASS-REQ and CACHE-TO-DASD are
valid variable names for the variable class CACHE.
Variable Descriptions
The following sections list and describe all report-writer variables except for
VSE/POWER accounting (PACCNT) variables. The variables are presented
alphabetically according to record type.
Variable Class
Variable Class
CACHE
LTA
CHANNEL
MCPU
CONTENTION
OPERATOR
Chapter 7: Variables 309
Variable Descriptions
Variable Class
Variable Class
COUNT
OTHER
CPU
PAGE
DATASPACE
PHASE
DEVICE
REAL
DISK, RDISK, VDISK
SAMPLE
DSN
SGETVIS
DYNAMIC
STEP
GETVIS
SVC
INTERRUPT
SYSTEM
INTERVAL
TAPE
JOB
THRESHOLD
LOCK
VM
LPAR
WAIT
Units of Measure
All variables that represent time are displayed in seconds.
Explanation of the Data Column Heading
In the following tables, the words in the Data column indicate that the
variables represent one or more of the following data types:
Data Type
Meaning
System
Total system values that cannot be used in a jobrelated, step-related, or task-related report.
Both
Supported on both the system level as well as the joblevel, step-level, or task-level.
Job
Job-related report data available.
Step
Step-related report data available.
Task
Task-related report data available.
310 Report Reference Guide
Variable Descriptions
CACHE Variable Class
The following table describes each variable:
System
Class
Variable Name
Data
Description
VSE
CACHE
BYPASS-REQ
System
Number of operations specifying BYPASS
CACHE.
VSE
CACHE
CACHE-TO-DASD
System
Number of cache-to-DASD transfer
operations.
VSE
CACHE
DASD-TO-CACHE
System
Number of DASD-to-cache transfer
operations.
VSE
CACHE
DASDFW-FORCED
System
Number of DASD fast-write operations
that were forced to access DASD directly
because of the constraints on
nonvolatile storage space.
VSE
CACHE
DASDFW-HITS
System
Number of DASD fast-write request hits.
VSE
CACHE
DASDFW-NORM-WRITE
System
Number of normal writes to a device in
DASD fast write mode.
VSE
CACHE
DASDFW-SEQ-HITS
System
Number of sequential write cache hits to
a device in DASD fast write mode.
VSE
CACHE
DASDFW-SEQ-WRITE
System
Number of sequential writes to a device
in DASD fast write mode.
VSE
CACHE
INHIBIT-LOAD-REQ
System
Number of operations specifying
INHIBIT CACHE LOAD.
VSE
CACHE
READ-CFW-HITS
System
Number of CACHE FAST WRITE read
cache hits.
VSE
CACHE
READ-CFW-REQS
System
Number of CACHE FAST WRITE read
operations.
VSE
CACHE
READ-NORM-HITS
System
Number of normal read cache hits.
VSE
CACHE
READ-NORM-REQS
System
Number of normal read operations.
VSE
CACHE
READ-SEQ-HITS
System
Number of sequential read cache hits.
VSE
CACHE
READ-SEQ-REQS
System
Number of sequential read operations.
VSE
CACHE
SEQ-DASD-TO-CACHE
System
Number of sequential DASD-to-cache
transfer operations.
VSE
CACHE
SEQ-DETECTED-REQS
System
Number of sequential-detected
sequential access read requests.
VSE
CACHE
SSID
System
Subsystem identifier.
Chapter 7: Variables 311
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
CACHE
STATUS-GROUP2
System
Device status, group 2.
VSE
CACHE
STATUS1
System
Byte 1 of the device status, group 1.
VSE
CACHE
STATUS2
System
Byte 2 of the device status, group 1.
VSE
CACHE
UNIT
System
Device unit address.
VSE
CACHE
WRITE-CFW-HITS
System
Number of CACHE FAST WRITE write
cache hits.
VSE
CACHE
WRITE-CFW-REQS
System
Number of CACHE FAST WRITE write
operations.
VSE
CACHE
WRITE-NORM-REQS
System
Number of normal write operations.
VSE
CACHE
WRITE-SEQ-REQS
System
Number of sequential write operations.
VSE
CACHE
WRITE-SEQ-REQS
System
Number of sequential write operations.
ID Options
The following ID options can be used with any CACHE variable:
■
CACHSSID
■
ENDTIME
■
CACHUNIT
■
PNET
■
CPUID
■
STARTTIME
■
CPUMOD
■
VMID
■
DISKID
■
VOLSER
For more information about cache statistics, see the IBM's, 3390 Storage
Control Reference (GA32-0090).
312 Report Reference Guide
Variable Descriptions
CHANNEL Variable Class
The following table describes each variable:
System
Class
Variable Name
Data
Description
VSE
CHANNEL
%CPUDEV-NOOVERLAP
System
Percentage of time that the
CPU was waiting while at least
one outstanding I/O to a tape
or disk device was on the
channel, based on sample
counts. The sum of
%CPUDEV-NOOVERLAP and
%CPU-OVERLAP equals 100.
VSE
CHANNEL
%CPUDEV-OVERLAP
System
Percentage of time that the
CPU was busy while at least
one outstanding I/O to a tape
or disk device was on the
channel, based on sample
counts. The sum of
%CPUDEV-OVERLAP and
%CPU-NOOVERLAP is 100.
VSE
CHANNEL
%DEVBUSY
System
Percentage of time that at least
one outstanding I/O to a tape
or disk device was on the
channel, based on sample
counts.
VSE
CHANNEL
%DEVCPUBUSY
System
Percentage of time that the
CPU was busy and at least one
outstanding I/O to a device
was on the channel, based on
sample counts. The sum of
%DEVCPUBUSY and
%DEVCPUWAIT equals
%DEVBUSY.
VSE
CHANNEL
%DEVCPUWAIT
System
Percentage of time that the
CPU was waiting and at least
one outstanding I/O to a
device was on the channel,
based on sample counts. The
sum of %DEVCPUWAIT and
%DEVCPUBUSY equals
%DEVBUSY.
VSE
CHANNEL
%FAIL
System
Percentage of SIOs that failed.
VSE
CHANNEL
%FAIL-CB
System
Percentage of SIOs that failed
Chapter 7: Variables 313
Variable Descriptions
System
Class
Variable Name
Data
Description
because of channel busy.
VSE
CHANNEL
%WAITIDLE
System
Percentage of time the CPU
was waiting and no I/Os to
tape or disk devices on the
channel were outstanding,
based on the number of times
the CPU was sampled in a wait
state.
VSE
CHANNEL
%WAITIO
System
Percentage of time the CPU
was waiting and at least one
I/O to a tape or disk device on
the channel was outstanding,
based on the number of times
the CPU was sampled in a wait
state.
VSE
CHANNEL
BUSY|
System
Percentage of channel busy
samples prior to SIO. Valid
only for native VSE.
UTILization
VSE
CHANNEL
BUSYS
System
Percentage of channel busy
samples for a time interval.
Valid only for native VSE.
VSE
CHANNEL
DEVBUSY
System
Average active device count.
Valid only for 370 and VM
modes.
VSE
CHANNEL
FAIL
System
Number of SIOs that failed.
VSE
CHANNEL
FAIL-CB
System
Number of SIOs that failed
because of channel busy.
VSE
CHANNEL
INTERRUPTs
System
Number of I/O interrupts.
VSE
CHANNEL
IOs|SIO
System
I/O count.
VSE
CHANNEL
MAXQ-DEPTH
System
Maximum queue depth.
VSE
CHANNEL
MAXDEVBUSY
System
Maximum active device count.
Valid only for 370 and VM
modes.
VSE
CHANNEL
Q-DEPTH
System
Average maximum queue
depth.
VSE
CHANNEL
TYPE
System
Channel type (block, byte, or
SEL).
VSE
CHANNEL
XABUSYS
System
Channel path utilization (XA
I/O).
314 Report Reference Guide
Variable Descriptions
ID Options
The following ID options can be used with any CHANNEL variable except VSE
CHANNEL XABUSYS:
■
CHNID
■
PNET
■
CPUID
■
STARTTIME
■
CPUMOD
■
VMID
■
ENDTIME
The following ID options can be used with the variable VSE CHANNEL
XABUSYS:
■
CHPID
■
PNET
■
CPUID
■
STARTTIME
■
CPUMOD
■
VMID
■
ENDTIME
If You Are Using XA I/O
If you are using the XA I/O channel-monitoring subsystem, for CHANNEL
variables other than VSE CHANNEL XABUSYS, the channel that the value of
the variable is attributed to comes from the first two digits of the device ID.
For example, if the device ID begins with 01, then the variable value is
attributed to channel 01.
Chapter 7: Variables 315
Variable Descriptions
CONTENTION Variable Class
The following table describes each variable of this class:
System
Class
Variable
Name
Data
Description
VSE
CONTENTION
CODE
Job, Step, Task
VSE wait code, in hexadecimal.
VSE
CONTENTION
COUNT
Job, Step, Task
Number of times contention
occurred.
VSE
CONTENTION
JOBNAME
Job, Step, Task
Name of the job that owned the
resource (for VSE 1.3 or later).
VSE
CONTENTION
PID
Job, Step, Task
Partition ID that owned the
resource.
VSE
CONTENTION
STEPNAME
Job, Step, Task
Name of the step that owned the
resource (for VSE 1.3 or later).
VSE
CONTENTION
TID
Job, Step, Task
Task ID that owned the resource.
VSE
CONTENTION
TYPE
Job, Step, Task
Eight-character wait description.
ID Options
The following ID options can be used with any CONTENTION variable:
■
CONJOBID
■
PNET
■
CONPID
■
STARTTIME
■
CONSTEPID
■
STEPID
■
CONTID
■
STEPSEQ#
■
CPUID
■
TASKID
■
CPUMOD
■
TASKNAME
■
ENDTIME
■
USERID
■
JOBID
316 Report Reference Guide
Variable Descriptions
■
VMID
■
PID
■
WAITID
COUNT Variable Class
The COUNT variable class displays the number of input records that have been
read.
System
Class
Variable Name
Data
Description
VSE
COUNT
ESMFCAC
System
System disk cache record.
VSE
COUNT
ESMFCHN
System
System channel record.
VSE
COUNT
ESMFCHP
System
System channel path record.
VSE
COUNT
ESMFCONT
Job, Step, Task
End-of-step task contention analysis
record.
VSE
COUNT
ESMFDELY
Job, Step, Task
End-of-step task delay analysis record.
VSE
COUNT
ESMFDEV
System
System device record.
VSE
COUNT
ESMFDSNX
Job, Step, Task
End-of-step task disk DSN record.
VSE
COUNT
ESMFEOJ
Job, Step
End-of-job record.
VSE
COUNT
ESMFEOS
Job, Step
End-of-step record.
VSE
COUNT
ESMFJAC
Job, Step
End-of-step job accounting record.
VSE
COUNT
ESMFLCK
Job, Step, Task
End-of-step task lock record.
VSE
COUNT
ESMFORPH
Job, Step, Task
End-of-step orphaned storage record.
VSE
COUNT
ESMFPAG
System
System paging record.
VSE
COUNT
ESMFPOWA
Job, Step
VSE/POWER accounting record.
VSE
COUNT
ESMFPRSM
System
LPAR or VM CPU activity record.
VSE
COUNT
ESMFSAM
System
System one-minute interval record.
VSE
COUNT
ESMFSDS
System
System data set record.
VSE
COUNT
ESMFSDSK
Job, Step, Task
End-of-step task disk record.
VSE
COUNT
ESMFSEK
System
System disk cylinder activity record.
VSE
COUNT
ESMFSJS
Job, Step
Start-of-job or -step record.
VSE
COUNT
ESMFSOIO
Job, Step, Task
End-of-step task non-disk device record.
VSE
COUNT
ESMFSPHS
Job, Step, Task
End-of-step task phase record.
Chapter 7: Variables 317
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
COUNT
ESMFSPSV
Job, Step, Task
End-of-step task phase SVC record.
VSE
COUNT
ESMFSSV
System
System SVC record.
VSE
COUNT
ESMFSTSK
Job, Step, Task
End-of-step task record.
VSE
COUNT
ESMFSTSV
Job, Step, Task
End-of-step task SVC record
VSE
COUNT
ESMFSXA
System
System XA device record
VSE
COUNT
ESMFSYS
System
System interval record
VSE
COUNT
ESMFTHR
System
Threshold record
ID Options
Each of the variable names for the COUNT variable class has a different set of
valid ID options. Each set of ID options is identical to the ID options for a
related variable class.
The following table lists the COUNT variable name, the variable class with
which it shares ID options, and the page number where those ID options are
listed:
Variable Name
Variable Class Having Identical ID Options
ESMFCAC
CACHE
ESMFCHN
CHANNEL
ESMFCHP
The variable VSE CHANNEL XABUSYS
ESMFCONT
CONTENTION
ESMFDELY
Non-system WAIT variables
ESMFDEV
System DEVICE variables
ESMFDSNX
Non-system DSN variables
ESMFEOJ
STEP, excluding the ID option STEPID
ESMFEOS
STEP
ESMFJAC
STEP
ESMFLCK
LOCK
ESMFORPH
Non-system SGETVIS variables
ESMFPAG
System PAGE variables
ESMFLCK
LOCK
ESMFORPH
Non-system SGETVIS variables
318 Report Reference Guide
Variable Descriptions
Variable Name
Variable Class Having Identical ID Options
ESMFPAG
System PAGE variables
ESMFPOWA
PACCNT, only ID options beginning with AC
ESMFPRSM
LPAR
ESMFSAM
SAMPLE
ESMFSDS
System DSN variables
ESMFSDSK
Non-system DISK variables
ESMFSEK
System DISK variables
ESMFSJS
STEP
ESMFSOIO
Non-system DEVICE variables
ESMFSPHS
PHASE
ESMFSPSV
Non-system SVC variables
ESMFSSV
System SVC variables
ESMFSTSK
Non-system CPU variables
ESMFSTSV
Non-system SVC variables
ESMFSXA
System DEVICE variables
ESMFSYS
System CPU variables
ESMFTHR
THRESHOLD
CPU Variable Class
For more information about CPU variable class when you are using the
VSE/ESA Turbo Dispatcher environment, see MCPU Variable Class.
System
Class
Variable Name
Data
Description
VSE
CPU
%BUSYReal
System
Percentage of time that a VSE machine was
running using the real processor. For an LPAR
or VM environment, use VSE LPAR %TOTAL
or VSE VM %TTIME for a more accurate
representation of the real CPU utilization.
VSE
CPU
%BUSYSample| Both
%ACTIVESample
Percentage of time CPU was sampled as busy.
This can be used by users who do not use job
accounting.
VSE
CPU
%BUSYVirt|
Percentage of time CPU was running using
the CPU timer. This is the preferred variable
UTILization
System
Chapter 7: Variables 319
Variable Descriptions
System
Class
Variable Name
Data
Description
for system CPU busy for all users. For VM or
PR/SM users, it gives the percentage as if the
VSE machine were running stand-alone on
the real processor.
VSE
CPU
%CONTention
System
Percentage of time a VSE machine wanted to
run but could not because of higher priority
virtual machines or LPARS. Valid for VM and
PR/SM users. Its value is defined as the total
length of time in the interval minus the length
of time the VSE machine was allowed to run,
divided by the length of time in the interval.
Increasing the priority of this machine
reduces this number.
VSE
CPU
%LTA
Both
Percentage of time CPU was sampled as
active and running in the LTA.
VSE
CPU
%PROBLEM
Both
Percentage of time CPU was sampled as
active and running in problem state. This
variable is not available in the VSE Turbo
Dispatcher environment or if more than one
CPU is active.
VSE
CPU
%SUPERVISOR
Both
Percentage of time CPU was sampled as
active and running in supervisor state. This
variable is not available in the VSE Turbo
Dispatcher environment or if more than one
CPU is active.
VSE
CPU
%WAITV
System
Percentage of time CPU was inactive using
the CPU timer.
VSE
CPU
%WAITIDLE
System
Percentage of CPU wait time when no I/Os to
tape or disk were outstanding. The sum of
%WAITIDLE and %WAITIO is 100.
VSE
CPU
%WAITIDLE-TOT System
Percentage of time the CPU was waiting when
there were no I/Os to tape or disk
outstanding. The sum of %WAITIDLE-TOT,
%BUSYV, and %WAITIO-TOT is 100.
VSE
CPU
%WAITIO
System
Percentage of CPU wait time when at least
one I/O to tape or disk was outstanding. The
sum of %WAITIO and %WAITIDLE is 100.
VSE
CPU
%WAITIO-TOT
System
Percentage of time the CPU was waiting when
at least one I/O to tape or disk was
outstanding. The sum of %WAITIO-TOT,
%BUSYV, and %WAITIDLE-TOT is 100.
VSE
CPU
%WAITSample
Both
Percentage of time CPU was sampled as
320 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
waiting.
VSE
CPU
BUSYVirt
System
Length of time CPU was running using the
CPU timer. This is the preferred variable for
system CPU busy for all users. For VM or
PR/SM users, it gives the number of CPU
seconds as if the VSE machine were running
stand-alone on the real processor.
VSE
CPU
CONTention
System
Length of time a VSE machine wanted to run
but could not because of higher priority
virtual machines or LPARS. Valid for VM and
PR/SM users. Its value is defined as the total
length of time in the interval minus the length
of time the VSE machine was allowed to run,
divided by the amount of time in the interval.
Increasing the priority of this machine
reduces this value. On native VSE systems,
this is the length of time the CPU was
manually stopped.
VSE
CPU
WAITV
System
Total time the CPU was inactive using the
CPU timer.
VSE
CPU
WAITIDLE
System
Length of time the CPU was waiting and there
were no I/Os to tape or disk outstanding.
VSE
CPU
WAITIO
System
Length of time the CPU was waiting and at
least one I/O to tape or disk was outstanding.
ID Options
The following ID options can be used with any system CPU variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system CPU variable:
■
ACCANC
■
ACDATE
■
ACIDEN
Chapter 7: Variables 321
Variable Descriptions
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
322 Report Reference Guide
Variable Descriptions
DATASPACE Variable Class
The DATASPACE variable class is valid only for VSE 1.3 or later.
Syste
m
Class
VSE
VSE
Variable
Name
Data
Description
DATASPACE COUNT
System,
Job, Step
Number of data spaces, in K,
on the system. Sampling is
performed at the end of the
SYSTIMEI interval.
DATASPACE SIZE
System,
Job, Step
Amount of virtual storage, in
K, used for all data spaces in
the system. Sampling is
performed at the end of the
SYSTIMEI interval.
ID Options
The following ID options can be used with any DATASPACE variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
DEVICE Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
DEVICE
%FAIL
System
Percentage of SIOs that failed.
VSE
DEVICE
%FAIL-CB
System
Percentage of SIOs that failed because of
channel busy. Valid for 370 mode only.
VSE
DEVICE
%FAIL-CUB
System
Percentage of SIOs that failed because of
control unit busy. Valid for 370 mode only.
VSE
DEVICE
%FAIL-DB
System
Percentage of SIOs that failed because of device
busy. Valid for 370 mode only.
Chapter 7: Variables 323
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
DEVICE
BUSY|UTILization
Both
Percentage of time device is active.
VSE
DEVICE
DESCRIPTION
System
25-character description of device.
VSE
DEVICE
FAIL
System
Number of SIOs that failed.
VSE
DEVICE
FAIL-CB
System
Number of SIOs that failed because of channel
busy. Valid for 370 mode only.
VSE
DEVICE
FAIL-CUB
System
Number of SIOs that failed because of control
unit busy. Valid for 370 mode only.
VSE
DEVICE
FAIL-DB
System
Number of SIOs that failed because of device
busy. Valid for 370 mode only.
VSE
DEVICE
IOTIME|I/OTIME
Both
Total active time.
VSE
DEVICE
MAXQ-DEPTH
System
Maximum queue depth.
VSE
DEVICE
MAXSERVTIME
Both
Maximum I/O service time.
VSE
DEVICE
Q-DEPTH
System
Average maximum queue depth.
VSE
DEVICE
Q-TIME
Both
Average length of time the I/O request was on
the channel queue.
VSE
DEVICE
READS
System
Number of read CCW commands.
VSE
DEVICE
SENSE
System
Number of sense or diagnostic CCW commands.
VSE
DEVICE
SERVTIME
Both
Average I/O service time.
VSE
DEVICE
SIOs|I/O|IO
Both
SIO count.
VSE
DEVICE
TYPE
System
Device type and model (eight characters).
VSE
DEVICE
UTILTIME
Both
Device utilization time (the average amount of
time between the start I/O and I/O interrupt).
VSE
DEVICE
WRITES
System
Number of write CCW commands.
ID Options
The following ID options can be used with any system DEVICE variable:
■
CPUID
■
CPUMOD
■
DEVID
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
324 Report Reference Guide
Variable Descriptions
The following ID options can be used with any non-system DEVICE variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DEVID
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
Chapter 7: Variables 325
Variable Descriptions
■
TASKID
■
TASKNAME
■
USERID
■
VMID
DISK Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
DISK
%ARMMOVE
System
Percentage of seeks causing arm movement.
(Cache hits do not cause arm movement.)
VSE
DISK
%FAIL
System
Percentage of SIOs that failed.
VSE
DISK
%FAIL-CB
System
Percentage of SIOs that failed because of
channel busy. Valid for 370 mode only.
VSE
DISK
%FAIL-CUB
System
Percentage of SIOs that failed because of
control unit busy. Valid for 370 mode only.
VSE
DISK
%FAIL-DB
System
Percentage of SIOs that failed because of
device busy. Valid for 370 mode only.
VSE
DISK
%QUEUED
System
Percentage of times that an I/O request to a
device had to be queued because another I/O
was already active.
VSE
DISK
%ZEROSEEK
System
Percentage of seeks not causing an arm move.
(Cache hits do not cause arm movement.)
VSE
DISK
ARMMOVE
System
Number of seeks causing arm movement.
(Cache hits do not cause arm movement.)
VSE
DISK
AVGSEEKD
System
Average seek distance. (Cache hits do not
cause arm movement.)
VSE
DISK
BUSY|UTILization
Both
Percentage of time disk is active.
VSE
DISK
FAIL
System
Number of SIOs that failed.
VSE
DISK
FAIL-CB
System
Number of SIOs that failed because of channel
busy. Valid for 370 mode only.
VSE
DISK
FAIL-CUB
System
Number of SIOs that failed because of control
unit busy. Valid for 370 mode only.
VSE
DISK
FAIL-DB
System
Number of SIOs that failed because of device
busy. Valid for 370 mode only.
VSE
DISK
MAXQ-DEPTH
System
Maximum queue depth.
326 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
DISK
MAXSERVTIME
Both
Maximum I/O service time (the time between
the I/O request being queued on the channel
and the I/O interrupt).
VSE
DISK
NOSEEK
System
Number of I/Os with no seek data.
VSE
DISK
NOSEEK-UTILTIME
System
Disk utilization time (the average amount of
time between the start I/O and I/O interrupt),
restricted to I/Os with no seek data.
VSE
DISK
Q-DEPTH
System
Average maximum queue depth.
VSE
DISK
Q-LENgth
System
Average device queue length.
VSE
DISK
Q-TIME
Both
Average length of time I/O request was on the
channel queue.
VSE
DISK
QUEUED
System
Number of times that an I/O request to a
device had to be queued because another I/O
was already active.
VSE
DISK
READS
System
Number of read CCW commands.
VSE
DISK
RESERVEs
System
Number of disk reserves (number of times the
CCW command was used to prevent other
CPUs from writing to a specified disk—
normally, the disk containing the lock file).
VSE
DISK
SEEKs
System
Seek count.
VSE
DISK
SEEK-UTILTIME
System
Disk utilization time (the average amount of
time between the start I/O and I/O interrupt),
restricted to I/Os with seek data.
VSE
DISK
SENSE
System
Number of sense or diagnostic CCW
commands.
VSE
DISK
SERVTIME
Both
Average I/O service time (the time between
the I/O request being queued on the channel
and the I/O interrupt).
VSE
DISK
SIOs|I/O|IO
Both
SIO count.
VSE
DISK
SUBSYSTEM
System
Number of I/O operations that change or
request information from a cache controller,
such as the IBM 3990 model 3 and 6.
VSE
DISK
TOTSEEKD
System
Total seek distance.
VSE
DISK
TYPE
System
Disk type and model (eight characters).
VSE
DISK
UTILTIME
Both
Disk utilization time (the average amount of
time between the start I/O and I/O interrupt).
VSE
DISK
WRITES
System
Number of write CCW commands.
Chapter 7: Variables 327
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
DISK
ZEROSEEK
System
Number of seeks not causing an arm move.
Variables Valid For XA I/O Users Only
The following variables are valid only if you are using the XA I/O channelmonitoring subsystem. For more information about the XA I/O channelmonitoring subsystem, see IBM's ESA/390 Principles of Operations (SA227201-00).
Syste
m
Class
Variable
Name
Data
VSE
DISK
ACTIVE
System Average disk service time (total
of VSE DISK CONNect, VSE DISK
DISConnect, and VSE DISK
PENDing). This value should
approximately equal VSE DISK
UTILTIME.
VSE
DISK
CONNect
System Average time, in seconds, spent
transferring commands and data
between the subchannel and the
channel subsystem.
VSE
DISK
DISConnect
System Average time, in seconds, that
the disk was logically
disconnected from the channel
subsystem while the subchannel
was active, including seek time,
latency, and RPS reconnect time.
VSE
DISK
PENDing
System Average time, in seconds,
between VSE issuing the start
subchannel and the first CCW
command being executed on the
actual subchannel.
VSE
DISK
SAMPLEs
System Number of start/resume
subchannels issued that had valid
times.
VSE
DISK
SSCH
System Number of start/resume
subchannels issued.
328 Report Reference Guide
Description
Variable Descriptions
RDISK and VDISK for VSE Users
The following additional variable classes are available for users of VSE 1.3 or
later:
Use this Class in
Place of DISK:
To Report on:
RDISK
Disk devices known to VSE as real (non-virtual).
VDISK
Disk devices that are virtual data spaces.
ID Options
The following ID options can be used with any system DISK, RDISK, or VDISK
variable:
■
CPUID
■
CPUMOD
■
DISKID
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
■
VOLSER
In addition to the preceding ID options, the following ID option can be used
only with the system variables VSE DISK SEEKS, VSE RDISK SEEKS, and VSE
VDISK SEEKS:
■
CYLID
The following ID options can be used with any non-system DISK, RDISK, or
VDISK variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
Chapter 7: Variables 329
Variable Descriptions
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DISKID
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
■
VOLSER
330 Report Reference Guide
Variable Descriptions
DSN Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
DSN
BUSY
Both
Percentage of time data set is active.
VSE
DSN
CUU
Both
Address of device in which the data set resides.
VSE
DSN
ENDADDR
Both
Data set end address.
VSE
DSN
IOTIME|I/OTIME
Both
Total active/busy time.
VSE
DSN
MAXSERVTIME
Both
Maximum I/O service time (the time between the
I/O request being queued on the channel and the
I/O interrupt).
VSE
DSN
READs
Both
Number of read SIOs.
VSE
DSN
SERVTIME
Both
Average I/O service time (the time between the
I/O request being queued on the channel and the
I/O interrupt).
VSE
DSN
SIOs|I/O|IO
Both
SIO count.
VSE
DSN
SIZE
Both
Number of tracks or blocks allocated to the data
set.
VSE
DSN
STARTADDR
Both
Data set start address.
VSE
DSN
VOLSER
Both
VOLSER of device in which the data set resides.
VSE
DSN
WRITEs
Both
Number of write SIOs.
VSE
DSN
WRITESERVtime
Both
Average I/O service time for writes.
ID Options
The following ID options can be used with any system DSN variable:
■
CPUID
■
CPUMOD
■
DISKID
■
DSNID
■
ENDADDR
■
ENDTIME
■
PNET
■
STARTADDR
Chapter 7: Variables 331
Variable Descriptions
■
STARTTIME
■
VMID
■
VOLSER
The following ID options can be used with any non-system DSN variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DISKID
■
DSNID
■
ENDADDR
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
332 Report Reference Guide
Variable Descriptions
■
PID
■
PNET
■
STARTADDR
■
STARTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
■
VOLSER
Reports using the DSNID ID option use data set statistics. To ensure accurate
data set statistics between initializations, you should execute the disk-mapping
program EVSEDBAT when you make significant changes in disk-mapping
configuration options, data set names, or data set locations. For more
information about running EVSEDBAT, see the Utilities Guide.
DYNAMIC Variable Class
DYNAMIC variables are valid only for VSE/ESA systems running in 370 mode
with dynamic partitions. For more information about the XA I/O channelmonitoring subsystem, see the IBM's ESA/390 Principles of Operations (SA227201-00).
System
Class
Variable Name
Data
Description
VSE
DYNAMIC
%USED
Job, Step
Percentage of dynamic GETVIS used.
VSE
DYNAMIC
MAX%USED
Job, Step
Maximum percentage of dynamic GETVIS
used.
VSE
DYNAMIC
MAXUSED
Job, Step
Maximum dynamic GETVIS used, in KB.
VSE
DYNAMIC
SIZE
Job, Step
Dynamic partition GETVIS size, in KB.
VSE
DYNAMIC
UNUSED
Job, Step
Dynamic GETVIS available (not used), in
KB.
VSE
DYNAMIC
USED
Job, Step
Dynamic GETVIS used, in KB.
Chapter 7: Variables 333
Variable Descriptions
ID Options
The following ID options can be used with any DYNAMIC variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
GETVIS Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
GETVIS
%USED
Job, Step
Percentage of 24-bit GETVIS used.
VSE
GETVIS
MAX%USED
Job, Step
Maximum percentage of 24-bit GETVIS
used.
VSE
GETVIS
MAXUSED
Job, Step
Maximum 24-bit GETVIS used, in KB.
334 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
GETVIS
REQUESTs
Job, Step,
Task
Number of 24-bit partition GETVIS
requests.
VSE
GETVIS
SIZE
Job, Step
24-bit GETVIS size, in KB.
VSE
GETVIS
TUSED
Job, Step,
Task
Amount of 24-bit partition GETVIS used.
VSE
GETVIS
UNUSED
Job, Step
24-bit GETVIS available (not used), in KB.
VSE
GETVIS
USED
Job, Step
24-bit GETVIS used, in KB.
VSE
GETVIS
31-%USED
Job, Step
Percentage of 31-bit GETVIS used.
VSE
GETVIS
31-MAX%USED
Job, Step
Maximum percentage of 31-bit GETVIS
used.
VSE
GETVIS
31-MAXUSED
Job, Step
Maximum 31-bit GETVIS used, in KB.
VSE
GETVIS
31-REQUESTs
Job, Step,
Task
Number of 31-bit partition GETVIS
requests.
VSE
GETVIS
31-SIZE
Job, Step
31-bit GETVIS size, in KB.
VSE
GETVIS
31-TUSED
Job, Step,
Task
Amount of 31-bit partition GETVIS used.
VSE
GETVIS
31-UNUSED
Job, Step
31-bit GETVIS available (not used), in KB.
VSE
GETVIS
31-USED
Job, Step
31-bit GETVIS used, in KB.
Configuration Requirement
The following variables must have full partition GETVIS monitoring active in
order to display valid data. For complete instructions on setting these
configuration options, see the Online User Guide.
■
VSE GETVIS REQUESTs
■
VSE GETVIS TUSED
■
VSE GETVIS 31-REQUESTs
■
VSE GETVIS 31-TUSED
ID Options
The following ID options can be used with any GETVIS variable:
■
ACCANC
■
ACDATE
■
ACIDEN
Chapter 7: Variables 335
Variable Descriptions
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
USERID
■
VMID
336 Report Reference Guide
Variable Descriptions
INTERRUPT Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
INTERRUPT
CLOCK-COMParator
System
Number of clock comparator external
interrupts.
VSE
INTERRUPT
CPU-TIMER
System
Number of CPU timer external
interrupts.
VSE
INTERRUPT
OTHER
System
Number of external interrupts
excluding CLOCK-COMParator, CPUTIMER, and VMCF-IUCV interrupts.
VSE
INTERRUPT
VMCF-IUCV
System
Number of VMCF/IUCV external
interrupts.
ID Options
The following ID options can be used with any INTERRUPT variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
INTERVAL Variable Class
The INTERVAL variable class displays the total interval that the input record
represents.
Syste
m
Class
Variable
Name
Data
Description
VSE
INTERVAL
ESMFCAC
System
System disk cache record.
VSE
INTERVAL
ESMFCHN
System
System channel record.
VSE
INTERVAL
ESMFCHP
System
System channel path record.
VSE
INTERVAL
ESMFCONT
Job, Step, Task
End-of-step task contention analysis
record.
Chapter 7: Variables 337
Variable Descriptions
Syste
m
Class
Variable
Name
Data
Description
VSE
INTERVAL
ESMFDELY
Job, Step, Task
End-of-step task delay analysis record.
VSE
INTERVAL
ESMFDEV
System
System device record.
VSE
INTERVAL
ESMFDSNX
Job, Step, Task
End-of-step task disk DSN record.
VSE
INTERVAL
ESMFEOJ
Job, Step
End-of-job record.
VSE
INTERVAL
ESMFEOS
Job, Step
End-of-step record.
VSE
INTERVAL
ESMFJAC
Job, Step
End-of-step job accounting record.
VSE
INTERVAL
ESMFLCK
Job, Step, Task
End-of-step task lock record.
VSE
INTERVAL
ESMFORPH
Job, Step, Task
End-of-step orphaned storage record.
VSE
INTERVAL
ESMFPAG
System
System paging record.
VSE
INTERVAL
ESMFPOWA
Job, Step
VSE/POWER accounting record.
VSE
INTERVAL
ESMFPRSM
System
LPAR or VM activity record.
VSE
INTERVAL
ESMFSAM
System
System one-minute interval record.
VSE
INTERVAL
ESMFSDS
System
System data set record.
VSE
INTERVAL
ESMFSDSK
Job, Step, Task
End-of-step task disk record.
VSE
INTERVAL
ESMFSEK
System
System disk cylinder activity record.
VSE
INTERVAL
ESMFSJS
Job, Step
Start-of-job or -step record.
VSE
INTERVAL
ESMFSOIO
Job, Step, Task
End-of-step task non-disk device record.
VSE
INTERVAL
ESMFSPHS
Job, Step, Task
End-of-step task phase record.
VSE
INTERVAL
ESMFSEK
System
System disk cylinder activity record.
VSE
INTERVAL
ESMFSJS
Job, Step
Start-of-job or -step record.
VSE
INTERVAL
ESMFSOIO
Job, Step, Task
End-of-step task non-disk device record.
VSE
INTERVAL
ESMFSPHS
Job, Step, Task
End-of-step task phase record.
VSE
INTERVAL
ESMFSPSV
Job, Step, Task
End-of-step task phase SVC record.
VSE
INTERVAL
ESMFSSV
System
System SVC record.
VSE
INTERVAL
ESMFSTSK
Job, Step, Task
End-of-step task record.
VSE
INTERVAL
ESMFSTSV
Job, Step, Task
End-of-step task SVC record.
VSE
INTERVAL
ESMFSXA
System
System XA device record.
VSE
INTERVAL
ESMFSYS
System
System interval record.
VSE
INTERVAL
ESMFTHR
System
Threshold record.
338 Report Reference Guide
Variable Descriptions
ID Options
Each of the variable names for the INTERVAL variable class has a different set
of valid ID options. Each set of ID options is identical to the ID options for a
related variable class.
The following table lists the INTERVAL variable name, and the variable class
with which it shares ID options:
Variable Name
Variable Class Having Identical ID Options
ESMFCAC
CACHE
ESMFCHN
CHANNEL
ESMFCHP
CHANNEL, XABUSYS variable only
ESMFCONT
CONTENTION
ESMFDELY
WAIT, non-system variable
ESMFDEV
DEVICE, system variable
ESMFDSNX
DSN, non-system variable
ESMFEOJ
STEP, excluding STEPID
ESMFEOS
STEP
ESMFJAC
STEP
ESMFLCK
LOCK
ESMFORPH
SGETVIS, non-system variable
ESMFPAG
PAGE, system variable
ESMFPOWA
PACCNT, all ID options beginning with AC
ESMFPRSM
LPAR
ESMFSAM
SAMPLE
ESMFSDS
DSN, system variable
ESMFSDSK
DISK, non-system variable
ESMFSEK
DISK, system variable
ESMFSJS
STEP
ESMFSOIO
DEVICE, non-system variable
ESMFSPHS
PHASE
ESMFSPSV
SVC, non-system variable
ESMFSSV
SVC, system variable
Chapter 7: Variables 339
Variable Descriptions
Variable Name
Variable Class Having Identical ID Options
ESMFSTSK
CPU, non-system variable
ESMFSTSV
SVC, non-system variable
ESMFSXA
DEVICE, system variable
ESMFSYS
CPU, system variable
ESMFTHR
THRESHOLD
JOB Variable Class
The following table describes each variable of this class:
Syste
m
Class Variable
Name
Data
Description
VSE
JOB
COST
Job,
Step,
Task
Total cost for the row in the report.
This is the same as the variable
REPORT COST TOTAL. For more
information, see the chapter
"Command Descriptions and
Syntax."
VSE
JOB
COUNT
Job
Number of jobs executed.
VSE
JOB
DURATION
Job
Average job execution time.
ID Options
The following ID options can be used with any JOB variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
340 Report Reference Guide
Variable Descriptions
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
USERID
■
VMID
LOCK Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
LOCK
HEXNAME
Job, Step, Task
Resource name displayed in
hexadecimal format.
VSE
LOCK
NAME
Job, Step, Task
Resource name.
VSE
LOCK
REQ-FAIL-OTHER
Job, Step, Task
Number of lock requests failed for
reasons other than the resource
was unavailable.
Chapter 7: Variables 341
Variable Descriptions
VSE
LOCK
REQ-FAIL-RSCE
Job, Step, Task
Number of lock requests that failed
because the resource was
unavailable.
VSE
LOCK
REQ-SUCCESS
Job, Step, Task
Number of successful lock
requests.
VSE
LOCK
REQuests
Job, Step, Task
Number of lock requests.
VSE
LOCK
TYPE
Job, Step, Task
Lock type (INTERNAL or
EXTERNAL).
VSE
LOCK
UNLOCK
Job, Step, Task
Number of unlock requests.
VSE
LOCK
UNLOCK-FAIL
Job, Step, Task
Number of unlock requests that
failed because the resource was
not locked.
ID Options
The following ID options can be used with any LOCK variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDJOB
■
EXDFRNO
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
342 Report Reference Guide
Variable Descriptions
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
LOCKHEXID
■
LOCKID
■
LOCKTYPE
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
THRDID
■
USERID
■
VMID
LPAR Variable Class
The LPAR variable class is valid only for VSE 1.3 or greater.
System
Class
Variable Name
Data
Description
VSE
LPAR
ACTIVE
System
CPU time used by the partition.
VSE
LPAR
%ACTIVE
System
Percentage of CPU time used by the partition.
VSE
LPAR
CPU
System
Logical CPU address.
VSE
LPAR
NAME
System
Logical partition name.
VSE
LPAR
NUMBER
System
Logical partition number.
VSE
LPAR
OVERHEAD
System
CPU time associated with LPAR overhead.
VSE
LPAR
%OVERHEAD
System
Percentage of CPU time associated with LPAR
overhead.
Chapter 7: Variables 343
Variable Descriptions
VSE
LPAR
PROCessors
System
Number of physical CPUs.
VSE
LPAR
TOTAL-time
System
Total CPU time (ACTIVE + OVERHEAD).
VSE
LPAR
%TOTAL-time
System
Percentage of total CPU time.
VSE
LPAR
WEIGHT
System
CPU weight factor.
ID Options
The following ID options can be used with any system LPAR variable:
■
CPUPID
■
ENDTIME
■
LPARID
■
LPID
■
STARTTIME
Important! Use LPAR data from one system only. If you are collecting LPAR
data from multiple systems, do not merge this data before reporting on it.
If you receive an error message saying there is no matching data, or if the
overhead numbers are zero, then either your hardware does not support this
function or you need a higher level of microcode.
LTA Variable Class
The following table describes each variable of this class:
Syste
m
Class Variable
Name
Data
Description
VSE
LTA
%BUSY
Job, Step,
Task
Percentage of time spent in LTA.
VSE
LTA
BUSY
Job, Step,
Task
Total time spent in LTA.
VSE
LTA
LOAD
Both
Number of LTA load requests.
VSE
LTA
TIME
System
Total time spent in LTA.
VSE
LTA
USE
Both
Number of times LTA was used.
344 Report Reference Guide
Variable Descriptions
ID Options
The following ID options can be used with any system LTA variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system LTA variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
Chapter 7: Variables 345
Variable Descriptions
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
MCPU Variable Class
The MCPU variable class applies only to a VSE Turbo Dispatcher environment.
System
Class
Variable Name
Data
Description
VSE
MCPU
%BUSYReal
System
Percentage of time that a VSE machine
was running using the real processor. For
an LPAR or VM environment, use VSE
LPAR %TOTAL or VSE VM %TTIME for a
more accurate representation of the real
CPU utilization. This value includes spin
time in a multiple-CPU environment.
VSE
MCPU
%BUSYVirt|
UTILization
System
Percentage of time CPU was running
using the CPU timer. This is the preferred
variable for system CPU busy for all
users. For VM or PR/SM users, it gives
the percentage as if the VSE machine
were running stand-alone on the real
processor. This value includes spin time
in a multiple-CPU environment.
VSE
MCPU
%CONTention
System
Percentage of time a VSE machine
wanted to run but could not because of
higher priority virtual machines or LPARS.
Valid for VM and PR/SM users. Its value is
defined as the total length of time in the
interval minus the length of time the VSE
machine was allowed to run, divided by
346 Report Reference Guide
Variable Descriptions
System
Class
Variable Name
Data
Description
the length of time in the interval.
Increasing the priority of this machine
reduces this number.
VSE
MCPU
%NON-PARallel
System
Percentage of time spent in a non-parallel
state.
VSE
MCPU
%PARallel
System
Percentage of time spent in a parallel
state.
VSE
MCPU
%SPIN
System
Percentage of unproductive time the
system spent waiting for a resource to be
freed.
VSE
MCPU
%WAITV
System
Percentage of time CPU was inactive
using the CPU timer.
VSE
MCPU
BUSYVirt
System
Length of time CPU was running using the
CPU timer. This is the preferred variable
for system CPU busy for all users. For VM
or PR/SM users, it gives the number of
CPU seconds as if the VSE machine were
running stand-alone on the real
processor. This value includes spin time
in a multiple-CPU environment.
VSE
MCPU
CONTention
System
Length of time a VSE machine wanted to
run but could not because of higher
priority virtual machines or LPARS. Valid
for VM and PR/SM users. Its value is
defined as the total length of time in the
interval minus the length of time the VSE
machine was allowed to run, divided by
the amount of time in the interval.
Increasing the priority of this machine
reduces this value. On native VSE
systems, this is the length of time the
CPU was manually stopped.
VSE
MCPU
NON-PARallel
System
Amount of time spent in a non-parallel
state.
VSE
MCPU
PARallel
System
Amount of time spent in a parallel state.
VSE
MCPU
SPIN
System
Amount of unproductive time the system
spent waiting for a resource to be freed.
VSE
MCPU
WAITV
System
Total time the CPU was inactive using the
CPU timer.
Chapter 7: Variables 347
Variable Descriptions
ID Options
The following ID options can be used with any system MCPU variable:
■
CPUID
■
CPUMOD
■
CPUPID
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
OPERATOR Variable Class
The OPERATOR variable class is valid only for VSE 1.3 or later.
Syste
m
Class
VSE
Variable
Name
Data
Description
OPERATOR REQUESTS
Job, Step,
Task
Number of operator replies
satisfied. Accumulated
when the operator request
is satisfied.
VSE
OPERATOR TIME
Job, Step,
Task
Total time spent waiting for
an operator reply.
Accumulated each
SYSTIMEI interval.
VSE
OPERATOR RESPonse
Job, Step,
Task
Average time spent waiting
for an operator reply.
Accumulated when the
operator request is
satisfied.
Important! The setting of the SAMPSECS configuration option determines the
intervals at which outstanding operator replies are sampled. The shorter the
interval, the greater the number of samples taken, and the more accurate
your samplings.
348 Report Reference Guide
Variable Descriptions
ID Options
The following ID options can be used with any OPERATOR variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
Chapter 7: Variables 349
Variable Descriptions
■
TASKNAME
■
USERID
■
VMID
OTHER Variable Class
The following table describes each variable of this class:
Syste
m
Class
Variable Name Data
Description
VSE
OTHER
I/O|IO
Number of SIOs to nontape and non-disk
devices.
VSE
OTHER
IOTIME|I/OTIME Job, Step,
Task
Total I/O time for nontape and non-disk
devices.
VSE
OTHER
SERVICE|SERVT Job, Step,
IME
Task
Average service time for
non-tape and non-disk
devices.
Job, Step,
Task
ID Options
The following ID options can be used with any OTHER variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
350 Report Reference Guide
Variable Descriptions
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
PAGE Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
PAGE
CUU
System
Device where page
data set resides.
VSE
PAGE
ENDADDR
System
Page data set end
address.
VSE
PAGE
FAULTs
Both
Total number of page
faults.
VSE
PAGE
INs
System
Total number of page-
Chapter 7: Variables 351
Variable Descriptions
System
Class
Variable Name
Data
Description
ins.
VSE
PAGE
IO
System
Total number of page
I/Os.
VSE
PAGE
OUTs
System
Total number of pageouts.
VSE
PAGE
VMFAULTs
Both
Number of VM pseudo
page faults.
VSE
PAGE
VMI/OTIME|VMIOTI
ME
Job, Step,
Task
Total VM pseudo page
I/O time.
VSE
PAGE
VMSERVICE|VMSERV Job, Step,
TIME
Task
Average VM pseudo
page service time.
VSE
PAGE
VOLID|VOLSER
System
Device volume ID.
VSE
PAGE
STARTADDR
System
Page data set start
address.
ID Options
The following ID options can be used with PAGE variables with data type Both
in the preceding table:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any system PAGE variable:
■
CPUID
■
CPUMOD
■
DISKID
■
ENDTIME
■
PAGEID
■
PNET
352 Report Reference Guide
Variable Descriptions
■
STARTTIME
■
VMID
■
VOLSR
The following ID options can be used with any non-system PAGE variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DISKID
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PAGEID
■
PID
Chapter 7: Variables 353
Variable Descriptions
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
■
VOLSER
PHASE Variable Class
The following table describes each variable of this class:
System Class
Variable
Name
Data
Description
VSE
PHASE
ADDRESS
Job, Step,
Task
Address in storage where
phase was loaded.
VSE
PHASE
CPUSAMP
Job, Step,
Task
Number of samples with
CPU active in this phase.
VSE
PHASE
LENGTH|SIZE Job, Step,
Task
Length of phase, in KB.
VSE
PHASE
LIBRARY
Job, Step,
Task
Library from which phase
was loaded.
VSE
PHASE
LOAD
Job, Step,
Task
Load count.
VSE
PHASE
SUBLIB
Job, Step,
Task
Sublibrary from which
phase was loaded.
VSE
PHASE
TID
Job, Step,
Task
Task ID that loaded the
phase.
VSE
PHASE
TIME
Job, Step,
Task
Time of day the phase
was loaded.
354 Report Reference Guide
Variable Descriptions
ID Options
The following ID options can be used with any PHASE variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CONTID
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRUS
■
EXFRM
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
LIBRARY
■
PGMTID
■
PHASEID
■
PID
■
PNET
Chapter 7: Variables 355
Variable Descriptions
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
SUBLIB
■
TASKID
■
TASKNAME
■
USERID
■
VMID
REAL Variable Class
The following table describes each variable of this class:
System
Class
Variable
Name
Data
Description
VSE
REAL
%AVAILABLE
System
Percentage of real storage not in
use.
VSE
REAL
%USED
System
Percentage of real storage in
use.
VSE
REAL
AVAILABLE
System
Amount of real storage not in
use, in KB.
VSE
REAL
DATASPAC
System
Amount of real storage used for
data spaces (VSE 1.3 or later).
VSE
REAL
PMR-PFTE
System
Amount of real storage used by
the page management system
task and the real storage taken
for page frame table entries
(PFTE), in KB (VSE 1.3 or later).
VSE
REAL
SIZE
System
Amount of real storage, in KB.
VSE
REAL
USED
System
Amount of real storage in use in
KB.
ID Options
The following ID options can be used with any REAL variable:
■
CPUID
■
CPUMOD
■
ENDTIME
356 Report Reference Guide
Variable Descriptions
■
PNET
■
STARTTIME
■
VMID
SAMPLE Variable Class
SAMPLE variables represent system statistics collected at one-minute
intervals.
System
Class
Variable Name
Data
Description
VSE
SAMPLE
%CPUCONT
System
Percentage of time the VSE machine
wanted to run but could not because of
higher priority machines.
VSE
SAMPLE
%CPUREAL
System
Percentage of time the VSE machine
was using the real processor.
VSE
SAMPLE
%CPUVIRT
System
Percentage of time the CPU was running
using the CPU timer.
VSE
SAMPLE
CPUCONT
System
Length of time the VSE machine wanted
to run but could not because of higher
priority machines.
VSE
SAMPLE
CPUREAL
System
Length of time the VSE machine was
using the real processor.
VSE
SAMPLE
CPUVIRT
System
Length of time the CPU was running
using the CPU timer.
VSE
SAMPLE
DSIO
System
Number of disk SIOs.
VSE
SAMPLE
LPAR-NAME
System
Logical partition name (VSE 1.3 or
later).
VSE
SAMPLE
LPAR-ACTIVE
System
CPU time used by the logical partition
(VSE 1.3 or later).
VSE
SAMPLE
LPAR-%ACTIVE
System
Percentage of CPU time used by the
logical partition (VSE 1.3 or later).
VSE
SAMPLE
LPAR-OVERHEAD
System
CPU time associated with LPAR overhead
(VSE 1.3 or later).
VSE
SAMPLE
LPAR-%OVERHEAD
System
Percentage of CPU time associated with
LPAR overhead (VSE 1.3 or later).
VSE
SAMPLE
LPAR-TOTAL-time
System
Total CPU time used (ACTIVE +
OVERHEAD) (VSE 1.3 or later).
VSE
SAMPLE
LPAR-%TOTAL-time
System
Percentage of total CPU time used (VSE
Chapter 7: Variables 357
Variable Descriptions
System
Class
Variable Name
Data
Description
1.3 or later).
VSE
SAMPLE
PAGF
System
Number of 370/ECPS page faults.
VSE
SAMPLE
PAGEIN
System
Number of page-in requests issued.
VSE
SAMPLE
PAGEOUT
System
Number of page-out requests issued.
VSE
SAMPLE
RSTOR-%AVAIL
System
Percentage of real storage not in use.
VSE
SAMPLE
RSTOR-%USED
System
Percentage of real storage in use.
VSE
SAMPLE
RSTOR-AVAIL
System
Amount of unused real storage, in KB.
VSE
SAMPLE
RSTOR-USED
System
Amount of used real storage, in KB.
VSE
SAMPLE
SIO
System
Number of SIOs.
VSE
SAMPLE
SVC
System
Number of supervisor call requests.
VSE
SAMPLE
VMPF
System
Number of VM pseudo page faults.
VSE
SAMPLE
VM-NAME
System
VM machine name (VSE 1.3 or later).
VSE
SAMPLE
VM-VTIME
System
Virtual CPU used (VSE 1.3 or later).
VSE
SAMPLE
VM-%VTIME
System
Percentage of virtual CPU used (VSE 1.3
or later).
VSE
SAMPLE
VM-STIME
System
CPU simulation used (VSE 1.3 or later).
VSE
SAMPLE
VM-%STIME
System
Percentage of CPU simulation used (VSE
1.3 or later).
VSE
SAMPLE
VM-TTIME
System
Total time the CPU used (VSE 1.3 or
later).
VSE
SAMPLE
VM-%TTIME
System
Percentage of total time the CPU used
(VSE 1.3 or later).
358 Report Reference Guide
Variable Descriptions
Variables Valid For XA I/O Users Only
The following variables are valid only if you are using the XA I/O channelmonitoring subsystem. For more information about the XA I/O channelmonitoring subsystem, see the IBM's Principles of Operation (SA22-7201-00).
System
Class
Variable Name
Data
Description
VSE
SAMPLE
DEVICE-ACTIVE
System
Average device service time.
VSE
SAMPLE
DEVICE-CONN
System
Average time in seconds spent in transferring
commands and data between the subchannel
and the channel subsystem for all XA I/O disk
devices.
VSE
SAMPLE
DEVICE-DISC
System
Average time, in seconds, that a device was
logically disconnected from the channel
subsystem while the subchannel was active,
including seek time, latency, and RPS reconnect
time.
VSE
SAMPLE
DEVICE-PEND
System
Average time in seconds between VSE issuing
the start subchannel and the first CCW
command being executed on the actual
subchannel for all XA I/O disk devices.
VSE
SAMPLE
DEVICE-SAMP
System
Number of start/resume subchannels issued.
ID Options
The following ID options can be used with any SAMPLE variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The VSE SAMPLE LPAR-variables can also be used with the LPARID ID option.
Chapter 7: Variables 359
Variable Descriptions
SGETVIS Variable Class
The following table describes each variable of this class:
System Class
Variable Name
Data
Description
VSE
SGETVIS
%USED
Both
Average of the highest percentage of
system 24-bit GETVIS used for each
SYSTIMEI interval. To obtain the
maximum of all intervals, use the MAX
option.
VSE
SGETVIS
ORPHAN-ADDRess
Job, Step,
Task
Address of orphaned storage.
VSE
SGETVIS
ORPHANGVSADDRess
Job, Step,
Task
Address of system GETVIS request.
VSE
SGETVIS
ORPHAN-LENGTH
Job, Step,
Task
Length of orphaned storage, in bytes.
VSE
SGETVIS
ORPHAN-PFIXED
Job, Step,
Task
One of the following:
■
YES—Storage was PFIXED
■
NO—Storage was not PFIXED
VSE
SGETVIS
ORPHAN-PGMNAME
Job, Step,
Task
Program that acquired the storage.
VSE
SGETVIS
ORPHAN-PGMOFFset
Job, Step,
Task
Offset within the program that
acquired the storage.
VSE
SGETVIS
ORPHAN-PROTECT
Job, Step,
Task
One of the following:
■
YES—Storage was fetch protected
■
NO—Storage was not fetch
protected
VSE
SGETVIS
ORPHAN-SUBPOOL
Job, Step,
Task
GETVIS subpool name.
VSE
SGETVIS
ORPHAN-SUPervisor
Job, Step,
Task
One of the following:
■
YES—Storage was acquired by a
supervisor service
■
NO—Storage was acquired by a
GETVIS macro
VSE
SGETVIS
ORPHAN-TIME
Job, Step,
Task
Date and time storage was allocated.
VSE
SGETVIS
REQUESTS
Both
Number of system 24-bit GETVIS
requests.
360 Report Reference Guide
Variable Descriptions
System Class
Variable Name
Data
Description
VSE
SGETVIS
SIZE
System
System 24-bit GETVIS size, in KB.
VSE
SGETVIS
STEP-USED
Job, Step
Average of the highest amount of
system 24-bit GETVIS used by the step
for each SYSTIMEI interval. To obtain
the maximum of all intervals, use the
MAX option.
VSE
SGETVIS
STEP-%USED
Job, Step
Average of the highest percentage of
system 24-bit GETVIS used by the step
for each SYSTIMEI interval. To obtain
the maximum of all intervals, use the
MAX option.
VSE
SGETVIS
STEP-31-USED
Job, Step
Average of the highest amount of
system 31-bit GETVIS used by the step
for each SYSTIMEI interval. To obtain
the maximum of all intervals, use the
MAX option.
VSE
SGETVIS
STEP-31-%USED
Job, Step
Average of the highest percentage of
system 31-bit GETVIS used by the step
for each SYSTIMEI interval. To obtain
the maximum of all intervals, use the
MAX option.
VSE
SGETVIS
USED
Both
Average of the highest amount of
system 24-bit GETVIS used for each
SYSTIMEI interval. To obtain the
maximum of all intervals, use the MAX
option.
VSE
SGETVIS
31-%USED
Both
Average of the highest percentage of
system 31-bit GETVIS used for each
SYSTIMEI interval. To obtain the
maximum of all intervals, use the MAX
option.
VSE
SGETVIS
31-REQUESTS
Both
Number of system 31-bit GETVIS
requests.
VSE
SGETVIS
31-SIZE
System
System 31-bit GETVIS size, in KB.
VSE
SGETVIS
31-USED
Both
Average of the highest amount of
system 31-bit GETVIS used for each
SYSTIMEI interval. To obtain the
maximum of all intervals, use the MAX
option.
Chapter 7: Variables 361
Variable Descriptions
ID Options
The following ID options can be used with any system SGETVIS variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system SGETVIS variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
STEPID
■
SEPSEQ#
■
SUBPOOL
■
TASKID
■
TASKNAME
■
VMID
The following ID options can be used with any SGETVIS ORPHAN- variable:
■
ENDTIME
■
ORPHADDR
■
PHASEID
■
STARTTIME
362 Report Reference Guide
Variable Descriptions
STEP Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
STEP
%BUSY
Job, Step
Percentage of time step was sampled as
busy from the time it started until it
ended. Users can use this variable
without job accounting for CPU utilization
while the step was running.
VSE
STEP
%CPUBUSYS
Job, Step
Percentage of time step was sampled
during the interval. Users can use this
variable without job accounting for CPU
utilization by step.
VSE
STEP
%RSTOR
Job, Step
Maximum percentage of real page frames
occupied.
VSE
STEP
%TCPU
Job, Step
Percentage of CPU time this step used
during the interval. This is the preferred
variable for job accounting users. The
sum of all the steps in the interval will
approximately total CPU %BUSYVirt.
VSE
STEP
%TCPUINTerval
Job, Step
Percentage of total CPU time this step
consumed during the interval. The total of
all steps in the interval equals 100%
during the interval.
VSE
STEP
%WORK
Job, Step
Percentage of samples taken when tasks
were not delayed. For example, the
resources that the system needed were
available and there was no contention
between tasks for resources being
accessed. A high value for this variable
indicates that resources generally were
available for tasks when they were
needed.
VSE
STEP
COUNT
Job, Step
Number of steps executed.
VSE
STEP
CPU
Job, Step
Average amount of CPU seconds this step
used.
VSE
STEP
DURATION
Job, Step
Average duration.
VSE
STEP
DURATIONT|DURT
Job, Step
Total duration.
VSE
STEP
ENDDATE
Job, Step
Step end date.
VSE
STEP
ENDTIME
Job, Step
Step end time.
Chapter 7: Variables 363
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
STEP
JOBNAME
Job, Step
VSE jobname.
VSE
STEP
PAGE-IO
Job, Step
Number of page I/Os.
VSE
STEP
PAGE-IN
Job, Step
Number of page-in I/Os.
VSE
STEP
PAGE-OUT
Job, Step
Number of page-out I/Os.
VSE
STEP
PARTITION
Job, Step
Partition ID in which the step was run.
SE
STEP
RSTOR
Job, Step
Maximum number of real page frames
occupied.
VSE
STEP
SAMPLE
Job, Step
Number of pseudo end-of-steps executed.
VSE
STEP
SGETVIS-31-USED
Job, Step
The average of the highest amount of
system 31-bit GETVIS used by the step
for each SYSTIMEI interval. To obtain the
maximum of all intervals, use the MAX
option.
VSE
STEP
SGETIVS-31%USED
Job, Step
The average of the highest percentage of
system 31-bit GETVIS used by the step
for each SYSTIMEI interval. To obtain the
maximum of all intervals, use the MAX
option.
VSE
STEP
STARTDATE
Job, Step
Step start date.
VSE
STEP
STARTTIME
Job, Step
Step start time.
VSE
STEP
STEPNAME
Job, Step
Step name from the //EXEC statement.
VSE
STEP
TCPU
Job, Step
Amount of CPU time while this step was
running during the interval. The sum of
all steps in the interval will approximately
total CPU BUSYVirt.
ID Options
The following ID options can be used with any STEP variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
364 Report Reference Guide
Variable Descriptions
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDFRNO
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
THRSID
■
USERID
■
VMID
Chapter 7: Variables 365
Variable Descriptions
SVC Variable Class
The following table describes each variable of this class:
System
Class
Variable Data
Name
Description
VSE
SVC
COUNT
Both
Number of supervisor calls issued.
VSE
SVC
DESCRIP
TION
Both
Description of supervisor call.
VSE
SVC
HEXCOD
E
Both
Supervisor call code, in
hexadecimal.
VSE
SVC
NAME
Both
Macro name associated with
supervisor call.
VSE
SVC
TCOUNT
Job,
Step,
Task
Number of supervisor calls issued.
ID Options
The following ID options can be used with any system SVC variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
SVCID
■
VMID
The following ID options can be used with any non-system SVC variable:
■
CONTID
■
CPUID
■
CPUMOD
■
ENDTIME
■
JOBID
■
LIBRARY
366 Report Reference Guide
Variable Descriptions
■
PGMTID
■
PHASEID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
SUBLIB
■
SVCID
■
TASKID
■
TASKNAME
■
THRSID
■
USERID
■
VMID
The following ID options are not valid with the VSE SVC TCOUNT variable:
■
ENDTIME
■
PGMTID
■
PHASEID
■
STARTTIME
SYSTEM Variable Class
The following table describes each variable of this class:
System
Class
Variable Name
Data
Description
VSE
SYSTEM
CHANQ
System
Number of channel queue entries
defined to the system through
the IPL SYS CHANQ option.
VSE
SYSTEM
CHANQ-%USE
System
Average maximum percentage of
channel queue entries in use.
VSE
SYSTEM
CHANQ-USE
System
Average maximum channel
queue entries in use.
VSE
SYSTEM
COPY-BLOCK
System
Number of copy blocks defined to
the system.
Chapter 7: Variables 367
Variable Descriptions
System
Class
Variable Name
Data
Description
VSE
SYSTEM
COPY-BLOCK%US
System
Average percentage of copy
blocks in use.
VSE
SYSTEM
COPY-BLOCK-USE System
Average number of copy blocks
in use.
VSE
SYSTEM
TIME
System CPU timer. This is the
length of time in seconds that VM
has allocated to VSE. This
variable is used in the
denominator for calculation of
the variable VSE CPU %BUSYV.
System
ID Options
The following ID options can be used with any SYSTEM variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDUSER
■
EXFRM
■
EXFRNO
■
EXFRUS
■
EXICL
■
EXIPR
■
EXJOB
■
EXPHASE
■
EXPID
368 Report Reference Guide
Variable Descriptions
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
TAPE Variable Class
The following table describes each variable of this class:
System Class
Variable Name
Data
Description
VSE
TAPE
%FAIL
System
Percentage of SIOs that failed.
VSE
TAPE
%FAIL-CB
System
Percentage of SIOs that failed because of
channel busy.
VSE
TAPE
%FAIL-CUB
System
Percentage of SIOs that failed because of
control unit busy.
VSE
TAPE
%FAIL-DB
System
Percentage of SIOs that failed because of
device busy.
VSE
TAPE
%USAGE
Job, Step,
Task
Percentage of time the tape unit is assigned.
VSE
TAPE
BUSY|UTILization
Both
Percentage of time device is active.
VSE
TAPE
FAIL
System
Number of SIOs that failed.
VSE
TAPE
FAIL-CB
System
Number of SIOs that failed because of
channel busy.
VSE
TAPE
FAIL-CUB
System
Number of SIOs that failed because of control
unit busy.
VSE
TAPE
FAIL-DB
System
Number of SIOs that failed because of device
busy.
Chapter 7: Variables 369
Variable Descriptions
System Class
Variable Name
Data
Description
VSE
TAPE
IOTIME|I/OTIME
Both
Total active time.
VSE
TAPE
MAXQ-DEPTH
System
Maximum queue depth.
VSE
TAPE
MAXSERVTIME
Both
Maximum I/O service time.
VSE
TAPE
Q-DEPTH
System
Average maximum queue depth.
VSE
TAPE
Q-TIME
System
Average length of time the I/O request was
on the channel queue.
VSE
TAPE
READS
System
Number of read CCW commands.
VSE
TAPE
SENSE
System
Number of sense or diagnostic CCW
commands.
VSE
TAPE
SERVTIME
Both
Average I/O service time.
VSE
TAPE
SIOs|I/O|IO
Both
SIO count.
VSE
TAPE
USAGE
Job, Step,
Task
Length of time, in seconds, that the tape unit
is assigned.
VSE
TAPE
UTILTIME
System
Device utilization time (the average amount
of time between the start I/O and I/O
interrupt).
VSE
TAPE
WRITES
System
Number of write CCW commands.
ID Options
The following ID options can be used with any system TAPE variable:
■
CPUID
■
CPUMOD
■
DEVID
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system TAPE variable:
■
ACCANC
■
ACDATE
■
ACIDEN
370 Report Reference Guide
Variable Descriptions
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
DEVID
■
ENDTIME
■
EXDCANC
■
EXDUSER
■
EXFRM
■
EXFRNO
■
EXFRUS
■
EXICL
■
EXIPR
■
EXJOB
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPID
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
USERID
■
VMID
Chapter 7: Variables 371
Variable Descriptions
THRESHOLD Variable Class
The following table describes each variable of this class:
System
Class
Variable
Name
Data
Description
VSE
THRESHOLD
CLASS
System
Threshold class (count, rate,
percentage, or time).
VSE
THRESHOLD
COUNT
System
Number of thresholds triggered.
VSE
THRESHOLD
DATE
System
Date the threshold was triggered.
VSE
THRESHOLD
JOBNAME
System
Jobname that triggered the threshold.
VSE
THRESHOLD
LIMIT
System
Threshold limit value.
VSE
THRESHOLD
MAXVALUE
System
Maximum value that triggered the
threshold.
VSE
THRESHOLD
MINVALUE
System
Minimum value that triggered the
threshold.
VSE
THRESHOLD
NAME
System
Name of the threshold.
VSE
THRESHOLD
PID
System
Partition ID that triggered the
threshold.
VSE
THRESHOLD
RESOURCE
System
Threshold resource.
VSE
THRESHOLD
STEPNAME
System
Step name that triggered the
threshold.
VSE
THRESHOLD
TASKNAME
System
Task name that triggered the
threshold.
VSE
THRESHOLD
TID
System
Task ID that triggered the threshold.
VSE
THRESHOLD
TIME
System
Time the threshold was triggered.
VSE
THRESHOLD
TYPE
System
Threshold type (upper or lower).
VSE
THRESHOLD
VALUE
System
Average value that triggered the
threshold.
ID Options
The following ID options can be used with any THRESHOLD variable:
■
CPUID
■
CPUMOD
■
ENDTIME
372 Report Reference Guide
Variable Descriptions
■
PNET
■
STARTTIME
■
THRSID
■
VMID
VM Variable Class
The VM variable class is valid only for VSE 1.3 or greater. If you are running
under VM and get an error message saying there is no matching data, the
version of VM you are running does not support this function. You may be able
to obtain support for this function from an IBM maintenance tape.
System
Class
Variable Name
Data
Description
VSE
VM
PROCessors
System
Number of CPUs.
VSE
VM
VTIME
System
Virtual CPU used.
VSE
VM
%VTIME
System
Percentage of virtual CPU
used.
VSE
VM
STIME
System
CPU simulation used.
VSE
VM
%STIME
System
Percentage of CPU simulation
used.
VSE
VM
TTIME
System
Total time the CPU used
VSE
VM
%TTIME
System
Percentage of total time the
CPU used.
ID Options
The following ID option can be used with any VM variable:
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
Important! Use VM CPU data from one system only. If you are collecting VM
CPU data from multiple systems, do not merge this data before reporting on it.
Chapter 7: Variables 373
Variable Descriptions
WAIT Variable Class
The following table describes each variable of this class:
System
Class
Variable
Name
Data
Description
VSE
WAIT
CODE
Both
VSE wait code, in hexadecimal.
For more information, see the
Online User Guide.
VSE
WAIT
COUNT
Both
Number of times tasks were
sampled to determine if they
were waiting and the task was
waiting.
VSE
WAIT
CPU-ACTIVE
System
Number of CPU active samples.
VSE
WAIT
CPU-WAIT
System
Number of CPU wait samples.
VSE
WAIT
I/O-ACTIVE
System
Number of I/O active samples.
VSE
WAIT
I/O-QUEUED System
Number of I/O queued
samples.
VSE
WAIT
IDLE
System
Number of idle samples.
VSE
WAIT
PCT
Both
Percentage of wait samples
taken in which the task was
waiting (VSE WAIT COUNT /
VSE WAIT SAMPLE).
VSE
WAIT
SAMPLE
Both
Number of times tasks were
sampled to determine if they
were waiting.
VSE
WAIT
TOTSAMPLEs
System
Total number of samples
taken.
VSE
WAIT
TYPE
Both
Eight-character wait
description.
ID Options
The following ID options can be used with any system WAIT variable:
■
CPUID
■
CPUMOD
■
ENDTIME
374 Report Reference Guide
VSE/POWER Accounting Variables
■
PNET
■
STARTTIME
■
VMID
The following ID options can be used with any non-system WAIT variable:
■
CPUID
■
CPUMOD
■
ENDTIME
■
JOBID
■
PID
■
PNET
■
STARTTIME
■
STEPSEQ#
■
TASKID
■
TASKNAME
■
TEPID
■
USERID
■
VMID
■
WAITID
VSE/POWER Accounting Variables
The report writer supports the VSE/POWER accounting record types described
in the following table. To restrict a VSE/POWER accounting report or variable
to one of these record types, specify the ID option ACIDEN and the listed
identifier with either the TAB command or the variable, as explained in the
chapter "VSE/POWER Reports".
Variables that apply to
ACIDEN
Identifier
All VSE/POWER accounting record types.
n/a
Advanced function printing (AFP) records, which contain
information for a device driving system (DDS) whenever the
DDS sends an account record order that contains a valid AFP
account record.
A
RJE (remote job entry) bisynch (BSC) records, which are
T
Chapter 7: Variables 375
VSE/POWER Accounting Variables
Variables that apply to
ACIDEN
Identifier
created when a user session signs off or terminates.
Execution (EXEC) records, which contain information about
every VSE jobstep.
E
List (LIST) records, which contain information about printer
activity.
L
Network (PNET) records, which contain information about
communication path activity.
N
Punch (PUNCH) records, which contain information about
punch-queue activity.
P
Reader (READER) records, which contain information about
every VSE/POWER job submitted for spooling.
R
NJE (network job entry) receiver (RECV) records, which are
created for every job or output received from another node.
V
RJE (remote job entry) system network architecture (SNA)
records, which are created when a user session signs off or
terminates.
S
VSE/POWER system-up (SYS) records, which are created on
completion of VSE/POWER startup.
U
NJE (network job entry) transmitter (TRANS) records, which
are created for every job or output transmitted to another
node.
M
Spool-access-connect (XCONN) records, which contain
information about spool-access-connection paths.
C
Spool-access-operation (XSPOOL) records, which contain
information about spool-access-connection operations and
which are commonly used to report on some types of laser
printer activity.
X
Definitions
The following terms are used in the descriptions of the variables that apply to
VSE/POWER accounting records:
Term
Meaning
Job accounting
Activated by specifying JA=YES on the IPL SYS card. (Job
accounting must also be specified in POWER generation.)
376 Report Reference Guide
VSE/POWER Accounting Variables
CPU timer
Active when the CPU is running or waiting. For VM or PR/SM
users, this time is simulated for the virtual machine or LPAR
to reflect the total amount of time the virtual machine or
LPAR was actually running or waiting.
General PACCNT Variables
The following variables apply to all types of VSE/POWER accounting records
supported by CA Explore PM for z/VSE:
System
Class
Variable
Name
Description
VSE
PACCNT
ACCANC
VSE/POWER cancel code.
VSE
PACCNT
ACDATE
Record date, in the format defined
for the system.
VSE
PACCNT
ACIDEN
Record ID.
VSE
PACCNT
ACNAME
Current VSE/POWER jobname.
VSE
PACCNT
ACNUMB
Job number assigned by
VSE/POWER.
VSE
PACCNT
ACSTOP
Record stop time, in the format
hh.mm.ss
VSE
PACCNT
ACSTRT
Record start time, in the format
hh.mm.ss
VSE
PACCNT
ACUSER
16 bytes of user information from
the $$ JOB card.
VSE
PACCNT
DURATION
Total duration of VSE/POWER
accounting records. Designed to be
used with the ACIDEN ID option.
VSE
PACCNT
RECCNT
Number of VSE/POWER accounting
records.
ID Options
The following ID options can be used with any general PACCNT variable in the
preceding table:
■
ACCANC
■
ACDATE
■
ACIDEN
Chapter 7: Variables 377
VSE/POWER Accounting Variables
■
ACNAME
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
PACCNT Advanced Function Printing (AFP) Variables
System
Class
Variable Name
Description
VSE
PACCNT
ACAPPLID
XPCC application identifier of the
device driving system (DDS).
ID Options
The following ID options can be used with the PACCNT AFP variable:
■
ACAPPLIC
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
378 Report Reference Guide
VSE/POWER Accounting Variables
PACCNT RJE Bisynch (BSC) Variables
The following table describes each variable:
System
Class
Variable Name
Description
VSE
PACCNT
BSCDTE
Date, in the format
defined for the system.
VSE
PACCNT
BSCERR
Error count.
VSE
PACCNT
BSCIDN
Record ID.
VSE
PACCNT
BSCIRS
Number of invalid
responses during
transmission.
VSE
PACCNT
BSCLAD
Line address.
VSE
PACCNT
BSCPAS
Line password.
VSE
PACCNT
BSCRID
Remote ID.
VSE
PACCNT
BSCSFC
Sign-off code.
VSE
PACCNT
BSCSGF
Sign-off time.
VSE
PACCNT
BSCSGN
Sign-on time.
VSE
PACCNT
BSCSOD
Sign-off date, in the
format defined for the
system.
VSE
PACCNT
BSCTCNT
Time-out count.
VSE
PACCNT
BSCTEC
Terminal or work station
error count.
VSE
PACCNT
BSCTRAN
Transmission count.
VSE
PACCNT
BSCUSE
Sign-on command user
information.
ID Options
The following ID options can be used with any PACCNT BSC variable:
■
ACAPPLIC
■
ACCANC
■
ACDATE
Chapter 7: Variables 379
VSE/POWER Accounting Variables
■
ACIDEN
■
ACNAME
■
ACSTOP
■
ACSTRT
■
ACUSER
■
BSCIDN
■
BSCLAD
■
BSCPAS
■
BSCRID
■
BSCSFC
■
BSCSGF
■
BSCSGN
■
BSCSOD
■
BSCUSE
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
PACCNT Execution (EXEC) Variables
The following table describes each variable:
System
Class
Variable Name
Description
VSE
PACCNT
EXALLTM
Total system wait time allocated to the jobstep.
VSE
PACCNT
EXCPUTM
Processor time the jobstep used.
VSE
PACCNT
EXDCANC
VSE cancel code.
VSE
PACCNT
EXDJOB
VSE jobname from the JOB card.
VSE
PACCNT
EXDUSER
16 bytes of user information from the JOB card.
VSE
PACCNT
EXFRM
FROM remote ID.
VSE
PACCNT
EXFRNO
Name of originating (FROM) node.
380 Report Reference Guide
VSE/POWER Accounting Variables
System
Class
Variable Name
Description
VSE
PACCNT
EXFRUS
ID of originating user.
VSE
PACCNT
EXICL
Class.
VSE
PACCNT
EXIPR
Priority.
VSE
PACCNT
EXJDUR
Duration of the jobstep.
VSE
PACCNT
EXJOBCNT
Number of VSE jobs executed.
VSE
PACCNT
EXNCD
Number of cards spooled.
VSE
PACCNT
EXNLN
Number of lines spooled.
VSE
PACCNT
EXNPG
Number of pages spooled.
VSE
PACCNT
EXOJ#
Original job number.
VSE
PACCNT
EXOVHTM
Overhead time allocated to the jobstep.
VSE
PACCNT
EXPASZ
The amount of storage used, in bytes.
VSE
PACCNT
EXPHASE
Phase name from the EXEC card.
VSE
PACCNT
EXPID
Partition ID.
VSE
PACCNT
EXPJOBCNT
Number of VSE/POWER jobs executed.
VSE
PACCNT
EXSIO
Number of SIOs.
VSE
PACCNT
EXSTPCNT
Number of steps executed.
VSE
PACCNT
EXTYPE
Record type:
VSE
PACCNT
EXXNODE
■
S—Step
■
L—Last step
Name of execution node.
ID Options
The following ID options can be used with any PACCNT EXEC variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
Chapter 7: Variables 381
VSE/POWER Accounting Variables
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
EXDCANC
■
EXDJOB
■
EXDUSER
■
EXFRM
■
EXFRNO
■
EXFRUS
■
EXICL
■
EXIPR
■
EXPHASE
■
EXPID
■
EXTYPE
■
EXXNODE
■
JOBID
■
PNET
■
STARTIEM
■
STEPID
■
USERID
■
VMID
ACCNT List (LIST) Variables
The following table describes each variable:
System
Class
Variable Name
Description
VSE
PACCNT
LSTACCT
Network account number.
VSE
PACCNT
LSTADR
Printer or RJE-line address.
VSE
PACCNT
LSTCOP
Number of printed copies.
VSE
PACCNT
LSTCPYG
Copy grouping.
382 Report Reference Guide
VSE/POWER Accounting Variables
System
Class
Variable Name
Description
VSE
PACCNT
LSTEXP
Number of extra pages printed because of PRESTART,
PSETUP, separator cards, or extra copies.
VSE
PACCNT
LSTEXR
Number of extra records printed because of a restart,
separator pages, or extra copies.
VSE
PACCNT
LSTEPGN
Number of extra pages printed. Overflows to zero
after 65,535. Valid for VSE 1.3 or later.
VSE
PACCNT
LSTFLSH
Flash ID (for laser printers).
VSE
PACCNT
LSTFOR
Print-form ID.
VSE
PACCNT
LSTFRNO
Name of originating (FROM) node.
VSE
PACCNT
LSTFRUS
ID of originating user.
VSE
PACCNT
LSTNODE
Name of your node in the network.
VSE
PACCNT
LSTNUM
Number of lines printed.
VSE
PACCNT
LSTOCL
Printed output class.
VSE
PACCNT
LSTOJ#
Original job number.
VSE
PACCNT
LSTOPR
Printed output priority number.
VSE
PACCNT
LSTPAG
Number of pages printed.
VSE
PACCNT
LSTPGN
Number of pages printed. Overflows to zero after
65,535. Valid for VSE 1.3 or later.
VSE
PACCNT
LSTRDEL
Number of records deleted by OUTEXIT routine.
VSE
PACCNT
LSTRINS
Number of records inserted by OUTEXIT routine.
VSE
PACCNT
LSTSUF
Job suffix number assigned by VSE/POWER.
VSE
PACCNT
LSTTO
TO remote ID.
VSE
PACCNT
LSTTOUS
ID of destination user.
VSE
PACCNT
LSTTRK
Number of DBLK groups for output storage.
ID Options
The following ID options can be used with any PACCNT LIST variable:
■
ACCANC
■
ACDATE
■
ACIDEN
Chapter 7: Variables 383
VSE/POWER Accounting Variables
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
ISTTOUS
■
LSTACCT
■
LSTADR
■
LSTCPYG
■
LSTFLSH
■
LSTFOR
■
LSTFRM
■
LSTFRNO
■
LSTFRUS
■
LSTNODE
■
LSTOPR
■
LSTTO
■
PNET
■
STARTIME
■
VMID
PACCNT Network (PNET) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
NETDTE
Date, in the format defined for the
system.
VSE
PACCNT
NETERR
Error count.
384 Report Reference Guide
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
NETICNT
Number of invalid responses.
VSE
PACCNT
NETIDEN
Record ID.
VSE
PACCNT
NETLAD
Line address.
VSE
PACCNT
NETNODE
Connected node ID.
VSE
PACCNT
NETNPAS
Node password.
VSE
PACCNT
NETPSW
Line password.
VSE
PACCNT
NETRCVE
Number of buffers received during
session.
VSE
PACCNT
NETSGF
Sign-off time.
VSE
PACCNT
NETSGN
Sign-on time.
VSE
PACCNT
NETSOD
Sign-off date, in the format defined for
the system.
VSE
PACCNT
NETTCNT
Time-out count.
VSE
PACCNT
NETTERM
ACF/VTAM cancel code.
VSE
PACCNT
NETTRAN
Number of buffers transmitted
ID Option
The following ID options can be used with any PACCNT PNET variable:
■
ACDATE
■
ACIDEN
■
ACSTOP
■
ACSTRT
■
CPUID
■
CPUMOD
■
ENDTIME
■
NETDTE
■
NETIDEN
■
NETLAD
■
NETNODE
■
NETNPAS
Chapter 7: Variables 385
VSE/POWER Accounting Variables
■
NETPSW
■
NETSGF
■
NETSGN
■
NETSOD
■
NETTERM
■
PNET
■
STARTIME
■
VMID
PACCNT PUNCH Variables
The following table describes each variable:
System
Class
Variable Name
Description
VSE
PACCNT
PUNACCT
Network account number.
VSE
PACCNT
PUNADR
Punch device or RJE-line address
(CUU).
VSE
PACCNT
PUNCOP
Number of punched copies.
VSE
PACCNT
PUNEXR
Number of additional cards punched.
VSE
PACCNT
PUNFOR
Punch-form ID.
VSE
PACCNT
PUNFRM
FROM remote ID.
VSE
PACCNT
PUNFRNO
Originating node name.
VSE
PACCNT
PUNFRUS
Originating-user ID.
VSE
PACCNT
PUNNODE
Own node ID.
VSE
PACCNT
PUNNUM
Number of records punched.
VSE
PACCNT
PUNOCL
Punched output class.
VSE
PACCNT
PUNOJ#
Original job number.
VSE
PACCNT
PUNOPR
Punched output priority number.
VSE
PACCNT
PUNRDEL
Number of records deleted by
OUTEXIT routine.
VSE
PACCNT
PUNRINS
Number of records inserted by
OUTEXIT routine
VSE
PACCNT
PUNSUF
Job suffix number assigned by
VSE/POWER.
386 Report Reference Guide
VSE/POWER Accounting Variables
System
Class
Variable Name
Description
VSE
PACCNT
PUNTO
TO remote ID.
VSE
PACCNT
PUNTOUS
Destination-user ID.
VSE
PACCNT
PUNTRK
Number of DBLK groups for output
storage.
ID Options
The following ID options can be used with any PACCNT PUNCH variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
PUNACCT
■
PUNADR
■
PUNFOR
■
PUNFRM
■
PUNFRUS
■
PUNNODE
■
PUNOCL
■
PUNOPR
■
PUNTO
■
PUNTOUS
■
STARTIME
■
VMID
Chapter 7: Variables 387
VSE/POWER Accounting Variables
PACCNT READER Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
RDRACCT
Network account number.
VSE
PACCNT
RDRADD
Reader device or line address (CUU).
VSE
PACCNT
RDRDUR
Total time in reader queue.
VSE
PACCNT
RDRFRM
FROM remote ID.
VSE
PACCNT
RDRFRUS
Originating node name.
VSE
PACCNT
RDRICL
Input class.
VSE
PACCNT
RDRIPR
Input priority number.
VSE
PACCNT
RDRNODE
Own node ID.
VSE
PACCNT
RDRNUM
Number of records read.
VSE
PACCNT
RDRTRK
Number of DBLK groups for input
storage.
ID Options
The following ID options can be used with any PACCNT READER variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PDRADD
388 Report Reference Guide
VSE/POWER Accounting Variables
■
PNET
■
PUNFRM
■
RDRACCT
■
RDRFRUS
■
RDRICL
■
RDRIPR
■
RDRNODE
■
STARTIME
■
VMID
PACCNT Receiver (RECV) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
NACACCT
Network account number.
VSE
PACCNT
NACADJ
Adjacent node name.
VSE
PACCNT
NACCLAS
Class of job output.
VSE
PACCNT
NACCNTC
Control record count.
VSE
PACCNT
NACCNTD
Data record count.
VSE
PACCNT
NACCOP
Number of copies.
VSE
PACCNT
NACCURR
Own node name.
VSE
PACCNT
NACLAD
Line address (CUU).
VSE
PACCNT
NACON
Originating node name.
VSE
PACCNT
NACORGJ# Original job number from job reader.
VSE
PACCNT
NACOUS
Remote originator user ID.
VSE
PACCNT
NACPR
Priority.
VSE
PACCNT
NACQTYP
Queue type.
VSE
PACCNT
NACSUF
Job suffix (segment) number.
VSE
PACCNT
NACTN
Destination node name.
VSE
PACCNT
NACTUS
Destination user ID.
Chapter 7: Variables 389
VSE/POWER Accounting Variables
ID Options
The following ID options can be used with any PACCNT RECV variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
NACACCT
■
NACADJ
■
NACCLAD
■
NACCLAS
■
NACCURR
■
NACON
■
NACOUS
■
NACPR
■
NACQTYP
■
NACTN
■
NACTUS
■
PNET
■
STARTIME
■
VMID
390 Report Reference Guide
VSE/POWER Accounting Variables
PACCNT System Network Architecture (SNA) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
SNADTE
Date, in the format defined for the
system.
VSE
PACCNT
SNAIDEN
Record ID.
VSE
PACCNT
SNALUN
Logical unit name.
VSE
PACCNT
SNARID
Remote ID.
VSE
PACCNT
SNASGF
Sign-off time.
VSE
PACCNT
SNASGN
Sign-on time.
VSE
PACCNT
SNATERM
Session termination code.
VSE
PACCNT
SNAUSE
Sign-on command user information.
ID Option
The following ID options can be used with any PACCNT SNA variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
SNADTE
■
SNAIDEM
■
SNALUN
■
SNARID
Chapter 7: Variables 391
VSE/POWER Accounting Variables
■
SNASGF
■
SNASGN
■
SNATERM
■
SNAUSE
■
STARTIME
■
VMID
PACCNT System-up (SYS) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
PWRATRK
Number of tracks or blocks in the
account file.
VSE
PACCNT
PWRDTE
Date, in the format defined for the
system.
VSE
PACCNT
PWRDTRK
Number of tracks or blocks in the data
file.
VSE
PACCNT
PWRDXTN
Number of data file extents.
VSE
PACCNT
PWRFLAG
Feature flags.
VSE
PACCNT
PWRGETSZ
GETVIS size, in KB.
VSE
PACCNT
PWRIDEN
Record ID.
VSE
PACCNT
PWRLEV
Level ID.
VSE
PACCNT
PWRPARSZ
Partition size.
VSE
PACCNT
PWRPART
Partition ID.
VSE
PACCNT
PWRQTRK
Number of tracks or blocks in the
queue file.
VSE
PACCNT
PWRRELSZ
Reserved processor (real) storage size.
VSE
PACCNT
PWRSGN
Startup time.
VSE
PACCNT
PWRVER
Version or modification level.
392 Report Reference Guide
VSE/POWER Accounting Variables
ID Option
The following ID options can be used with any PACCNT SYS variable:
■
ACDATE
■
ACIDEN
■
ACSTRT
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
PWRDTE
■
PWRIDEN
■
PWRLEV
■
PWRPART
■
PWRSGN
■
SNAVER
■
STARTIME
■
VMID
PACCNT NJE Transmitter (TRANS) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
NACACCT
Network account number.
VSE
PACCNT
NACADJ
Adjacent node name.
VSE
PACCNT
NACCLAS
Class of job output.
VSE
PACCNT
NACCNTC
Control record count.
VSE
PACCNT
NACCNTD
Data record count.
VSE
PACCNT
NACCOP
Number of copies.
VSE
PACCNT
NACCURR
Own node name.
VSE
PACCNT
NACLAD
Line address (CUU).
VSE
PACCNT
NACON
Originating node name.
Chapter 7: Variables 393
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
NACORGJ#
Original job number from job reader.
VSE
PACCNT
NACOUS
Remote originator user ID.
VSE
PACCNT
NACPR
Priority.
VSE
PACCNT
NACQTYP
Queue type.
VSE
PACCNT
NACSUF
Job suffix (segment) number.
VSE
PACCNT
NACTN
Destination node name.
VSE
PACCNT
NACTUS
Destination user ID.
ID Options
The following ID options can be used with any PACCNT TRANS variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
■
CPUMOD
■
ENDTIME
■
NACACCT
■
NACADJ
■
NACCLAD
■
NACCLAS
■
NACCURR
■
NACON
■
NACOUS
■
NACPR
■
NACQTYP
■
NACTN
394 Report Reference Guide
VSE/POWER Accounting Variables
■
NACTUS
■
PNET
■
STARTIME
■
VMID
PACCNT Spool-Access-Connect (XCONN) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
XCOAPPL
XPCC application ID.
VSE
PACCNT
XCOCTL#
Number of CTL requests.
VSE
PACCNT
XCODATE
Date, in the format defined for the
system.
VSE
PACCNT
XCODEVN
Device name.
VSE
PACCNT
XCOIDEN
Account-record ID.
VSE
PACCNT
XCOMSG#
Number of messages returned in
response to a CTL or PUT request.
VSE
PACCNT
XCOSTOP
Connection stop time.
VSE
PACCNT
XCOSTRT
Connection start time.
VSE
PACCNT
XCOTERM
Connection-termination code.
ID Options
The following ID options can be used with any PACCNT XCONN variable:
■
ACDATE
■
ACIDEN
■
ACSTOP
■
ACSTRT
■
CPUID
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTIME
Chapter 7: Variables 395
VSE/POWER Accounting Variables
■
VMID
■
XCOAPPL
■
XCODATE
■
XCODEVN
■
XCOIDEN
■
XCOSTOP
■
XCOSTRT
■
XCOTERM
PACCNT Spool-Access-Operation (XSPOOL) Variables
The following table describes each variable:
System
Class
Variable
Name
Description
VSE
PACCNT
XSPACCT
Network account number.
VSE
PACCNT
XSPCANC
VSE/POWER cancel code.
VSE
PACCNT
XSPCLSS
Class.
VSE
PACCNT
XSPCOPY
Number of copies.
VSE
PACCNT
XSPCPYG
Copy grouping.
VSE
PACCNT
XSPDATE
Date, in the format defined for the system.
VSE
PACCNT
XSPDISP
Disposition, as specified with the DISP= parameter.
VSE
PACCNT
XSPEXL#
Number of extra lines or cards because of separator
pages or restarts.
VSE
PACCNT
XSPEXP#
Number of extra pages.
VSE
PACCNT
XSPEXR#
Number of extra records.
VSE
PACCNT
XSPFLSH
Flash ID (for laser printers).
VSE
PACCNT
XSPFORM
Form ID.
VSE
PACCNT
XSPIDEN
Account-record ID.
VSE
PACCNT
XSPJSUF
Job suffix number assigned by VSE/POWER.
VSE
PACCNT
XSPLNE#
Total number of lines or cards.
VSE
PACCNT
XSPNAME
Name of job or report.
VSE
PACCNT
XSPNODE
Name of your node.
396 Report Reference Guide
VSE/POWER Accounting Variables
System
Class
Variable
Name
Description
VSE
PACCNT
XSPNUMB
Job number assigned by VSE/POWER.
VSE
PACCNT
XSPOJ#
Original job number.
VSE
PACCNT
XSPPGE#
Total number of pages.
VSE
PACCNT
XSPRDEL
Records deleted by OUTEXIT routine.
VSE
PACCNT
XSPRINS
Records inserted by OUTEXIT routine.
VSE
PACCNT
XSPPRIO
Priority.
VSE
PACCNT
XSPQUID
Queue type.
VSE
PACCNT
XSPREC#
Number of records.
VSE
PACCNT
XSPREQT
Request type.
VSE
PACCNT
XSPRQAP
Requesting XPCC application ID.
VSE
PACCNT
XSPRQUS
Requesting user ID.
VSE
PACCNT
XSPSTOP
Stop time of processing.
VSE
PACCNT
XSPSTRT
Start time of processing.
VSE
PACCNT
XSPTONM
Name of destination node.
VSE
PACCNT
XSPTOUS
Destination user ID.
VSE
PACCNT
XSPTRK#
Number of DBLK groups occupied on disk.
VSE
PACCNT
XSPUSER
16 bytes of user information.
ID Options
The following ID options can be used with any PACCNT XSPOOL variable:
■
ACCANC
■
ACDATE
■
ACIDEN
■
ACNAME
■
ACNUMB
■
ACSTOP
■
ACSTRT
■
ACUSER
■
CPUID
Chapter 7: Variables 397
VSE/POWER Accounting Variables
■
CPUMOD
■
ENDTIME
■
PNET
■
STARTTIME
■
VMID
■
XSPACCT
■
XSPCANC
■
XSPCLASS
■
XSPDATE
■
XSPFLSH
■
XSPFORM
■
XSPIDEN
■
XSPNODE
■
XSPNUMB
■
XSPQUID
■
XSPCPYG
■
XSPRIO
■
XSPRQAP
■
XSPRQUS
■
XSPSTOP
■
XSPNAME
■
XSPTONM
■
XSPTOUS
■
XSPUSER
■
XSPREQT
■
XSPSTRT
398 Report Reference Guide
Chapter 8: Variable Options
Two kinds of options can be used with variables:
■
Variable options
■
ID options
These options can be used with most variables:
■
COUNT
■
FORMAT
■
LOGICAL
■
MAX and MIN
■
MAXDATE and MAXTIME
■
PerCenT
■
RATE
■
SELZERO
■
TOTAL
■
XTIME, XTIMEM, and NXTIME
■
XTND and NXTND
This section contains the following topics:
Valid Variable Options (see page 399)
Descriptions of Variable Options (see page 400)
Valid Variable Options
The variable options that are valid only in tabular reports are as follows. They
are discussed in the "Tabular Report" chapter.
■
DIFF
■
RANGE
■
RIGHT
■
SELECT
Chapter 8: Variable Options 399
Descriptions of Variable Options
Specifying Options
Specify variable options following the variable to which they apply, as follows:
variable [option [option ...]]
Descriptions of Variable Options
Each variable option, including the syntax, operands, and examples are
described in this section.
COUNT Option
Use the COUNT option to convert a variable into the number of different
identifiers that correspond to that variable.
Option Syntax and Operand
COUNT=IDoption
Operand
Meaning
IDoption
Any ID option valid for the variable.
The following command would produce a tabular report displaying the total
number of unique jobs executed:
TAB VSE JOB COUNT COUNT=JOBID
END
RUN
FORMAT Option
Use the FORMAT option to define the length of an output field or to specify
how many decimal positions it contains.
The FORMAT option can also be used with ID options to control the number of
characters printed for each identifier. For more information about formatting
identifiers, see the chapter "ID Options."
400 Report Reference Guide
Descriptions of Variable Options
Option Syntax and Operand
FORMAT (outputformat)
Operand
Meaning
outputformat
One of the following, for numeric or alphanumeric output:
■
For numeric data, specify up to 15 Ns with or without a
period to indicate the placement of the decimal point.
For example, FORMAT(NN.NNN) indicates a five-digit
output rounded to three decimal places. You can include
any constants other than the letters N and C in the
string. For example, specify FORMAT(NN.NNN%) to
include a percent sign with each value in your report.
■
For alphanumeric data, specify nC, where n is the
number of characters to appear in the output. For
example, FORMAT(4C) indicates an output of four
characters. There is no limit on the value of n.
Note: If a value for a variable is greater than the output format you specify,
the value is replaced by an asterisk (*). For example, if you specify
FORMAT(NN.NN) with a variable, all values greater than 99.99 for that
variable are replaced by asterisks in your report.
Examples of the FORMAT option and the result of each are shown following:
Sample Entry
Result
VSE STEP CPU
FORMAT(NNN.NN)
By default, the output of the variable VSE
STEP TCPU appears in the format N.NNN,
NN.NN, or NNNNN, depending on the size
of the value. The FORMAT option here
forces the output to two decimal places.
VSE DISK SIO RATE
FORMAT(NN.N)
The RATE option used with the variable
VSE DISK SIO defaults to two decimal
places. The FORMAT option here alters the
output to one decimal place.
LOGICAL Option
By default, the report writer checks all input records and discards the records
with negative values. Use the LOGICAL option with a variable to bypass this
check and treat all values for the variable as unsigned (logical) values.
Chapter 8: Variable Options 401
Descriptions of Variable Options
Option Syntax
LOGICAL
The following commands create a tabular report on steps, treating all values
for the variable VSE STEP PAGE-IO as unsigned. Records with a negative value
for VSE STEP CPU are discarded.
TAB STEPID VSE STEP CPU AND,
VSE STEP PAGE-IO LOGICAL
END
RUN
MAX and MIN Options
Use the MAX and MIN options to force a variable that by default prints a count
or an average to print the minimum or maximum value.
Option Syntax and Operand
MAX[=IDoption]
MIN[=IDoption
Operand
Meaning
IDoption
Any ID option valid for the variable. The values produced by
the MAX and MIN options are largely dependent on the
structure of the data records. Use this operand to control how
the values are computed.
The following example uses the MAX and MIN options with the variable VSE
DISK SIO:
VSE DISK SIO MIN
VSE DISK SIO MAX
VSE DISK SIO MAX=STEPID
VSE DISK SIO is defined as the number of SIOs performed. VSE DISK SIO MIN
prints the minimum SIO count for any single device; VSE DISK SIO MAX prints
the maximum. VSE DISK SIO MAX=STEPID prints the maximum number of
SIOs performed by any single step.
MAXDATE and MAXTIME Options
Use the MAXDATE and MAXTIME options to print the date and time when the
value of a variable is highest.
402 Report Reference Guide
Descriptions of Variable Options
Option Syntax
MAXDATE
MAXTIME
The following examples use the MAXDATE and MAXTIME options with the
variable VSE DISK SERVTIME:
VSE DISK SERVTIME MAXDATE
VSE DISK SERVTIME MAXTIME
For example, in a tabular report organized by disk, the variable VSE DISK
SERVTIME would create a column by default, showing the average disk service
time for each disk. Specifying MAXDATE with the variable instead prints the
date on which disk service time was highest for each disk. Similarly, VSE DISK
SERVTIME MAXTIME prints the time at which this value was highest for each
disk.
PerCenT Option
Use the PerCenT option to cause a variable to represent a resource's usage as
a percentage of the total value for the system. You can use the PerCenT option
only with variables that represent a total that is not the same as the value for
the entire system.
Option Syntax and Operand
PerCenT
In the following example, the PLOT command plots the SIO count of device
0861. The PLOT2 command plots the percentage of SIOs for that device.
PLOT
VSE DEVICE SIO
DEVID(0861) ALONE
PLOT2 VSE DEVICE SIO PCT DEVID(0861)
END
RUN
RATE Option
Use the RATE option to display a rate (number per second, minute, hour, day,
or week) rather than a count. You can use the RATE option only with variables
that represent a count.
Chapter 8: Variable Options 403
Descriptions of Variable Options
Option Syntax and Operand
RATE[(period [, WEIGHTED] [type])]
Opearand
Meaning
period
Defines the time interval the rate is to be based
upon. Specify one of the following:
■
RPTINT—Calculates the rate based on the
reporting interval.
■
SYSINT—Calculates the rate based on the
interval of the CA Explore PM for z/VSE main
system record, thereby accounting only for the
time CA Explore PM for z/VSE was active logging
data. This is the default.
■
[nn] interval—Calculates the rate based on the
interval specified. nn can be 1 to 99; the default
is 1. Replace interval with SECONDs, MINUTEs,
HOURs, DAYs, or WEEKs. To get meaningful
data, specify a value equal to the setting of the
SYSTIMEI configuration option or the EACH
value of the report.
WEIGHTED
Prints rates based only on those intervals that show
activity for the specified variable.
type
Specify one of the following:
■
COUNT—Prints the number of active intervals.
■
MAX—Prints the maximum value for any one
interval.
■
MAXDATE—Prints the date of the interval during
which the maximum value occurred.
■
MAXRATE—Prints the maximum rate for any one
interval.
■
MAXTIME—Prints the time of the interval during
which the maximum value occurred.
In the following example, the PLOT command plots the SIO count of device
0861 and the number of SIOs by all devices. The PLOT2 command plots the
SIO rate (the number per second) for device 0861 and the rate for all devices.
PLOT
VSE DEVICE SIO
DEVID(0861)
PLOT2 VSE DEVICE SIO RATE DEVID(0861)
EACH HOUR
END
RUN
404 Report Reference Guide
Descriptions of Variable Options
The following commands create a tabular report showing the hourly device SIO
rate (average number per hour) each day:
TAB DATE VSE DEVICE SIO RATE(1 HOUR)
EACH DAY
END
RUN
The following commands create a tabular report showing the highest I/O rate
for any one hour and the time that it occurred:
TAB TIME VSE DISK SIO RATE(1 HOUR,MAXRATE)
AND,
VSE DISK SIO RATE(1 HOUR,MAXTIME)
EACH DAY
END
RUN
SELZERO Option
By default, the report writer checks all input records and discards any with
zero activity for the specified variables. For example, a tabular report on
terminal activity includes only those terminals that have a positive value for at
least one variable specified with the TAB command. Use the SELZERO option
to bypass this check and include all resources in the report.
Option Syntax and Operand
SELZERO
By default, a graph of tape I/Os by jobname includes only jobs that issued at
least one tape I/O. The following commands graph the average number of
tape I/Os by every job, including those issuing no tape I/Os:
GRAF JOBID VSE TAPE I/O SELZERO
END
RUN
TOTAL Option
Use the TOTAL option to force a variable that by default prints an average to
print a total.
Chapter 8: Variable Options 405
Descriptions of Variable Options
Option Syntax
TOTAL
The following example uses the TOTAL option with the variable VSE DISK
SERVTIME:
VSE DISK SERVTIME TOTAL
By default, the variable VSE DISK SERVTIME creates a column showing the
average disk service time per SIO. Specifying the variable with the option
TOTAL creates a column showing the total service time for all SIOs.
XTIME, XTIMEM, and NXTIME Options
By default, many time-based report writer variables are displayed in seconds.
If you expect a variable to show a time of many hours, you can use the XTIME
option to translate the time to hhh:mm:ss format, where hhh is hours, mm is
minutes, and ss is seconds.
If you want more precise output of time values, you can use the XTIMEM
option or the NXTIME option. The XTIMEM option translates the time value to
hhh:mm:ss:lll format, where hhh is hours, mm is minutes, ss is seconds, and
lll is milliseconds. The NXTIME option changes the value to ssss.lll format,
where ssss is seconds and lll is milliseconds.
The hhh:mm:ss, hhh:mm:ss:lll, and ssss.lll formats take up more column
space than the default format.
Option Syntax
XTIME
XTIMEM
NXTIME
The following example uses the XTIME option with the variable VSE STEP
TCPU:
VSE STEP TCPU XTIME
XTND and NXTND Options
Use the XTND and NXTND options to increase or decrease the number of digits
in a variable's output.
406 Report Reference Guide
Descriptions of Variable Options
Most variables have a maximum value of five digits. If a number is larger than
99999, the report writer divides it by 1000 and adds an uppercase K. (For
example, 200,000 becomes 200K.) If the number is still too large, the report
writer divides by 1000 again and adds an uppercase M, and so on. For values
representing storage, the report writer divides large values by 1024 and adds
a lowercase k; if the number is still too large, it divides by 1024 again and
adds a lowercase m.
The XTND and NXTND variable options are not valid for variables that yield
time values. You can use the XTIME, XTIMEM, and NXTIME options to control
the output of time variables.
Use the XTND (extend) option to support the printing of up to eight digits. This
allows you to print more precise output of numbers up to 99,999,999
(including commas). The overriding headers created with the HDR1 and HDR2
operands cannot exceed ten characters.
XTND Option Syntax
XTND
You might use the XTND option with the variable VSE JOB COUNT if you
expect the number of jobs to be more than 99999 and you want an exact
count, as follows:
VSE JOB COUNT XTND
Some numbers that the report writer expects to be large can be extended by
default. Use the NXTND option to reduce the number of digits printed, thus
increasing the number of columns that can fit across a page.
NXTND Option Syntax
NXTND
The following example uses the NXTND option with the variable VSE DEVICE
SIO:
VSE DEVICE SIO NXTND
Chapter 8: Variable Options 407
Chapter 9: ID Options
You can use ID options with certain commands, with variables, or with both,
as follows:
■
Use ID options with commands to organize the data in a tabular, graph, or
flashback report by a specific type of resource. For example, you can
create a tabular report organized by jobname, where each row contains
information about only a single job. This use of ID options is explained
later in this chapter.
■
You can also specify one or more identifiers to limit the report to the
particular resource or resources specified by the identifiers.
■
Use ID options with variables in any type of report to limit the range of the
variable to a particular resource or group of resources. For example, you
can limit the range of a variable to a specific channel or a specific group of
channels. This use of ID options is explained later in this chapter.
■
When you use ID options with variables, you must include one or more
identifiers that specify the particular resources for which you want
information.
This chapter provides descriptions of ID options, their uses, and their
identifiers.
This section contains the following topics:
Descriptions of ID Options (see page 410)
VSE/POWER Accounting ID Options (see page 413)
Specifying Identifiers with ID Options (see page 419)
Using Generic Characters in Identifiers (see page 419)
Specifying Identifiers in Hexadecimal (see page 420)
Using ID Options with Commands (see page 420)
Specifying ID Options (see page 420)
TAB Report Using an ID Option and Identifiers (see page 422)
TAB and TAB2 Report Using ID Options (see page 422)
Graph Report Using an ID Option Without Identifiers (see page 423)
Graph Report Using an ID Option and Identifiers (see page 424)
Flashback Report Using an ID Option and Identifiers (see page 425)
Using ID Options with Variables (see page 425)
Specifying ID Options (see page 426)
Using ID Options with Commands Versus with Variables (see page 426)
Sample Report 1 (see page 427)
Sample Report 2 (see page 427)
Example Using ID Options with Variables (see page 428)
Using ID Options with Both Commands and Variables (see page 428)
Formatting Identifiers in Output (see page 429)
Using the FORMAT Option (see page 430)
Chapter 9: ID Options 409
Descriptions of ID Options
Option Syntax and Operand (see page 430)
Using the DEFINE Command (see page 431)
Using the DEFINE Command versus the FORMAT Option (see page 433)
Descriptions of ID Options
An ID option is a keyword that names a type of resource. For example, the ID
option JOBID refers to jobs, and the ID option VOLSER refers to volumes.
An identifier is either the name of a particular resource or a generic
specification of a group of resources that a report or variable is to be limited
to. Identifiers are specified in parentheses following ID options. For example,
specifying the ID option and identifiers JOBID (MYJOB1,MYJOB2,MYJOB3) with
a TAB command organizes the report by jobname and limits it to the three
jobs named MYJOB1, MYJOB2, and MYJOB3. Identifiers are explained later in
this chapter under the heading entitled, Specifying Identifiers with ID Options.
All ID options, the identifiers that are valid for each of them, their maximum
length in characters, and the variable record types with which they can be
used are as follows:
ID Option
Identifiers Specified
with the ID Option
Identifier Length
Variable Classes Used
with the ID Option
CACHSSID
Subsystem IDs (one per
physical device)
4
CACHE
CACHUNIT
Device unit addresses
2 hexadecimal digits
CACHE
CHNID
Channel IDs
Exactly 2
CHANNEL, except VSE
CHANNEL XABUSYS
hexadecimal digits
CHPID
Channel path IDs
Exactly 2
hexadecimal digits
The variable VSE CHANNEL
XABUSYS only
CONJOBID
Jobnames
8
CONTENTION
CONPID
Partition IDs
2 hexadecimal digits
CONTENTION
CONSTEPID
Stepnames
8
CONTENTION
CONTID
Task IDs
4 hexadecimal digits
CONTENTION, PHASE,
non-system SVC
CPUID
CPU serial numbers of
VSE machines
6
All VSE variable classes
except VM
CPUMOD
CPU model numbers of
VSE machines
6
All VSE variable classes
410 Report Reference Guide
Descriptions of ID Options
ID Option
Identifiers Specified
with the ID Option
Identifier Length
Variable Classes Used
with the ID Option
CPUPID
CPU processor ID
2
MCPU
CYLID
Cylinder addresses
4
The variables VSE DISK
SEEKS, VSE RDISK SEEKS,
and VSE VDISK SEEKS only
DEVID
Device channel and unit
addresses (CUUs)
Exactly 4 hexadecimal digits
DEVICE, TAPE
DISKID
Disk channel and unit
addresses (CUUs)
Exactly 4 hexadecimal digits
CACHE, DISK, DSN, PAGE,
RDISK, VDISK
DSNID
Data set names
44
DSN
ENDADDR
None
8
DSN
ENDTIME
None
8 (hh:mm:ss format)
All variable classes
JOBID
Jobnames
8
Non-system variables of the
following classes:
CONTENTION, CPU, DEVICE,
DISK, DSN, DYNAMIC,
GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE,
PHASE, RDISK, SGETVIS,
STEP, SVC, SYSTEM, TAPE,
VDISK, WAIT
Any PACCNT EXEC variable
LIBRARY
Library names
7
PHASE, non-system SVC
LOCKHEXID
Lock resource names in
hexadecimal format
24 hexadecimal digits
LOCK
LOCKID
Lock resource names
12
LOCK
LOCKTYPE
Lock types (INTERNAL
or EXTERNAL)
8
LOCK
LPARID
Logical partition names
8
LPAR, SAMPLE LPARvariables
LPID
Logical partition
processor numbers
2
LPAR
ORPHADDR
Storage addresses
Exactly 8 hexadecimal digits
SGETVIS ORPHAN-variables
PAGEID
Page data set extents
2
PAGE
PGMTID
Task IDs
4 hexadecimal digits
PHASE, non-system SVC
except for VSE SVC TCOUNT
PHASEID
Phase names
8
PHASE, SGETVIS ORPHANvariables, non-system SVC
Chapter 9: ID Options 411
Descriptions of ID Options
ID Option
Identifiers Specified
with the ID Option
Identifier Length
Variable Classes Used
with the ID Option
except for SVC TCOUNT
PID
Partition IDs
2
Non-system variables of the
following classes:
CONTENTION, CPU, DEVICE,
DISK, DSN, DYNAMIC,
GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE,
PHASE, RDISK, STEP, SVC,
SYSTEM, TAPE, VDISK,
WAIT
PNET
Node IDs for VSE
machines for native VSE
8
All VSE variable classes
RDISKID
Real disk channel and
unit addresses (CUUs)
Exactly 4 hexadecimal digits
RDISK
TASKID
Task IDs
4 hexadecimal digits
Non-system variables of the
following classes:
CONTENTION, CPU, DEVICE,
DISK, DSN, LOCK, LTA,
OPERATOR, OTHER, PAGE,
PHASE, RIDSK, SGETVIS,
SVC, SYSTEM, TAPE, VDISK,
WAIT
TASKNAME
Task names
8
Non-system variables of the
following classes:
CONTENTION, CPU, DEVICE,
DISK, DSN, LOCK, LTA,
OPERATOR, OTHER, PAGE,
PHASE, RDISK, SGETVIS,
SVC, SYSTEM, TAPE, VDISK
WAIT
THRSID
Threshold types
8
LOCK, STEP, non-system
SVC, THRESHOLD
USERID
User IDs from // ID card 8
Non-system variables of the
following classes:
CONTENTION, CPU, DEVICE,
DISK, DSN, DYNAMIC,
GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE,
PHASE, RDISK, STEP, SVC,
SYSTEM, TAPE, VDISK,
WAIT
VDISKID
Virtual disk channel and
VDISK
412 Report Reference Guide
Exactly 4 hexadecimal digits
VSE/POWER Accounting ID Options
ID Option
Identifiers Specified
with the ID Option
Identifier Length
Variable Classes Used
with the ID Option
unit addresses (CUUs)
VMID
VM machine IDs of VSE
guest machines
8
All VSE variable classes
VOLSER
Volume IDs
6
CACHE, DISK, DSN, RDISK,
PAGE, VDISK
WAITID
Wait types
8
CONTENTION, non-system
WAIT
VSE/POWER Accounting ID Options
The ID options that apply to VSE/POWER accounting variables are as follows:
ID Option
Identifiers Specified
with the ID Option
Identifier
Length
Variable Classes Used with the ID
Option
ACAPPLID
XPCC application
identifiers of the device
driving system (DDS)
8
PACCNT AFP
ACCANC
VSE/POWER cancel codes
2 hexa-decimal
digits
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: general, AFP, BSC, EXEC,
LIST, PUNCH, READER, RECV, SNA,
TRANS, XSPOOL
ACDATE
Record dates, in the
format defined for the
system
8
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: general, AFP, BSC, EXEC,
LIST, PNET, PUNCH, READER, RECV,
SNA, SYS, TRANS, XCONN, XSPOOL
ACIDEN
Record types ( For more
information, see the
chapter "VSE/POWER
Reports.")
1
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
Chapter 9: ID Options 413
VSE/POWER Accounting ID Options
ID Option
Identifiers Specified
with the ID Option
Identifier
Length
Variable Classes Used with the ID
Option
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: general, AFP, BSC, EXEC,
LIST, PNET, PUNCH, READER, RECV,
SNA, SYS, TRANS, XCONN, XSPOOL
ACNAME
VSE/POWER jobnames
8
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: general, AFP, BSC, EXEC,
LIST, PUNCH, READER, SNA, TRANS,
XSPOOL
ACNUMB
VSE/POWER job numbers
Exactly 5
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: general, EXEC, LIST, PUNCH,
READER, RECV, TRANS, XSPOOL
ACSTOP
Record end times, in
hh/mm/ss format
8
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: general, AFP, BSC, EXEC,
LIST, PNET, PUNCH, READER, RECV,
SNA, TRANS, XCONN, XSPOOL
ACSTRT
Record start times, in
hh/mm/ss format
8
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: general, AFP, BSC, EXEC,
LIST, PNET, PUNCH, READER, RECV,
SNA, SYS, TRANS, XCONN, XSPOOL
ACSYSID
System IDs
1
PACCNT variable classes
Only valid when
414 Report Reference Guide
VSE/POWER Accounting ID Options
ID Option
Identifiers Specified
with the ID Option
Identifier
Length
Variable Classes Used with the ID
Option
OPTION(PWRPREFIX=YES) is
specified
ACUSER
$$ JOB user information
16
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: general, AFP, BSC, EXEC,
LIST, PUNCH, READER, RECV, SNA,
TRANS, XSPOOL
BSCDTE
Dates, in the format
defined for the system
8
PACCNT BSC
BSCIDN
Record IDs
1
PACCNT BSC
BSCLAD
Line addresses
3
PACCNT BSC
BSCPAS
Line passwords
8
PACCNT BSC
BSCRID
Remote IDs
8
PACCNT BSC
BSCSFC
Sign-off codes
1
PACCNT BSC
BSCSGF
Sign-off times
8
PACCNT BSC
BSCSGN
Sign-on times
8
PACCNT BSC
BSCSOD
Sign-off dates, in the
format defined for the
system
8
PACCNT BSC
BSCUSE
Sign-on command user
information
16
PACCNT BSC
EXDCANC
VSE cancel codes
2 hexadecimal
digits
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: EXEC, LIST, PUNCH, READER,
RECV, TRANS, XSPOOL
EXDJOB
VSE jobnames
8
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
Chapter 9: ID Options 415
VSE/POWER Accounting ID Options
ID Option
Identifiers Specified
with the ID Option
Identifier
Length
Variable Classes Used with the ID
Option
PACCNT EXEC
EXDUSER
JOB card user information 16
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT EXEC
EXFRNO
Originating node names
8
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT EXEC
EXFRUS
IDs of originating users
8
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT EXEC
EXICL
Classes, as specified with 1
the CLASS= parameter on
the POWER job card
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT EXEC
EXIPR
Priorities
1
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT variables of the following
types: EXEC, LIST, PUNCH, READER,
RECV, TRANS, XSPOOL
EXPHASE
Phase names
8
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT EXEC
EXPID
Partition IDs
416 Report Reference Guide
2
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
VSE/POWER Accounting ID Options
ID Option
Identifiers Specified
with the ID Option
Identifier
Length
Variable Classes Used with the ID
Option
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT EXEC
EXTYPE
Record types:
■
S—Step
■
L—Last step
1
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT EXEC
EXXNODE
Execution node names
8
Non-system variables of the following
classes: CPU, DEVICE, DISK, DSN,
DYNAMIC, GETVIS, JOB, LOCK, LTA,
OPERATOR, OTHER, PAGE, PHASE,
RDISK, STEP, SYSTEM, TAPE, VDISK
PACCNT EXEC
LSTACCT
Network account numbers 8
PACCNT LIST
LSTADR
Printer/RJE-line addresses 3
(CUUs)
PACCNT LIST
NACQTYP
Queue types:
1
PACCNT RECV, PACCNT TRANS
■
R—Reader
■
L— List
■
P—Punch
NACTN
Destination node names
8
PACCNT RECV, PACCNT TRANS
NACTUS
Destination user IDs
8
PACCNT RECV, PACCNT TRANS
NETDTE
Dates, in the format
defined for the system
8
PACCNT PNET
NETIDEN
Record IDs
1
PACCNT PNET
NETLAD
Line addresses
3
PACCNT PNET
NETNODE
Connected node IDs
8
PACCNT PNET
NETNPAS
Node passwords
8
PACCNT PNET
NETPSW
Line passwords
8
PACCNT PNET
NETSGF
Sign-off time
8
PACCNT PNET
NETSGN
Sign-on time
8
PACCNT PNET
NETSOD
Sign-off date
8
PACCNT PNET
Chapter 9: ID Options 417
VSE/POWER Accounting ID Options
ID Option
Identifiers Specified
with the ID Option
Identifier
Length
Variable Classes Used with the ID
Option
NETTERM
ACF/VTAM cancel code
2 hexadecimal
digits
PACCNT PNET
PUNACCT
Network account numbers 8
PACCNT PUNCH
PUNADD
Punch device or RJE-line
addresses (CUU)
3
PACCNT PUNCH
PUNFOR
Punch-forms IDs
4
PACCNT PUNCH
PUNFRM
Originating node names
8
PACCNT PUNCH
PUNFRUS
Originating-user IDs
8
PACCNT PUNCH
PUNNODE
Own node IDs
8
PACCNT PUNCH
PUNOCL
Punched output classes
1
PACCNT PUNCH
PUNOPR
Punched output priority
numbers
1
PACCNT PUNCH
PUNTO
TO remote IDs
8
PACCNT PUNCH
PUNTOUS
Destination-user IDs
8
PACCNT PUNCH
PWRDTE
Dates, in the format
defined for the system
8
PACCNT SYS
PWRIDEN
Record IDs
1
PACCNT SYS
PWRLEV
Level IDs
4
PACCNT SYS
PWRPART
Partition IDs
2
PACCNT SYS
PWRSGN
Startup times
8
PACCNT SYS
PWRVER
Version/modification
levels
4
PACCNT SYS
RDRACCT
Network account numbers 8
PACCNT READER
RDRADD
Reader device or line
addresses (CUU)
3
PACCNT READER
RDRFRM
FROM remote IDs
8
PACCNT READER
RDRFRUS
Originating node names
8
PACCNT READER
RDRICL
Input classes, as specified 1
with the CLASS=
parameter on the POWER
job card
PACCNT READER
For more information about creating reports using VSE/POWER accounting
data, see the chapter "VSE/POWER Reports."
418 Report Reference Guide
Specifying Identifiers with ID Options
Specifying Identifiers with ID Options
Identifiers specify particular resources of the type determined by the ID
option. The effect of specifying an identifier depends on whether the ID option
it is used with is specified with a command or with a variable, as follows:
■
If an ID option is used with a command, specifying identifiers restricts the
report to information about the particular resources specified.
■
If an ID option is used with a variable, specifying identifiers restricts the
range of the variable to the particular resources specified.
The identifiers that are valid with each ID option are listed in the "Variable
Options" chapter.
Identifiers can specify one of the following:
■
An individual resource of the type determined by the ID option. For
example, the ID option JOBID can be followed by an identifier that names
a specific job, that is, a jobname.
■
A group of resources of the type determined by the ID option. You can
specify more than one resource in two ways:
–
You can list several individual resources separated by commas.
–
You can specify one or more groups of resources using generic
characters, as explained in the following section. For example, the ID
option DSNID can be followed by an identifier that specifies the group
of data sets whose names begin with the letter C.
Using Generic Characters in Identifiers
Identifiers can contain the following generic characters to report on groups of
resources:
■
A plus sign (+) tells the report writer not to compare that position in the
identifier. A place in an identifier filled in with the plus sign (+) is always a
match.
■
An asterisk (*) tells the report writer that all places after and including the
asterisk are matches.
■
A not sign (¬) tells the report writer to exclude the identifier that follows
it. You can use the generic characters * and + when specifying the
identifier to be excluded.
The following GRAF command produces a report on job activity use for only
certain jobs:
GRAF JOBID(PAY*,¬PAY001) VSE JOB COUNT
Chapter 9: ID Options 419
Specifying Identifiers in Hexadecimal
In this example, the ID option JOBID is specified with two identifiers, PAY* and
¬PAY001. The identifier PAY* includes all jobs whose identifiers start with PAY.
The identifier ¬PAY001 excludes the job PAY001. Thus, this ID option specifies
that all PAY jobs except PAY001 are to be included in the graph.
Specifying Identifiers in Hexadecimal
Identifiers can be specified in their hexadecimal representation by placing the
hexadecimal value inside single quotes.
The following two commands generate the same report, a report on only those
data sets whose IDs begin with EXP:
TAB DSNID(EXP*) variable
END
TAB DSNID('C5E7D7'*) variable
END
Using ID Options with Commands
Use ID options with commands to organize the data in a report by a specific
type of resource, such as job, channel, disk, or data set.
You can use ID options with the TAB, TAB2, GRAF, and FLASHBACK
commands.
You cannot use ID options with any of the plot commands. You can, however,
use ID options with variables in plot reports, as described later in this chapter.
To use an ID option with a command, specify the ID option after the command
and before any variables.
Specifying ID Options
The syntax of ID options when used with commands is as follows:
command idoption[(identifier[,identifier...])] [variable]
The operands for ID options have the following meanings:
Operand
Meaning
idoption
One of the ID options listed in the "ID Options"
chapter in this guide. The ID option you specify
420 Report Reference Guide
Specifying ID Options
Operand
Meaning
determines the type of resource the resulting
report will be organized by.
identifier
Individual resource or group of resources the
report is to be limited to. The types of identifiers
that are valid for each ID option are given in the
chapter "ID Options."
For more information about specifying identifiers,
see Specifying Identifiers with ID Options in the
chapter "ID Options."
You are not required to specify identifiers when you use an ID option with a
command. If you specify one or more identifiers with an ID option, the
resulting report is not only organized by the type of resource specified by the
ID option, but the entire report is limited to the resources specified by the
identifiers.
The following TAB command includes the ID option JOBID to generate a report
organized by jobname that shows the usage of each job and its average
duration:
TAB JOBID VSE JOB COUNT AND VSE JOB DURATION
END
RUN
The preceding commands generate a report like the following:
JOB
JOB
AVERAGE
NAME
COUNT
DURATION
-------- -------- -------ALT
55
00:01:23
CATALR
51
00:00:16
EXPRPT
35
00:01:46
ALERT
18
00:00:57
JCLSCHED
13
04:55:02
AXPU3
12
00:00:03
OPENTEST
12
00:00:11
FAQSCIST
11
00:00:37
READ
9
00:00:15
GSPDSU
8
00:04:45
LIBR
8
00:00:15
FAQSTPVS
7
00:00:44
ALTRULE
6
00:00:35
JCLXCU
6
00:00:06
AXPX5
5
00:00:22
DFHDUMP
5
00:00:19
DLITEST
5
00:01:02
EVSTAT
5
00:00:12
GSDIR
5
00:00:40
CICSMROA
4
11:28:07
-------- -------- -------SUMMARY
280
00:24:24
-------- -------- --------
Chapter 9: ID Options 421
TAB Report Using an ID Option and Identifiers
TAB Report Using an ID Option and Identifiers
The following TAB command is similar to the preceding example, but the ID
option JOBID is specified with the identifier A* to generate a report on jobs
with names beginning with the letter A:
TAB JOBID(A*) FOR 20 VSE JOB COUNT AND VSE JOB DURATION
END
RUN
The preceding commands generate a report like the following:
JOB
JOB
AVERAGE
NAME
COUNT
DURATION
-------- -------- -------ALT
55
00:01:23
ALERT
18
00:00:57
AXPU3
12
00:00:03
ALTRULE
6
00:00:35
AXPX5
5
00:00:22
-------- -------- -------SUMMARY
96
00:01:02
-------- -------- --------
TAB and TAB2 Report Using ID Options
The following example uses the ID option and identifiers JOBID( JCLSCHED,
CICSMROA) with the TAB command and the ID option TABLEID with the TAB2
command to create a table of jobs and the data sets associated with them:
TAB
JOBID(JCLSCHED,CICSMROA) VSE DSN SIO AND VSE DSN SERVTIME
TAB2 DSNID
END
RUN
422 Report Reference Guide
VSE DSN SIO AND VSE DSN SERVTIME
Graph Report Using an ID Option Without Identifiers
The preceding commands generate a report like the following:
JOB
DSN
SERVICE
DSN
NAME
SIO
TIME
NAME
-------- ---------- -------- -------------------------------------------JCLSCHED
8,172
0.037
VSE3TST.VSE2TST.SHARED.MON.PDS
VSE3TST.VSE.SHARED.PDS.FLEE/XP.AUDIT
VSE2TST.SYSRES.SYSLIB
PROD.LIB.FOR.MSHP.INSTALL
VSE.HARDCOPY.FILE.S
VSE2TST.POWER.QUEUE.FILE
VSE2TST.MASTER.CATALOG
VSE2TST.SYSRES.PRD2
WM08RS.VTOC
.
.
.
-------------------------------------------SUMMARY
-------------------------------------------CICSMROA
3,826
0.038
VSE3TST.VSE2TST.SHARED.MON.PDS
PROD.LIB.FOR.MSHP.INSTALL
CICSVSE2.S1SCTY.VSAM
VSE2TST.CICS.DUMPA.MROA
VSE2TST.MASTER.CATALOG
VSE2TST.SYSRES.PRD2
CICSVSE2.S1SAUDT.VSAM
CICSVSE2.S1SECLOG.VSAM
VSE2TST.SYSRES.SYSLIB
.
.
.
-------------------------------------------SUMMARY
--------------------------------------------
DSN
SIO
---------3,458
1,921
898
847
463
292
132
39
39
.
.
.
---------8,172
---------3,164
223
156
82
56
52
28
22
12
.
.
.
---------3,826
----------
SERVICE
TIME
-------0.042
0.042
0.017
0.037
0.012
0.029
0.046
0.039
0.070
.
.
.
-------0.037
-------0.038
0.043
0.038
0.029
0.017
0.045
0.094
0.056
0.087
.
.
.
-------0.038
--------
Graph Report Using an ID Option Without Identifiers
By default, the GRAF command produces a report on the identifiers associated
with the specified variable. If you specify an ID option with the GRAF
command, that ID option's identifiers are used in place of the default.
For example, graph reports on DISK variables are, by default, organized by
disk ID.
The following commands use the ID option VOLSER with the GRAF command
to produce a report on disk SIOs by volume serial number rather than by disk
ID:
GRAF VOLSER VSE DISK SIO
END
RUN
Chapter 9: ID Options 423
Graph Report Using an ID Option and Identifiers
The preceding commands generate a report like the following:
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXX.
.
.
.
.
.
.
.
.
.
.XXXXXXX .
.
.
.
.
.
.
.
.
.
.XXXXXXX .
.
.
.
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
PACK61
PACK60
PACK32
PACK25
PACK40
PACK63
PACK10
PACK42
PACK62
PACK13
PACK41
PACK11
PACK30
PACK23
DOSRES
PACK24
SYMBOLS:
"X" =
X
74515
53109
47908
44322
41705
29463
29331
21051
15975
13090
12332
10743
7575
6503
5425
5364
X
DEVICE SIO COUNT
Graph Report Using an ID Option and Identifiers
The following commands are the same as those in the preceding example
except that the ID option VOLSER is specified with the identifier PACK6+,
which restricts the report to volumes PACK60 through PACK6F:
GRAF VOLSER(PACK6+) VSE DISK SIO
END
RUN
The preceding commands generate a report like the following:
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
PACK61
PACK60
PACK63
PACK62
SYMBOLS:
"X" =
DEVICE SIO COUNT
424 Report Reference Guide
X
74515
53109
29463
15975
X
Flashback Report Using an ID Option and Identifiers
Flashback Report Using an ID Option and Identifiers
The following commands produce a flashback VSESTEP report only on those
jobs whose jobnames begin with IND:
FLASHBACK VSESTEP JOBID(IND*)
FROM
01/30/04 08.00.00
TO
01/30/04 12.00.00
END
RUN
The preceding commands generate a report like the following, shown in part:
PART
ID
---F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F3
F3
F3
F3
----
START
TIME
-------08.00.01
08.08.45
08.09.03
08.09.33
08.09.55
08.10.06
08.10.28
08.10.34
08.11.06
08.15.20
08.16.08
08.16.25
08.16.36
08.16.37
08.18.25
08.18.26
08.18.44
08.19.44
11.56.55
11.57.30
11.57.48
11.57.49
-------08.00.01
---- --------
END
TIME
-------08.08.45
08.09.03
08.09.32
08.09.54
08.10.05
08.10.28
08.10.33
08.11.05
08.15.20
08.16.08
08.16.25
08.16.35
08.16.37
08.17.50
08.18.26
08.18.43
08.19.10
08.20.10
11.56.55
11.57.48
11.57.49
12.00.00
-------12.00.00
--------
JOB
NAME
-------IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND020
IND020
IND020
IND020
--------
STEP
NAME
-------IN0070
IN1220
MTPBATCH
IN0125
IN0115
IN0116
IN0008
IN0040
IN0400
IN0420
IN0050
IN1210
TDYNASN
CPYDT
TDYNASN
CPYTD
IN0057
DP7005
GSFAQSHJ
DP7005
TDYNASN
CPYDT
--------
TOTAL
TCPU
DISK
DISK
TAPE
OTHER
PAGE
PAGE
GETVIS %GETVIS
DURATION TIME
IO
SERVTIME
IO
IO
FAULTS
IO
USED
USED
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----00:08:43 14.73
13247
0.036
0
0
13
1
184K
29.7
00:00:17 0.540
318
0.036
0
0
98
1
304K
31.3
00:00:29 0.293
234
0.031
0
0
22
0
44K
35.5
00:00:20 0.478
312
0.037
0
0
46
6
112K
13.1
00:00:09 0.506
238
0.021
0
0
39
0
100K
11.7
00:00:21 0.795
495
0.032
0
0
32
0
60K
7.0
00:00:04 0.186
107
0.036
0
0
23
0
36K
5.9
00:00:31 1.061
664
0.033
0
0
59
30
160K
28.8
00:04:13 14.45
4372
0.054
0
0
65
0
352K
44.0
00:00:47 5.979
1452
0.028
0
0
56
0
68K
8.5
00:00:16 0.547
423
0.034
0
0
31
0
80K
13.0
00:00:09 0.306
197
0.036
0
0
76
0
252K
26.0
00:00:00 0.040
17
0.031
0
0
12
0
0
0.0
00:01:12 0.728
673
0.040
51
0
64
0
52K
6.9
00:00:00 0.040
17
0.041
0
0
12
0
0
0.0
00:00:16 0.523
492
0.029
22
0
52
0
40K
5.3
00:00:26 1.330
811
22
0
0
60
0
228K
41.1
00:00:24 1.822
982
0.021
0
0
53
0
168K
17.0
00:00:00 0.047
10
0.028
0
0
10
0
0
0.0
00:00:17 1.270
697
0.023
0
0
21
0
36K
3.7
00:00:00 0.040
17
0.033
0
0
12
0
4K
0.5
00:02:11 11.07
4377
0.033
2201
0
56
1
88K
11.6
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----00:21:16 56.79
30152
0.036
2274
0
912
39
118K
17.9
-------- -------- -------- -------- -------- -------- -------- ----- ----------- -------- -------- ------
Using ID Options with Variables
Use ID options with individual variables to limit the range of the variable to a
particular resource or group of resources. You can use ID options with
variables in any type of report.
When you use ID options with variables, you must specify one or more
identifiers.
To use an ID option with a variable, specify the ID option and its identifiers
immediately following the variable you want to restrict.
Chapter 9: ID Options 425
Specifying ID Options
Specifying ID Options
The syntax of ID options when used with variables is as follows:
variable idoption (identifier[,identifier...])
The operands for ID options have the following meanings:
Operand
Meaning
idoption
One of the ID options listed earlier in this
chapter. The ID option you specify determines
the type of resource the report is to be about.
The ID options that can be used with a given
variable depend upon the variable's class and
data type. The ID options that are valid for each
class and record type are given in the "Variables"
chapter.
identifier
Individual resource or group of resources the
variable is to be limited to. The types of
identifiers that are valid for each ID option are
given earlier in this chapter.
For more information about specifying identifiers,
see Specifying Identifiers with ID Options.
Using ID Options with Commands Versus with Variables
The following examples illustrate the difference between using ID options with
commands and using ID options with variables.
The following commands include the ID option and identifiers
JOBID(EXPRPT,EVSTAT), specified with the TAB command:
TAB DATE JOBID(EXPRPT,EVSTAT) VSE JOB COUNT AND,
VSE JOB DURATION
FROM 08/02/04
TO
END
RUN
426 Report Reference Guide
08/04/04
Sample Report 1
The following commands include the same variables as the preceding
commands, and the same ID option and identifiers are specified. In this case,
the ID option and identifiers are specified with the second occurrence of each
variable instead of with the TAB command:
TAB DATE VSE JOB COUNT
HDR1(TOTAL)
HDR2(JOB COUNT) AND,
VSE JOB COUNT JOBID(EXPRPT,EVSTAT)
HDR1(E JOBS) HDR2(JOB COUNT) AND,
VSE JOB DURATION
HDR1(TOTAL)
HDR2(DURATION)
AND,
VSE JOB DURATION JOBID(EXPRPT,EVSTAT) HDR1(E JOBS) HDR2(DURATION)
FROM 08/02/04
TO
08/04/04
END
RUN
Sample Report 1
The first of the two preceding sets of sample commands generates the
following report:
JOB
DATE
NAME
-------- -------03/02/04 EXPRPT
EVSTAT
-------- -------SUMMARY
-------- -------03/03/04 EXPRPT
EVSTAT
-------- -------SUMMARY
-------- -------03/04/04 EXPRPT
EVSTAT
-------- -------SUMMARY
-------- --------
JOB
COUNT
-------23
1
-------24
-------6
2
-------8
-------19
2
-------21
--------
AVERAGE
DURATION
-------00:01:37
00:00:25
-------00:01:34
-------00:00:59
00:00:08
-------00:00:46
-------00:01:58
00:00:08
-------00:01:47
--------
Sample Report 2
The second of the two preceding sets of sample commands generates the
following report:
TOTAL
E JOBS
DATE
JOB COUNT JOB COUNT
-------- --------- --------03/02/04
176
24
03/03/04
142
8
03/04/04
70
21
-------- --------- --------PERIOD
388
53
TOTAL
E JOBS
DURATION DURATION
-------- ----------01:09:39
00:01:34
01:03:12
00:00:46
01:19:27
00:01:47
-------- ----------01:09:04
00:01:32
Chapter 9: ID Options 427
Example Using ID Options with Variables
Note how the preceding reports differ:
■
The first report is organized by both time and jobname, and the entire
report is restricted to data about the specified jobs.
■
The second report is organized only by time, and each ID option restricts
the range of just the one variable it is specified with. That is, the third and
last columns in the report, which were generated by variables specified
with the ID option and identifiers JOBID (EXPRPT, EVSTAT), contain
information about jobs EXPRPT and EVSTAT only. The second and fourth
columns contain information about all jobs, information not included in the
first report.
Example Using ID Options with Variables
Plot Report—the following commands generate a plot report that shows the
number of channel SIOs for channel 01:
PLOT VSE CHANNEL SIO CHNID(01)
FROM 11/28/03 08:00:00
TO
11/28/03 12:00:00
EACH 30 MINUTES
END
RUN
The preceding commands generate a report like the following. Along with the
number of SIOs for channel 01, the number of SIOs for all channels is plotted,
enabling you to easily compare the values.
11/28/03 08.00.00
08.30.00
09.00.00
09.30.00
10.00.00
10.30.00
11.00.00
11.30.00
SUMMARY:
RANGE:
SYMBOLS:
"X" =
0
2770
5540
8311
11081
13852
16622
19392
22163
24933
27704
X
+.........+.........+.........+........+........+........+.........+........+........+........+
.XXXXXXXXXXX-------------------------------------------------.
.
.
. 2935 17683
.XXXXXXXXXXXXXXXXXXXXXXXXX--------------------------------------------------------------------- 6958 27704
.XXXXX-----.
.
.
.
.
.
.
.
. 1300 3153
.XXX--------.
.
.
.
.
.
.
.
.
715 3458
.XXXXX------------------.
.
.
.
.
.
.
. 1355 6529
.XXXXXXXXXXXXXX--------------------------.
.
.
.
.
. 3845 11563
.XXXXXXX-------------------------------.
.
.
.
.
.
. 2011 10835
.XXXXXXXXXXXXXX------------------------------------------------------.
.
. 3925 19914
.
.
.
.
.
.
.
.
.
.
. SUMMARY:
.XXXXXXXXXX--------------------------------.
.
.
.
.
. 2880 12604
+.........+.........+.........+........+........+........+.........+........+........+........+
0
2770
5540
8311
11081
13852
16622
19392
22163
24933
27704
X
-
CHANNEL SIO COUNT
"-" =
GLOBAL CHANNEL SIO COUNT
Using ID Options with Both Commands and Variables
A single report writer command can include more than one ID option. You can
specify an ID option with the command and also specify ID options with one or
more of the variables included in the command.
428 Report Reference Guide
Formatting Identifiers in Output
The following TAB command is specified with the ID option VOLSER that
organizes the report by volume. Two of the variables are specified with the ID
option and identifier DSNID(VSE*) which restricts the range of those variables
to the jobs with names beginning with VSE.
TAB VOLSER VSE DSN SIO
VSE DSN SIO
AND,
DSNID(VSE*) HDR1(
SIOs)
HDR2(FOR "VSE*") AND,
VSE DSN SERVTIME
AND,
VSE DSN SERVTIME DSNID(VSE*) HDR1( SERVTIME) HDR2(FOR "VSE*")
END
RUN
The preceding commands generate a report similar to the following:
VOLSER
DSN
SIOs
SERVICE
ID
SIO
FOR "VSE*" TIME
-------- ---------- ---------- -------TST002
846,633 576,688
0.022
SYSWK1
369,966 288,240
0.040
DOSRES
245,877
80,032
0.033
TSTSYS
190,564
1,016
0.032
SQLS31
9,323
0
0.014
SYSWK9
7,952
0
0.024
VAID01
7,932
0
0.018
SQLIBS
2,330
0
0.027
DEVSQL
1,365
0
0.019
VMDAT1
252
0
0.030
VMDAT2
193
0
0.026
DRS007
114
0
0.009
TSI154
66
0
0.034
TSI155
38
0
0.016
-------- ---------- ---------- -------SUMMARY
1,682,605 945,976
0.029
-------- ---------- ---------- --------
SERVTIME
FOR "VSE*"
---------0.020
0.039
0.030
0.043
0.000
0.000
0.000
0.000
0.000
0.000
0.000
0.000
0.000
0.000
---------0.027
----------
The first and third columns of the report show the value of the variables for all
data sets on each volume. The second and last columns show the values of the
variables for each volume for only those data sets whose names begin with the
letters VSE.
Formatting Identifiers in Output
In some situations, you may want to change the way identifiers are printed.
You can do this in two ways:
■
Use the FORMAT option to limit the number of characters printed for each
identifier.
■
Use the DEFINE command to define new identifiers or redefine existing
identifiers.
Each of these methods is explained in more detail in the following sections.
Chapter 9: ID Options 429
Using the FORMAT Option
Using the FORMAT Option
You can use the FORMAT option to limit the number of characters printed for
each identifier. Identifiers are truncated just before printing. Therefore, the
same (truncated) identifier may appear more than once in the report. Data for
identifiers that are identical after truncation are not combined in the report.
For a complete description of the FORMAT option and its full syntax, see the
chapter "Variable Options."
Option Syntax and Operand
The syntax of the FORMAT option when used with ID options is as follows:
ID option FORMAT(nC)
The operand for the FORMAT option is as follows:
Operand
Meaning
n
Number of characters to appear in the output. For example,
FORMAT(4C) indicates an output of four characters. There is no
limit on the value of n.
Assume, for example, your data set names are 44 characters long. A portion
of a report on data sets might look like this:
DSN
DEVICE STARTING ENDING
VOLSER
PERCENT
TOTAL
SERVICE
MAX
DSN
NAME
CUU
CCC-HH
CCC-HH
ID
BUSY
I/O TIME
TIME
SERVTIME
SIO
-------------------------------------------- -------- -------- -------- -------- -------- -------- -------- -------- ---------ARCHIVE.TEST.SECURITY.FILE11
0121
610- 00 674- 04 VSE002
0.2
57.71
0.028
0.082
2,059
ARCHIVE.TEST.SECURITY.FILE11.INDEX
0121
612- 09 612- 09 VSE002
0.4
43.51
0.023
0.033
1,913
AXP.LOG1.KSDS
0351
124- 02 130- 19 SYSWK1
0.4
679.3
0.030
0.233
22,498
AXP.LOG2.KSDS.INDX
0351
126- 20 126- 20 SYSWK1
0.4
380.9
0.033
0.190
11,412
AXP.LOG3
0351
277- 00 277- 29 SYSWK1
0.3
119.3
0.074
0.208
1,620
BU.PDS.MON.BACKUP.FILE
0121
201- 00 210- 14 VSE002
3.0
162.7
0.029
0.034
5,506
BU.PDS.VIO.BACKUP.FILE
0121
571- 00 584- 04 VSE002
8.6
155.5
0.046
0.046
3,360
CICS.CSD
0351
292- 00 292- 27 SYSWK1
0.2
19.18
0.034
0.081
563
CICS.CSD.INDX
0351
285- 03 285- 03 SYSWK1
0.1
7.687
0.031
0.064
244
CICS.DUMPA
0351
264- 00 268- 29 SYSWK1
0.1
24.66
0.054
0.149
460
CICS.DUMPB
0350
83- 00
84- 29 DOSRES
0.2
1.373
0.030
0.030
46
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
430 Report Reference Guide
Using the DEFINE Command
The data set names in the preceding report could be shortened using the
FORMAT option, saving enough column space to include one or more additional
variables. The following commands are similar to those used to generate the
preceding report, but they include the option FORMAT(10C) and the additional
variables VSE DSN WRITES and VSE DSN WRITESERV:
TAB DSNID FORMAT(10C) SORT ALPHA HDR1(
VSE DSN CUU
DSN) HDR2(
NAME),
AND,
VSE DSN STARTADDR AND VSE DSN ENDADDR
AND,
VSE DSN VOLSER
AND VSE DSN BUSY
AND,
VSE DSN IOTIME
AND VSE DSN SERVTIME AND,
VSE DSN MAXSERV
AND VSE DSN SIOS
VSE DSN WRITES
AND VSE DSN WRITESERV
AND,
END
RUN
The preceding commands produce a report like the following:
DSN
DEVICE STARTING ENDING
VOLSER
PERCENT
TOTAL
SERVICE
MAX
DSN
DSN
WRITE
NAME
CUU
CCC-HH
CCC-HH
ID
BUSY
I/O TIME
TIME
SERVTIME
SIO
WRITES SERVTIME
---------- -------- -------- -------- -------- -------- -------- -------- -------- ---------- -------- -------ARCHIVE.TE
0121
610- 00 674- 04 VSE002
0.2
57.71
0.028
0.082
2,059
202
0.022
ARCHIVE.TE
0121
612- 09 612- 09 VSE002
0.4
43.51
0.023
0.033
1,913
11
0.016
AXP.LOG1.K
0351
124- 02 130- 19 SYSWK1
0.4
679.3
0.030
0.233
22,498 13369
0.035
AXP.LOG2.K
0351
126- 20 126- 20 SYSWK1
0.4
380.9
0.033
0.190
11,412
302
0.047
AXP.LOG3
0351
277- 00 277- 29 SYSWK1
0.3
119.3
0.074
0.208
1,620
942
0.115
BU.PDS.MON
0121
201- 00 210- 14 VSE002
3.0
162.7
0.029
0.034
5,506
5506
0.029
BU.PDS.VIO
0121
571- 00 584- 04 VSE002
8.6
155.5
0.046
0.046
3,360
3360
0.046
CICS.CSD
0351
292- 00 292- 27 SYSWK1
0.2
19.18
0.034
0.081
563
37
0.046
CICS.CSD.I
0351
285- 03 285- 03 SYSWK1
0.1
7.687
0.031
0.064
244
0
0.000
CICS.DUMPA
0351
264- 00 268- 29 SYSWK1
0.1
24.66
0.054
0.149
460
273
0.056
CICS.DUMPB
0350
83- 00
84- 29 DOSRES
0.2
1.373
0.030
0.030
46
46
0.030
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Note: The data set name ARCHIVE.TE appears twice in the first column in the
preceding report. This is because the first ten characters of two data set
names were the same.
Using the DEFINE Command
You can use the DEFINE command to define new identifiers or redefine
existing identifiers.
The DEFINE command can also be used to define new variables. For more
information about DEFINE command and its full syntax, see the chapter
"Commands."
Chapter 9: ID Options 431
Using the DEFINE Command
The syntax of the DEFINE command when used to define ID options based on
existing ID options is as follows:
DEFINE ID newid [oldid [(start,length)]] ['string']
Operand
Meaning
ID
Requests the definition of a new ID option.
newid
New ID option name you want to define.
oldid
Existing ID option name you want to be a component
of the new ID option.
start,length
Specify the starting position (start) and length (length)
of the part of it you want to include if you do not want
to include the entire existing ID option in the new ID
option.
string
Character string that you want to be a component of
the new ID option. You must enclose the string in
single quotes. The string can be more than one
character in length, and it can include or consist
entirely of blanks.
When defining a new ID option, you can include multiple character strings or
existing ID options, in any order. When printed, components are concatenated
without intervening spaces.
Use the following syntax to define new ID options without using existing ID
options. This allows you to report on any data field located in any record. The
syntax is shown on two lines with a continuation comma at the end of the first
line.
DEFINE XID name PRODUCT=EVSE RECORD=rectype [SUBTYPE=subtype]
OFFSET=data-offset LENGTH=data-length,
[TRIPLET=triplet-offset] [TYPE=data-type] [HDR1=header1]
[HDR2=header2]
Operand
Meaning
XID
Requests the definition of a new ID option.
name
Name given to the new ID option you are creating.
PRODUCT=EVSE
Identifies the CA Explore PM for z/VSE product for which
an ID option is being defined. You can omit this operand
if you use the PRODUCT operand of the OPTION
command, as explained in the "Commands" chapter.
432 Report Reference Guide
Using the DEFINE Command versus the FORMAT Option
Operand
Meaning
rectype
Record type. To specify a value in hexadecimal, prefix
the value with the letter x, as in RECORD=x3C. You can
omit this operand if you use the RECORD operand of the
OPTION command, as explained in "Commands"
chapter.
subtype
Record subtype.
data-offset
Offset to the data field from the beginning of the record.
To specify a value in hexadecimal, prefix the value with
the letter x, as in OFFSET=x3C.
data-length
Length of the data field.
triplet-offset
Offset from the beginning of the record to the triplet
information. To specify a value in hexadecimal, prefix
the value with the letter x, as in TRIPLET=x3C.
data-type
One of the following data types:
■
BINARY—Binary.
■
CHARACTER—Character. This is the default.
■
HEX—Hexadecimal.
header1
String of up to 8 characters to be used as the top
column heading. The default is the null string.
header2
String of up to 8 characters to be used as the bottom
column heading. The default is the null string.
Using the DEFINE Command versus the FORMAT Option
You should be careful while using the DEFINE command to create shortened
forms of identifiers because, unlike the FORMAT option, the DEFINE command
can merge data about different identifiers. For instance, the DEFINE command
could be used to redefine the ID option DSNID to be the first 10 characters of
the data set name. If this command had been used in the example earlier in
this chapter, instead of the FORMAT option, the data for the first two data sets
listed, ARCHIVE.TEST.SECURITY.FILE11 and
ARCHIVE.TEST.SECURITY.FILE11.INDEX, would have been merged, since both
data set names would have been redefined to the same value, ARCHIVE.TE.
The DEFINE command offers more flexibility than the FORMAT option. For
example, while the FORMAT option allows you to truncate identifiers and retain
the first characters, the DEFINE command allows you to select any portion of
the identifiers. For instance, in the example earlier in this chapter, the ID
option DSNID could have been redefined to be 10 characters long beginning
with the second character rather than with the first.
Chapter 9: ID Options 433
Using the DEFINE Command versus the FORMAT Option
The following examples show ways to enter the DEFINE command and the
result of each:
Sample Entry
DEFINE ID DSNID DSNID(1,30)
DEFINE ID ACUSER ACUSER(3,4)
Result
Redefines the length of the ID option
DSNID from 44 characters to 30, starting
with position 1.
Redefines the ID option ACUSER to use
only 4 characters, starting with position
3.
DEFINE ID CHNID 'Channel ' CHNID Redefines the ID option CHNID to include
the word Channel and a blank before the
channel ID.
DEFINE ID MYKEY DISKID ' '
VOLSER
DEFINE XID KEY19 PRODUCT=EVSE
RECORD=19, OFFSET=X14 LENGTH=8
TYPE=HEX
434 Report Reference Guide
Creates a new ID option called MYKEY
with components DISKID and VOLSER
and places a blank between the two
components.
Creates the new ID option KEY19, which
is of record type 19, at offset X'14', of
length 8, and of type hexadecimal. The
continuation comma allows the command
to be continued on a second line.
Chapter 10: Tabular Reports
Tabular reports organize data into rows and vertical columns. When you create
tabular reports, you use labels or keys at the beginning of each row to
describe what the data in the line represents, which can be either a time
period or a particular resource, such as a job, data set, or disk. Headings at
the top of each column describe a variable; the value of that variable for each
time period or resource appears in that column.
The related topic links are as follows:
■
For more information about report writer commands, see the chapter
"Commands."
■
For more information about tabular reports, see the chapter "Reading
Reports."
■
For more information about descriptions of report writer variables and lists
of the ID options you can use with each class of variable, see the chapter
"Variables."
■
For more information about descriptions of ID options and their use with
commands and variables, see the chapter "ID Options."
This chapter describes how to generate tabular reports using the TAB and
TAB2 commands.
This section contains the following topics:
TABulate Command (see page 436)
Organizing Reports by Time and Date or Resources (see page 436)
Specifying Variables With or Without ID Options (see page 439)
Changing Column Headings (see page 441)
Using Variable Options (see page 443)
Limiting the Resources Included in a Report (see page 448)
Sorting Reports (see page 450)
Using Other Commands with the TAB Command (see page 454)
TAB2 Reports (see page 462)
Chapter 10: Tabular Reports 435
TABulate Command
TABulate Command
Use the TAB command to produce tabular reports. The variables you specify
with the TAB command determine the columns in your report and the order in
which they appear. The operands you specify determine:
■
How the report is organized: by date or time, by resource type or
individual resources (such as jobs, data sets, or disks), or by both.
■
How the report is sorted.
■
Column headings that appear in the report.
Organizing Reports by Time and Date or Resources
You can organize tabular reports by date or time, by a type of resource, or by
both. Examples of each of these types of organization are given in the
following sections.
Tabulating by Date and Time
Use the DATETIME operand to create tabular reports organized by date and
time.
The following commands create a tabular report displaying disk SIOs, disk
service time, and disk utilization. The DATETIME operand causes the report to
be organized by date and time.
TAB DATETIME VSE DISK SIO AND,
VSE DISK SERVTIME AND,
VSE DISK UTILIZATION
EACH HOUR
FROM 02/06/04 08:00:00
TO
END
RUN
436 Report Reference Guide
02/06/04 12:00:00
Organizing Reports by Time and Date or Resources
The preceding commands generate a report like the following:
DATE
-------02/06/04
02/06/04
02/06/04
02/06/04
-------PERIOD
--------
TIME
----08.00
09.00
10.00
11.00
---------
SIO
COUNT
---------45,520
61,345
60,140
89,123
---------256,128
----------
SERVICE
DEVICE
TIME
%BUSY
-------- -------0.021
4.6
0.025
6.9
0.024
7.0
0.026
7.4
-------- -------0.025
7.1
-------- --------
In the preceding example, the date is the same for each row in the report.
Such reports can be made briefer by omitting the date and using the TIME
operand instead of the DATETIME operand.
Tabulating by Day
Use the DAY operand to create tabular reports organized by the day of the
week (MONDAY, TUESDAY, and so on).
The following commands create a report in which data is organized by day:
TAB DAY VSE CPU BUSY
AND,
VSE CPU %BUSY
AND,
VSE CPU WAIT
AND,
VSE CPU WAITIDLE AND,
VSE CPU WAITIO
END
RUN
The preceding commands generate a report like the following:
WEEKDAY
--------MONDAY
TUESDAY
WEDNESDAY
--------PERIOD
---------
CPU
ACTIVE
-------00:24:32
00:21:34
00:30:09
-------01:16:15
--------
CPU
%ACTIVE
-------2.6
1.9
3.2
-------2.5
--------
CPU WAIT
CPU
CPU
TIME
IDLE
WAITIO
-------- -------- -------15:02:26 53204
750.2
18:53:26 67054
844.9
15:14:52 52924
1840
-------- -------- -------49:10:44
173K
3436
-------- -------- --------
Chapter 10: Tabular Reports 437
Organizing Reports by Time and Date or Resources
Tabulating by Resources
You can organize tabular reports by a type of resource, such as jobs or data
sets, or by individual resources within a type. Specify an ID option with or
without identifiers following the TAB command and preceding any variables.
Identifiers are listed in the first column, in descending order of the value of the
first variable specified. For information about sorting reports in other ways,
see Sorting Reports.
The following example uses the same commands used in the example earlier
in this chapter in the Tabulating by Date and Time section except the ID option
DISKID replaces the DATETIME operand. The resulting report is organized by
disk rather than by date and time.
TAB DISKID VSE DISK SIO AND,
VSE DISK SERVTIME AND,
VSE DISK UTILIZATION
FROM 02/06/99 08:00:00
TO
02/06/99 12:00:00
END
RUN
The preceding commands generate a report similar to the following, shown in
part:
DISK
SIO
SERVICE
DEVICE
ID
COUNT
TIME
%BUSY
-------- ---------- -------- -------0550
95,010
0.023
8.9
0350
62,730
0.026
11.2
0121
62,730
0.022
7.2
0351
29,123
0.020
2.7
0120
4,535
0.020
0.2
0122
1,600
0.027
0.2
0551
400
0.021
0.1
-------- ---------- -------- -------SUMMARY
256,128
0.025
7.1
-------- ---------- -------- --------
Tabulating by Both Time or Date and Resources
You can specify both an ID option and either the DATETIME, DATE, TIME, or
DAY operand to create a more detailed tabular report.
438 Report Reference Guide
Specifying Variables With or Without ID Options
The following commands generate a report organized by both time and
jobname. The FOR operand, described in Using the FOR Operand to Limit
Reports Organized by Identifier in this chapter, limits the report to the five
most active jobs during each interval.
TAB TIME JOBID FOR 5 VSE JOB COUNT
AND,
VSE STEP COUNT
AND,
VSE STEP TCPU
AND,
VSE DISK SIO
AND,
VSE PHASE LOADS AND,
VSE SVC COUNT
EACH HOUR
FROM 01/26/04 08:00:00
TO
01/26/04 11:00:00
END
RUN
The preceding commands generate a report like the following
TIME
----08.00
--------09.00
--------10.00
---------
JOB
NAME
-------ALT
AXPI9
SYSTEM
JCLSCHED
-------SUMMARY
-------EVSERPT
DYNBTST
GSRPDEMO
CATALR
-------SUMMARY
-------SVTM550
EVSERPT
ALTZ
GSRPDEMO
DYNBLK
-------SUMMARY
--------
JOB
COUNT
-------2
2
0
0
-------4
-------4
4
2
1
-------11
-------3
3
3
1
1
-------11
--------
STEP
COUNT
-------2
2
0
0
-------4
-------4
4
2
1
-------11
-------5
3
3
1
1
-------13
--------
TCPU
TIME
-------0.130
0.066
3.246
2.159
-------5.601
-------82.51
0.682
0.517
0.050
-------83.76
-------0.283
44.00
0.086
0.261
0.249
-------44.88
--------
SIO
COUNT
---------84
0
6
302
---------392
---------466
474
223
40
---------1,203
---------140
176
24
119
278
---------737
----------
LOAD
COUNT
-------34
8
0
17
-------59
-------399
490
268
17
-------1174
-------75
171
24
138
136
-------544
--------
SVC
COUNT
---------106
0
0
239
---------345
---------80,429
3,543
652
151
---------8
---------199
35,436
9
138
1,047
---------37,459
----------
Specifying Variables With or Without ID Options
You can specify multiple variables with the TAB command. The resulting report
includes a column of data for each variable specified, in the order in which the
variables are specified.
If you do not specify an ID option with the TAB command, there are no
restrictions on the variables you can include in the command.
Chapter 10: Tabular Reports 439
Specifying Variables With or Without ID Options
If you specify an ID option with the TAB command, the result is a report
organized by the type of resource associated with the ID option. Accordingly,
you can then use only those variables that apply to that type of resource. For
example, you cannot create reports showing CPU activity by data set, disk, or
channel. The variable classes that you can use with each ID option are listed in
the "ID Options" chapter.
However, you can use variables of different classes within a report organized
by a type of resource. For example, a report organized by jobname can include
STEP, DISK, PHASE, or SVC variables (among others), since these apply to job
activity.
Using Both CICS and VSE Variables
If you are running both CA Explore PM for z/VSE and CA Explore PM for CICS,
you can produce tabular and plot reports containing data collected by both CA
Explore PM for z/VSE systems. You can use any combination of these CA
Explore PM for z/VSE variables, subject to the restrictions described in the
previous section.
To use more than one type of CA Explore PM for z/VSE variable, you must use
the INPUT command to tell the report writer to read input data from flashback
or log files from each CA Explore PM for z/VSE system whose data you want to
use. For more information about the INPUT command, see the chapter
"Commands."
The following commands generate a report using data from both the CA
Explore PM for z/VSE flashback file (EVSEFBK) and from the CA Explore PM for
CICS flashback file (EXPCFBK):
INPUT(EVSEFBK,EXPCFBK)
TAB DATE VSE DISK SIO
VSE DISK SIO RATE
AND,
VSE DISK MAXSERVTIME
AND,
TRAN USE
AND,
EACH 1 DAY
FROM 01/16/04
RUN
440 Report Reference Guide
AND,
VSE DISK SERVTIME
TRAN LIFE
END
HDR1(DISK) HDR2(SIO COUNT) AND,
HDR1(DISK) HDR2(SIO RATE)
Changing Column Headings
The preceding commands generate a report like the following:
DATE
-------01/16/04
01/17/04
01/18/04
-------PERIOD
--------
DISK
SIO COUNT
---------2,156
170,270
74,139
---------246,565
----------
DISK
SERVICE
MAX
TRAN
SIO RATE
TIME
SERVTIME
USE
-------- -------- -------- -------0.02
0.023
0.093
154
1.97
0.023
0.244
461
2.42
0.018
0.069
223
-------- -------- -------- -------0.53
0.022
0.244
838
-------- -------- -------- --------
TRAN
LIFETIME
-------1.218
0.822
0.761
-------0.878
--------
Using ID Options with Variables
To limit the range of a variable to a specific resource or group of resources,
specify an ID option and one or more identifiers following the variable. The use
of ID options with variables is explained in the "ID Options" chapter.
Not all ID options can be used with all variables. For more information about
which ID options you can use with each variable class, see the chapter
"Variables."
The following example uses the ID option VOLSER to generate a single report
containing information about two volumes:
TAB DATE VSE DISK SIO VOLSER(VSE001) HDR1(VSE001) HDR2(SIO) AND,
VSE DISK SIO VOLSER(VSE002) HDR1(VSE002) HDR2(SIO)
END
RUN
The preceding commands generate a report like the following:
VSE001
VSE002
DATE
SIO
SIO
-------- ---------- ---------03/09/04
2,978
12,778
03/10/04
5,304
16,861
03/11/04
30,734
35,452
03/12/04
38,711
52,322
03/13/04
2,113
395
03/14/04
417
1,610
-------- ---------- ---------PERIOD
80,257
119,418
-------- ---------- ----------
Changing Column Headings
Each variable is assigned an abbreviation that is used by default as the
heading for columns containing data about the variable. You can use the HDR1
and HDR2 operands to replace the top and bottom lines of the heading,
respectively.
Chapter 10: Tabular Reports 441
Changing Column Headings
Changing headings is especially useful if you:
■
Change the type of data that a variable represents (for example, from a
count to a rate), as shown in the following example.
■
Use an ID option and identifiers to restrict the scope of a variable to
particular resources, as shown in the preceding example and in the
example following.
■
Need to shorten the column headings to gain space.
■
There are no restrictions on the characters you can use in a heading.
The variable VSE DISK SIO is specified twice in the following example. By
default, the column created for each occurrence of this variable would have
the heading SIO COUNT. Since the second occurrence of the variable applies
only to disk 0121, the HDR1 and HDR2 operands are included to create the
heading SIO COUNT FOR DISK 0121 above the column for this variable.
TAB TIME VSE DISK SIO
VSE DISK SERVTIME
AND,
AND,
VSE DISK UTILIZATION AND,
VSE DISK SIO DISKID(0121) HDR1(SIO COUNT) HDR2(FOR DISK 0121)
EACH HOUR
FROM 01/06/04 08:00:00
TO
01/06/04 12:00:00
END
RUN
The preceding commands generate a report like the following:
SIO
SERVICE
DEVICE
TIME
COUNT
TIME
%BUSY
----- ---------- -------- -------08.00
45,520
0.021
4.6
09.00
61,345
0.025
6.9
10.00
60,140
0.024
7.0
11.00
89,123
0.026
7.4
----- ---------- -------- -------PERIOD
256,128
0.025
7.1
----- ---------- -------- --------
442 Report Reference Guide
SIO COUNT
FOR DISK 0121
------------11,479
16,900
14,321
20,030
------------62,730
-------------
Using Variable Options
Using Variable Options
You can use any of the variable options described in the "Variables" chapter
with the TAB command. An example using the RATE option is given in
Changing a Count to a Rate, and an example using the FORMAT option is given
in Formatting Numeric Data. The following options can be used only with the
TAB command:
■
DIFF
■
RANGE
■
RIGHT
■
SELECT
Displaying Percentage of Change Over Time
In tabular reports organized by time or date, you can use the DIFF option to
create a column displaying the percentage of change in a variable's value
between each time interval. The percentage of change is calculated with the
following formula:
((current value - previous value)/previous value)*100
Syntax
DIFF
The following commands use the DIFF option to display the percentage of
change in the number of disk SIOs.
TAB DATE VSE DISK SIO AND,
VSE DISK SIO DIFF HDR2(%CHANGE)
END
RUN
Note: The HDR2 option assigns an appropriate column heading.
The preceding commands generate a report like the following:
SIO
SIO
DATE
COUNT
%CHANGE
-------- ---------- ---------03/02/04
15,765
03/03/04
22,165 +40.5%
03/04/04
66,374 +199.4%
03/05/04
91,302 +37.5%
03/06/04
2,535 -97.2%
03/07/04
2,123 -16.2%
-------- ---------- ---------PERIOD
200,264
-------- ---------- ----------
Chapter 10: Tabular Reports 443
Using Variable Options
The difference between the number of disk SIOs in the first interval and the
second interval is 6400 (22,165 - 15,765). This is a 40.5% increase (6400 /
15,765 = 40.5%).
Changing a Count to a Rate
Use the RATE option with a variable that normally displays a count to display
the rate for the variable.
The following commands produce a report that displays the SIO activity of all
active volumes by volume serial number. The RATE option is also used to give
the SIO rate (number per second) for each.
TAB DATE VOLSER VSE DISK SIO
HDR2(SIO)
AND,
VSE DISK SIO DIFF HDR2(%CHANGE) AND,
VSE DISK SIO RATE HDR2(RATE)
EACH 1 DAY
END
RUN
The preceding commands generate a report like the following:
VOLSER
DATE
ID
-------- -------03/02/04 SYSWK1
DOSRES
GUEST4
-------- -------SUMMARY
-------- -------03/03/04 SYSWK1
DOSRES
-------- -------SUMMARY
-------- -------03/04/04 SYSWK1
DOSRES
GUEST4
-------- -------SUMMARY
-------- --------
SIO
SIO
---------12,778
2,978
9
---------5,765
---------16,861
5,304
---------22,165
---------35,452
30,734
188
---------66,374
----------
SIO
SIO
%CHANGE
RATE
---------- -------0.15
0.03
0.00
---------- -------0.18
---------- -------+31.9%
0.20
+78.1%
0.06
---------- -------+40.5%
0.26
---------- -------+110.2%
0.41
+479.4%
0.36
0.00
---------- -------+199.4%
0.77
---------- --------
In the 86,400 seconds on 03/02/04, volume SYSWKI had 12,778 SIOs, which
is a rate of 0.15 per second. Although the number of SIOs for volume GUEST4
is not zero, the corresponding rate is so low that it appears as zero.
444 Report Reference Guide
Using Variable Options
The following commands produce a report that displays the SIO activity of two
volumes:
TAB DATE VSE DISK SIO
VOLSER(DOSRES) HDR1(DOSRES) HDR2(SIO)
VSE DISK SIO DIFF VOLSER(DOSRES) HDR1(DOSRES) HDR2(%CHANGE)
AND,
AND,
VSE DISK SIO RATE VOLSER(DOSRES) HDR1(DOSRES) HDR2(SIO-RATE) AND,
VSE DISK SIO
VOLSER(SYSWK1) HDR1(SYSWK1) HDR2(SIO)
VSE DISK SIO DIFF VOLSER(SYSWK1) HDR1(SYSWK1) HDR2(%CHANGE)
AND,
AND,
VSE DISK SIO RATE VOLSER(SYSWK1) HDR1(SYSWK1) HDR2(SIO-RATE)
EACH 1 DAY
END
RUN
The preceding commands generate a report like the following:
DOSRES
DOSRES
DATE
SIO
%CHANGE
-------- ---------- ---------03/02/04
2,978
03/03/04
5,304 +78.1%
03/04/04
30,734 +479.4%
03/05/04
38,711 +25.9%
03/06/04
2,113 -94.5%
03/07/04
417 -80.2%
-------- ---------- ---------PERIOD
80,257
-------- ---------- ----------
DOSRES
SYSWK1
SYSWK1
SIO-RATE
SIO
%CHANGE
-------- ---------- ---------0.03
12,778
0.06
16,861 +31.9%
0.36
35,452 +110.2%
0.45
52,322 +47.5%
0.02
395 -99.2%
0.01
1,610 +307.5%
-------- ---------- ---------0.16
119,418
-------- ---------- ----------
SYSWK1
SIO-RATE
-------0.15
0.20
0.41
0.61
0.00
0.02
-------0.24
--------
Formatting Numeric Data
You can use the FORMAT variable option to define the length of an output field
and the number of decimal positions it contains. This is useful when you
require more precise output than is printed by default, or when you want to
decrease the width of columns to gain space for additional columns.
Chapter 10: Tabular Reports 445
Using Variable Options
The following commands produce a report showing the CPU utilization for the
system and for each partition. The FORMAT option specifies the format for
each variable.
TAB DATETIME,
VSE STEP %TCPU FORMAT(NN.N) HDR1(------) HDR2(SYSTEM) AND,
VSE STEP %TCPU
PID(AR) FORMAT(NN.N) HDR1(----)
HDR2(AR)
AND,
VSE STEP %TCPU
PID(BG) FORMAT(NN.N) HDR1(----)
HDR2(BG)
AND,
VSE STEP %TCPU
PID(F1) FORMAT(NN.N) HDR1(----)
HDR2(F1)
AND,
VSE STEP %TCPU
PID(F2) FORMAT(NN.N) HDR1(----)
HDR2(F2)
AND,
VSE STEP %TCPU
PID(F3) FORMAT(NN.N) HDR1(----)
HDR2(F3)
AND,
VSE STEP %TCPU
PID(F4) FORMAT(NN.N) HDR1(----)
HDR2(F4)
AND,
VSE STEP %TCPU
PID(F5) FORMAT(NN.N) HDR1(----)
HDR2(F5)
AND,
VSE STEP %TCPU
PID(F6) FORMAT(NN.N) HDR1(----)
HDR2(F6)
AND,
VSE STEP %TCPU
PID(F7) FORMAT(NN.N) HDR1(----)
HDR2(F7)
AND,
VSE STEP %TCPU
PID(F8) FORMAT(NN.N) HDR1(----)
HDR2(F8)
AND,
VSE STEP %TCPU
PID(F9) FORMAT(NN.N) HDR1(----)
HDR2(F9)
AND,
VSE STEP %TCPU
PID(FA) FORMAT(NN.N) HDR1(----)
HDR2(FA)
AND,
VSE STEP %TCPU
PID(FB) FORMAT(NN.N) HDR1(----)
HDR2(FB)
EACH 1 HOUR
FROM 01/30/04 08:00:00
TO
01/30/04 12:00:00
END
RUN
The preceding commands generate a report like the following:
-------DATE
-------01/30/04
01/30/04
01/30/04
01/30/04
-------PERIOD
--------
----TIME
----08.00
09.00
10.00
11.00
---------
-----SYSTEM
-----58.1
55.6
53.5
42.5
-----54.7
------
---AR
---0.3
0.3
0.3
0.4
---0.3
----
---BG
---8.1
0.6
3.5
1.5
---3.5
----
---F1
---11.2
13.5
14.4
10.3
---12.4
----
---F2
---1.4
1.4
1.5
1.2
---1.4
----
---F3
---5.1
13.1
7.7
3.1
---8.7
----
---F4
---2.9
1.2
0.9
6.1
---3.1
----
---F5
---12.1
10.5
6.1
6.4
---9.2
----
---F6
---4.0
4.0
4.3
3.6
---4.0
----
---F7
---5.0
3.7
3.8
1.2
---3.5
----
---F8
---0.0
0.0
0.5
0.1
---0.2
----
---F9
---0.7
0.4
0.5
0.7
---0.6
----
---FA
---0.7
0.5
2.5
2.2
---1.5
----
---FB
---7.0
7.0
8.0
6.3
---7.1
----
Specifying a Time Period for a Variable
Use the SELECT option to apply to a particular variable the time period
specified with an INCLUDE or EXCLUDE command.
446 Report Reference Guide
Using Variable Options
Option Syntax and Operand
SELECT(name)
Operand
Meaning
name
The name operand of the SELECT command must match the
name operand of the ID operand for the INCLUDE or EXCLUDE
command that specifies the time period you want to apply to
the variable
The following example assigns the values of 1STSHIFT, 2NDSHIFT, and
3RDSHIFT to the name operands of the INCLUDE and SELECT commands.
Each associated time period from the INCLUDE command is applied to the VSE
CPU %BUSYV variable.
INCLUDE 08.00.00 - 15.59.59 ID 1STSHIFT
INCLUDE 16.00.00 - 23.59.59 ID 2NDSHIFT
INCLUDE 00.00.00 - 07.59.59 ID 3RDSHIFT
EACH 1 DAY
TAB DAY DATE VSE CPU %BUSYV
HDR1(TOTAL)
HDR2(%CPU) AND,
VSE CPU %BUSYV SELECT(1STSHIFT) HDR1(1STSHIFT) HDR2(%CPU) AND,
VSE CPU %BUSYV SELECT(2NDSHIFT) HDR1(2NDSHIFT) HDR2(%CPU) AND,
VSE CPU %BUSYV SELECT(3RDSHIFT) HDR1(3RDSHIFT) HDR2(%CPU) AND,
VSE JOB COUNT
HDR1(TOTAL)
HDR2(JOBS) AND,
VSE JOB COUNT
SELECT(1STSHIFT) HDR1(1STSHIFT) HDR2(JOBS) AND,
VSE JOB COUNT
SELECT(2NDSHIFT) HDR1(2NDSHIFT) HDR2(JOBS) AND,
VSE JOB COUNT
SELECT(3RDSHIFT) HDR1(3RDSHIFT) HDR2(JOBS)
END
RUN
The preceding commands generate a report like the following:
WEEKDAY
--------Monday
Tuesday
Wednesday
Thursday
Friday
--------PERIOD
---------
TOTAL
1STSHIFT
DATE
%CPU
%CPU
-------- -------- -------01/25/04
1.7
1.9
01/26/04
1.0
1.7
01/27/04
0.9
1.2
01/28/04
1.2
1.7
01/29/04
1.0
1.0
-------- -------- -------1.1
1.5
-------- -------- --------
2NDSHIFT
%CPU
-------1.6
0.7
1.1
1.1
0.9
-------1.1
--------
3RDSHIFT TOTAL
1STSHIFT 2NDSHIFT
%CPU
JOBS
JOBS
JOBS
-------- -------- -------- -------0.0
124
53
71
0.6
81
59
22
0.5
330
303
27
0.7
131
67
64
1.0
283
28
17
-------- -------- -------- -------0.7
949
510
201
-------- -------- -------- --------
3RDSHIFT
JOBS
-------0
0
0
0
238
-------238
--------
Shifting a Column to the Right
Use the RIGHT option to shift the column for a variable to the right. The entire
column, including the headings, is shifted.
Chapter 10: Tabular Reports 447
Limiting the Resources Included in a Report
Option Syntax and Operand
RIGHT(n)
Operand
Meaning
n
Number of print columns (spaces) the column is to be shifted
to the right
In the following example, the RIGHT variable option is specified with the
variable VSE DISK SIO to shift the column to the right so that it appears under
the first heading specified with the HEADER command. The HEADER command
is described in the "Commands" chapter.
HEADER(20,26) ----------TOTAL----------HEADER(49,26) --------DISK 0122--------TAB DAY VSE DISK SIO RIGHT(8)
VSE DISK SERVTIME
AND,
AND,
VSE DISK UTILIZATION
AND,
VSE DISK SIO
DISKID(0122) AND,
VSE DISK SERVTIME
DISKID(0122) AND,
VSE DISK UTILIZATION DISKID(0122)
END
RUN
The preceding commands generate a report like the following:
SHIFT NONE
EACH
DAY
PERIOD NONE
WEEKDAY
--------Wednesday
Thursday
Friday
--------PERIOD
---------
----------TOTAL------------------DISK 0122--------SIO
SERVICE DEVICE
SIO
SERVICE DEVICE
COUNT
TIME
%BUSY
COUNT
TIME
%BUSY
---------- -------- -------- ---------- -------- -------386,897 0.004
0.2
3,933 0.020
0.1
541,233 0.004
0.1
8,568 0.015
480,207 0.003
0.2
22,330 0.004
0.1
---------- -------- -------- ---------- -------- -------1,408,337 0.004
0.2
34,831 0.008
0.1
---------- -------- -------- ---------- -------- --------
Limiting the Resources Included in a Report
You can limit a report to a subset of a resource type by specifying one or more
identifiers with an ID option used with the TAB command.
448 Report Reference Guide
Limiting the Resources Included in a Report
The following commands include the ID option DISKID and the identifier 01++
to display data about all disks whose IDs start with 01:
TAB DISKID(01++) VSE DISK SERVTIME
VSE DISK SIO
AND,
AND,
VSE DISK UTILIZATION
END
RUN
The preceding commands generate a report like the following:
DISK SERVICE
SIO
DEVICE
CUU
TIME
COUNT
%BUSY
---- -------- ---------- -------0150 0.069
117
0.3
0151 0.031
105
0.1
0153 0.026
968
0.7
0123 0.026
411
0.1
0121 0.022
1,027,419
8.5
0126 0.020
35
0.0
0122 0.018
272,138
7.3
0152 0.016
12,968
0.2
0125 0.016
1,169
0.2
0124 0.014
1,056
0.2
0120 0.009
89
0.0
---- -------- ---------- -------SUM
0.021
1,316,475
5.4
---- -------- ---------- --------
Limiting Reports Organized by Identifier
Use the FOR operand to limit the number of identifiers included in a report.
Use the OPTION command and set the PRINT parameter to OTHERS to insert a
line in the report that represents all data excluded by the FOR operand.
For example, the following commands are the same as those in the preceding
example except for the addition of the operand FOR 5, which limits the report
to the five disks that begin with 01 with the highest service times, as follows:
TAB DISKID(01++) FOR 5 VSE DISK SERVTIME
VSE DISK SIO
AND,
AND,
VSE DISK UTILIZATION
END
RUN
Chapter 10: Tabular Reports 449
Sorting Reports
The preceding commands generate a report like the following:
DISK SERVICE
SIO
DEVICE
CUU
TIME
COUNT
%BUSY
---- -------- ---------- -------0150 0.069
117
0.3
0151 0.031
105
0.1
0153 0.026
968
0.7
0123 0.026
411
0.1
0121 0.022
1,027,419
8.5
---- -------- ---------- -------SUM
0.022
1,029,020
7.7
---- -------- ---------- --------
Limiting Reports Organized by Time and Date
Use the FOR operand to limit the number of time periods in reports organized
by time and date.
The following commands produce a report limited to the five times with the
highest values for the variable VSE CPU %BUSYV:
TAB DATETIME VSE CPU %BUSYV FOR 5
EACH 1 HOUR
END
RUN
The preceding commands generate a report like the following:
DATE
-------02/22/04
02/22/04
02/22/04
02/22/04
02/22/04
-------PERIOD
--------
TIME
----03.00
04.00
06.00
11.00
15.00
---------
VIRTUAL
%CPU
-------4.2
1.9
2.9
1.6
2.0
-------1.5
--------
Sorting Reports
By default, tabular reports are sorted from left to right with respect to the
variable values, in descending order. The leftmost variable is considered first.
If the value is the same for two entries, the variable to the right is considered.
This continues until variable values differ.
450 Report Reference Guide
Sorting Reports
Consider the following commands and the report they generate:
TAB DISKID VSE DISK SERVTIME AND,
VSE DISK SIO
AND,
VSE DISK UTILIZATION
END
RUN
The preceding commands generate a report like the following:
DISK SERVICE
SIO
DEVICE
CUU
TIME
COUNT
%BUSY
---- -------- ---------- -------0150 0.069
117
0.3
0555 0.047
107
0.1
0551 0.047
15
0.0
0554 0.041
163
0.1
0151 0.031
105
0.1
0351 0.029
299,067
3.4
0350 0.026
267,374
2.7
0153 0.026
968
0.7
0123 0.026
411
0.1
0550 0.023
140,075
2.8
0121 0.022
1,027,419
8.5
0126 0.020
35
0.0
0122 0.018
272,138
7.3
0152 0.016
12,968
0.2
0553 0.016
4,633
0.4
0125 0.016
1,169
0.2
0124 0.014
1,056
0.2
0120 0.009
89
0.0
---- -------- ---------- -------SUM
0.023
2,027,909
3.9
---- -------- ---------- --------
In the preceding report disk 0150 has the highest service time, so it appears
first in the report. Disks 0555 and 0551 have the same service time, but 0555
had more SIOs, so it precedes 0551 in the report.
Sorting Reports by Different Keys
To sort columns by different keys, you can alter the order of the columns.
To create a report similar to the preceding one but showing the disks with the
most SIOs listed first in the report, move the variable VSE DISK SIO so that it
is the first variable in the TAB command, as follows:
TAB DISKID VSE DISK SIO
VSE DISK SERVTIME
AND,
AND,
VSE DISK UTILIZATION
END
RUN
Chapter 10: Tabular Reports 451
Sorting Reports
The preceding commands generate a report like the following:
DISK
SIO
SERVICE DEVICE
CUU
COUNT
TIME
%BUSY
---- ---------- -------- -------0121 1,027,419 0.022
8.5
0351
299,067 0.029
3.4
0122
272,138 0.018
7.3
0350
267,374 0.026
2.7
0550
140,075 0.023
2.8
0152
12,968 0.016
0.2
0553
4,633 0.016
0.4
0125
1,169 0.016
0.2
0124
1,056 0.014
0.2
0153
968 0.026
0.7
0123
411 0.026
0.1
0554
163 0.041
0.1
0150
117 0.069
0.3
0555
107 0.047
0.1
0151
105 0.031
0.1
0120
89 0.009
0.0
0126
35 0.020
0.0
0551
15 0.047
0.0
---- ---------- -------- -------SUM
2,027,909 0.023
3.9
---- ---------- -------- --------
Sorting Reports in Ascending Order
To sort reports in ascending order, add the SORT ASCENDING operand to the
TAB command. The following commands produce a report sorted so that the
disks with the fewest SIOs are listed first in the report:
TAB DISKID VSE DISK SIO SORT ASCENDING AND,
VSE DISK SERVTIME
VSE DISK UTILIZATION
END
RUN
452 Report Reference Guide
AND,
Sorting Reports
The preceding commands generate a report like the following:
DISK
SIO
SERVICE DEVICE
CUU
COUNT
TIME
%BUSY
---- ---------- -------- -------0551
15 0.047
0.0
0126
35 0.020
0.0
0120
89 0.009
0.0
0151
105 0.031
0.1
0555
107 0.047
0.1
0150
117 0.069
0.3
0554
163 0.041
0.1
0123
411 0.026
0.1
0153
968 0.026
0.7
0124
1,056 0.014
0.2
0125
1,169 0.016
0.2
0553
4,633 0.016
0.4
0152
12,968 0.016
0.2
0550
140,075 0.023
2.8
0350
267,374 0.026
2.7
0122
272,138 0.018
7.3
0351
299,067 0.029
3.4
0121 1,027,419 0.022
8.5
---- ---------- -------- -------SUM
2,027,909 0.023
3.9
---- ---------- -------- --------
You can specify the SORT operand with a variable other than the first variable.
For example, the following commands generate a report sorted by disk
utilization, with the third variable specified:
TAB DISKID VSE DISK SIO
VSE DISK SERVTIME
AND,
AND,
VSE DISK UTILIZATION SORT ASCENDING
END
RUN
The preceding commands generate a report like the following:
DISK
SIO
SERVICE DEVICE
CUU
COUNT
TIME
%BUSY
---- ---------- -------- -------0126
35 0.020
0.0
0120
89 0.009
0.0
0551
15 0.047
0.0
0151
105 0.031
0.1
0554
163 0.041
0.1
0555
107 0.047
0.1
0123
411 0.026
0.1
0124
1,056 0.014
0.2
0125
1,169 0.016
0.2
0152
12,968 0.016
0.2
0150
117 0.069
0.3
0553
4,633 0.016
0.4
0153
968 0.026
0.7
0350
267,374 0.026
2.7
0550
140,075 0.023
2.8
0351
299,067 0.029
3.4
0122
272,138 0.018
7.3
0121 1,027,419 0.022
8.5
---- ---------- -------- -------SUM
2,027,909 0.023
3.9
---- ---------- -------- --------
Chapter 10: Tabular Reports 453
Using Other Commands with the TAB Command
Sorting Reports by Identifier
To sort reports by identifier, add the SORT ALPHA operand to the TAB
command.
The following commands generate a report sorted alphanumerically by data
set name:
TAB DSNID FOR 15 SORT ALPHA,
VSE DSN CUU
AND,
VSE DSN VOLSER
AND,
VSE DSN STARTADDR AND,
VSE DSN ENDADDR
AND,
VSE DSN IOTIME
AND,
VSE DSN BUSY
AND,
VSE DSN SIO
AND,
VSE DSN SERVTIME
END
RUN
The preceding commands generate a report like the following:
DSN
DEVICE VOLSER STARTING ENDING TOTAL
PERCENT
DSN
SERVICE
NAME
CUU
ID
CCC-HH
CCC-HH I/O TIME BUSY
SIO
TIME
----------------------- -------- ------ -------- ------- -------- ------- -------- ------AXP.LOG1.KSDS
0351
SYSWK1 124- 02 126- 18 781.9
0.3
25,836
0.030
AXP.LOG1.KSDS.INDX
0351
SYSWK1 126- 20 126- 20 430.1
0.4
12,187
0.035
AXP.LOG3
0351
SYSWK1 277- 00 277- 29 133.1
0.3
1,837
0.072
BU.PDS.MON.BACKUP.FILE
0121
VSE002 201- 00 210- 14 160.6
3.0
5,517
0.029
BU.PDS.VIO.BACKUP.FILE
0121
VSE002 571- 00 584- 04 205.9
10.1
4,415
0.047
CICS.CSD
0351
SYSWK1 292- 00 292- 27
16.67
0.2
381
0.044
CICS.CSD.INDX
0351
SYSWK1 285- 03 285- 03
7.144
0.1
192
0.037
CICS.DUMPA
0351
SYSWK1 264- 00 268- 29
28.03
0.1
499
0.056
CICS.EXPRESS.ARCHIVE
0121
VSE002 215- 14 215- 14
0.655
0.0
40
0.016
CICS.EXPRESS.CONFIG
0121
VSE002 215- 00 215- 13
2.673
0.1
160
0.017
CICS.TD.INTRA
0350
DOSRES
77- 00 77- 24
0.088
0.0
2
0.044
CICSB.DFHDMPA
0351
SYSWK1 414- 11 414- 20
0.055
0.0
1
0.055
CICSB.DFHJ01A
0121
VSE002 345- 05 345- 14
0.052
0.0
2
0.026
CICSB.DFHJ01B
0121
VSE002 346- 00 346- 09
2.194
0.0
39
0.056
CICSB.DFHJ02A
0121
VSE002 347- 05 347- 14
1.842
0.0
40
0.046
----------------------- -------- ------ -------- -------- -------- ------- -------- ------SUMMARY
1771
0.3
51,148
0.035
----------------------- -------- ------ -------- -------- -------- -------- -------- -------
Using Other Commands with the TAB Command
You can use the secondary commands described in the "Commands" chapter
to tailor tabular reports. Examples of the following commands in tabular
reports are given in the following sections:
■
RANGE
■
GROUP
■
COST
454 Report Reference Guide
Using Other Commands with the TAB Command
Tabulating by Ranges
You can use either the RANGE command or the RANGE option to restrict a
report to resources whose activity falls within a specified range. The RANGE
command is explained in further detail in the "Commands" chapter. Examples
of its use in tabular reports are given in the following sections. The RANGE
option, which is valid only for tabular reports, is described in the "Variable
Options" chapter.
The RANGE command can be used to test range criteria either at the record
level (immediate) or, by specifying the DEFERRED operand, just prior to
printing the report (deferred). Immediate range criteria are tested before the
record is processed. If the range criteria are not met, the record is discarded
for that particular report.
Deferred range criteria are not tested until all data is read. The range criteria
are checked just before each row is printed, and if any variable in the row fails
to meet its range criteria, the entire row is discarded.
Immediate Range Criteria
The following commands produce a report about jobs. The RANGE command is
specified without the DEFERRED operand to exclude from the report any
individual record for which the value of VSE DISK IO is greater than 5000.
TAB JOBID VSE JOB COUNT
AND,
VSE STEP COUNT
AND,
VSE STEP CPU
AND,
VSE STEP TCPU
AND,
VSE STEP DURATION
AND,
VSE STEP DURT
AND,
VSE DISK IO
HDR1(DISK)
HDR2(I/Os) AND,
VSE TAPE IO
HDR1(TAPE)
HDR2(I/Os) AND,
VSE OTHER IO HDR1(OTHER) HDR2(I/Os)
RANGE VSE DISK IO 0-5000
END
RUN
Chapter 10: Tabular Reports 455
Using Other Commands with the TAB Command
The preceding commands generate a report like the following:
JOB
JOB
STEP
CPU
TCPU
AVERAGE
TOTAL
DISK
TAPE
OTHER
NAME
COUNT
COUNT
TIME
TIME
DURATION DURATION
I/Os
I/Os
I/Os
-------- -------- -------- -------- -------- -------- -------- ---------- ---------- -------EXPRPT
103
104
8.387
939.3
00:01:03 01:48:49
100,387
22,163
2951
ALT
63
121
0.309
56.86
00:00:47 01:35:37
108,601
50
7440
JCLSCHED
14
14
4.168
946.1
04:13:30 59:09:03
899,080
0
5655
VSOSPLIT
14
14
0.224
3.138
00:00:11 00:02:35
4,379
0
997
AXPU3
12
12
0.068
0.818
00:00:03 00:00:32
770
0
69
OPENTEST
12
12
0.065
0.774
00:00:11 00:02:06
1,004
0
116
CATALR
11
17
0.107
2.563
00:00:11 00:03:00
6,127
0
821
GSPDSU
10
10
3.543
38.97
00:05:15 00:52:32
118,569
0
267
FAQSCIST
9
9
0.310
2.785
00:00:43 00:06:25
2,893
0
253
READ
9
9
0.220
2.197
00:00:15 00:02:13
4,977
0
568
-------- -------- -------- -------- -------- -------- -------- ---------- ---------- -------SUMMARY
257
322
3.242
1993
00:11:52 63:42:52 1,246,787
22,213 19137
-------- -------- -------- -------- -------- -------- -------- ---------- ---------- --------
Deferred Range Criteria
In the preceding example, several jobs with a total number of disk I/Os not in
the specified range are included in the report. Because the RANGE command
was specified without the DEFERRED operand, the test of the number of I/Os
was applied to each individual record, not to the total number of I/Os for each
job. Although individual records with more than 5000 I/Os were excluded, the
total for a given job can exceed the range.
If instead of the preceding report you wanted a report on the jobs that had a
total of fewer than 5000 disk I/Os, you would use the same commands as
those in the previous example but specify the DEFERRED operand with the
RANGE command. This causes the report writer to apply the range criteria only
after all the input data is read, enabling it to determine whether each job had
a total of fewer than 5000 disk I/Os.
TAB JOBID VSE JOB COUNT
AND,
VSE STEP COUNT
AND,
VSE STEP CPU
AND,
VSE STEP TCPU
AND,
VSE STEP DURATION
AND,
VSE STEP DURT
AND,
VSE DISK IO
HDR1(DISK)
HDR2(I/Os) AND,
VSE TAPE IO
HDR1(TAPE)
HDR2(I/Os) AND,
VSE OTHER IO HDR1(OTHER) HDR2(I/Os)
RANGE VSE DISK IO 0-5000 DEFERRED
END
RUN
456 Report Reference Guide
Using Other Commands with the TAB Command
The preceding commands generate a report like the following:
JOB
JOB
STEP
CPU
TCPU
AVERAGE
TOTAL
DISK
TAPE
OTHER
NAME
COUNT
COUNT
TIME
TIME
DURATION DURATION
I/Os
I/Os
I/Os
-------- -------- -------- -------- -------- -------- -------- -------- -------- -------VSOSPLIT
14
14
0.224
3.138
00:00:11 00:02:35
4,379
0
997
AXPU3
12
12
0.068
0.818
00:00:03 00:00:32
770
0
69
OPENTEST
12
12
0.065
0.774
00:00:11 00:02:06
1,004
0
116
FAQSCIST
10
10
0.310
3.096
00:00:40 00:06:37
3,230
0
288
READ
9
9
0.220
2.197
00:00:15 00:02:13
4,977
0
568
-------- -------- -------- -------- -------- -------- -------- -------- -------- -------SUMMARY
57
57
0.173
10.02
00:00:15 00:14:03
14,360
0
2038
-------- -------- -------- -------- -------- -------- -------- -------- -------- --------
Using the RANGE Option
Using the RANGE option yields results identical to those produced by the
RANGE command with the DEFERRED operand.
Option Syntax and Operand
RANGE(list)
Operand
Meaning
list
Specifies the range IDs that correspond to the RANGE
commands for the report. Range IDs in list must be one to eight
characters long and separated by commas.
The following commands are the same as those in the previous example
except that the RANGE command is omitted and the variable VSE DISK IO is
specified with the RANGE option:
TAB JOBID,
VSE JOB
COUNT
AND,
VSE STEP
COUNT
AND,
VSE STEP
CPU
AND,
VSE STEP
TCPU
AND,
VSE STEP
DURATION
AND,
VSE STEP
DURT
VSE DISK
IO
RANGE(0,5000) HDR1(DISK)
HDR2(I/Os) AND,
VSE TAPE
IO
HDR1(TAPE)
HDR2(I/Os) AND,
VSE OTHER IO
AND,
HDR1(OTHER) HDR2(I/Os)
END
RUN
The preceding commands generate a report identical to the previous report.
Chapter 10: Tabular Reports 457
Using Other Commands with the TAB Command
Tabulating by Groups
Use the GROUP command to define groups of resources you want a report to
be about. The GROUP command is explained in further detail in the chapter
"Commands."
You can also include groups in a report by using the OPTION command and
setting the PRINT parameter to GROUP.
The following example uses the GROUP command to define groups by the
VSE/POWER user information ID option, ACUSER. Since each of the group
names begins with a hyphen, the groups can be included in the tabular report
by specifying ACUSER(-*). The ID option ACIDEN(E) causes the data to be
taken from VSE/POWER execution records.
GROUP ACUSER '- COMPILES'(++C*)
GROUP ACUSER '- PRODUCTION JOBS'(++O*)
GROUP ACUSER '- TEST JOBS'(++T*)
TAB ACUSER(-*) ACIDEN(E) HDR1(JOB) HDR2(CLASS),
VSE PACCNT EXJOBCNT
AND,
VSE PACCNT EXJOBCNT PCT HDR1(JOB) HDR2(PCT) AND,
VSE PACCNT EXSTPCNT
AND,
VSE PACCNT EXCPUTM
AND,
VSE PACCNT EXSIO
END
RUN
The preceding commands generate a report like the following:
JOB
JOB
JOB
STEP
CLASS
COUNT
PCT
COUNT
----------------- -------- -------- -------- TEST JOBS
70
47.0
244
- COMPILES
46
30.9
91
- PRODUCTION JOBS
33
22.1
81
----------------- -------- -------- -------SUMMARY
149
100.0
416
----------------- -------- -------- --------
CPU
SIO
TIME
COUNT
-------- -------00:31:08
472K
00:02:10
129K
00:01:18
132K
-------- -------00:34:37
733K
-------- --------
Tabulating by Both Group and Range
You can use the GROUP and RANGE commands together to produce a report
on groups of resources whose activity falls within different ranges.
The following example uses both the GROUP and RANGE commands to define
groups by the VSE/POWER ID option EXPHASE.
458 Report Reference Guide
Using Other Commands with the TAB Command
In this example, eight groups of steps are defined in terms of their CPU usage.
Since each group name begins with CPU, it can be selected in the tabular
report by specifying EXPHASE(CPU*). The ACIDEN(E) ID option causes the
data to be taken from VSE/POWER execution records.
GROUP EXPHASE 'CPU CONSUMED: 0 - 1'(*)
GROUP EXPHASE 'CPU CONSUMED: 1 - 5'(*)
GROUP EXPHASE 'CPU CONSUMED: 5 - 10'(*)
RANGE(CPU0)
RANGE(CPU1)
RANGE(CPU5)
GROUP EXPHASE 'CPU CONSUMED: 10 - 20'(*) RANGE(CPU10)
GROUP EXPHASE 'CPU CONSUMED: 20 - 30'(*) RANGE(CPU20)
GROUP EXPHASE 'CPU CONSUMED: 30 - 40'(*) RANGE(CPU30)
GROUP EXPHASE 'CPU CONSUMED: 40 - 50'(*) RANGE(CPU40)
GROUP EXPHASE 'CPU CONSUMED: 50+'(*)
RANGE(CPU50)
RANGE VSE PACCNT EXCPUTM 0-1 ID CPU0
RANGE VSE PACCNT EXCPUTM 1-5 ID CPU1
RANGE VSE PACCNT EXCPUTM 5-10 ID CPU5
RANGE VSE PACCNT EXCPUTM 10-20 ID CPU10
RANGE VSE PACCNT EXCPUTM 20-30 ID CPU20
RANGE VSE PACCNT EXCPUTM 30-40 ID CPU30
RANGE VSE PACCNT EXCPUTM 40-50 ID CPU40
RANGE VSE PACCNT EXCPUTM 50+ ID CPU50
TAB EXPHASE(CPU*) HDR1(STEP CPU DISTRIBUTION) HDR2(IN SECONDS)
ACIDEN(E) SORT ALPHA,
VSE PACCNT EXSTPCNT AND VSE PACCNT EXSTPCNT PCT
AND,
VSE PACCNT EXCPUTM
AND VSE PACCNT EXCPUTM NXTND AND,
VSE PACCNT EXNLN
AND VSE PACCNT EXNPG
END
RUN
The preceding commands generate a report like the following:
STEP CPU DISTRIBUTION STEP
STEP
CPU
CPU
LINES
PAGES
IN SECONDS
COUNT
%COUNT
TIME
TIME
SPOOLED
SPOOLED
--------------------- -------- -------- -------- -------- ---------- ---------CPU CONSUMED: 0 - 1
549
57.6
00:03:11 191.5
71,169
1,882
CPU CONSUMED: 1 - 5
293
30.7
00:11:01 661.2
418,037
8,760
CPU CONSUMED: 10 - 20
26
2.7
00:06:35 395.6
65,199
1,128
CPU CONSUMED: 20 - 30
11
1.2
00:04:24 264.4
125,280
2,722
CPU CONSUMED: 30 - 40
8
0.8
00:04:35 275.2
52,536
933
CPU CONSUMED: 40 - 50
4
0.4
00:03:00 180.8
26,068
491
CPU CONSUMED: 5 - 10
41
4.3
00:04:58 298.5
203,169
4,495
CPU CONSUMED: 50+
21
2.2
00:29:16
1756
21,961
529
--------------------- -------- -------- -------- -------- ---------- ---------SUMMARY
953
100.0
01:07:03
4023
983,419
20,940
--------------------- -------- -------- -------- -------- ---------- ----------
Chapter 10: Tabular Reports 459
Using Other Commands with the TAB Command
Creating Charge-Back Reports
Use the COST command with the TAB command to create charge-back
reports.
The COST commands in this example define the following cost factors: $10 for
every CPU second used, 10 cents for each tape I/O, and 1 cent per disk I/O.
The TAB command makes use of these cost factors, creating a tabular report
with a column showing the value of each variable for each job. The HDR1 and
HDR2 operands assign those columns appropriate headings. The last variable,
REPORT COST TOTAL, creates a column that shows the sum of the costs for
each row in the report.
COST VSE STEP TCPU 10.00
COST VSE TAPE IO
0.10
COST VSE DISK IO
0.01
*
TAB JOBID VSE JOB
COUNT
AND,
VSE STEP
COUNT
AND,
VSE STEP
DURATIONT
AND,
VSE STEP
DURATION
AND,
VSE STEP
CPU
AND,
VSE STEP
TCPU
VSE STEP
TCPU COST HDR1(CPU)
VSE TAPE
IO
COST HDR1(TAPE-IO) HDR2(COST) AND,
VSE DISK
IO
COST HDR1(DISK-IO) HDR2(COST) AND,
AND,
HDR2(COST) AND,
REPORT COST TOTAL
END
RUN
The preceding commands generate a report like the following:
JOB
JOB
STEP
TOTAL
NAME
COUNT
COUNT
DURATION
-------- -------- -------- -------S1B100
8
13
00:00:59
DYNDIR
7
7
00:00:05
MAINT
6
6
00:00:19
REFRSH
6
6
00:00:18
GSEDIT
5
5
00:01:15
ALERT
4
6
00:01:02
.
.
.
.
.
.
.
.
.
.
.
.
-------- -------- -------- -------SUMMARY
96
371
-------- -------- -------- --------
AVERAGE
CPU
TCPU
CPU
TAPE-IO
DISK-IO
TOTAL
DURATION TIME
TIME
COST
COST
COST
COST
-------- -------- -------- ---------- -------- ---------- -----------00:00:04 0.090
1.165
$11.65
$0.00
$24.07
$35.71
00:00:00 0.022
0.156
$1.56
$0.00
$6.46
$8.01
00:00:03 0.095
0.569
$5.69
$0.00
$8.50
$14.18
00:00:03 0.144
0.863
$8.63
$0.00
$8.29
$16.92
00:00:15 0.314
1.571
$15.71
$0.00
$34.32
$50.02
00:00:10 0.048
0.289
$2.89
$0.00
$14.27
$17.15
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
-------- -------- -------- ---------- -------- ---------- -----------$1,725.84 $195.70
$970.51
$2,892.04
-------- -------- -------- ---------- -------- ---------- ------------
Creating Reports on GETVIS Usage
GETVIS information is logged by CA Explore PM for z/VSE and can be used to
display GETVIS usage by partition, job, or step.
460 Report Reference Guide
Using Other Commands with the TAB Command
The following commands produce a report on GETVIS usage by job:
TAB JOBID FOR 30 VSE GETVIS USED
AND,
VSE GETVIS MAXUSED
AND,
VSE GETVIS %USED
AND,
VSE GETVIS MAX%USED
END
RUN
The preceding commands generate a report like the following:
JOB
GETVIS
MAX
%GETVIS
NAME
USED
GETVIS
USED
-------- -------- -------- -------VTAMSTRT
2671k
2696k
90.9
SLL310
2595k
2764k
75.6
JCLSCHED
1116k
1992k
57.2
CICSMROB
797k
1068k
40.8
CICSMROA
709k
1080k
38.7
EVSEIBAT
707k
888k
35.5
XXX/VTAM
660k
660k
33.2
SYSTEM
612k
680k
42.1
EXPCDEV
592k
592k
31.8
EXPRPT
493k
3976k
28.0
XXXMON
427k
512k
23.0
FAQSCICI
356k
356k
9.3
FAOXSFN
344k
356k
9.0
FAQSCICW
336k
336k
8.8
S1FILEX2
247k
336k
27.3
TESTG02
238k
252k
17.1
VAIDCOP
235k
316k
28.8
FAQSCICP
225k
344k
8.9
IDCPRT
196k
204k
20.0
TESTGUX
188k
188k
5.1
GSAOGEM
186k
312k
4.9
SARUFN
182k
212k
11.9
GSLJCLUF
181k
204k
4.6
$SARCMA$
174k
200k
11.4
VSOANLYZ
171k
176k
11.1
IPWPOWER
166k
248k
35.8
SARDATCL
165k
180k
3.0
VSOSPLIT
159k
340k
26.3
PLMDATCL
157k
276k
9.1
ISMDLI
152k
152k
30.2
-------- -------- -------- -------SUMMARY
945k
0
51.0
-------- -------- -------- --------
MAX
%GETVIS
-------91.3
79.3
99.8
52.6
56.0
44.3
33.2
46.8
31.8
100.0
26.2
9.3
9.3
8.8
37.8
17.3
38.7
9.0
20.8
5.1
8.2
13.9
39.7
13.1
19.5
53.4
3.2
36.2
18.1
30.2
-------0.0
--------
The following commands produce a report on GETVIS usage by partition. This
type of report can be helpful in determining if certain partitions are overallocated or under-allocated.
TAB PID
VSE GETVIS USED
AND,
VSE GETVIS MAXUSED
AND,
VSE GETVIS %USED
AND,
VSE GETVIS MAX%USED
END
RUN
Chapter 10: Tabular Reports 461
TAB2 Reports
The preceding commands generate a report like the following:
PART GETVIS
MAX
%GETVIS
ID
USED
GETVIS
USED
---- -------- -------- -------F3
2659k
2696k
91.0
FB
2521k
2764k
75.6
F7
1040k
1992k
57.3
F5
704k
888k
35.4
F2
673k
1080k
37.5
AR
612k
680k
42.2
F4
319k
1068k
20.6
F9
284k
820k
25.3
F6
259k
660k
24.2
F1
164k
248k
35.7
FA
118k
824k
18.1
BG
106k
3976k
9.5
F8
68k
720k
27.5
---- -------- -------- -------SUM
586k
3976k
43.8
---- -------- -------- --------
MAX
%GETVIS
-------91.3
79.3
99.8
44.3
56.0
46.8
52.6
43.9
33.2
53.4
44.1
100.0
78.6
-------100.0
--------
TAB2 Reports
Examples of the following command and operands used in TAB2 reports are
given in the following sections:
■
TAB2 command
■
FOR operand
■
DATE, TIME, DAY, or DATETIME operand
■
Creating TAB2 Reports on GETVIS Usage
462 Report Reference Guide
Chapter 11: Plot Reports
The Plot Reports, plot the value of a variable for a group of resources either
against time or against another variable. This chapter describes and gives
examples of how to generate plot reports using the following commands:
PLOT, PLOT2, VPLOT, VPLOT2, MPLOT, HPLOT
Plot reports fall into three categories:
■
Horizontal plot reports—Generated by the PLOT and PLOT2 commands,
plot a variable horizontally across time.
■
Vertical plot reports—Generated by the VPLOT, VPLOT2, and MPLOT
commands, plot a variable vertically across time.
■
Distribution plot reports—Generated by the HPLOT command used with
either the VPLOT or the MPLOT command, plot one variable on the vertical
axis and another on the horizontal axis.
For more information about report writer commands, see the chapter
"Commands."
This section contains the following topics:
Using Data from Other CA Explore PM for z/VSE Systems (see page 463)
Horizontal Reports (PLOT and PLOT2) (see page 464)
PLOT2 Command (see page 470)
Vertical Reports (VPLOT, VPLOT2, and MPLOT) (see page 470)
Distribution Plot Reports (MPLOT) (see page 489)
Horizontal Reports (HPLOT) (see page 496)
Using Data from Other CA Explore PM for z/VSE Systems
If in addition to CA Explore PM for z/VSE, you run CA Explore PM for CICS, you
can produce plot reports containing data collected by both the CA Explore PM
for z/VSE systems.
To use more than one type of CA Explore PM for z/VSE variable, you must use
the INPUT command to tell the report writer to read input data from flashback
or log files from each CA Explore PM for z/VSE system whose data you want to
use. For more information about INPUT command, see the chapter
"Commands."
Chapter 11: Plot Reports 463
Horizontal Reports (PLOT and PLOT2)
Horizontal Reports (PLOT and PLOT2)
This section describes operands and sample commands, and provides sample
output for the reports generated by the PLOT and PLOT 2 commands.
PLOT Command
Use the PLOT command to produce reports that plot statistics about resources
for one or more time periods.
The command syntax and operands are as follows:
The syntax of the PLOT command is as follows:
PLOT variable [options] [ALONE] [SCALE({n},{mX})] [CHAR1(x)]
[CHAR2(x)]
Operands for the PLOT command are shown in the following table:
Operand
Meaning
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID option you
specify must include at least one identifier.
ALONE
Prevents the display of the global (system-wide) value of the
variable. To use this operand, you must restrict the variable
with an ID option.
SCALE(n)
By default, the highest value of a plot's horizontal axis equals
the highest value reached by a variable in the plot or, for
variables representing percentages, 100%.
or
SCALE(mX)
or
SCALE(n,mX)
To override this dynamic scale, specify n as the maximum
value. If the variable that you choose produces integers, n
must be an integer.
In some cases, bar graphs in a plot report will be too short to
appear. To display these graphs, you can cause each plot
character to appear as m characters by specifying the
multiplier mX, where m is an integer. Since the resulting bar
graphs will no longer correspond numerically to the scale,
this is useful only for determining relative performance.
CHAR1(x)
464 Report Reference Guide
Sets the plot character that represents the restricted
variable. Replace x with any valid EBCDIC character.
Horizontal Reports (PLOT and PLOT2)
Operand
Meaning
CHAR2(x)
Sets the plot character that represents the global variable.
Replace x with any valid EBCDIC character.
Creating a Simple PLOT Report
To create a simple plot report, use the PLOT command followed by a variable
to be plotted.
For example, the following commands produce a plot of disk activity, with each
detail line representing a half hour, for part of a single day:
PLOT VSE DISK SIO
EACH 30 MINUTES
FROM 03/05/04 10:00:00
TO
03/05/04 14:00:00
END
RUN
The preceding commands generate a report like the following:
SHIFT NONE
EACH
30 MINUTES
PERIOD NONE
01/25/99 10.00.00
10.30.00
11.00.00
11.30.00
12.00.00
12.30.00
SUMMARY:
RANGE:
SYMBOLS:
"X" =
DEVICE SIO COUNT
0
2943
5886
8830
11773
14717
17660
20603
23547
26490
29434
X
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.-------------------------.
.
.
.
.
.
.
.
7703
.--------------------------------------------------------------.
.
.
.
18586
.---------------------------------------------------------------------------------------------------29434
.---------------------------------------------------.
.
.
.
.
15161
.-----------------------.
.
.
.
.
.
.
.
7071
.-----------------------------.
.
.
.
.
.
.
8935
.
.
.
.
.
.
.
.
.
.
. SUMMARY:
.-------------------------------------------------.
.
.
.
.
.
14481
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
2943
5886
8830
11773
14717
17660
20603
23547
26490
29434
X
-
DEVICE SIO COUNT
"-" =
GLOBAL DEVICE SIO COUNT
Using ID Options in Plot Reports
To plot the performance of one or more individual resources (such as jobs,
disks, or channels), follow the variables to be plotted with an ID option
together with a list of one or more identifiers (such as jobnames or disk IDs).
You can use generic characters to specify a group of identifiers.
Chapter 11: Plot Reports 465
Horizontal Reports (PLOT and PLOT2)
The following PLOT command includes the variable VSE DEVICE SIO, followed
by the ID option DISKID and the identifier 022B to produce a plot of SIO
counts for disk 022B:
PLOT VSE DISK SIO DISKID(022B)
EACH 30 MINUTES
FROM 01/25/04 10:00:00
TO
01/25/04 14:00:00
END
RUN
The preceding commands generate a report like the following. Along with the
SIO counts for disk 022B (plotted with Xs), the SIO counts for all disks are
plotted with hyphens, enabling you to easily compare the two.
SHIFT NONE
EACH
30 MINUTES
PERIOD NONE
01/25/99 10.00.00
10.30.00
11.00.00
11.30.00
12.00.00
12.30.00
SUMMARY:
RANGE:
SYMBOLS:
"X" =
DEVICE SIO COUNT
0
2943
5886
8830
11773
14717
17660
20603
23547
26490
29434
X
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.X------------------------.
.
.
.
.
.
.
.
337 7703
.XX------------------------------------------------------------.
.
.
.
549 18586
.XX-------------------------------------------------------------------------------------------------708 29434
.---------------------------------------------------.
.
.
.
.
133 15161
.XXXXX------------------.
.
.
.
.
.
.
. 1535 7071
.XXXXX------------------------.
.
.
.
.
.
. 1584 8935
.
.
.
.
.
.
.
.
.
.
. SUMMARY:
.XXX----------------------------------------------.
.
.
.
.
.
807 14481
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
2943
5886
8830
11773
14717
17660
20603
23547
26490
29434
X
-
DEVICE SIO COUNT
"-" =
GLOBAL DEVICE SIO COUNT
Excluding Global Values from a Plot
Use the ALONE operand to plot the activity of one or more identifiers without
including a plot of global activity in the report.
Suppose you want to plot the SIO counts for disk 022B, but you do not want
to plot the SIOs counts for all disks, you can use the same commands as in
the previous example but add the ALONE operand, as follows:
PLOT VSE DISK SIO DISKID(022B) ALONE
EACH 30 MINUTES
FROM 01/25/04 10:00:00
TO
END
RUN
466 Report Reference Guide
01/25/04 14:00:00
Horizontal Reports (PLOT and PLOT2)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
30 MINUTES
PERIOD NONE
01/25/04 10.00.00
10.30.00
11.00.00
11.30.00
12.00.00
12.30.00
SUMMARY:
RANGE:
SYMBOLS:
"X" =
DEVICE SIO COUNT
0
158.4
316.8
475.2
633.6
792.0
950.4
1108
1267
1425
1584
X
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
337
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
549
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
708
.XXXXXXXX .
.
.
.
.
.
.
.
.
.
133
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX . 1535
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 1584
.
.
.
.
.
.
.
.
.
.
. SUMMARY:
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
807
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
158.4
316.8
475.2
633.6
792.0
950.4
1108
1267
1425
1584
X
DEVICE SIO COUNT
Changing a Plot's Scale
By default, the highest value of a plot's scale equals the highest value reached
by a variable in the plot or, for variables representing percentages, 100%.
Use the SCALE operand to set your own scale.
If the variable you are plotting yields integer values, you must specify an
integer value with the SCALE operand. If the variable yields real values, the
scale you specify must include a decimal point.
To change the maximum value of the scale, used in the preceding example, to
3,000, add the SCALE(3000) operand, as follows:
PLOT VSE DISK SIO DISKID(022B) ALONE SCALE(3000)
EACH 30 MINUTES
FROM 01/25/04 10:00:00
TO
01/25/04 14:00:00
END
RUN
Chapter 11: Plot Reports 467
Horizontal Reports (PLOT and PLOT2)
These commands generate a report like the following:
SHIFT NONE
EACH
30 MINUTES
PERIOD NONE
01/25/04 10.00.00
10.30.00
11.00.00
11.30.00
12.00.00
12.30.00
SUMMARY:
RANGE:
SYMBOLS:
"X" =
DEVICE SIO COUNT
0
300
600
900
1200
1500
1800
2100
2400
2700
3000
X
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXX
.
.
.
.
.
.
.
.
.
337
.XXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.
549
.XXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
708
.XXXX
.
.
.
.
.
.
.
.
.
.
133
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
. 1535
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
. 1584
.
.
.
.
.
.
.
.
.
.
. SUMMARY:
.XXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
807
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
300
600
900
1200
1500
1800
2100
2400
2700
3000
X
DEVICE SIO COUNT
Specifying the Characters in a Plot
Use the CHAR1 operand to specify the character used to plot the resource
specified by an ID option. Use the CHAR2 operand to specify the character
used to plot global activity.
The following commands plot the number of SIOs for channel 01 using the
character 1 and the total number of SIOs for all channels using Xs:
PLOT VSE DISK SERVTIME DISKID(01++) CHAR1(1) CHAR2(X)
EACH HOUR
FROM 03/05/04 08:00:00
TO
END
RUN
468 Report Reference Guide
03/05/04 16:00:00
Horizontal Reports (PLOT and PLOT2)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
HOUR
PERIOD NONE
DEVICE I/O SERVICE TIME
03/05/04 08.00.00
09.00.00
10.00.00
11.00.00
12.00.00
13.00.00
14.00.00
15.00.00
SUMMARY:
RANGE:
SYMBOLS:
"1" =
0
0.003
0.006
0.009
0.012
0.015
0.018
0.021
0.024
0.027 0.030
+.........+.........+.........+.........+.........+.........+.........+.........+.........+......+
.
.
.
.
.
.
.
.
.
.
.
.1111111111111111111111111111111111111111111111111111111111111111111111XXXXXXX .
.
.
.1111111111111111111111111111111111111111111111111111111111111111111111XXXXXXXXXXXXXXXXX .
.
.111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111
.
.11111111111111111111111111111111111111111111111111111111111111111111111111111111
.
.
.1111111111111111111111111111111111111111111111111111111111111111111XXX
.
.
.
.111111111111111111111111111111111111111111111111111111111111111XXXXXXX
.
.
.
.1111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111
.
.
.
.
.
.
.
.
.
.
.
.1111111111111111111111111111111111111111111111111111111111111111111 .
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+......+
0
0.003
0.006
0.009
0.012
0.015
0.018
0.021
0.024
0.027 0.030
DEVICE I/O SERVICE TIME
"X" =
1
X
0.000 0.000
0.021 0.023
0.021 0.026
0.027 0.025
0.024 0.024
0.020 0.021
0.019 0.021
0.030 0.027
SUMMARY:
0.020 0.020
1
X
GLOBAL DEVICE I/O SERVICE TIME
Converting Counts to Rates
Use the RATE option to plot a rate (number per second) rather than a count.
The following commands plot the SIO rate for disk 022B against the total
system SIO rate:
PLOT VSE DISK SIO DISKID(022B) RATE
EACH 30 MINUTES
FROM 01/25/04 10:00:00
TO
01/25/04 14:00:00
END
RUN
The preceding commands generate a report like the following:
SHIFT NONE
EACH
30 MINUTES
PERIOD NONE
01/25/04 10.00.00
10.30.00
11.00.00
11.30.00
12.00.00
12.30.00
SUMMARY:
RANGE:
SYMBOLS:
"X" =
DEVICE SIO COUNT
0
1.64
3.27
4.91
6.54
8.18
9.82
11.45
13.09
14.72 16.36
X
+.........+.........+.........+.........+.........+.........+.........+.........+.........+......+
.XX-----------------------------------------------.
.
.
.
. 0.36 8.20
.XX------------------------------------------------------------.
.
.
. 0.31 10.34
.XX----------------------------------------------------------------------------------------------- 0.39 16.36
.---------------------------------------------------.
.
.
.
. 0.07 8.43
.XXXXX------------------.
.
.
.
.
.
.
. 0.85 3.93
.XXXXX------------------------.
.
.
.
.
.
. 0.88 4.97
.
.
.
.
.
.
.
.
.
.
. SUMMARY:
.XXX-------------------------------------------------.
.
.
.
. 0.47 8.70
+.........+.........+.........+.........+.........+.........+.........+.........+.........+......+
0
1.64
3.27
4.91
6.54
8.18
9.82
11.45
13.09
14.72 16.36
X
-
DEVICE SIO COUNT
"-" =
GLOBAL DEVICE SIO COUNT
Chapter 11: Plot Reports 469
PLOT2 Command
PLOT2 Command
Use the PLOT2 command with the PLOT command to plot the performance of
two variables side-by-side to see if a cause-and-effect relationship exists
between them.
You cannot use the PLOT2 command without the PLOT command.
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
This section discusses operands and sample commands, and provides sample
output for the vertical reports generated by the VPLOT, VPLOT 2, and MPLOT
commands.
VPLOT Command
Use the VPLOT command to produce reports that plot resource usage in
vertical columns. The horizontal axis of the plot represents time.
Option Syntax and Operands
The syntax of the VPLOT command is as follows:
VPLOT var [options] [SCALE({n},{mX})] [STACK=id] [CHAR1(x)] [HDR1(txt)]
[HDR2(txt)] [HDR(txt)] [CYLINDER] [XDSN]
The operands for the VPLOT command have the following meanings:
Operand
Meaning
var
Any report writer variable.
options
Any valid variable options or ID options. Each ID option you
specify must include at least one identifier.
SCALE(n)
By default, the highest value of a plot's vertical axis equals
the highest value reached by a variable in the plot or, for
variables representing percentages, 100%.
or
SCALE(mX)
or
SCALE(n,mX)
To override this dynamic scale, specify n as the maximum
value. If the variable that you choose produces integers, n
must be an integer.
You can also widen each plot column by using the multiplier
mX, where m is an integer.
STACK=id
470 Report Reference Guide
Replaces the plot character with the identifiers being
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
Operand
Meaning
plotted, from most active to least active starting at the
bottom of the graph. You can specify the mX option of the
SCALE operand to print more characters of each identifier.
CHAR1(x)
Sets the plot character. Replace x with any valid EBCDIC
character.
HDR1(txt)
Overrides the default top heading for the scale to the left of
the plot. Replace txt with the new heading. To remove the
header, replace txt with a null string, as in HDR1().
HDR2(txt)
Overrides the default bottom heading for the scale to the
left of the plot. Replace txt with the new heading. To
remove the header, replace txt with a null string, as in
HDR2().
HDR(txt)
Overrides the default description beside the SYMBOLS:
heading that describes the plotted variables. Replace txt
with the new description, not to exceed 30 characters.
CYLINDER
Changes the horizontal axis from time to cylinders. This
option is valid only when plotting disk seeks.
XDSN
Prints extended data set information after the plot. This
option is valid only when plotting disk seeks.
Creating a Simple VPLOT Report
The following commands plot device service time between 10:00 a.m. and
10:00 p.m.:
VPLOT VSE DEVICE SERVTIME
EACH 30 MINUTES
FROM 03/05/04 10:00:00
TO
03/05/04 22:00:00
END
RUN
Chapter 11: Plot Reports 471
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
30 MINUTES
DEVICE I/O SERVICE TIME
PERIOD NONE
SERVICE
SERVICE
TIME
TIME
--------------0.032
I
X
I 0.032
I
X
I
I
X
I
I X
X
I
I X
X
I
0.028
I X
X
I 0.028
I X X
X
I
I X X
X
I
I X X X
X
I
I X X X
X
I
0.024
I X X X
X
I 0.024
I X X X
X X
I
AI-XXX-X----X-X----------------------------------------------------------------------------------------------- I
I XXXXX X X X
I
IXXXXXXXX X X
XX X X
I
0.020
IXXXXXXXX X X
XX X X
I 0.020
IXXXXXXXXXXXXX XXXX X X
I
IXXXXXXXXXXXXXXXXXXX X X
I
IXXXXXXXXXXXXXXXXXXX X X
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
0.016
IXXXXXXXXXXXXXXXXXXXXXXXX
I 0.016
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
0.012
IXXXXXXXXXXXXXXXXXXXXXXXX
I 0.012
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
0.008
IXXXXXXXXXXXXXXXXXXXXXXXX
I 0.008
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
0.004
IXXXXXXXXXXXXXXXXXXXXXXXX
I 0.004
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
I
0.000
II---------I---------I---------I---------I---------I---------I---------I---------I-------I---------I---------II 0.000
10:00
15:00
20:00
03/05
03/05
03/05
SYMBOLS:
"X" = DEVICE I/O SERVICE TIME
472 Report Reference Guide
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
Using the SCALE(mX) Operand
The following commands are the same as those in the previous example
except for the addition of the SCALE(3X) operand, which widens the resulting
plot.
VPLOT VSE DEVICE SERVTIME SCALE(3X)
EACH 30 MINUTES
FROM 03/05/04 10:00:00
TO
03/05/04 22:00:00
END
RUN
Chapter 11: Plot Reports 473
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
30 MINUTES
DEVICE I/O SERVICE TIME
PERIOD NONE
SERVICE
SERVICE
TIME
TIME
-------------0.032
I
XXX
I 0.032
I
XXX
I
I
XXX
I
I
XXX
XXX
I
I
XXX
XXX
I
0.028
I
XXX
XXX
I 0.028
I
XXX
XXX
XXX
I
I
XXX
XXX
XXX
I
I
XXX
XXX
XXX
XXX
I
I
XXX
XXX
XXX
XXX
I
0.024
I
XXX
XXX
XXX
XXX
I 0.024
I
XXX
XXX
XXX
XXX
XXX
I
AI---XXXXXXXXX---XXX------------XXX---XXX----------------------------------------------------------------------I
I
XXXXXXXXXXXXXXX
XXX
XXX
XXX
I
IXXXXXXXXXXXXXXXXXXXXXXXX
XXX
XXX
XXXXXX
XXX
XXX
I
0.020
IXXXXXXXXXXXXXXXXXXXXXXXX
XXX
XXX
XXXXXX
XXX
XXX
I 0.020
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXXXXXXXXXXX
XXX
XXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXX
XXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXX
XXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
0.016
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I 0.016
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
0.012
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I 0.012
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
0.008
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I 0.008
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
0.004
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I 0.004
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
0.000
II---------I---------I---------I---------I---------I---------I---------I-------I---------I---------I---------II 0.000
10:00
11:30
13:00
15:00
16:30
18:00
20:00
21:30
03/05
03/05
03/05
03/05
03/05
03/05
03/05
03/05
SYMBOLS:
"X" = DEVICE I/O SERVICE TIME
474 Report Reference Guide
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
Using the SCALE(n) Operand
The following example uses the SCALE(0.050) operand to plot device service
time with a maximum scale value of 0.050 seconds. The CHAR1 operand
specifies D as the plot character.
VPLOT VSE DEVICE SERVTIME SCALE(0.050) CHAR1(D)
EACH 30 MINUTES
FROM 03/05/04 10:00:00
TO
03/05/04 22:00:00
END
RUN
Chapter 11: Plot Reports 475
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
30 MINUTES
PERIOD NONE
SERVICE
TIME
DEVICE I/O SERVICE TIME
SERVICE
TIME
-------0.050
I
I 0.050
I
I
I
I
I
I
I
I
0.044
I
I 0.044
I
I
I
I
I
I
I
I
0.038
I
I 0.038
I
I
I
I
I
I
I
I
0.032
I
D
I 0.032
I
D
I
I D
D
I
I D
D
I
I D D
D
I
0.026
I D D D
D
I 0.026
I D D D
D
I
I D D D
D D
I
AI-DDD-D----D-D----------------------------------------------------------------------------------------------- I
I DDDDD D D D
I
0.020
IDDDDDDDDDDDDD DDDD D D
I 0.020
IDDDDDDDDDDDDDDDDDDD D D
I
IDDDDDDDDDDDDDDDDDDD D D
I
IDDDDDDDDDDDDDDDDDDDDDDDD
I
IDDDDDDDDDDDDDDDDDDDDDDDD
I
0.014
IDDDDDDDDDDDDDDDDDDDDDDDD
I 0.014
IDDDDDDDDDDDDDDDDDDDDDDDD
I
IDDDDDDDDDDDDDDDDDDDDDDDD
I
IDDDDDDDDDDDDDDDDDDDDDDDD
I
IDDDDDDDDDDDDDDDDDDDDDDDD
I
0.008
IDDDDDDDDDDDDDDDDDDDDDDDD
I 0.008
IDDDDDDDDDDDDDDDDDDDDDDDD
I
IDDDDDDDDDDDDDDDDDDDDDDDD
I
IDDDDDDDDDDDDDDDDDDDDDDDD
I
IDDDDDDDDDDDDDDDDDDDDDDDD
I
0.000
II---------I---------I---------I---------I---------I---------I---------I---------I---------I-------I---------II 0.000
10:00
15:00
20:00
03/05
03/05
03/05
SYMBOLS:
"D" = DEVICE I/O SERVICE TIME
476 Report Reference Guide
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
Using the SCALE(n,mX) Operand
You can use both the n and mX parameters of the SCALE operand together.
The following commands plot device service time with a maximum scale value
of 0.050 seconds, with the plot tripled in width:
VPLOT VSE DEVICE SERVTIME SCALE(0.050,3X)
EACH 30 MINUTES
FROM 03/05/04 10:00:00
TO
03/05/04 22:00:00
END
RUN
Chapter 11: Plot Reports 477
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
30 MINUTES
DEVICE I/O SERVICE TIME
PERIOD NONE
SERVICE
SERVICE
TIME
TIME
--------------0.050
I
I 0.050
I
I
I
I
I
I
I
I
0.044
I
I 0.044
I
I
I
I
I
I
I
I
0.038
I
I 0.038
I
I
I
I
I
I
I
I
0.032
I
XXX
I 0.032
I
XXX
I
I
XXX
XXX
I
I
XXX
XXX
I
I
XXX
XXX
XXX
I
0.026
I
XXX
XXX
XXX
XXX
I 0.026
I
XXX
XXX
XXX
XXX
I
I
XXX
XXX
XXX
XXX
XXX
I
AI---XXXXXXXXX---XXX------------XXX---XXX---------------------------------------------------------------------- I
I
XXXXXXXXXXXXXXX
XXX
XXX
XXX
I
0.020
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXXXXXXXXXXX
XXX
XXX
I 0.020
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXX
XXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XXX
XXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
0.014
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I 0.014
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
0.008
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I 0.008
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
IXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
I
0.000
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I--------II 0.000
10:00
11:30
13:00
15:00
16:30
18:00
20:00
21:30
03/05
03/05
03/05
03/05
03/05
03/05
03/05
03/05
SYMBOLS:
"X" = DEVICE I/O SERVICE TIME
Creating Seek Analysis Reports
To create seek analysis reports, you must have CA Explore PM for z/VSE
monitor your disk devices by setting the monitor option on the Configure
DASD panel to Y. For more information about setting the value of this option,
see the Online User Guide.
478 Report Reference Guide
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
To create a seek analysis report, use the VPLOT command together with:
■
The variable VSE DISK SEEKS.
■
The ID option VOLSER. For a report on all active disk devices, use this ID
option without identifiers. To limit the report to certain disk devices,
specify the ID option and identifiers VOLSER(volumes), where volumes is
one or more volume serial numbers, separated by commas. You can use
generic characters when specifying these identifiers.
■
The CYLINDER operand, which alters the horizontal scale from time to
cylinder addresses.
■
The XDSN operand, which prints extended data set information. This
operand is optional.
Creating Plots for Multiple Time Periods
The EACH and PERIOD commands are ignored for seek analysis reports. To
create plots for different time frames, you must run each as a separate report,
using the FROM and TO commands to specify the time period.
The following commands produce a seek analysis report on the volume
SYSWK1:
VPLOT VSE DISK SEEKS VOLSER(SYSWK1) CYLINDER XDSN
END
RUN
Chapter 11: Plot Reports 479
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
The preceding commands generate a report like the following two-page report:
480 Report Reference Guide
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
DEVICE 3350
VSCALE 1483
HSCALE 6
SEEK
COUNT
-------51897
I
I
I
I
I
44484
I
I
I
I
I
37070
I
I
I
I
I
29657
I
I
I
I
I
22243
I
I
I
I
I
14830
I
I
I
I
I
7416
I
I
I
I
IX
O
I
000
SYSWK1 – 0351
SEEK COUNTS
SEEK
COUNT
--------
B
G
G
G
G
G
FG
FG
FG
FG
FG
FG
FG
FG
FG
FG
FG
FG
E EEFG
HH
060
120
180
AB CD EEEEEEEEFGHHHHHHHH
SYMBOLS:
"X" = SEEK COUNTS
B - UNKN.38-20.38-28
0038-0038 I E - VSE.PRD2.LIBRARY
0074-0123 J F - VSE.PRD2.LIBRARY
*0074-0123 K G - AXP.LOG1.KSDS
*0126-0126 L H - VSE.PRD2.LIBRARY
0131-0180 M -
A
B
C
D
E
F
F
F
F
G
G
G
G
H
I
I
I
J
K
L
M
-
DEVVSE.VTAM.TRACE.FILE
UNKN.38-20.38-28
UNKN.56-00.58-19
CICSMROA.JOURNAL.FILE
VSE.PRD2.LIBRARY
VSE.PRD2.LIBRARY
AXP.LOG1.KSDS
UNKN.124-19.124-24
AXP.LOG1.KSDS
AXP.LOG1.KSDS
AXP.LOG1.KSDS
AXP.LOG1.KSDS.INDX
UNKN.130-02.130-29
VSE.PRD2.LIBRARY
VSESP.USER.CATALOG
VSESP.USER.CATALOG.INDX
VSESP.USER.CATALOG
CICS.DUMPA
AXP.LOG3
CICS.CSD.INDX
CICS.CSD
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
240
K
N
N
N
I
300
IJ KLMN
I
360
VSESP.USER.CATALOG
CICS.DUMPA
AXP.LOG3
CICS.CSD.INDX
CICS.CSD
333856627474124124124126126126130131260263263264277285292-
25
20
00
01
00
00
02
19
21
05
15
20
02
00
00
18
21
00
00
03
00
34385862123123124124124126126126130180263263263268277285292-
R R R
R R R
R RR R RR
RRRR R RRRR R
RRRRR RRRRRRRR
QRRRRRRRRRRRRRRR
QRRRRRRRRRRRRRRR
PXQRRRRRRRRRRRRRRR
PXQRRRRRRRRRRRRRRR
PXQRRRRRRRRRRRRRRRX
I
I
I
420
480
540
OP QRRRRRRRRRRRRRRR S TTTT
*0260-0263
0264-0268
0277-0277
0285-0285
0292-0292
09
28
19
29
29
29
05
24
24
06
18
20
29
29
17
20
29
29
29
03
27
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
N
P
Q
R
T
001015
001160
001680
001861
002220
002220
003722
003739
003741
003785
003795
003800
003902
003930
007800
007908
007911
007920
008310
008553
008760
-
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
UNKN.295-18.296-27
*0295-0296
VSE.DOC.HARDCOPY.FILE
0406-0409
CICSB.DFHDMPA
*0414-0414
VSE.POWER.DATA.FILE
0416-0510
DOS.PAGING.FILE.FF4006899 0529-0553
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
001029
001168
001759
001889
003719
003719
003725
003744
003744
003786
003798
003800
003929
005429
007907
007910
007919
008069
008339
008553
008787
REPORT
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
1
PAGE 2
15
9
80
29
1500
1500
4
6
4
2
4
1
28
1500
108
3
9
150
30
1
28
Chapter 11: Plot Reports 481
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
N
N
N
O
P
Q
Q
R
S
T
-
UNKN.295-18.296-27
UNKN.297-21.297-29
SYSWK1.VTOC
NICK.SCRATCH.GSAUDIT.RESET.DEVVSE
VSE.DOC.HARDCOPY.FILE
CICSB.DFHDMPA
VSE.POWER.DATA.FILE
VSE.POWER.DATA.FILE
VSE.RECORDER.FILE
DOS.PAGING.FILE.FF4006899021
295297298399406414416416521529-
18
21
00
00
15
11
00
00
00
00
296297298400409414510510521553-
27
29
29
29
14
20
29
29
29
29
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
RTA
S=
S=
S=
S=
S=
S=
S=
S=
S=
S=
008868
008931
008940
011970
012195
012431
012480
012480
015630
015870
E=
E=
E=
E=
E=
E=
E=
E=
E=
E=
008907
008939
008969
012029
012284
012440
015329
015329
015659
016619
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
TRKS=
40
9
30
60
90
10
2850
2850
30
750
The seek analysis report displays the following information:
■
The first line of the report displays the device type and, if you do not
specify a title with the TITLE3 command, the disk's volume serial number
and address. The plot's vertical and horizontal scale intervals are displayed
beneath the device type.
■
The vertical axis represents the number of seeks to the disk. Seek counts
are also shown numerically on each side of the plot.
■
The horizontal axis represents the cylinders on the disk.
■
The 15 most active data sets on the disk are assigned a letter, identified
beneath the plot. The data set's starting and ending cylinders are shown
beside the data set's name. An asterisk preceding a starting cylinder
number indicates that more than one data set resides in the cylinder
range.
■
The letter assigned to each data set is used to plot the number of seeks to
that data set, and the line below the horizontal scale shows graphically the
location of the data set on the disk.
To represent cylinder blocks with a two-digit number, include the command
OPTION(SEEKCHAR=NUMERIC) in your report commands. For more
information on the OPTION command, see the chapter "Commands." If you
specified the XDSN operand, the following information is displayed after the
plot:
For CKD devices:
■
Data set name
■
Starting and ending ccc-hh address
■
Starting and ending relative track address
■
Number of tracks the data set occupies
482 Report Reference Guide
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
For FBA devices:
■
Data set name
■
Cylinder in which the data set starts and ends
■
Starting and ending block number
■
Number of blocks the data set occupies
Seek Analysis Report on a Range of Cylinders
Use the RANGE command to produce a seek analysis report on a specified
range of cylinders.
The following commands produce a seek analysis report on cylinders 000-200
on the volume DOSRES:
VPLOT VSE DISK SEEKS VOLSER(DOSRES) CYLINDER
RANGE VSE DISK CYLINDER 000-200
END
RUN
Chapter 11: Plot Reports 483
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
The preceding commands generate a report like the following:
DEVICE 3350
DOSRES - 0350
VSCALE 1127
SEEK COUNTS
HSCALE 2
SEEK
SEEK
COUNT
COUNT
--------------39429
I
B
I
I
B
I
I
B
I
I
B
I
I
B
I
33797
I
B
I
I
B
I
I
B
I
I
B
I
I
B
I
28164
I
B
I
I
B
I
I
B
I
I
B
I
I
B
I
22532
I
B
I
I
B
I
I
B D
I
I
B D
I
I
B D
I
16899
I
B D
I
I
B D
I
I
B D
I
I
B D
I
I
B D
I
11267
I
B D
I
I
B D
I
I
B D
I
I
BCD
I
I
BCD
I
5634
I
BCD
M
I
I
A
BCD
M
I
IA
A
BCD
M
I
IA
A
BCD
K
M
I
IA
AAA A
A
BCD
F
J K
M
P
P I
0
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I-I
000
020
040
060
080
100
120
140
160
180
200
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABCD
EFGHI J K
LM NNO
PPPPPPPPPPPPPPPPPP
SYMBOLS:
"X" = SEEK COUNTS
A - VSE.SYSRES.LIBRARY
0000-0061 F - VSE.MESSAGES.ONLINE.INDX *0076-0076 K - UNKN.92-10.92-18
*0092-0092
B - VSE.POWER.QUEUE.FILE
0063-0063 G - UNKN.79-08.79-20
0079-0079 M - DOSRES.VTOC
0145-0145
C - VSAM.MASTER.CATALOG
0064-0066 H - VSE.MESSAGES.ONLINE
0081-0081 N - FAQS.MESSAGE.FILE
0151-0154
D - VSAM.MASTER.CATALOG.INDX *0066-0066 I - UNKN.82-06.82-21
*0082-0082 O - FAQS.MESSAGE.FILE.INDX
0155-0155
E - VSE.MESSAGES.ONLINE
0074-0076 J - UNKN.87-04.88-25
0087-0088 P - VSE.PRD1.LIBRARY
0164-0200
Using the STACK Operand
Use the STACK=id operand with the VPLOT command to replace the plot
character with the identifiers being plotted, from most active to least active
starting at the bottom of the plot. You can specify the mX option of the SCALE
operand to print more characters of each identifier.
484 Report Reference Guide
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
The following commands create a vertical plot of CPU usage. The STACK=PID
operand specifies that partition IDs are to be plotted, and the SCALE(2X)
operand widens each plot column to two characters so the entire partition ID
can be printed.
VPLOT VSE STEP %TCPU STACK=PID SCALE(2X)
FROM 12/06/03 07.00.00
TO
12/06/03 20.00.00
EACH 15 MINUTES
END
RUN
The preceding commands generate a report like the following:
%USED
CPU
---100.0
%USED
CPU
-------I
I 100.0
I
F7 G1
I
I
FBF9L3F8
I
I
C1
F7FBF8L3
I
I
F2F2
F8C1G1C1
I
87.5
I
F7F7C1
N1ARF8F7AR
I
87.5
I
C1F7C1F8F7 C1F2
F2L3L3C1BG
BG
I
I
F8F2F8ARF8F2F8F6
F8L2ARARBG
FA
I
I
FBC1ARL3ARF7F7F8
F7L2L2BGBGF7 C1
I
I
ARF8L2L3ARF8L3F7
C1L2L2BGFBC1 ARL3
I
75.0
I
ARARL2L3FBL3ARC1 C1L3L2L2FBFBF6 E1C1
AR
I
75.0
I
L3ARL2L3FBARARL3 F7ARL2L2FBFBAR L2AR
AR
L1
I
I
L3FBL3L2L2ARL2AR F8FBL2L2L1FBFB L2L2
L2
C1
I
I
FBL2FBL3L2L2L2L2AR ARFBL2L2L1FBL2 L2L2
L1
C1
I
I
F6L2L3L3L2L2L2L2FB ARFBL1L2L1L2L2 L1L2BG L1C1
ARL2
I
62.5
I
F2L2L3FBL2L2L2L2FB L3L2L1L2L1L2L2 L1L1AR FBF6
L1L2
I
62.5
I
F8L2L2FBL2L3L2L1L2 L3L2L1L1L1L2L1 L1L1FB FBAR
L2FBL1
I
I
F7L2L2FBFBL3L1L1L2 E1L2L1L1L1L2L1 L1L1L1 FBL1
AR
L2FBF9
I
AIF2------ARL2L2FBFBL3L1L1L2E1E1L2L1L1L1L2L1--L1FBL1--FBL1------F5----FBFBC1FB------------------------------- I
IF8
ARE1L1L1FBL3L1L1L1F2FBL2L1L1L2L1L1 FBFBL1C1FBFB
L1
FBFBARC1
I
50.0
IBG
L3E1L1L1FBL3L1L1L1C1FBL2L1L1L2L1L1 FBFBL2ARFBFB
N1
FBFBL2AR
I
50.0
IL3
F2L3E1L1L1FBL3L1L1L1F8FBL2L1L1L2L1E1 FBFBL2L1FBFB
N1
N1FBL2L1
I
IAR
FBL2E1L1L1L1L3L1L1L1F7FBL1L1L1L2L1E1 FBFBL2L1FBFB
FB
N1N1FBL2
I
IL2F2 F8L2E1L1L1L1E1L1L1L1L3FBL1E1L1L2L1E1 FBFBE1FBFBFB
FB
N1N1FBL2
F5
I
IL2FA F7E1E1L1L1L1E1L1L1L1FBL2L1E1L1L2L1E1 FBFBE1FBE1FB
FAFB
N1N1FBFA
AR
I
37.5
IE1F6F2E1E1E1L1L1L1E1L1L1L1ARL2L1E1L1L2L1E1 FBFBE1L2E1FB
ARFB
N1N1FBFA
FA
I
37.5
IE1F8F8ARE1E1L1L1L1E1L1L1L1ARL2L1E1E1E1E1E1F9FBFBE1L2E1E1
FBFB
N1N1FBN1
G1
I
IE1FBE1ARE1E1E1L1L1E1E1E1L1L2L2L1E1E1E1E1E1C1FBFBE1E1E1E1A
1FB L1N1N1N1N1F9 FBF5
I
IE1E1L3L3E1E1E1L1L1E1E1E1L1L2L2L1E1E1E1E1E1ARFBFBE1E1E1E1F5 N1FB F5N1N1N1N1AR FBAR
BG
I
IE1ARARL3L1L1E1E1L1E1E1E1E1L1L1L1E1E1E1E1E1L2FBE1E1E1E1E1FB N1FB FBN1N1N1N1L1 FBFA
FB
I
25.0
IE1L2FBL2L1L1E1E1L1E1E1E1E1L1L1L1E1E1E1E1E1E1FBE1E1E1E1E1L1 N1FBFAN1N1N1N1N1FBL1FBG1
AR
I
25.0
IE1L2FBL2L1L1E1E1E1L1E1E1E1L1L1E1E1E1E1E1E1E1FBE1E1E1E1E1L1 N1FBL1N1N1N1N1N1FBARFBFB
F7FA F3 FA
I
IL1L2L2L1L1L1E1E1E1L1E1E1E1L1L1E1E1E1E1E1E1FBFBE1E1E1E1E1E1 N1FBN1N1N1N1N1N1L2FAFBFB
BGF4 FA F4AR
I
IL1L1L2L1L1L1E1E1E1L1E1E1E1L1L1E1E1E1E1E1E1FBFBE1E1E1E1E1E1 N1FBF5N1N1N1N1N1L2G1FBFB
F9C1E1 F4FBE1C1
I
IL1L1L1L1L1L1E1E1E1L1E1E1E1L1L1E1E1E1E1E1E1FBFBE1E1E1E1E1E1 N1FBF5N1N1N1N1N1N1L2FBFBL1F5L1F1F6BGE1F4FBE1
I
12.5
IL1L1L1L1L1L1E1E1E1L1E1E1E1L1L1E1E1E1E1E1E1L1FBE1E1E1E1E1E1ARN1FBFBN1N1N1N1N1N1L2FBFBF5ARARF4F6F7ARARARFA
I
IL1L1L1L1L1L1E1E1E1L1E1E1E1L1L1E1E1E1E1E1E1L1FBE1E1E1E1E1E1F9N1FBFBN1N1N1N1N1N1FBFBFBF3FBE1F6F6E1G1F3L1F3
I
12.5
IL1L1L1L1L1L1E1E1E1L1E1E1E1L1L1E1E1E1E1E1E1L1FBE1E1E1E1E1E1FAN1FBFBN1N1N1N1N1N1FBFBFBFBL1G1ARF6ARL1L1L1L1
I
IL1L1L1L1L1L1E1E1E1L1E1E1E1L1L1E1E1E1E1E1E1L1FBE1E1E1E1E1E1FBN1FBFBN1N1N1N1N1N1FBFBFBFBF3FBFAF6FAL1L1L1L1
I
IL1L1L1L1L1L1E1E1E1L1E1E1E1L1L1E1E1E1E1E1E1L1FBE1E1E1E1E1E1L1N1FBFBN1N1N1N1N1N1FBFBFBFBF4FBE1F6F4L1L1L1L1
I
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I------II
07:00
08:15
09:30
10:45
12:00
13:15
14:30
15:45
17:00
18:15
19:30
12/06
12/06
12/06
12/06
12/06
12/06
12/06
12/06
12/06
12/06
12/06
SYMBOLS:
"X" = PCT OF USED CPU OVER TIME INTERVAL (TIMER)
Chapter 11: Plot Reports 485
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
VPLOT2 Command
Use the VPLOT2 command with the VPLOT command to plot a second variable
directly over the first one, allowing you to compare the performance of two
variables to see if a cause-and-effect relationship exists between them.
You cannot use the VPLOT2 command without the VPLOT command.
Option Syntax and Operands
The syntax of the VPLOT2 command is as follows:
VPLOT2 variable [options] [SCALE({n},{mX},{COMMON})] [CHAR1(x)] [HDR1(text)]
[HDR2(text)] [HDR(text)]
The operands for the VPLOT2 command are the same as for the VPLOT
command except that the VPLOT2 command does not support the CYLINDER,
XDSN, or STACK operands, and it does support the COMMON option of the
SCALE operand. Specify SCALE(COMMON) if you want the same scale to be
used to plot both variables.
The operands for the VPLOT2 command are the same as for the VPLOT
command except that it does not support the and it does support the COMMON
option of the SCALE operand. Specify SCALE(COMMON) if you want the same
scale to be used to plot both variables.
For more information about the other VPLOT2 operands, see descriptions of
the VPLOT operands in the chapter "Commands."
Creating a Simple VPLOT2 Report
The following example uses the VPLOT and VPLOT2 commands to plot both job
and step counts.
VPLOT
VSE JOB
COUNT SCALE(25) CHAR1(X)
VPLOT2 VSE STEP COUNT SCALE(25) CHAR1(O)
EACH 30 MINUTES
FROM 03/04/04 00:00:00
TO
END
RUN
486 Report Reference Guide
03/06/04 00:00:00
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
The preceding commands generate a report like the following, except that in
the sample report the letter E appears where a Ä symbol would appear in the
actual report:
SHIFT NONE
EACH
30 MINUTES
JOB EXECUTION COUNT
PERIOD NONE
JOB
STEP
COUNT
COUNT
-------------25
I
I
25
I
I
I
I
I
I
I
I
22
I
I
22
I
E
I
I
E
I
I
O
E
I
I
O
E
I
19
I
O
E
I
19
I
O
E
O
I
I
O
E
O
I
I
O
E
O
I
I
O
OO
O
E
E
I
16
I
O
OO
O
E
E
I
16
I
O
EO
O
E O EO
I
I
O
EO
O
E O EO
I
I
O
EO O
O
E O EO
I
I
O
EE O
O
E E EE
I
13
I
O
EE O
O
E E XX
I
13
I
O
EE O
O
E E EE
I
I
O
EE O
O
E E EE
I
I
E
EE E
O
O
O
E E EE
I
I
E
EE E X EXOEO
E
O
E E E EE
I
1O
I
E
EE E X EXOEO
E
O
E E E EE
I
10
I
E O
X
EE EOE EXOEE
E
O
OO E E EOOEE
I
I
E O
X
EE EOE EXOEE
E
O
OO E E EOOEE
I
I
E E
E
EE EEEEEEOEE
E
O
OO E EOEOOEE
I
IO
E EE
E
EE EEEEEEEEE
E
O
OOOE EEEOEEE
I
7
IO
E EE
E
EE EEEEEEEEE
E
O
OOOE EEEOEEE
I
7
IE
E EE
E
EE EEEEEEEEE
E
O
OEEE EEEEEEEO EO
I
IE
E EE
E
EE EEEEEEEEE
E
O
OEEE EEEEEEEO EO
I
IE---------------E-EE--OEO---EE-EEEEEEEEE---E------------------XE-----EEEEOEEEEEEEO--EE------------------------IA
AIE-------------O-E-EE-EEEOE--EE-EEEEEEEEE-O-E------------------EE----EEEEEEEEEEEEEE--EE---O--------------------I
4
IE
O E EE EEEOE EE EEEEEEEEE O E
EE
EEEEEEEEEEEEEE EE
O
I
4
IE
O
O O E EE EEEEEEEEEOEEEEEEEEE EEE
EE
EEEEEEEEEEEEEE OEE O E O O O
I
IE
O
O O E EE EEEEEEEEEOEEEEEEEEE EEE
EE
EEEEEEEEEEEEEE OEE O E O O O
I
IE O O O E OEE E E EEOEEEEEEEEEEEEEEEEEEEEEEE O O
EE
EEEEEEEEEEEEEEEEEE E E E E E
I
IE E E E E EEEXEEE EEEEEEEEEEEEEEEEEEEEEEEEEE E EE
EE
EEEEEEEEEEEEEEEEEE E E E E EE
I
0
II---------I---------I----------I---------I---------I---------I---------I---------I---------I---------I-------II
0
00:00
05:00
10:00
15:00
20:00
01:00
06:00
11:00
16:00
21:00
03/04
03/04
03/04
03/04
03/04
03/05
03/05
03/05
03/05
03/05
SYMBOLS:
"X" = JOB EXECUTION COUNT
"O" = STEP EXECUTION COUNT
Chapter 11: Plot Reports 487
Vertical Reports (VPLOT, VPLOT2, and MPLOT)
Using the SCALE(mX) Operand
The following commands plot the number of SIOs and disk service time. The
SCALE(2X) operands cause both plots to be doubled in width.
VPLOT
VSE DISK SIO
SCALE(2X) CHAR1(X)
VPLOT2 VSE DISK SERVTIME SCALE(2X) CHAR1(O)
EACH 30 MINUTES
FROM 03/05/04 10:00:00
TO
END
RUN
488 Report Reference Guide
03/06/04 10:00:00
Distribution Plot Reports (MPLOT)
The preceding commands generate a report like the following, except that
where the letter E appears in the sample report, a Ä symbol would appear in
the actual report:
SHIFT NONE
EACH
30 MINUTES
DEVICE SIO COUNT
PERIOD NONE
SIO
SERVICE
COUNT
TIME
--------------75040
I
XX
OO
OO
I 0.034
I
XX
OO
OO
I
I
XX
OO
OO
I
I
XX
OO
OO
I
I OO
XX
OO
OO
I
65660
I OO
XX
OO
OO
I 0.030
I OO
XX
OO
OO
I
I OO
XX
OO
OO
I
I OO OO XX
OO
OO
OO
I
I OO OO XX
OO
OO
OO
I
56280
I OO OO XX
OO
OO
OO
I 0.026
I OO OO XX
OO
OO
OO
I
I OO OO EE
OO OO
OO
OO
I
---------I--OO--OO--EE--------OOXXOO------------------------------OO--------------------------OO--OO -------------------IA
I OOOOOO EE
OO OOEEOO
OO OO
OOOOOO OO
I
46900
I OOOOOO EE
OO OOEEOO
OO OO
OOOOOO OO
I 0.002
IOOOOOOOOOOEE OOOO OOEEOO
OO
OO OO
OOOOOO OO
I
IOOOOOOOOOOEEOOOOOO OOEEOO
OOOO
OO OO
OO OO OO
OO
OO OOOOOO OOOO
I
IOOOOOOOOOOEEOOOOOOOOOOEEOO OOOOOOOOOOOOOOO OO OO OO OO OO OO
OO OO OO OOOOOOOOOOOO
I
IOOOOOOOOOOEEOOOOOOOOOOEEOOOOOOOOOOOOOOOOOOO OO OO OO OO OO OO
OO OOOOOO OOOOOOOOOOOO
I
37520
IOOOOOOEEOOEEOOOOOOOOEEEEOOOOOOOOOOOOOOOOOOO OO OO OO OO OO OO
OO OOOOOO OOOOOOOOOOOO
I 0.018
IOOOOOOEEOOEEOOOOOOOOEEEEOOOOOOOOOOOOOOOOOOO OO OO OO OO OO OO
OO OOOOOOOOOOOOOOOOOOOO
I
IOOOOOOEEOOEEOOOOOOOOEEEEOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
I
IOOOOOOEEEEEEOOOOOOOOEEEEOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
I
IOOOOOOEEEEEEEEEEOOOOEEEEOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
I
28140
IOOOOOOEEEEEEEEEEOOOOEEEEOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOEEOO
I 0.014
IOOOOOOEEEEEEEEEEOOOOEEEEOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOEEOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOEEOO
I
IOOOOOOEEEEEEEEEEOOOOEEEEOOOOOOOOOOOOOOOOOOOEEOOOOOOOOOEEOOOOOOOOOOOOOEEOOOOOOOOOOOOOOOOOOOOOEEOO
I
IOOEEOOEEEEEEEEEEOOOOEEEEOOOOOOOOOOOOOOOOOOOEEOOOOOOOOOEEOOOOOOOOOOOOOEEOOOOOOOOOOOOOOOOOOOOOEEOO
I
IOOEEOOEEEEEEEEEEEEOOEEEEOOOOOOOOOOOOOOOOOOOEEOOOOOOOOOEEOOOOOOOOOOOOOEEOOOOOOOOOOOOOOOOOOOOOEEOO
I
18760
IOOEEEEEEEEEEEEEEEEOOEEEEOOOOOOOOOOOOOOOOOOOEEOOOOOOOOOEEOOOOOOOOOOOOOEEOOOOOOOOOOOOOOOOOOOOOEEOO
I
IOOEEEEEEEEEEEEEEEEOOEEEEOOOOOOOOOOOOOOOOOOOEEOOOOOOOOOEEOOOOOOOOOOOOOEEOOOOOOOOOOOOOOOOOOOOOEEOO
I
AIOOEEEEEEEEEEEEEEEEOOEEEEOOOOOOEEOOOOOOOOOOOEEOOOOOOOOOEEOOOOOOOOOOOOOEEOOOOOOOOOOOOOOOOOOOOOEEOO--------------I
IOOEEEEEEEEEEEEEEEEEEEEEEOOOOOOEEEEOOOOOOOOOEEOOOOOOOOOEEOOOOOOOOOOOOOEEOOOOOOOOOOOOOOOOOOOOOEEOO
I
IEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEOOOOOOOOOEEOOOOOOOOOEEOOOOOOOOOOOEEEEOOOOOOOOOOOOOOOOOOOOOEEOO
I
9380
IEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEOOEEOOOOOEEOOEEOOEEOEEOOOEEOOEEOOEEEEOOEEEEEEOOOOOOOEEEEEEEEOO
I 0.006
IEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEOOEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEOOOOEEEEEEEEEEEOO
I
IEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEOOEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEOOEEEEEEEEEEEEOO
I
IEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEOOEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEOOEEEEEEEEEEEEOO
I
IEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE
I
0
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I---------II 0.000
10:00
12:30
15:00
17:30
20:00
22:30
01:00
03:30
06:00
08:30
03/05
03/05
03/05
03/05
03/05
03/05
03/06
03/06
03/06
03/06
SYMBOLS:
"X" = DEVICE SIO COUNT
"O" = DEVICE I/O SERVICE TIME
Distribution Plot Reports (MPLOT)
This section discusses operands and sample commands, and provides sample
output for the distribution reports generated by the MPLOT command.
Chapter 11: Plot Reports 489
Distribution Plot Reports (MPLOT)
MPLOT Command
Use the MPLOT command to produce a vertical plot similar to that produced by
the VPLOT command, except that only the outline of the columns is printed.
The MPLOT command allows you to request multiple variables on the same
report.
Option Syntax and Operands
The syntax of the MPLOT command is as follows:
MPLOT variable [options] [SCALE({n},{mX})] [CHAR1(x)] [HDR1(text)] [HDR2(text)]
[HDR(text)]
[AND, variable [options] [SCALE({n},{mX})] [CHAR1(x)] [HDR1(text)]
[HDR2(text)] [HDR(text)]] [AND,...]
The operands for the MPLOT command have the following meanings:
Operand
Meaning
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID option you
specify must include at least one identifier.
SCALE(n)
By default, the highest value of a plot's horizontal axis is set
to the highest value of the plotted variables. For variables
that represent percentages, the default maximum value is
100%.
or
SCALE(mX)
or
SCALE(n,mX)
To override this dynamic scale, specify n as the maximum
value. If the variable that you choose produces integers, n
must be an integer. You cannot use more than three digits to
the right of the decimal point when specifying n.
You can also widen the outline of the plot by using the
multiplier mX, where m is an integer.
CHAR1(x)
Sets the plot character. Replace x with any valid EBCDIC
character.
HDR1(text)
Overrides the default top heading for the scale of the plot.
Replace text with the new heading. To remove the header,
replace text with a null string, as in HDR1().
HDR2(text)
Overrides the default bottom heading for the scale of the
plot. Replace text with the new column heading. To remove
the header, replace text with a null string, as in HDR2().
HDR(text)
Overrides the default description beside the SYMBOLS:
heading that describes the plotted variables. Replace text
490 Report Reference Guide
Distribution Plot Reports (MPLOT)
Operand
Meaning
with the new description, not to exceed 30 characters.
AND,
Signals that another variable will be specified. The variable
will be plotted on top of the preceding variables. The comma
after AND lets you continue to the next line.
Using One Variable
The following example uses the MPLOT command to plot GETVIS usage:
MPLOT VSE GETVIS USED
EACH 15 MINUTES
FROM 03/04/04 00:00:00
TO
03/05/04 00:00:00
END
RUN
Chapter 11: Plot Reports 491
Distribution Plot Reports (MPLOT)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
15 MINUTES
GETVIS USED
PERIOD NONE
GETVIS
GETVIS
USED
USED
------------1337K I
X
I
1337K
I
X
I
I
XX
X
I
I
XX
X
I
I
X
XX
X
I
1170K I
X
XX
X
I
1170K
I
X
XX
X
I
I
X
XX
X
X
I
I
X
XX
X
X
X
X X X XX XXX X X
I
I
XX
X
XX
X
X
X
X X X XX X X X X
I
1003K I
X
XX
X
XX
X
X
X
X X X XX X X X X
I
1003K
I
XX XXX XX XX XX
XX
X
XX
X
X
X
X X X XX X X X X
I
I XXX XXX XXX X X X X XX XX XX
XX
X
XX
X
X
X
X X X XX X X X X
I
I X X X X X X X X X X XX XX XX
XX
X X X
XX
X
X
X
X X X XX X X X X
I
I X X X X X X X X X X XX XX XX
XX
X X X
XX X
X
X
X
X X X XX X X X X
I
836K I X X X X X X X X X X XX XX XX
XX
X X X
XX XX
X
X
X
X X X XX X X XXX
I
836K
I X X X X X X X X X X XX XX XX
XX
X X X
XX XX
X
X
X
XX X X XX X X X X
I
I X X X X X X X X X X XX XX XX
XX
XXX X
XX XX
X
X
X
XX X X X X X X X X
I
I X X X X X X X X X X XX X X XX
XX
X X XXX
XX XX
XX
X
X
XX X X X X
X X
I
I X X X X X X X X X X XX X X X X XX
X X X X
X X X
XX
X X
X
X XX X X X
X
I
669K AI-X-X-X-X-X-X-X-X-X-X-XX--X-X-X-X--XX---X--X---XX-X---X----XX---X-X---X-----X-X-X-XXX-X---------X------------ I
669K
I X X X X X X X X X X XX X X X X XX
X
X X
X
XX
X X
XX
X X X X X X
X
I
I X X X X X X X X X X XX X X X X XX
X
X X
X
XX
X XX XX X X X X X X X
X
I
I X X X X X X X X X X XX X X X X XX
X
X X
X
XX X X X X XX X X X X X X X
X
I
I X X
X X X X X X X X X X X XX X X
X
X
XX X X X X XX X X X
X X X
X
I
502K I X
X X X
X X X X X XX XX
X X XX XXX X X XX X
X X
X
I
502K
I X
X X
X X X X X XX X
XX X X X X X X X
X
X
I
I X
X
X X X X XX X
X X
X X X X
X
I
I X
X
X XX X
X
X X X X
X
I
I X
X X X
X
X
X
I
335K I X
X X
X
I
335K
I X
X X
X
I
IX
X X
X
I
I
X X
X
I
I
X X
X
I
168K I
X
X
I
168K
I
X
I
I
X
I
I
X
I
I
X
I
0
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I-------II
0
00:00
02:30
05:00
07:30
10:00
12:30
15:00
17:30
20:00
22:30
03/04
03/04
03/04
03/04
03/04
03/04
03/04
03/04
03/04
03/04
SYMBOLS:
"X" = GETVIS USED
492 Report Reference Guide
Distribution Plot Reports (MPLOT)
Using Multiple Variables
The following example uses the MPLOT command to plot the number of disk
SIOs with Xs and disk service time with Os.
MPLOT VSE DISK SIO
SCALE(50000,2X) CHAR1(X) AND,
VSE DISK SERVTIME SCALE(0.040,2X) CHAR1(O)
EACH 30 MINUTES
FROM 03/05/04 10:00:00
TO
03/06/04 10:00:00
END
RUN
Chapter 11: Plot Reports 493
Distribution Plot Reports (MPLOT)
The preceding commands generate a report like the following, except that in
the sample report, where the letter E appears, a Ä symbol would appear in the
actual report:
SHIFT NONE
EACH
30 MINUTES
DEVICE I/O SERVICE TIME
PERIOD NONE
SIO
SERVICE
COUNT
TIME
-------50000
I
+
+
I 0.040
I
XX
XX
I
I
XX
XX
I
I
XX
XX
I
I
XX
XX
I
43750
I
XX
XX
I 0.035
I
XX
OOXX
OO
I
I
XX
OOXX
OO
I
I
XX
OOXX
OO
I
I
XX
OOXX
OO
I
37500
I OO XX XX
EE X
OO
I 0.030
I OO XX XX
EO X
OO
I
I OO XX XX
EO X
OO
I
I OO EE XX
EO X
OO
OO
I
I OO EE XX
EO X
OO
OO
I
31250
I OOXXOOXXOE XX
EO X
OO
OO
I 0.025
I OOX OO OOXX X
EO XOO
OO
OO
I
I--OOX-OO--OO---X----EO-XOO------------------------------OO--------------------------OO--OO--XX--------------- IA
I O EO O OO
XOO E OE O
OO OO
O OO O EE
I
IOO X
OO O OX O X X O
OO
OO OO
O
O EE
I
O
O
25000
I
X
OO X O E X O
OOOO
OO OO
EE OO OO
OO
OO O
O EXOO
I 0.020
I
X
X 00X X O OOOO
OO EE OO
OO EE OO OO
EE OO OO O
OOXX O
I
I XX
X
X X OO
O EE OO OO OO EE OO OO
EE O OO O O
XX O
I
I X
X
X X
O EE OO OO O OOXE O OO O OOOOXE O
OO
XX O
I
I X
XX X X
OOXXOO OO OO
XXOO
OO
XXOO
XX O
I
18750
IXX
X X X
XX
XX
XX
XX O
I 0.015
I
X X X
XX
XX
XX
XX O
I
AI-----------------X--X--X-----------------XX--------------XX--------------XX------XX-----------XX O------------I
I
X X X
XX
XX
XX
XX
XX O
I
I
X X
XX
XX
XX
XX
XX
XX
XX O
I
12500
I
XX
X
X XX
XX
XX
XX
XX X
XX O
I 0.010
I
X XX
X
XX
XX
XX
X X
XX O
I
I
XX
X XX
XX XX XX XX XX
XX
XX XX
X
XX O
I
I
X XX
XX XX XX XX XX XX XX XX XX X
X
XX O
I
I
X X
XX XX XX XX XX XX XX X XX X XX
XX
XX O
I
6250
I
X X
XX XX
X
XX O
I 0.005
I
X X
X
XX X O
I
I
X X
XX XX
X O
I
I
X X
X X
X O
I
I
XX
XX
XE
I
0
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I--------II 0.000
10:00
12:30
15:00
17:30
20:00
22:30
01:00
03:30
06:00
08:30
03/05
03/05
03/05
03/05
03/05
03/05
03/06
03/06
03/06
03/06
SYMBOLS:
"X" = DEVICE SIO COUNT
"O" = DEVICE I/O SERVICE TIME
494 Report Reference Guide
Distribution Plot Reports (MPLOT)
The following commands are the same as those in the preceding example
except for the addition of a third variable, VSE CPU BUSY, which will be plotted
with plus signs (+):
MPLOT VSE DISK SIO
SCALE(50000,2X) CHAR1(X) AND,
VSE DISK SERVTIME SCALE(0.040,2X) CHAR1(O) AND,
VSE CPU BUSY
SCALE(2X)
CHAR1(+)
EACH 30 MINUTES
FROM 03/05/04 10:00:00
TO
03/06/04 10:00:00
END
RUN
Chapter 11: Plot Reports 495
Horizontal Reports (HPLOT)
The preceding commands generate a report like the following, except that
where the letter E appears in the sample report, a Ä would appear in the
actual report:
SHIFT NONE
EACH
30 MINUTES
CPU ACTIVE TIME
PERIOD NONE
SIO
SERVICE
CPU
COUNT
TIME
ACTIVE
--------------- -------50000
I
+
+++
I 0.040 00:04:26
I
XX
++XX
I
I
XX
++XX
I
I
XX
++XX
I
I
XX
++XX
I
43750
I
XX
++XX
I 0.035 00:03:53
I
XX
00XX
OO
I
I
XX
00XX
OO
I
I
XX
00XX
OO
I
I
XX
00XX
OO
I
37500
I OO XX XX
EE X
OO
I 0.030 00:03:20
I OO XX XX
E0 X
OO
I
I OO XX XX
E0 X
OO
I
I OO EE XX
E0 X
OO
OO
I
I OO EE XX
E0 X
OO
OO
I
31250
I OOXXOOXXOE XX
E0 X
OO
OO
I 0.025 00:02:46
I OOX OO OOXX X
E0 XOO
OO
OO
I
I--OOX-OO--OO---X----E0-XOO------------------------------OO--------------------------OO--OO--XX------IA
I O EO O 00
XOO E+OE O
OO OO
O OO O EE
I
IOO X
OO+0 OE O E+ X O
OO
OO OO
O
O EE
I
25000
I
X
++OO X O E +E O
OOOO
OO OO
EE OO OO
OO
OO O
O EXOO
I 0.020 00:02:13
I
X
++
X OOE E O OOOO
OO EE OO
OO EE OO OO
EE OO OO O
OOXX
I
I XX
++
X
E E OO
O EE OO OO OO EE OO OO
EE O OO O O
XX
I
I X
++
X
E E
O EE OO OO O OOXE O OO O OOOOXE O
OO
XX O
I
I X
++
XX E E
OOXXOO OO OO
XXOO
OO
XXOO
XX O
I
18750
IXX
++
X E E
XX
XX
XX
XX O
I 0.015 00:01:40
I
++
++
X E E
XX
XX
XX
XX O
I
AI----+-++--++-----X--E--E----------------XX--------------XX--------------XX------XX----------XX-O----I
I
+ + ++
X E E
XX
XX
XX
XX
XX O
I
I
+ + ++
X E +XX
XX
XX
XX
XX
XX
XX O
I
12500
I
+ + ++
XX+ + X
X XX
XX
XX
XX
XX X
XX O
I 0.010 00:01:07
I
+ + + ++++
+ + X XX
X
XX
XX
XX
X X
XX O
I
I
+ + +
+
+ + XX
X XX XX XX XX XX XX
XX
XX XX
X
XX O
I
I
+ + +
+
+ +
X XX XX XX XX XX XX XX XX XX XX X
X
XX O
I
I ++
++
++ + +
+X X XX XX XX XX XX XX X XX X XX XX
XX
XX O
I
6250
I++---------------+--+--+--------+X--X-------------------------XX--XX---------------X--------XX-0----I 0.005 A00:00:33
I
++
+
++ X X
++
++
++ X
XX+X O
I
I
++ ++
X X
++
++
++
++ + XX XX +X O
I
I
++
X X+ ++ ++ ++ ++ ++ ++ ++ ++ ++ ++
++ X X+++ X O
I
I
XX ++ ++ ++ ++ ++ ++ ++ ++ ++ ++
++XX
XE
I
0
II---------I---------I---------I---------I---------I---------I---------I---------I---------I-------III 0.000 00:00:00
10:00
12:30
15:00
17:30
20:00
22:30
01:00
03:30
06:00
08:30
03/05
03/05
03/05
03/05
03/05
03/05
03/06
03/06
03/06
03/06
SYMBOLS:
"X" = DEVICE SIO COUNT
"O" = DEVICE I/O SERVICE TIME
"+" = CPU ACTIVE TIME
Horizontal Reports (HPLOT)
The following section discusses operands and sample commands and provides
sample output for HPLOT reports.
496 Report Reference Guide
Horizontal Reports (HPLOT)
HPLOT Command
Use the HPLOT command to plot the distribution of one variable based on the
value of another variable. The variable you specify with the HPLOT command
is plotted along the horizontal axis. The second variable, specified with either
the VPLOT or the MPLOT command, is plotted vertically.
You cannot use the HPLOT command without either the MPLOT or VPLOT
command. The HPLOT command must follow the MPLOT or VPLOT command.
To set the plot character for an HPLOT report, specify the CHAR1 operand with
the MPLOT or VPLOT command.
Option Syntax and Operands
The syntax of the HPLOT command is as follows:
HPLOT variable [options] [SCALE(n)] [SCATTER]
The operands for the HPLOT command have the following meanings:
Operand
Meaning
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID option
you specify must include at least one identifier.
SCALE(n)
By default, the highest value of a plot's horizontal axis is
set to the highest value of the plotted variables. For
variables that represent percentages, the default
maximum value is 100%.
To override this dynamic scale, specify n as the maximum
value. If the variable that you choose produces integers, n
must be an integer. You cannot use more than three digits
to the right of the decimal point when specifying n.
If you use the RECORD option of the EACH command, you
must use SCALE(n), specifying a value for n appropriate
for the activity you are plotting.
SCATTER
Prints a scatter plot showing how many times each point in
the plot is reached.
Chapter 11: Plot Reports 497
Horizontal Reports (HPLOT)
Using VPLOT with HPLOT
The following example uses the HPLOT and VPLOT commands to produce a
distribution plot of disk SIOs against disk service time. Because the command
EACH RECORD is specified, the SCALE operand must be used with the HPLOT
command.
VPLOT VSE DISK SIO
HPLOT VSE DISK SERVTIME SCALE(0.100)
EACH RECORD
END
RUN
498 Report Reference Guide
Horizontal Reports (HPLOT)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
RECORD
PERIOD NONE
SIO
COUNT
243K
213K
183K
152K
122K
91274
60850
30427
DEVICE I/O SERVICE TIME
I
X
I
X
I
X
I
X
I
X
I
XX
I
XX
I
XX
I
XX
I
XX
I
XX
I
XX
I
XX
I
XX X
I
XX X
I
XX X
I
XX X
I
XXX X
I
XXX X
I
XXXXX X
I
XXXXX X
I
XXXXX X
I
XXXXXXX
I
XXXXXXX X
I
XXXXXXX X
I
XXXXXXX X
I
XXXXXXX X
I
XXXXXXX X
I
XXXXXXXXX
I
XXXXXXXXXX
I
XXXXXXXXXXX X
I
XXXXXXXXXXX X X
X
I
XXXXXXXXXXXX X X XX
I
XXXXXXXXXXXX XX X XX
I
XXXXXXXXXXXX XX X XX XX
X
I
XXXXXXXXXXXXXXX X XX XX X
X
I
XXXXXXXXXXXXXXX XXXXX XX X
XX
I
XXXXXXXXXXXXXXXXXXXXXXXXX X
XX
I
XXXXXXXXXXXXXXXXXXXXXXXXX X
XX X
I
XXXXXXXXXXXXXXXXXXXXXXXXXX X
XX X
X
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I
0.000
0.010
0.020
0.030
0.040
0.050
0.060
0.070
0.080
0.090
0.100
X
A - 0.024
SAMPLE COUNT ==> 1014
DEVICE I/O SERVICE TIME
SAMPLES WITHIN H-SCALE ==> 1011
99.7%
Using MPLOT with HPLOT
The following commands are identical to those in the previous example except
that MPLOT has been used instead of VPLOT.
MPLOT VSE DISK SIO
HPLOT VSE DISK SERVTIME SCALE(0.100)
EACH RECORD
END
RUN
Chapter 11: Plot Reports 499
Horizontal Reports (HPLOT)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
RECORD
PERIOD NONE
SIO
COUNT
170K
148K
127K
106K
84756
63567
42378
21189
DEVICE I/O SERVICE TIME
I
X
I
X
I
X
I
XX
I
XX
I
XX
I
XX X
I
XX X
I
X XX X
I
X XX X
I
X XX X
I
X XX X
I
X XX X
I
X XX X
I
X XX X
I
XX XX X
I
X X X X
I
X
X X
I
X
XX
I
X
X
I
X
X
I
X
X X
I
X
X X
I
X
X X
I
X
X X
I
X
X X
I
X
X X
I
X
X X
I
X
X XX
I
X
X
I
X
X
X
I
X
X
XX
I
X
X X X X
X
I
X
X X X X
X
I
X
X X X X
X
X
I
X X
XXX X X X
X
X
I
X X
X
X X
X
X
I
XX X
XX X
X
X
X
I
X X
XX
X
X
X
X
I
X
X X X X
X
X
X
X
X
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I
0.000
0.010
0.020
0.030
0.040
0.050
0.060
0.070
0.080
0.090
0.100
X
A - 0.025
SAMPLE COUNT ==> 1382
DEVICE I/O SERVICE TIME
SAMPLES WITHIN H-SCALE ==> 1378
99.7%
The following commands are identical to those in the previous example except
that the scale specified with the HPLOT command has been changed to 0.050
and the letter M has been specified as the plot character:
MPLOT VSE DISK SIO CHAR1(M)
HPLOT VSE DISK SERVTIME SCALE(0.050)
EACH RECORD
END
RUN
500 Report Reference Guide
Horizontal Reports (HPLOT)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
RECORD
PERIOD NONE
SIO
COUNT
170K
148K
127K
106K
84756
63567
42378
21189
DEVICE I/O SERVICE TIME
I
M
I
M
I
M
I
M M
I
M M
I
M M
I
M M
M
I
M M
M
I
M
M M
M
I
M
M M
M
I
M
M M
M
I
M
M M
M
I
M
M M
M
I
M
M M
M
I
M
M M
M
I
M M
M M
M
I
M M M M M
M
I
M M M M M
M
I
M M M M M M M
I
M M M M M M M
I
M M M M M M M
I
M M M M M M M
M
I
M M M M M M M
M
I
M M M M M M M
M
I
M M M M M M M
M
I
M M M M M M M
M
I
M M M M M M M
M
I
M M M M M M M
M
I
M M M M M M M M M M M
I
M M M M M M M M M M M M
M
I
M M M M M M M M M M M M
M
I
M M M M M M M M M M M M
M M
I
M M M M M M M M M M M M
M
M M M
M
I
M M M M M M M M M M M M
M
M M M
M
I
M M M M M M M M M M M M
M
M M M
M
I
M
M M M M M M M M M M M M M M M
M M M M
M
M
I
M
M M M M M M M M M M M M M M M M M M M M M
M
M
I
M M
M M M M M M M M M M M M M M M M M M M M M M M
M
M
M
I
M M M M M M M M M M M M M M M M M M M M M M M M M M M M
M
M
I
M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M
M M M
M
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I
0.000
0.005
0.010
0.015
0.020
0.025
0.030
0.035
0.040
0.045
0.050
M
A - 0.025
SAMPLE COUNT ==> 1382
DEVICE I/O SERVICE TIME
SAMPLES WITHIN H-SCALE ==> 1356
98.1%
Using the SCATTER Operand
Use the SCATTER operand with the HPLOT command to produce a scatter plot
showing the number of times each point in the plot was reached.
Chapter 11: Plot Reports 501
Horizontal Reports (HPLOT)
The following commands produce a scatter plot of CPU use versus step
duration:
VPLOT VSE PACCNT EXCPUTM SCALE(20)
HPLOT VSE PACCNT EXJDUR
SCALE(600) SCATTER
EACH RECORD
END
RUN
The preceding commands generate a report like the following:
SHIFT NONE
EACH
RECORD
PERIOD NONE
CPU
TIME
DURATION OF JOB STEP
1
12231
C
00:00:20 I
1
I
I
I
1
I
00:00:18 I
I
I
I
I
00:00:15 I
I
1
I
I
1
1
I
00:00:13 I
I
I
I
I
00:00:10 I
I
I
1
11
I
1
2 1
I
11 1 1
1
1
00:00:08 I
1
32
2 1
1
1
I
1
1
1 1 1
2
I
1
1
1
I
21
21
1
1 1
I
3 1
1
00:00:05 I
124
12
1
1
1
1
I
4 2112
11 1
I
1 3231 1 2 11
1
1
I
31 1 1
1
I
1
00:00:03 I 1
1
I 21
1 11
1
1
I 32212221 11 11
1 1
2
1
1
I 144KLC87234 2 1
1 12
1 1
1 1
1
2
I++++LDB732135331
11
21 1 1
1
1
3
II---------I---------I---------I---------I---------I---------I---------I---------I---------I---------I
00:00:00 00:01:00 00:02:00 00:03:00 00:04:00 00:05:00 00:06:00 00:07:00 00:08:00 00:09:00 00:10:00 X
-00:18:34
SAMPLE COUNT ==> 645
DURATION OF JOB STEP
SAMPLES WITHIN H-SCALE ==> 626
97.0%
SAMPLES WITHIN V-SCALE ==> 623
96.5
502 Report Reference Guide
Chapter 12: Graph Reports
The Graph Reports are graphs used to compare related identifiers. This
chapter describes and gives examples of how to create graph reports using the
GRAF and GRAF2 commands.
This section contains the following topics:
GRAF Reports (GRAF and GRAF2) (see page 503)
GRAF2 Reports (see page 512)
GRAF Reports (GRAF and GRAF2)
Syntax and operands used to create GRAF reports are described in the next
section. Sample output is also included.
GRAF Command
The GRAF command produces a single-line bar graph of the performance of
each identifier associated with a variable. For example, using the GRAF
command with a JOB variable produces a bar graph of the variable for each
job.
Command Syntax and Operands
The syntax of the GRAF command is as follows:
GRAF [idoption[(identifiers)]] variable [options] [SCALE({n},{mX})] [SORT order]
[FOR n] CHAR1(x)
Operands for the GRAF command are shown in the following table:
Operands
Meaning
idoption
(identifiers)
Any ID option that is valid for the variable, specified with or
without identifiers. Specifying this operand causes the
resulting report to be organized by the specified ID option
and limited to the identifiers specified by identifiers. If you do
not specify an ID option, all identifiers of the type associated
with the variable are included in the report.
For example, a graph of a DISK variable by default graphs
the value of that variable for each disk. Specifying the ID
Chapter 12: Graph Reports 503
GRAF Reports (GRAF and GRAF2)
Operands
Meaning
option and identifier DISKID(0081) graphs the value of the
variable for disk 0081 only; specifying the ID option VOLSER
graphs the value of the variable for each volume.
variable
Any report writer variable.
options
Any valid variable options or ID options. Each ID option you
specify must include at least one identifier.
SCALE(n)
By default, the highest value of a bar graph's axis is set to
the highest value of the graphed variables. For variables that
represent percentages, the default maximum value is 100%.
or
SCALE(mX)
or
SCALE(n,mX)
To override this dynamic scale, specify n as the maximum
value. If the variable that you choose produces integers, n
must be an integer. You cannot use more than three digits to
the right of the decimal point when specifying n.
In some cases, bar graphs in a graph report will be too short
to appear. To display these graphs, you can cause each plot
character to appear as m characters by specifying the
multiplier mX, where m is an integer. Since the resulting bar
graphs will no longer correspond numerically to the scale,
this is useful only for determining relative performance.
SORT order
Sorts the report. Replace order with one of the following:
■
DESCENDING—Sorts identifiers in descending order of
value of the variable specified. This is the default sorting
order.
■
ASCENDING—Sorts identifiers in ascending order of value
of the variable specified.
FOR n
Limits the report to the n identifiers in each time period that
would appear first in the report. For reports sorted in
descending order, these are the n most active identifiers; for
reports sorted in ascending order, these are the n least active
identifiers. n must be an integer.
CHAR1(x)
Sets the plot character. Replace x with any valid EBCDIC
character.
504 Report Reference Guide
GRAF Reports (GRAF and GRAF2)
Creating a Simple GRAF Report
The following commands graph the number of SIOs by each device. Because
the log file may contain data that covers many months, the FROM and TO
commands are used to limit the report to the devices active between 8:00 and
9:00 a.m. on 03/30/04.
GRAF VSE DEVICE SIO
FROM 03/30/04 08:00:00
TO
03/30/04 09:00:00
END
RUN
The preceding commands generate a report like the following:
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXX.
.
.
.
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
0861
0860
0632
0225
0740
0863
0110
0742
0383
0862
0381
0113
0741
0111
0480
00E8
0384
0630
0382
SYMBOLS:
"X" =
X
74515
53109
47908
44322
41705
29463
29331
21051
16345
15975
15434
13090
12332
10743
10055
9755
8575
7575
6697
X
DEVICE SIO COUNT
Graphing by an Alternate Resource
By default, the GRAF command produces a report on the identifiers associated
with the specified variable. To graph the value of the variable for resources of
another type, specify an ID option with the GRAF command.
Graph reports on DISK variables are, by default, organized by disk ID. The
following commands use the ID option VOLSER with the GRAF command to
produce a report on disk SIOs by volume instead:
GRAF VOLSER VSE DISK SIO
END
RUN
Chapter 12: Graph Reports 505
GRAF Reports (GRAF and GRAF2)
The preceding commands generate a report like the following:
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
.
.XXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXX.
.
.
.
.
.
.
.
.
.
.XXXXXXX .
.
.
.
.
.
.
.
.
.
.XXXXXXX .
.
.
.
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
7451
14903
22354
29806
37257
44709
52160
59612
67063
74515
PACK61
PACK60
PACK32
PACK25
PACK40
PACK63
PACK10
PACK42
PACK62
PACK13
PACK41
PACK11
PACK30
PACK23
DOSRES
PACK24
SYMBOLS:
"X" =
X
74515
53109
47908
44322
41705
29463
29331
21051
15975
13090
12332
10743
7575
6503
5425
5364
X
DEVICE SIO COUNT
Including an AVERAGE Line in a Graph
To include in a graph report a line graphing the average value of the variable
specified for all identifiers listed, specify the command
OPTION(AVERAGE=YES).
The following commands produce a report that graphs the number of phase
loads by each library, and the average number of phase loads for all libraries:
OPTION(AVERAGE=YES)
GRAF LIBRARY VSE PHASE LOADS SCALE(5000)
END
RUN
506 Report Reference Guide
GRAF Reports (GRAF and GRAF2)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
DAY
PERIOD NONE
0
500
1000
1500
2000
2500
3000
3500
4000
4500
5000
X
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX> 103K
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX> 11344
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
. 4055
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
. 2073
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
. 1824
.XXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
. 1389
.XXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
674
.XXXXXXX .
.
.
.
.
.
.
.
.
.
334
.XXXX
.
.
.
.
.
.
.
.
.
.
224
.
.
.
.
.
.
.
.
.
.
.
21
.
.
.
.
.
.
.
.
.
.
.
5
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
500
1000
1500
2000
2500
3000
3500
4000
4500
5000
X
SVA
AVERAGE>
IJSYSRS
DCMLIB
PRD1
PRODLIB
PRD2
EXPCLIB
CAMLIB
ISMLIB
SQLIB
SYMBOLS:
VSE PHASE LOADS
"X" =
VSE PHASE LOADS
Note: The value of the variable for a resource can be nonzero and yet be too
low to appear graphically, as is the case in the preceding report for libraries
ISMLIB and SQLIB.
Limiting Reports Using ID Options
Use an ID option and identifiers with the GRAF command to specify the
resources to be included in a graph report. You can specify individual
resources or groups of resources.
The following commands use the ID option DEVID and the generic identifier
(00++) to report on the devices on channel 00:
GRAF DEVID(00++) VSE DEVICE SIO
END
RUN
Chapter 12: Graph Reports 507
GRAF Reports (GRAF and GRAF2)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
DAY
PERIOD NONE
0
150
300
450
600
750
900
1050
1200
1350
1500
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.XXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.XXXXXXXXXXXX
.
.
.
.
.
.
.
.
.
.XXXXXXXXX.
.
.
.
.
.
.
.
.
.
.XXXX
.
.
.
.
.
.
.
.
.
.
.XXXX
.
.
.
.
.
.
.
.
.
.
.XXX
.
.
.
.
.
.
.
.
.
.
.XXX
.
.
.
.
.
.
.
.
.
.
.X
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
150
300
450
600
750
900
1050
1200
1350
1500
0089
0083
000D
00C0
0081
0080
0082
008A
0084
0087
0085
0086
0088
SYMBOLS:
DEVICE SIO COUNT
"X" =
X
1500
1158
670
512
296
174
132
57
57
49
46
16
4
X
DEVICE SIO COUNT
Limiting Reports Using the FOR Operand
Use the FOR n operand to produce a report on the n resources with the
highest or lowest values (depending on the sorting order) for the variable
being graphed.
The following commands are similar to those in the preceding example except
that the FOR operand is used to limit the report to the five devices on channel
00 with the highest SIO counts. A continuation comma is used to continue the
GRAF command to a second line, and the CHAR1 operand sets the plot
character to S.
GRAF VSE DEVICE SIO DEVID(00++),
FOR 5 CHAR1(S)
END
RUN
508 Report Reference Guide
GRAF Reports (GRAF and GRAF2)
The preceding commands generate a report like the following:
SHIFT NONE
EACH
DAY
PERIOD NONE
0
150
300
450
600
750
900
1050
1200
1350
1500
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS
.SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS .
.
.
.SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS
.
.
.
.
.
.
.SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS
.
.
.
.
.
.
.
.SSSSSSSSSSSSSSSSSSSS
.
.
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
150
300
450
600
750
900
1050
1200
1350
1500
0089
0083
000D
00C0
0081
SYMBOLS:
DEVICE SIO COUNT
"S" =
S
1500
1158
670
512
296
S
DEVICE SIO COUNT
Changing the Scale of a Report
By default, the highest value of a bar graph's horizontal axis is set to the
highest value of the graphed variables. For variables that represent
percentages, the default maximum value is 100%. Use the SCALE(n) operand
to specify the scale of a graph report.
If the variable does not yield results with a decimal point, you cannot use a
decimal point in the SCALE operand.
The following commands produce a report similar to the preceding report but
with a scale of 2000:
GRAF DEVID(00++) VSE DEVICE SIO FOR 5 CHAR1(S) SCALE(2000)
END
RUN
The preceding commands generate a report like the following:
SHIFT NONE
EACH
DAY
PERIOD NONE
0
200
400
600
800
1000
1200
1400
1600
1800
2000
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS
.
.
.
.SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS .
.
.
.
.
.SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS
.
.
.
.
.
.
.
.SSSSSSSSSSSSSSSSSSSSSSSSSS
.
.
.
.
.
.
.
.
.SSSSSSSSSSSSSSS
.
.
.
.
.
.
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
200
400
600
800
1000
1200
1400
1600
1800
2000
0089
0083
000D
00C0
0081
SYMBOLS:
DEVICE SIO COUNT
"S" =
S
1500
1158
670
512
296
S
DEVICE SIO COUNT
Chapter 12: Graph Reports 509
GRAF Reports (GRAF and GRAF2)
Sorting Reports
By default, the identifiers in a graph report are sorted in descending order of
value of the variable specified. Use the SORT ASCENDING operand to sort a
graph report in ascending order.
The following commands produce a report on the 20 least active data sets:
GRAF VSE DSN IOTIME FOR 20 SCALE(0.150) SORT ASCENDING
END
RUN
The preceding commands generate a report like the following:
SHIFT NONE
EACH
DAY
PERIOD NONE
DATASET TOTAL I/O (BUSY) TIME
0
0.015
0.030
0.045
0.060
0.075
0.090
0.105
0.120
0.135
0.150
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
FVRDLI.RELOAD.WORK.XXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
PROD.VNLVS3.VNDXS3.XXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
DEVVSE.S1SCTY.VSAM.XXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
BASE.SWEENEY
.XXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
PROD.VNLVS0.VNDXP0.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
PROD.CULVS0.CUDXP0.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
PROD.VNLVS3.VNDXS3.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
VSE.MESSAGE.ROUTIN.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
CICSB.DFHTEMP
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
DYNBUF.NEWFILE.IND.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.
.
PROD.VNLVS2.VNDXS2.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.
.
VSE.ONLINE.PROB.DE.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
SQLS31.VTOC
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
.
DYNBUF.NEWFILE
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
.
XXXXFBK.FLASHBK.NE.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
DEVVSE.VTAM.TRACE..XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
BU.PDS.EXP.BACKUP..XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
SYSWK9.QDAS.SHARE..XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
.
.
.
.
SQLS31.VOL1.LABEL .XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
CICSB.DFHNTRA
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
0.015
0.030
0.045
0.060
0.075
0.090
0.105
0.120
0.135
0.150
SYMBOLS:
"X" =
X
0.030
0.031
0.034
0.036
0.047
0.048
0.050
0.050
0.054
0.058
0.059
0.060
0.070
0.074
0.080
0.081
0.083
0.088
0.097
0.110
X
DATASET TOTAL I/O (BUSY) TIME
Creating Reports on Specified Shifts
Use the SHIFT command to create reports that cover only certain hours of the
day. The following commands produce a report on the 20 jobs with the longest
average durations between 6:00 p.m. and 8:00 a.m., using a scale of 1800
seconds (30 minutes):
GRAF VSE JOB DURATION FOR 20 SCALE(1800)
SHIFT 18:00:00 08:00:00
END
RUN
510 Report Reference Guide
GRAF Reports (GRAF and GRAF2)
The preceding commands generate a report like the following:
SHIFT 18:00:00 08:00:00
EACH
DAY
PERIOD NONE
0
00:03:00 00:06:00 00:09:00 00:12:00 00:15:00 00:18:00 00:21:00 00:24:00 00:27:00 00:30:00 X
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>26:32:06
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>26:32:01
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>03:53:19
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.00:21:26
.XXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
.00:05:58
.XXXXXXXXXXXXXX
.
.
.
.
.
.
.
.
.00:04:14
.XXXXX
.
.
.
.
.
.
.
.
.
.00:01:37
.XXXXX
.
.
.
.
.
.
.
.
.
.00:01:31
.XXXX
.
.
.
.
.
.
.
.
.
.00:01:12
.XXX
.
.
.
.
.
.
.
.
.
.00:01:00
.XXX
.
.
.
.
.
.
.
.
.
.00:00:58
.XXX
.
.
.
.
.
.
.
.
.
.00:00:50
.XXX
.
.
.
.
.
.
.
.
.
.00:00:49
.XX
.
.
.
.
.
.
.
.
.
.00:00:42
.XX
.
.
.
.
.
.
.
.
.
.00:00:41
.XX
.
.
.
.
.
.
.
.
.
.00:00:37
.XX
.
.
.
.
.
.
.
.
.
.00:00:35
.XX
.
.
.
.
.
.
.
.
.
.00:00:27
.X
.
.
.
.
.
.
.
.
.
.00:00:23
.X
.
.
.
.
.
.
.
.
.
.00:00:20
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
00:03:00 00:06:00 00:09:00 00:12:00 00:15:00 00:18:00 00:21:00 00:24:00 00:27:00 00:30:00 X
CICSMROB
EXPCDEV
SARBCH
AXPHJ22
GSPDSU
LIBRCPYT
GSFFFAD
PDSANAL
AXPU003
ALT
AXPHJ6G
AXPHJ6F
BLDDIST
EXPUTIL
AXPHJ6
AXPHJ6D
EXPRPT1
EVSEBKUP
ALRTVVAU
EXPRPT
SYMBOLS:
AVERAGE JOB DURATION
"X" =
AVERAGE JOB DURATION
Creating Reports with Multiple Time Periods
By default, graph reports include one detail line for each identifier, showing
the value of the variable specified for that identifier during the time period
covered in the report. If you use the EACH command with the GRAF command,
however, the report writer produces a detail line for each identifier for each
time period specified by the EACH command.
The following example uses the FROM, TO, and EACH commands to produce a
report on device SIO counts for the five most active devices each hour:
GRAF DEVID(04++) VSE DEVICE SIO SCALE(10000),
FOR 5 SORT ASCENDING
FROM 03/30/04 09.00.00
TO
03/30/04 12.00.00
EACH 1 HOUR
END
RUN
Chapter 12: Graph Reports 511
GRAF2 Reports
The preceding commands produce a report like the following:
0
1000
2000
3000
4000
5000
6000
7000
8000
9000
10000
X
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
.
.
.
.
.
.
.
.
.
.
.
03/30/04 09.00.00 .
.
.
.
.
.
.
.
.
.
.
0480
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX> 12221
042B
.XXXXXXXXXXXXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
. 2696
04A0
.XXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
. 2402
04C0
.XXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
. 2134
042D
.XXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
. 1743
.
.
.
.
.
.
.
.
.
.
.
03/30/04 10.00.00 .
.
.
.
.
.
.
.
.
.
.
0480
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX> 13488
04A0
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
. 3237
043B
.XXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
. 2055
042D
.XXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
. 1997
04C0
.XXXXXXXXXXXXXXXXX .
.
.
.
.
.
.
.
. 1667
.
.
.
.
.
.
.
.
.
.
.
03/30/04 11.00.00 .
.
.
.
.
.
.
.
.
.
.
0480
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
. 8935
04A0
.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
. 3366
042D
.XXXXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
. 2455
046D
.XXXXXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
. 2325
04C0
.XXXXXXXXXXXXXXXXXXXX
.
.
.
.
.
.
.
. 1973
+.........+.........+.........+.........+.........+.........+.........+.........+.........+.........+
0
1000
2000
3000
4000
5000
6000
7000
8000
9000
10000
X
SYMBOLS:
"X" =
DEVICE SIO COUNT
GRAF2 Reports
Use the GRAF2 command to produce one or more subgraphs for each
individual resource included by the GRAF command. These subgraphs can do
either of the following:
■
Graph the performance of a second, related set of resources. For example,
if your GRAF command graphs by job, a GRAF2 command could list each
step for each job and show the amount of CPU used by each step.
■
Graph the values of one or more variables for each resource. For example,
if your GRAF command graphs by jobstep, a GRAF2 command could show
the duration, CPU use, and SIO counts for each step.
512 Report Reference Guide
Chapter 13: Flashback Reports
Flashback reports are tabular reports that contain detailed information about
jobs, jobsteps, or job pseudo end-of-steps. This chapter describes how to
create flashback reports and provides examples using the FLASHBACK
command.
The following restrictions apply to flashback reports:
■
Each flashback report must be run as a single report in a separate run.
You cannot specify another primary report command (such as TAB, PLOT,
or Select) in a jobstream with the FLASHBACK command.
■
Job or steps are presented in chronological order of ending time. You
cannot sort flashback reports.
■
To produce reports using data from VSE/POWER accounting records, CA
Explore PM for z/VSE POWRACCT configuration option must be set to YES
or YNO, and the appropriate record types must be selected from the
Configure Log Record panel. For more information about setting CA
Explore PM for z/VSE configuration options, see the Online User Guide.
This section contains the following topics:
FLASHBACK Command (see page 513)
Output Considerations (see page 514)
Command Syntax and Operands (see page 514)
Default Flashback Reports (see page 515)
Output Consideration for Flashback Reports (see page 515)
Default VSEEXEC Report (see page 515)
Default VSEJOB Report (see page 516)
Default VSELIST Report (see page 517)
Default VSESAMP Report (see page 518)
Default VSESTEP Report (see page 519)
Tailoring Default Flashback Reports (see page 520)
Using ID Options to Limit FLASHBACK Reports (see page 521)
Limiting Reports to Specified Variable Values (see page 523)
Creating Specialized Flashback Reports (see page 524)
Using the Date and Time Operands (see page 526)
FLASHBACK Command
Use the FLASHBACK command to produce a tabular report containing one line
of output per job, jobstep, or job pseudo end-of-step.
Chapter 13: Flashback Reports 513
Output Considerations
Output Considerations
The FLASHBACK command can generate enormous amounts of output if run
against a very large input file. To avoid problems, use either the FROM and TO
commands, the COUNT command, or the SELECT command to limit output.
Command Syntax and Operands
The syntax of the FLASHBACK command is as follows:
FLASHBACK type [[period] idoption[(identifiers)] [variable [options] [HDR1(text)]
[HDR2(text)]] [AND,variable [options] [HDR1(text)] [HDR2(text)]] [AND,...]
The operands for the FLASHBACK command are shown as follows:
Operand
Meaning
type
Specify one of the following:
period
■
VSEEXEC—Prints one line for every VSE/POWER
execution record. Each execution record represents
one jobstep.
■
VSEJOB—Prints one line for every job executed.
■
VSELIST—Prints one line for every VSE/POWER list
record.
■
VSESAMP— Prints one line for every step and
pseudo end-of-step executed. A pseudo end-of-step
record is created by CA-EXPLORE for each step that
is running at the end of a SYSTIMEI interval.
■
VSESTEP— Prints one line for every step executed.
One of the following to indicate the first column or
columns in the report:
■
DATETIME—Creates columns for the date and time
of the record
■
DATE—Creates a column for the date of the record
■
TIME—Creates a column for the time of the record
■
DAY—Creates a column for the day of the record
(MONDAY, TUESDAY, and so forth)
You can use one of the DATE, TIME, DAY, or DATETIME
operands only if you create a specialized flashback
report by specifying one or more ID options and any
desired variables with the FLASHBACK command.
514 Report Reference Guide
Default Flashback Reports
Operand
Meaning
idoption(identifiers
)
Lists all the resources (or just those specified by
identifiers) for an ID option. You can specify multiple ID
options. For examples using ID options with the
FLASHBACK command.
variable
Any report writer variable.
Default Flashback Reports
To create a default flashback report, specify the command FLASHBACK without
any ID options or variables.
Output Consideration for Flashback Reports
You should use either the FROM and TO commands, the COUNT command, or
the SELECT command to limit report output.
Default VSEEXEC Report
The VSEEXEC flashback report prints one line for every VSE/POWER execution
record. Each execution record represents one jobstep.
The following commands produce a default VSEEXEC flashback report:
FLASHBACK VSEEXEC
FROM 03/09/04 13:00:00
TO
03/09/04 15:00:00
END
RUN
Chapter 13: Flashback Reports 515
Default VSEJOB Report
The preceding commands generate a report like the following:
PART
ID
---F8
BG
F8
FA
BG
F8
F8
F8
F8
BG
BG
BG
BG
BG
BG
BG
----
JOB
CPU
SIO
PAGES
DURATION
TIME
COUNT
SPOOLED
-------- -------- -------- -------00:00:25 0.373
681
3
00:00:30 0.177
2221
65
00:02:11 0.410
1061
3
00:01:56 0.567
2340
3
00:01:56 0.493
1752
4
00:00:47 0.560
2401
4
00:00:14 0.336
740
5
00:00:16 0.367
768
5
00:00:13 0.187
528
2
00:00:21 0.103
166
2
00:00:16 0.213
1867
1
00:00:12 0.560
395
8
00:00:21 0.120
337
1
00:00:18 0.116
327
1
00:00:19 0.116
327
1
00:00:19 0.116
327
1
-------- -------- -------- -------00:10:32 4.814
16238
109
---- -------- -------- -------- -- -------- ---------------- ----- -------- -------- ----- ----------- -------- -------- -------DATE
-------03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
03/09/04
--------
START
TIME
-------13:08:32
13:11:54
13.37.19
13.37.40
13.37.48
13.39.32
13.54.34
13.55.11
14.02.46
14.50.31
14.50.52
14.51.08
14.51.19
14.51.40
14.51.58
14.52.16
--------
STOP
TIME
-------13:08:56
13:12:24
13.39.31
13.39.36
13.39.44
13.40.20
13.54.48
13.55.27
14.02.59
14.50.52
14.51.08
14.51.19
14.51.40
14.51.58
14.52.16
14.52.35
--------
ID
-E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
--
POWER
NAME
-------ECDIMODL
PAUSE
GSSDFCM
GSEDIT
GSFAOCM
GSFAOEX
S1S010
S1S010
LIBR
INSTALT
INSTALT
INSTALT
INSTALT
INSTALT
INSTALT
INSTALT
--------
USER
POWER
VSE
INFO
CC
JOB NAME
---------------- ----- -------10
ECDIMODL
10
PAUSE
TO MERROW
10
GSSDFCM
TO MERROW
10
GSEDIT
TO MERROW
10
GSFAOCM
TO MERROW
10
GSFAOEX
10
S1S010
10
S1S010
10
LIBR
10
INSTALL
10
INSTALL
10
INSTALL
10
REMOVE
10
REMOVE
10
REMOVE
10
REMOVE
---------------- ----- --------
PHASE
NAME
-------LNKEDT
GSFAQSHC
LNKEDT
LNKEDT
LNKEDT
LNKEDT
LNKEDT
LNKEDT
LIBR
TSIDDEB
LIBR
MAINT
MSHP
MSHP
MSHP
MSHP
--------
VSE
CC
--10
18
10
10
10
10
10
10
10
10
10
10
10
10
10
10
---
REC
TYPE
---L
L
L
L
L
L
L
L
L
S
S
L
L
L
L
L
----
Default VSEJOB Report
The VSEJOB flashback report prints one line for every job executed.
The following commands produce a default VSEJOB flashback report:
FLASHBACK VSEJOB
FROM 03/10/04 14:00:00
TO
END
RUN
516 Report Reference Guide
03/10/04 17:00:00
Default VSELIST Report
The preceding commands generate a report like the following:
PART
ID
---BG
BG
BG
F8
BG
BG
BG
BG
BG
F6
F6
F8
F2
F8
F8
BG
BG
BG
BG
BG
F8
BG
BG
F6
F6
F6
F6
F6
F6
F6
F6
F6
F6
F6
F7
F7
----
START
TIME
-------14.06.08
14.15.22
14.20.08
14.31.46
14.29.18
14.36.23
14.49.26
14.53.16
14.59.29
15.01.37
15.02.57
15.04.00
14.00.01
15.13.06
15.13.40
15.00.44
15.20.03
15.26.42
15.27.21
15.37.23
15.40.26
15.45.17
15.50.48
16.30.55
16.33.53
16.42.26
16.45.05
16.46.06
16.48.32
16.49.10
16.50.24
16.51.53
16.54.22
16.55.56
14.00.01
16.58.48
--------
END
TIME
-------14.07.34
14.15.58
14.21.10
14.31.56
14.30.06
14.36.59
14.50.30
14.53.31
15.00.44
15.01.39
15.03.00
15.04.10
15.12.58
15.13.24
15.13.47
15.19.55
15.22.16
15.27.00
15.29.29
15.37.38
15.41.22
15.46.54
15.51.24
16.31.00
16.33.56
16.42.36
16.45.10
16.47.24
16.48.59
16.49.14
16.50.36
16.52.05
16.54.27
16.56.03
16.58.37
17.00.01
--------
JOB
NAME
-------ALERT
TESTOSJ2
TESTOSJ2
IDCAMS
TESTOSJ2
TESTOSJ2
DLIUNLD
TESTOSJ2
DLIUNLD
LIBRRENA
LIBRRENA
S1FILEX2
CICSMROA
DFHDUMP
DFHDUMP
DLIUNLD
DLIUNLD
DLIUNLD
DLIUNLD
TESTOSJ2
GSFAOEX
DLIUNLD
TESTOSJ2
REXXBAT
REXXBAT
MAINT
REXXBAT
ALT
GSBCOMUF
REXXBAT
MAINT
MAINT
REXXBAT
REXXBAT
JCLSCHED
JCLSCHED
--------
STEP
NAME
-------AXPBR14
TSIDMNT
TSIDMNT
IDCAMS
TSIDMNT
TSIDMNT
GDBDRVR
TSIDMNT
GDBDRVR
LIBR
LIBR
$LNKEDT
DFHSIP
DFHDUP
DFHDUP
GDBDRVR
GDBDRVR
GDBDRVR
GDBDRVR
TSIDMNT
$LNKEDT
GDBDRVR
TSIDMNT
REXXBAT
REXXBAT
GVCMAINT
REXXBAT
AXPL7
$LNKEDT
REXXBAT
GVCMAINT
GVCMAINT
REXXBAT
REXXBAT
JCLSCHED
JCLSCHED
--------
TOTAL
TCPU
DISK
DISK
TAPE
OTHER
PAGE
PAGE
GETVIS GETVIS
DURATION TIME
IO
SERVTIME
IO
IO
FAULTS
IO
USED
USED
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----00:01:26 0.111
2
0.018
0
0
16
0
4k
0.1
00:00:36 0.110
227
0.030
0
38
35
0
60k
1.6
00:01:02 0.130
227
0.016
0
38
28
0
64k
1.7
00:00:10 0.199
374
0.019
0
50
37
0
0
0.0
00:00:47 0.110
227
0.017
0
38
28
0
30k
1.6
00:00:36 0.109
227
0.013
0
38
28
0
0
0.0
00:01:04 2.670
2714
0.018
0
406
133
317
568k
15.5
00:00:15 0.089
224
0.026
0
38
28
0
0
0.0
00:01:15 3.713
2958
0.020
0
408
57
7
364k
9.9
00:00:03 0.055
111
0.019
0
6
25
0
0
0.0
00:00:03 0.056
111
0.023
0
6
17
0
0
0.0
00:00:11 0.308
372
0.016
0
43
109
0
0
0.0
01:12:56 10.72
1765
0.023
0
221
1259
37
798k
41.4
00:00:17 0.276
227
0.032
0
29
35
0
0
0.0
00:00:08 0.125
214
0.027
0
29
31
0
0
0.0
00:19:11 2.788
2881
0.049
0
417
103
0
286k
15.6
00:02:12 1.064
2299
0.034
0
395
50
0
568k
15.5
00:00:18 0.232
310
0.025
0
18
26
0
0
0.0
00:02:07 3.770
2999
0.035
0
410
52
0
0
0.0
00:00:15 0.093
227
0.028
0
38
28
0
0
0.0
00:00:56 0.549
568
0.034
0
45
114
0
0
0.0
00:01:38 2.755
2715
0.031
0
407
51
0
568k
15.5
00:00:35 0.109
224
0.017
0
38
28
0
0
0.0
00:00:04 0.093
141
0.017
0
35
37
0
0
0.0
00:00:03 0.066
100
0.024
0
2
30
0
0
0.0
00:00:09 0.164
297
0.022
0
75
38
0
96k
4.8
00:00:05 0.082
128
0.029
0
6
36
0
200k
9.9
00:01:19 1.280
2225
0.029
0
82
151
0
116k
8.9
00:00:26 0.313
374
0.038
0
30
55
0
132k
8.7
00:00:05 0.079
130
0.026
0
6
36
0
0
0.0
00:00:12 0.162
297
0.030
0
75
29
0
0
0.0
00:00:12 0.156
278
0.036
0
75
29
0
0
0.0
00:00:05 0.081
131
0.028
0
7
35
0
0
0.0
00:00:07 0.081
130
0.048
0
6
35
0
200k
9.9
02:58:36 36.20
9153
0.031
0
1002
662
5
1408k
70.6
00:01:13 0.845
1048
0.028
0
52
94
0
0
0.0
-------- -------- -------- -------- -------- -------- -------- -------- -------- ------
Default VSELIST Report
The VSELIST flashback report prints one line for every VSE/POWER list record.
The following commands produce a default VSELIST flashback report:
FLASHBACK VSELIST
FROM 03/10/04 15:00:00
TO
03/10/04 17:00:00
END
RUN
Chapter 13: Flashback Reports 517
Default VSESAMP Report
The preceding commands generate a report like the following:
POWER
JOB NAME
-------DLIUNLD
LIBRRENA
LIBRRENA
S1FILEX2
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
CICSMROA
DFHDUMP
DFHDUMP
DLIUNLD
DLIUNLD
DLIUNLD
DLIUNLD
TESTOSJ2
GSFAOEX
DLIUNLD
TESTOSJ2
REXXBAT
REXXBAT
MAINT
REXXBAT
AXPPRTV2
GSBCOMUF
REXXBAT
MAINT
MAINT
REXXBAT
REXXBAT
JCLSCHED
--------
USER
POWER
INFO
CC
DATE
---------------- ----- -------10
03/10/04
TO PLM
10
03/10/04
TO PLM
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
TO MERROW
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
10
03/10/04
---------------- ----- --------
START
TIME
-------15.00.48
15.01.42
15.03.02
15.04.13
15.08.03
15.08.18
15.08.41
15.09.02
15.09.21
15.09.43
15.10.03
15.10.22
15.10.44
15.11.07
15.11.28
15.11.50
15.12.11
15.12.34
15.13.03
15.13.26
15.13.51
15.20.03
15.22.24
15.27.08
15.29.34
15.38.33
15.41.25
15.47.01
15.55.30
16.31.02
16.33.59
16.42.38
16.45.13
16.47.27
16.49.02
16.49.17
16.50.39
16.52.08
16.54.31
16.56.08
16.58.47
--------
STOP
TIME
-------15.00.48
15.01.42
15.03.02
15.04.13
15.08.17
15.08.40
15.09.02
15.09.21
15.09.43
15.10.02
15.10.21
15.10.43
15.11.06
15.11.27
15.11.49
15.12.11
15.12.34
15.12.51
15.13.10
15.13.33
15.13.51
15.20.06
15.22.25
15.27.08
15.29.35
15.38.55
15.41.25
15.47.02
15.55.45
16.31.02
16.34.00
16.42.39
16.45.13
16.47.30
16.49.02
16.49.17
16.50.39
16.52.08
16.54.31
16.56.08
16.58.48
--------
PRT FORM
LINES
PAGES
EXTRA
EXTRA PRINTED
CUU ID
PRINTED PRINTED RECORDS
PAGES COPIES
---- ---- -------- -------- -------- -------- -----00F
141
9
0
0
1
00F
4
1
0
0
1
00F
4
1
0
0
1
00F
66
3
0
0
1
00F
3736
101
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
3300
100
0
0
1
00F
2264
70
0
0
1
00F
2513
69
0
0
1
00F
30
1
0
0
1
00F
136
8
0
0
1
00F
132
8
0
0
1
00F
69
5
0
0
1
00F
141
9
0
0
1
00F
2982
77
0
0
1
00F
111
4
0
0
1
00F
136
8
0
0
1
00F
2982
77
0
0
1
00F
77
2
0
0
1
00F
15
1
0
0
1
00F
4
1
0
0
1
00F
17
1
0
0
1
00F
1941
60
0
0
1
00F
32
2
0
0
1
00F
17
1
0
0
1
00F
3
1
0
0
1
00F
4
1
0
0
1
00F
17
1
0
0
1
00F
17
1
0
0
1
00F
175
7
0
0
1
---- ---- -------- -------- -------- -------- -----60666
1830
0
0
41
-------- ---------------- ----- -------- -------- -------- -- ---- ---- -------- -------------- -- -------- -----ID
-L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
--
Default VSESAMP Report
The VSESAMP flashback report prints one line for every step and pseudo
end-of-step executed. A pseudo end-of-step record is created by CA Explore
PM for z/VSE for each step that is running at the end of a SYSTIMEI interval.
518 Report Reference Guide
Default VSESTEP Report
The following commands produce a default VSESAMP flashback report:
FLASHBACK VSESAMP
FROM 03/10/04 14:00:00
TO
03/10/04 14:30:00
END
RUN
The preceding commands generate a report like the following:
PART
ID
---BG
BG
AR
BG
FB
F9
F7
F5
F4
F3
F2
F1
BG
BG
BG
BG
BG
AR
BG
FB
F9
F7
F5
F4
F3
F2
F1
----
START
TIME
-------14.06.08
14.06.08
14.00.01
14.07.35
14.00.01
14.00.01
14.00.01
14.00.01
14.00.01
14.00.01
14.00.01
14.00.01
14.15.22
14.15.22
14.18.20
14.20.08
14.22.34
14.15.01
14.29.18
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
-------14.00.01
---- --------
END
TIME
-------14.06.08
14.07.34
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
14.15.01
14.15.22
14.15.58
14.20.08
14.21.10
14.29.18
14.30.01
14.30.01
14.30.01
14.30.01
14.30.01
14.30.01
14.30.01
14.30.01
14.30.01
14.30.01
-------14.30.01
--------
JOB
NAME
-------*JOBCTL*
ALERT
SYSTEM
*JOBCTL*
SQL310
EXPCDEV
JCLSCHED
EVSEIBAT
CICSMROB
VTAMSTRT
CICSMROA
IPWPOWER
*JOBCTL*
TESTOSJ2
*JOBCTL*
TESTOSJ2
*JOBCTL*
SYSTEM
TESTOSJ2
SQL310
EXPCDEV
JCLSCHED
EVSEIBAT
CICSMROB
VTAMSTRT
CICSMROA
IPWPOWER
--------
STEP
NAME
-------NO NAME
AXPBR14
SYSSTEP
NO NAME
ARISQLDS
ECDIGEN
JCLSCHED
EVSESBAT
DFHSIP
ISTINCVT
DFHSIP
AXPL9
NO NAME
TSIDMNT
NO NAME
TSIDMNT
NO NAME
SYSSTEP
TSIDMNT
ARISQLDS
ECDIGEN
JCLSCHED
EVSESBAT
DFHSIP
ISTINCVT
DFHSIP
AXPL9
--------
TOTAL
TCPU
DISK
DISK
TAPE
OTHER
PAGE
PAGE
GETVIS %GETVIS
DURATION TIME
IO
SERVTIME
IO
IO
FAULTS
IO
USED
USED
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----00:00:00 0.094
48
0.046
0
20
27
0
0
0.0
00:01:26 0.111
2
0.018
0
0
16
0
4k
0.1
00:15:00 2.110
18
0.177
0
11
7
0
644k
44.4
00:07:26 0.004
83
0.020
0
6
28
0
0
0.0
00:15:00 0.000
0
0.000
0
0
0
0
2572k
73.8
00:15:00 0.202
9
0.028
0
0
5
0
664k
35.6
00:15:00 4.240
82
0.036
0
4
7
0
1260k
63.1
00:15:00 0.425
36
0.020
0
0
0
0
784k
39.1
00:15:00 2.024
3
0.039
0
0
6
0
699k
34.1
00:15:00 0.089
35
0.017
0
35
9
0
2696k
91.3
00:15:00 0.281
75
0.054
0
0
42
0
568k
29.5
00:15:00 0.599
2183
0.042
0
1179
3
0
148k
31.9
00:00:00 0.041
56
0.031
0
13
22
0
0
0.0
00:00:36 0.110
227
0.030
0
38
35
0
60k
1.6
00:01:48 0.055
153
0.022
0
29
68
0
0
0.0
00:01:02 0.130
227
0.016
0
38
28
0
64k
1.7
00:06:46 0.044
153
0.021
0
29
65
0
0
0.0
00:15:00 2.681
67
0.176
0
42
8
0
648k
44.6
00:00:42 0.050
13
0.031
0
0
7
0
0
0.0
00:15:00 0.000
0
0.000
0
0
0
0
2572k
73.8
00:15:00 0.176
5
0.014
0
0
7
0
664k
35.6
00:15:00 4.945
1752
0.026
0
86
56
0
1332k
66.7
00:15:00 0.432
33
0.025
0
1
2
0
784k
39.1
00:15:00 2.012
3
0.017
0
1
8
0
699k
34.1
00:15:00 0.098
173
0.034
0
173
0
0
2696k
91.3
00:15:00 0.886
279
0.035
0
15
249
0
572k
29.7
00:15:00 0.800
1480
0.021
0
491
7
0
152k
32.8
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----04:49:41 22.63
7195
0.032
0
2211
712
0
751k
42.4
-------- -------- -------- -------- -------- -------- -------- ----- ----------- -------- -------- ------
Default VSESTEP Report
The VSESTEP flashback report prints one line for every step executed.
The following commands produce a default VSESTEP flashback report:
FLASHBACK VSESTEP
FROM 03/10/04 14:00:00
TO
03/10/04 17:00:00
END
RUN
Chapter 13: Flashback Reports 519
Tailoring Default Flashback Reports
The preceding commands generate a report like the following:
PART
ID
---BG
BG
BG
F8
BG
BG
BG
BG
BG
F6
F6
F8
F2
F8
F8
F2
F2
F2
BG
BG
BG
BG
BG
F8
BG
BG
F6
F6
F6
F6
F6
F6
F6
F6
F6
F6
F6
F6
F7
F7
----
START
TIME
-------14.06.08
14.15.22
14.20.08
14.31.46
14.29.18
14.36.23
14.49.26
14.53.16
14.59.29
15.01.37
15.02.57
15.04.00
14.00.01
15.13.06
15.13.40
15.13.59
15.14.15
15.14.53
15.15.00
15.20.03
15.26.42
15.27.21
15.37.23
15.40.26
15.45.17
15.50.48
16.30.55
16.33.53
16.42.26
16.45.05
16.46.06
16.46.36
16.48.32
16.49.10
16.50.24
16.51.53
16.54.22
16.55.56
14.00.01
16.58.48
--------
END
TIME
-------14.07.34
14.15.58
14.21.10
14.31.56
14.30.06
14.36.59
14.50.30
14.53.31
15.00.44
15.01.39
15.03.00
15.04.10
15.12.58
15.13.24
15.13.47
15.14.12
15.14.51
15.14.56
15.19.55
15.22.16
15.27.00
15.29.29
15.37.38
15.41.22
15.46.54
15.51.24
16.31.00
16.33.56
16.42.36
16.45.10
16.46.35
16.47.24
16.48.59
16.49.14
16.50.36
16.52.05
16.54.27
16.56.03
16.58.37
17.00.01
--------
JOB
NAME
-------ALERT
TESTOSJ2
TESTOSJ2
IDCAMS
TESTOSJ2
TESTOSJ2
DLIUNLD
TESTOSJ2
DLIUNLD
LIBRRENA
LIBRRENA
S1FILEX2
CICSMROA
DFHDUMP
DFHDUMP
CICSMROA
CICSMROA
CICSMROA
DLIUNLD
DLIUNLD
DLIUNLD
DLIUNLD
TESTOSJ2
GSFAOEX
DLIUNLD
TESTOSJ2
REXXBAT
REXXBAT
MAINT
REXXBAT
ALT
ALT
GSBCOMUF
REXXBAT
MAINT
MAINT
REXXBAT
REXXBAT
JCLSCHED
JCLSCHED
--------
STEP
NAME
-------AXPBR14
TSIDMNT
TSIDMNT
IDCAMS
TSIDMNT
TSIDMNT
GDBDRVR
TSIDMNT
GDBDRVR
LIBR
LIBR
$LNKEDT
DFHSIP
DFHDUP
DFHDUP
DTRSETP
IDCAMS
IESWAITT
GDBDRVR
GDBDRVR
GDBDRVR
GDBDRVR
TSIDMNT
$LNKEDT
GDBDRVR
TSIDMNT
REXXBAT
REXXBAT
GVCMAINT
REXXBAT
AXPL10
AXPL7
$LNKEDT
REXXBAT
GVCMAINT
GVCMAINT
REXXBAT
REXXBAT
JCLSCHED
JCLSCHED
--------
TOTAL
TCPU
DISK
DISK
TAPE
OTHER
PAGE
PAGE
GETVIS %GETVIS
DURATION TIME
IO
SERVTIME
IO
IO
FAULTS
IO
USED
USED
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----00:01:26 0.206
50
0.045
0
20
43
0
2k
0.1
00:00:36 0.110
227
0.030
0
38
35
0
60k
1.6
00:01:02 0.130
227
0.016
0
38
28
0
64k
1.7
00:00:10 0.199
374
0.019
0
50
37
0
0
0.0
00:00:47 0.110
227
0.017
0
38
28
0
30k
1.6
00:00:36 0.109
227
0.013
0
38
28
0
0
0.0
00:01:04 2.670
2714
0.018
0
406
133
317
568k
15.5
00:00:15 0.089
224
0.026
0
38
28
0
0
0.0
00:01:15 3.713
2958
0.020
0
408
57
7
364k
9.9
00:00:03 0.055
111
0.019
0
6
25
0
0
0.0
00:00:03 0.056
111
0.023
0
6
17
0
0
0.0
00:00:11 0.308
372
0.016
0
43
109
0
0
0.0
01:12:56 10.72
1765
0.023
0
221
1259
37
798k
41.4
00:00:17 0.276
227
0.032
0
29
35
0
0
0.0
00:00:08 0.125
214
0.027
0
29
31
0
0
0.0
00:00:14 0.240
234
0.031
0
10
31
0
164k
16.2
00:00:35 0.293
1116
0.031
0
23
41
0
0
0.0
00:00:03 0.040
113
0.027
0
0
20
0
0
0.0
00:04:54 2.778
2718
0.051
0
410
51
0
572k
15.6
00:02:12 1.064
2299
0.034
0
395
50
0
568k
15.5
00:00:18 0.232
310
0.025
0
18
26
0
0
0.0
00:02:07 3.770
2999
0.035
0
410
52
0
0
0.0
00:00:15 0.093
227
0.028
0
38
28
0
0
0.0
00:00:56 0.549
568
0.034
0
45
114
0
0
0.0
00:01:38 2.755
2715
0.031
0
407
51
0
568k
15.5
00:00:35 0.109
224
0.017
0
38
28
0
0
0.0
00:00:04 0.093
141
0.017
0
35
37
0
0
0.0
00:00:03 0.066
100
0.024
0
2
30
0
0
0.0
00:00:09 0.164
297
0.022
0
75
38
0
96k
4.8
00:00:05 0.082
128
0.029
0
6
36
0
200k
9.9
00:00:30 0.468
732
0.032
0
24
33
0
88k
4.4
00:00:48 0.808
1443
0.028
0
53
100
0
260k
13.7
00:00:26 0.313
374
0.038
0
30
55
0
132k
8.7
00:00:05 0.079
130
0.026
0
6
36
0
0
0.0
00:00:12 0.162
297
0.030
0
75
29
0
0
0.0
00:00:12 0.156
278
0.036
0
75
29
0
0
0.0
00:00:05 0.081
131
0.028
0
7
35
0
0
0.0
00:00:07 0.081
130
0.048
0
6
35
0
200k
9.9
02:58:36 36.20
9153
0.031
0
1002
662
5
1408k
70.6
00:01:13 0.845
1048
0.028
0
52
94
0
0
0.0
-------- -------- -------- -------- -------- -------- -------- -------- -------- ------
Tailoring Default Flashback Reports
The following sections provide information and examples on how to create
unique flashback reports tailored to your own needs by using an ID option and
an identifier or by specifying the RANGE command with the FLASHBACK
command.
520 Report Reference Guide
Using ID Options to Limit FLASHBACK Reports
Using ID Options to Limit FLASHBACK Reports
To limit the information contained in a default flashback report to specific
resources, such as a single partition or those jobs beginning with the letters
ACCT, specify an ID option and one or more identifiers with the FLASHBACK
command.
The ID options you can use with the FLASHBACK command depend on the
record type you specify, as follows:
If You Specify This Record Type
Use These ID Options
VSESAMP
■
CPUID
■
CPUMOD
■
JOBID
■
PID
■
PNET
■
STEPID
■
VMID
■
ACCANC
■
ACCIDEN
■
ACNAME
■
ACNUMB
■
ACUSER
■
EXDCANC
■
EXDJOB
■
EXFRNO
■
EXFRUS
■
EXPHASE
■
EXPID
■
EXXNODE
■
ACCANC
■
ACCIDEN
■
ACNAME
■
ACNUMB
■
ACUSER
or
VSESTEP
or
VSEJOB
VSEEXEC
VSELIST
Chapter 13: Flashback Reports 521
Using ID Options to Limit FLASHBACK Reports
If You Specify This Record Type
Use These ID Options
■
LSTACCT
■
LSTADR
■
LSTFOR
■
LSTFRUS
■
LSTFRNO
■
LSTNODE
■
LSTTOUS
The following commands produce a flashback VSESTEP report on only those
jobs whose jobnames begin with IND:
FLASHBACK VSESTEP JOBID(IND*)
FROM
10/30/04 08.00.00
TO
10/30/04 12.00.00
END
RUN
The preceding commands generate a report like the following:
PART
ID
---F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F4
F3
F3
F3
F3
----
START
TIME
-------08.00.01
08.08.45
08.09.03
08.09.33
08.09.55
08.10.06
08.10.28
08.10.34
08.11.06
08.15.20
08.16.08
08.16.25
08.16.36
08.16.37
08.18.25
08.18.26
08.18.44
08.19.44
11.56.55
11.57.30
11.57.48
11.57.49
--------
END
TIME
-------08.08.45
08.09.03
08.09.32
08.09.54
08.10.05
08.10.28
08.10.33
08.11.05
08.15.20
08.16.08
08.16.25
08.16.35
08.16.37
08.17.50
08.18.26
08.18.43
08.19.10
08.20.10
11.56.55
11.57.48
11.57.49
12.00.00
--------
JOB
NAME
-------IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND020
IND020
IND020
IND020
--------
STEP
NAME
-------IN0070
IN1220
MTPBATCH
IN0125
IN0115
IN0116
IN0008
IN0040
IN0400
IN0420
IN0050
IN1210
TDYNASN
CPYDT
TDYNASN
CPYTD
IN0057
DP7005
GSFAQSHJ
DP7005
TDYNASN
CPYDT
--------
522 Report Reference Guide
TOTAL
TCPU
DISK
DISK
TAPE
OTHER
PAGE
PAGE
GETVIS %GETVIS
DURATION TIME
IO
SERVTIME
IO
IO
FAULTS
IO
USED
USED
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----00:08:43 14.73
13247
0.036
0
0
13
1
184K
29.7
00:00:17 0.540
318
0.036
0
0
98
1
304K
31.3
00:00:29 0.293
234
0.031
0
0
22
0
44K
35.5
00:00:20 0.478
312
0.037
0
0
46
6
112K
13.1
00:00:09 0.506
238
0.021
0
0
39
0
100K
11.7
00:00:21 0.795
495
0.032
0
0
32
0
60K
7.0
00:00:04 0.186
107
0.036
0
0
23
0
36K
5.9
00:00:31 1.061
664
0.033
0
0
59
30
160K
28.8
00:04:13 14.45
4372
0.054
0
0
65
0
352K
44.0
00:00:47 5.979
1452
0.028
0
0
56
0
68K
8.5
00:00:16 0.547
423
0.034
0
0
31
0
80K
13.0
00:00:09 0.306
197
0.036
0
0
76
0
252K
26.0
00:00:00 0.040
17
0.031
0
0
12
0
0
0.0
00:01:12 0.728
673
0.040
51
0
64
0
52K
6.9
00:00:00 0.040
17
0.041
0
0
12
0
0
0.0
00:00:16 0.523
499
0.029
22
0
52
0
40K
5.3
00:00:26 1.330
811
22
0
0
60
0
228K
41.1
00:00:24 1.822
982
0.021
0
0
53
0
168K
17.0
00:00:00 0.047
10
0.028
0
0
10
0
0
0.0
00:00:17 1.270
697
0.023
0
0
21
0
36K
3.7
00:00:00 0.040
17
0.033
0
0
12
0
4K
0.5
00:02:11 11.07
4377
0.033
2201
0
56
1
88K
11.6
-------- -------- -------- -------- -------- -------- -------- -------- -------- ------
Limiting Reports to Specified Variable Values
The following commands produce a flashback VSEJOB report on only those
jobs that executed in the BG partition and whose jobnames begin with either T
or D:
T
FLASHBACK VSEJOB PID(BG) JOBID(T*,D*)
FROM 03/10/04 06:00:00
TO
03/10/04 20:00:00
END
RUN
The preceding commands generate a report like the following:
SHIFT NONE
EACH
JOB
DATE
03/10/04
PART
START
END
ID
TIME
TIME
---- -------- -------BG 10.38.40 10.39.12
BG 10.43.17 10.44.02
BG 10.50.01 10.50.41
BG 10.51.14 10.53.00
BG 10.53.20 10.56.38
BG 10.57.06 10.59.05
BG 11.04.01 11.08.12
BG 11.38.08 11.47.07
BG 12.09.42 12.10.11
BG 13.46.46 13.46.50
BG 13.52.33 13.52.47
BG 14.15.22 14.15.58
BG 14.20.08 14.21.10
BG 14.29.18 14.30.06
BG 14.36.23 14.36.59
BG 14.49.26 14.50.30
BG 14.53.16 14.53.31
BG 14.59.29 15.00.44
BG 15.00.44 15.19.55
BG 15.20.03 15.22.16
BG 15.26.42 15.27.00
BG 15.27.21 15.29.29
BG 15.37.23 15.37.38
BG 15.45.17 15.46.54
BG 15.50.48 15.51.24
BG 18.01.54 18.02.01
BG 18.16.38 18.16.43
BG 18.18.59 18.19.03
---- -------- --------
JOB
NAME
-------DACBGEN
DACBGEN
DLITEST
DLITEST
DLITEST
DLITEST
DLITEST
DLITEST
DEVCOPY
TSIDDEB
TESTOSJ2
TESTOSJ2
TESTOSJ2
TESTOSJ2
TESTOSJ2
DLIUNLD
TESTOSJ2
DLIUNLD
DLIUNLD
DLIUNLD
DLIUNLD
DLIUNLD
TESTOSJ2
DLIUNLD
TESTOSJ2
TESTOSJ2
TESTALT
TESTALT
--------
STEP
NAME
-------$LNKEDT
$LNKEDT
GDBDRVR
GDBDRVR
GDBDRVR
GDBDRVR
GDBDRVR
GDBDRVR
LIBR
TSIDDEB
TSIDMNT
TSIDMNT
TSIDMNT
TSIDMNT
TSIDMNT
GDBDRVR
TSIDMNT
GDBDRVR
GDBDRVR
GDBDRVR
GDBDRVR
GDBDRVR
TSIDMNT
GDBDRVR
TSIDMNT
TSIDMNT
TSIDMNT
TSIDMNT
--------
TOTAL
TCPU
DISK
DISK
TAPE
OTHER
PAGE
PAGE
GETVIS %GETVIS
DURATION TIME
IO
SERVTIME
IO
IO
FAULTS
IO
USED
USED
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----00:00:31 0.568
938
0.027
0
114
158
0
28k
2.1
00:00:45 0.648
1045
0.036
0
139
185
0
131k
10.3
00:00:40 0.396
259
0.036
0
19
32
0
0
0.0
00:01:46 1.226
1644
0.026
0
228
41
0
0
0.0
00:03:18 1.459
2046
0.036
0
313
43
0
188k
5.1
00:02:00 3.741
2962
0.030
0
415
81
139
576k
15.7
00:04:11 6.798
3304
0.057
0
495
376
46
0
0.0
00:09:14 2.844
3087
0.044
0
477
123
0
0
0.0
00:00:28 0.254
640
0.034
0
68
46
0
0
0.0
00:00:04 0.085
99
0.025
0
8
33
0
0
0.0
00:00:13 0.091
224
0.014
0
38
28
0
0
0.0
00:00:36 0.110
227
0.030
0
38
35
0
60k
1.6
00:01:02 0.130
227
0.016
0
38
28
0
64k
1.7
00:00:47 0.110
227
0.017
0
38
28
0
30k
1.6
00:00:36 0.109
227
0.013
0
38
28
0
0
0.0
00:01:04 2.670
2714
0.018
0
406
133
317
568k
15.5
00:00:15 0.089
224
0.026
0
38
28
0
0
0.0
00:01:15 3.713
2958
0.020
0
408
57
7
364k
9.9
00:19:11 2.788
2881
0.049
0
417
103
0
286k
15.6
00:02:12 1.064
2299
0.034
0
395
50
0
568k
15.5
00:00:18 0.232
310
0.025
0
18
26
0
0
0.0
00:02:07 3.770
2999
0.035
0
410
52
0
0
0.0
00:00:15 0.093
227
0.028
0
38
28
0
0
0.0
00:01:38 2.755
2715
0.031
0
407
51
0
568k
15.5
00:00:35 0.109
224
0.017
0
38
28
0
0
0.0
00:00:06 0.085
227
0.016
0
38
28
0
60k
1.6
00:00:04 0.082
227
0.013
0
38
28
0
64k
1.7
00:00:04 0.085
227
0.014
0
38
28
0
60k
1.6
-------- -------- -------- -------- -------- -------- -------- -------- -------- ------
Limiting Reports to Specified Variable Values
Specify the RANGE command with the FLASHBACK command to produce a
report about only those resources that fulfill the specified range criteria. You
can specify more than one RANGE command in a single report.
Chapter 13: Flashback Reports 523
Creating Specialized Flashback Reports
The following commands produce a flashback VSESAMP report on only those
steps that used more than 10 seconds of CPU:
FLASHBACK VSESAMP
FROM 03/10/04 00:00:00
TO
03/11/04 00:00:00
RANGE VSE STEP TCPU 10+ DEFERRED
END
RUN
The preceding commands generate a report like the following:
SHIFT NONE
EACH
STEP INTVL
DATE
03/10/04
PART
START
END
ID
TIME
TIME
---- -------- -------F7 10.30.00 10.45.01
AR 10.45.01 11.00.01
F7 10.45.01 11.00.01
F7 11.00.01 11.15.01
F7 11.15.01 11.30.01
F7 11.30.01 11.45.01
F7 11.45.01 12.00.01
F7 12.00.01 12.15.01
F7 12.15.01 12.30.01
AR 12.30.01 12.45.01
F7 12.30.01 12.45.01
F7 12.45.01 13.00.01
---- -------- -------06.45.01 00.00.01
---- -------- --------
JOB
NAME
-------JCLSCHED
SYSTEM
JCLSCHED
JCLSCHED
JCLSCHED
JCLSCHED
JCLSCHED
JCLSCHED
JCLSCHED
SYSTEM
JCLSCHED
JCLSCHED
--------
STEP
NAME
-------JCLSCHED
SYSSTEP
JCLSCHED
JCLSCHED
JCLSCHED
JCLSCHED
JCLSCHED
JCLSCHED
JCLSCHED
SYSSTEP
JCLSCHED
JCLSCHED
--------
TOTAL
TCPU
DISK
DISK
TAPE
OTHER
PAGE
PAGE
GETVIS %GETVIS
DURATION TIME
IO
SERVTIME
IO
IO
FAULTS
IO
USED
USED
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----00:15:00 19.53
13465
0.042
0
112
42
23
1268k
63.5
00:15:00 14.26
783
0.051
0
5
7
59
648k
44.6
00:15:00 24.06
17299
0.040
0
266
32
23
1299k
64.7
00:15:00 17.02
11960
0.063
0
240
27
58
1452k
72.7
00:15:00 18.44
12546
0.054
0
113
18
3
1468k
73.5
00:15:00 17.99
11998
0.057
0
391
20
6
1452k
72.7
00:15:01 17.00
17897
0.052
0
318
36
0
1500k
75.2
00:15:00 25.17
9740
0.064
0
47
41
4
1444k
72.3
00:14:59 14.71
10294
0.090
0
46
18
0
1472k
73.7
00:15:00 10.78
242
0.046
0
3
5
0
644k
44.4
00:15:00 16.22
9106
0.100
0
161
55
5
1512k
75.8
00:15:00 11.57
6528
0.136
0
203
23
0
1608k
80.6
-------- -------- -------- -------- -------- -------- -------- -------- -------- -----176
1054
619K
0.046
1197
62609
37876
3970
612k
43.1
-------- -------- -------- -------- -------- -------- -------- ----- ----------- -------- -------- ------
Creating Specialized Flashback Reports
To produce a flashback report with columns different than the default report,
specify one or more variables with the FLASHBACK command. A column is
created in the report for each variable you specify.
The variables you can use with the FLASHBACK command depend on the
record type you specify.
The following table describes suggested variables for each record type:
If You Specify
This Record
Type:
Use These Variables:
VSEJOB
Any report writer variable except the following:
or
■
524 Report Reference Guide
VSE/POWER accounting (PACCNT) variables
Creating Specialized Flashback Reports
VSESAMP
or
■
System variables, as indicated in the Data column of
the tables describing the variables. For more
information, see the chapter "Variables."
■
General VSE/POWER accounting variables beginning
with AC (For more information, see the chapter
"Variables").
■
VSE/POWER accounting execution (EXEC) variables
(For more information, see the chapter "VSE/Power
Reports").
■
General VSE/POWER accounting variables beginning
with AC (For more information, see the chapter
"Variables").
■
VSE/POWER accounting list (LIST) variables (For
more information, see the chapter "Variables").
VSESTEP
VSEEXEC
VSELIST
The following commands produce a report showing information different from
the default VSEJOB flashback report. The FORMAT variable option specifies the
format for the variable VSE STEP TCPU.
FLASHBACK VSEJOB PID VSE STEP STARTDATE AND VSE STEP STARTTIME
AND,
VSE STEP ENDDATE
AND VSE STEP ENDTIME
VSE STEP JOBNAME
AND VSE STEP STEPNAME
VSE STEP DURT
AND VSE STEP TCPU
VSE STEP PAGE-IN
AND VSE STEP PAGE-OUT
VSE STEP RSTOR
AND VSE STEP COUNT
AND,
AND,
FORMAT(NNN.NNNN)
AND,
AND,
FROM 03/10/04 14:00:00
TO
03/10/04 17:00:00
END
RUN
Chapter 13: Flashback Reports 525
Using the Date and Time Operands
The preceding commands generate a report like the following:
PART
ID
---BG
BG
BG
F8
BG
BG
BG
BG
BG
F6
F6
F8
F2
F8
F8
BG
BG
BG
BG
BG
F8
BG
BG
F6
F6
F6
F6
F6
F6
F6
F6
F6
F6
F6
F7
F7
----
START
DATE
-------03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
--------
START
TIME
-------14.06.08
14.15.22
14.20.08
14.31.46
14.29.18
14.36.23
14.49.26
14.53.16
14.59.29
15.01.37
15.02.57
15.04.00
14.00.01
15.13.06
15.13.40
15.00.44
15.20.03
15.26.42
15.27.21
15.37.23
15.40.26
15.45.17
15.50.48
16.30.55
16.33.53
16.42.26
16.45.05
16.46.06
16.48.32
16.49.10
16.50.24
16.51.53
16.54.22
16.55.56
14.00.01
16.58.48
--------
END
DATE
-------03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
03/10/04
--------
END
TIME
-------14.07.34
14.15.58
14.21.10
14.31.56
14.30.06
14.36.59
14.50.30
14.53.31
15.00.44
15.01.39
15.03.00
15.04.10
15.12.58
15.13.24
15.13.47
15.19.55
15.22.16
15.27.00
15.29.29
15.37.38
15.41.22
15.46.54
15.51.24
16.31.00
16.33.56
16.42.36
16.45.10
16.47.24
16.48.59
16.49.14
16.50.36
16.52.05
16.54.27
16.56.03
16.58.37
17.00.01
--------
JOB
NAME
-------ALERT
TESTOSJ2
TESTOSJ2
IDCAMS
TESTOSJ2
TESTOSJ2
DLIUNLD
TESTOSJ2
DLIUNLD
LIBRRENA
LIBRRENA
S1FILEX2
CICSMROA
DFHDUMP
DFHDUMP
DLIUNLD
DLIUNLD
DLIUNLD
DLIUNLD
TESTOSJ2
GSFAOEX
DLIUNLD
TESTOSJ2
REXXBAT
REXXBAT
MAINT
REXXBAT
ALT
GSBCOMUF
REXXBAT
MAINT
MAINT
REXXBAT
REXXBAT
JCLSCHED
JCLSCHED
--------
STEP
NAME
-------AXPBR14
TSIDMNT
TSIDMNT
IDCAMS
TSIDMNT
TSIDMNT
GDBDRVR
TSIDMNT
GDBDRVR
LIBR
LIBR
$LNKEDT
DFHSIP
DFHDUP
DFHDUP
GDBDRVR
GDBDRVR
GDBDRVR
GDBDRVR
TSIDMNT
$LNKEDT
GDBDRVR
TSIDMNT
REXXBAT
REXXBAT
GVCMAINT
REXXBAT
AXPL7
$LNKEDT
REXXBAT
GVCMAINT
GVCMAINT
REXXBAT
REXXBAT
JCLSCHED
JCLSCHED
--------
TOTAL
TCPU
PAGE
PAGE
REAL
STEP
DURATION TIME
IN
OUT
PAGES
COUNT
-------- -------- -------- -------- -------- -------00:01:26
0.1114
0
0
0
1
00:00:36
0.1103
0
0
0
1
00:01:02
0.1300
0
0
0
1
00:00:10
0.1994
0
0
0
1
00:00:47
0.1101
0
0
33
1
00:00:36
0.1085
0
0
0
1
00:01:04
2.6703
72
245
72
1
00:00:15
0.0891
0
0
0
1
00:01:15
3.7125
3
4
96
1
00:00:03
0.0548
0
0
0
1
00:00:03
0.0556
0
0
0
1
00:00:11
0.3085
0
0
0
1
01:12:56 10.7236
37
0
790
1
00:00:17
0.2765
0
0
0
1
00:00:08
0.1247
0
0
0
1
00:19:11
2.7878
0
0
140
1
00:02:12
1.0639
0
0
130
1
00:00:18
0.2322
0
0
0
1
00:02:07
3.7704
0
0
227
1
00:00:15
0.0997
0
0
0
1
00:00:56
0.5486
0
0
14
1
00:01:38
2.7546
0
0
95
1
00:00:35
0.1088
0
0
0
1
00:00:04
0.0932
0
0
0
1
00:00:03
0.0660
0
0
0
1
00:00:09
0.1641
0
0
0
1
00:00:05
0.0817
0
0
0
1
00:01:19
1.2803
0
0
94
2
00:00:26
0.3126
0
0
0
1
00:00:05
0.0791
0
0
0
1
00:00:12
0.1623
0
0
0
1
00:00:12
0.1556
0
0
31
1
00:00:05
0.0809
0
0
0
1
00:00:07
0.0814
0
0
20
1
02:58:36 36.2053
5
0
433
1
00:01:13
0.8451
0
0
205
0
-------- -------- -------- -------- -------- --------
Using the Date and Time Operands
To produce a flashback report that has the date, time, or day in the first
column, or the date and time in the first two columns, specify the DATE, TIME,
DAY, or DATETIME operand with the FLASHBACK command.
You can use one of the DATE, TIME, DAY, or DATETIME operands only if you
create a specialized flashback report by specifying one or more ID options and
any desired variables with the FLASHBACK command.
526 Report Reference Guide
Using the Date and Time Operands
The following commands create a specialized VSJOB flashback report with the
first columns listing the date and time of each job included in the report. The
ID option and identifier PID(¬BG) restricts the report to jobs not run in
partition BG, and the RANGE commands restrict the report to jobs that lasted
longer than 1 minute (60 seconds) and that used at least 5 seconds of CPU.
FLASHBACK VSEJOB DATETIME PID(¬BG),
VSE STEP STARTTIME AND VSE STEP ENDTIME AND,
VSE STEP JOBNAME
AND VSE STEP STEPNAME AND,
VSE STEP DURT
AND VSE STEP TCPU
RANGE VSE STEP DURT 60+
RANGE VSE STEP TCPU 5+
END
RUN
The preceding commands generate a report like the following:
SHIFT
EACH
DATE
NONE
JOB
03/13/04
DATE
-------03/13/04
03/13/04
03/13/04
03/13/04
03/13/04
03/13/04
03/13/04
03/13/04
03/13/04
03/13/04
03/13/04
03/13/04
03/13/04
03/15/04
03/15/04
03/16/04
--------
PART
START
END
JOB
TIME
ID
TIME
TIME
NAME
-------- ---- -------- -------- -------09.24.42 F8 09.23.13 09.24.40 EXPRPT
09.27.15 F8 09.25.39 09.27.13 EXPRPT
09.27.56 FA 09.26.35 09.27.56 EXPRPT
09.40.28 F8 09.38.51 09.40.25 EXPRPT
11.20.48 FA 11.16.07 11.20.48 EXPRPT
11.36.17 F8 11.35.14 11.36.16 EXPRPT
11.36.39 FA 11.35.22 11.36.39 EXPRPT
11.55.25 F2 11.15.00 11.30.01 CICSMROA
12.47.27 FA 12.40.07 12.45.01 ASMDLI
15.54.36 F7 04.45.01 14.45.01 JCLSCHED
16.24.23 F2 12.17.16 12.30.00 CICSMROA
17.15.08 F7 16.15.00 17.00.01 JCLSCHED
17.44.42 F2 16.25.53 16.30.01 CICSMROA
13.15.11 F2 17.48.20 10.00.01 CICSMROA
21.14.43 F2 14.10.32 14.15.01 CICSMROA
13.41.16 FA 13.40.10 13.41.16 EXPRPT
-------- ---- -------- -------- --------
STEP
NAME
-------EXPRPT
EXPRPT
EXPRPT
EXPRPT
EXPRPT
EXPRPT
EXPRPT
DFHSIP
ASSEMBLY
JCLSCHED
DFHSIP
JCLSCHED
DFHSIP
DFHSIP
DFHSIP
EXPRPT
--------
TOTAL
TCPU
DURATION TIME
-------- -------00:01:26 7.889
00:01:34 7.420
00:01:22 7.750
00:01:34 8.521
00:04:41 5.015
00:01:02 5.027
00:01:17 5.475
00:15:01 5.360
00:04:55 5.326
02:14:58 64.22
00:12:44 6.544
00:30:00 12.25
00:04:07 6.879
00:18:48 13.30
00:04:29 5.117
00:01:05 7.482
-------- --------
Chapter 13: Flashback Reports 527
Chapter 14: VSE/POWER Reports
Before you can run VSE/POWER accounting reports, CA Explore PM for z/VSE
must log VSE/POWER records. To configure CA Explore PM for z/VSE to log
VSE/POWER records, do the following:
■
Set the POWRACCT configuration option to either YES or YNO.
■
Set the record types used by your reports to be logged from the Configure
Log Records panel.
For more information about performing these steps, see the Online User
Guide.
This chapter explains how to use the report writer to produce reports that use
VSE/POWER accounting records logged by CA Explore PM for z/VSE. The
commands for running nine different VSE/POWER accounting reports and
sample output for each report are also provided.
This section contains the following topics:
Creating VSE/POWER Accounting Reports (see page 529)
Prewritten VSE/POWER Accounting Reports (see page 532)
Creating VSE/POWER Accounting Reports
The report writer currently supports the VSE/POWER accounting record types
shown in the following table. To restrict a VSE/POWER accounting report or
variable to one of these record types, specify the ID option ACIDEN and the
identifier listed with either the TAB command or the variable, as explained in
the following sections.
Record Type
Description
ACIDEN Identifier
AFP
A
Advanced function printing records,
which contain information for a device
driving system (DDS) whenever the
DDS sends an account record order
that contains a valid AFP account
record
BSC
RJE bisynch records, which are
created when a user session signs off
or terminates.
T
EXEC
Execution records, which contain
information about every VSE jobstep.
E
Chapter 14: VSE/POWER Reports 529
Creating VSE/POWER Accounting Reports
Record Type
Description
ACIDEN Identifier
LIST
List records, which contain
information about printer activity.
L
PNET
NJE records, which contain
information about communication
path activity.
N
PUNCH
Punch records, which contain
information about punch-queue
activity.
P
READER
Reader records, which contain
information about every VSE/POWER
job submitted for spooling.
R
RECV
NJE receiver records, which are
created for every job or output
received from another node.
V
SNA
RJE SNA records, which are created
when a user session signs off or
terminates.
S
SYS
System-up records, which are created U
on completion of VSE/POWER startup.
TRANS
NJE transmitter records, which are
created for every job or output
transmitted to another node.
M
XCONN
Spool-access-connect records, which
contain information about spoolaccess-connection paths.
C
XSPOOL
X
Spool-access-operation records,
which contain information about
spool-access-connection operations. A
common use for this record is to
report on some types of laser printer
activity.
Organizing and Limiting VSE/POWER Accounting Reports
You should organize VSE/POWER accounting tabular reports by specifying one
or more VSE/POWER accounting ID options with the TAB command. Each row
in the resulting report will contain information about a single resource. For
example, specify the ID option ACNUMB with the TAB command to organize a
report by the job numbers assigned by VSE/POWER, with each row in the
report representing data corresponding to a single job number.
530 Report Reference Guide
Creating VSE/POWER Accounting Reports
If you do not specify an ID option with the TAB command, the resulting report
will be organized by time, with each row summarizing the values of all
variables for the time period, regardless of jobname, phase, partition, and so
on.
VSE/POWER accounting ID options are described in the "ID Options" chapter.
Limiting Entire Reports
The VSE/POWER accounting ID options beginning with AC select information
from most VSE/POWER accounting records supported by CA Explore PM for
z/VSE.
When you specify one of these ID options with the TAB or TAB2 command to
organize your reports, you should also specify the ID option ACIDEN and one
or more identifiers representing the record types that you want to include in
the report. The identifier associated with each record type is listed in the table
in Creating VSE/POWER Accounting Reports.
For example, the following commands use the ID option ACNAME to create a
tabular report organized by VSE/POWER jobname. The ID option and
identifiers ACIDEN(E,L,X) causes report data to be taken from execution, list,
and spool-access-operation records only.
TAB ACNAME ACIDEN(E,L,X) VSE PACCNT EXJOBCNT AND,
VSE PACCNT EXJDUR
AND,
VSE PACCNT EXCPUTM
Limiting Individual Columns in a Report
The VSE/POWER accounting variables beginning with AC are common to most
VSE/POWER accounting records supported by CA Explore PM for z/VSE. When
you use one of these variables, you must specify the ID option ACIDEN and
one or more identifiers with the variable. This limits the data represented by
the variable to one or more record types.
For example, in the following commands, the ID option and identifier
ACIDEN(E) is specified twice, causing the data for the variables VSE PACCNT
ACDATE and VSE PACCNT ACSTRT to be taken from execution records:
TAB ACNAME VSE PACCNT ACDATE ACIDEN(E) AND,
VSE PACCNT ACSTRT ACIDEN(E) AND,
VSE PACCNT EXJDUR
END
RUN
Chapter 14: VSE/POWER Reports 531
Prewritten VSE/POWER Accounting Reports
Prewritten VSE/POWER Accounting Reports
This section contains the commands you run to produce the following
VSE/POWER accounting reports:
This Report
Contains Information About
Combination Report
Each VSE/POWER job, using data from
execution, list, and spool-access-operation
records
Job and Step Report
Each job executed, including detailed
information about all its steps
Jobname and Device Report
The execution of each job, including
detailed information about the devices
each job used
List Output Report
All list output, sorted by VSE/POWER
jobname
Print Forms Report
Printed output, sorted by print form ID
Spool Access Report
Get-spool and put-spool activity performed
against a list queue entry; for example, an
external laser printer that uses
VSE/POWER spool access
Start, Stop, and Date Report
Each step executed, in chronological order
Unique Job Report
Each job executed, sorted by VSE/POWER
job number
Unique Step Report
Each step executed, sorted by jobname
You can directly run the commands for the reports shown in this chapter
without any modification, unless any modification is specified. When you run
these reports for the first time, you should add secondary commands (such as
FROM and TO) to limit the report output.
Combination Report
The Combination Report contains information about each VSE/POWER job,
using data from execution, list, and spool-access-operation records.
532 Report Reference Guide
Prewritten VSE/POWER Accounting Reports
A sample Combination Report is shown as follows:
POWER
JOB
-------17922
18772
18834
18842
18759
18800
18830
18875
18785
18836
18833
18828
18793
18778
18806
18908
18804
18874
18802
18812
18795
18805
18873
.
.
-------SUMMARY
--------
JOB
DURATION
-------00:32:31
00:25:16
00:22:30
00:20:14
00:19:15
00:11:58
00:11:58
00:10:51
00:09:43
00:08:55
00:07:20
00:05:57
00:05:16
00:05:01
00:04:27
00:04:13
00:04:09
00:03:51
00:03:34
00:02:51
00:02:34
00:02:28
00:02:15
.
.
-------04:17:30
-------- --------- --------- ---- --- -------DATE
-------10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
.
.
--------
EXECUTION
START
--------07.33.59
07.39.15
08.28.46
08.19.20
07.56.40
07.57.43
08.27.11
08.48.34
08.10.56
08.43.23
08.27.22
08.16.48
08.11.31
08.05.54
08.06.31
08.54.50
08.23.12
08.48.24
08.05.03
08.25.54
08.21.36
08.23.25
08.55.22
.
.
---------
EXECUTION PART VSE
STOP
ID CC
--------- ---- --08.06.31
BG 10
08.04.32
F5 FF
08.51.17
F3 18
08.39.35
BG 10
08.20.10
F4 10
08.36.46
F7 10
08.39.09
F5 10
08.59.25
F7 10
08.20.39
F5 10
08.52.18
F5 10
08.34.43
F4 10
08.22.46
F3 20
08.16.48
F3 10
08.10.55
F5 00
08.10.59
BG 10
08.59.03
BG 10
08.27.22
F4 10
08.52.16
BG 10
08.08.37
F3 10
08.28.46
F3 10
08.24.11
F5 00
08.25.54
F3 24
08.57.38
F5 10
.
.
.
.
.
.
--------- ---- ---
CPU
SIO
LINES
PRINT
TIME
COUNT
SPOOLED
START
-------- -------- ---------- -------00:01:07 60899
00:00:52 36246
77
00:00:57 41737
4,489
08.16.54
00:03:07 25806
634
08.19.07
00:00:35 27574
2,038
08.47.15
00:01:11 19508
4,120
08.52.17
00:01:30 25382
3,853
08.13.45
00:00:49 19167
5,298
08.35.38
00:01:02 18061
22,287
00:02:14 12017
10,815
08.17.15
00:00:00
278
363
08.16.30
00:00:02
4920
1,931
08.12.27
00:00:09
8536
7,919
00:00:21 17914
15,612
00:00:53
7616
11,930
08.10.59
00:00:02
2475
1
08.54.43
00:00:07
5898
2,148
00:00:07
7455
4
08.35.24
00:00:04
2405
28
00:00:05
4046
85
08.06.39
00:00:03
2600
62
00:00:01
7711
6,035
00:00:18
3789
08.35.04
.
.
.
.
.
.
.
.
-------- -------- ---------- -------00:17:45
490K
216,424
-------- -------- ---------- --------
PRINT
POWER LINES
PAGES
STOP
CC
PRINTED PRINTED
-------- ----- -------- ------
08.16.54
08.19.08
08.49.17
08.57.13
08.13.45
08.35.38
10
10
10
B0
10
10
08.17.15
08.16.30
08.12.27
10
10
10
08.18.18
08.54.43
2002
4128
104
79
10
10
11930
227
08.52.50
30
2
08.06.39
10
08.35.04 10
.
.
.
.
.
.
.
.
-------- ----- -------- -----30795
662
-------- ----- -------- ------
Commands
The following commands produce a Combination Report:
DEFINE VAR VSE PACCNT LINETOT = VSE PACCNT LSTNUM + VSE PACCNT XSPLNE#
DEFINE VAR VSE PACCNT PAGETOT = VSE PACCNT LSTPAG + VSE PACCNT XSPPGE#
TAB ACNUMB ACIDEN(E,L,X),
VSE PACCNT ACDATE
AND,
VSE PACCNT ACSTRT ACIDEN(E) HDR1(EXECUTION) HDR2(START) AND,
VSE PACCNT ACSTOP ACIDEN(E) HDR1(EXECUTION) HDR2(STOP)
AND,
VSE PACCNT EXPID
AND,
VSE PACCNT EXDCANC
AND,
VSE PACCNT EXJDUR
AND,
VSE PACCNT EXCPUTM
AND,
VSE PACCNT EXSIO
AND,
VSE PACCNT EXNLN
AND,
VSE PACCNT ACSTRT
ACIDEN(L,X) HDR1(PRINT) HDR2(START)
AND,
VSE PACCNT ACSTOP
ACIDEN(L,X) HDR1(PRINT) HDR2(STOP)
AND,
VSE PACCNT ACCANC
ACIDEN(L,X)
AND,
VSE PACCNT LINETOT HDR1(LINES) HDR2(PRINTED)
AND,
VSE PACCNT PAGETOT HDR1(PAGES) HDR2(PRINTED)
END
RUN
Chapter 14: VSE/POWER Reports 533
Prewritten VSE/POWER Accounting Reports
Command Functions
Some of the functions performed by the preceding commands are as follows:
■
The first DEFINE command defines the new variable VSE PACCNT
LINETOT, which calculates the total number of lines printed.
■
The second DEFINE command defines the new variable VSE PACCNT
PAGETOT, which calculates the total number of pages printed.
■
The ID option ACNUMB organizes the tabular report by VSE/POWER job
number.
■
The ID option and identifiers ACIDEN(E,L,X) causes the report data to be
taken from VSE/POWER execution, list, and spool-access-operation
records.
■
This ID option is also used with individual variables to further restrict
columns in the report; for example, the ID option and identifier ACIDEN(E)
causes the data for the variable VSE PACCNT ACSTRT to be drawn from
execution records only.
534 Report Reference Guide
Prewritten VSE/POWER Accounting Reports
Job and Step Report
The Job and Step Report contain information about each job executed,
including detailed information about all its steps.
The following is a sample Job and Step Report:
POWER
POWER
USER
PART
START
STOP
JOB
NAME
INFO
ID
TIME
TIME
DATE
-------- -------- ---------------- ---- -------- -------- -------17922
DPD070
BG 07.33.59 08.06.31 10/30/04
18759
IND028
F4 07.56.40 08.08.45 10/30/04
08.08.45 08.09.03 10/30/04
08.09.03 08.09.33 10/30/04
08.09.33 08.09.55 10/30/04
08.09.55 08.10.06 10/30/04
08.10.06 08.10.28 10/30/04
08.10.28 08.10.34 10/30/04
08.10.34 08.11.07 10/30/04
08.15.21 08.16.09 10/30/04
08.16.09 08.16.26 10/30/04
08.16.26 08.16.36 10/30/04
08.16.36 08.16.37 10/30/04
08.16.37 08.18.25 10/30/04
08.18.25 08.18.26 10/30/04
08.18.26 08.18.43 10/30/04
08.18.43 08.19.45 10/30/04
08.19.45 08.20.10 10/30/04
-------- -------- -------SUMMARY
-------- -------- -------18772
TICW02Y ++T RBT 07.39.13 F5 07.39.15 08.04.30 10/30/04
08.04.30 08.04.32 10/30/04
-------- -------- -------SUMMARY
-------- -------- -------.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
-------- -------- ---------------- ---- -------- -------- --------
VSE
JOB NAME
-------DPD070
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
IND028
--------
PHASE
NAME
-------CPYDT
IN0070
IN1220
MTPBATCH
IN0125
IN0115
IN0 16
IN0008
IN0040
IN0420
IN0050
IN1210
TDYNASN
CPYDT
TDYNASN
CPYTD
IN0057
DP7005
--------
VSE
CC
--10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
---
-------TICW02Y
TICW02Y
--------
-------PO0041
PO0042ZT
--------
--10
FF
---
-------- -------- --.
.
.
.
.
.
.
.
.
-------- -------- ---
JOB
DURATION
-------00:32:31
00:12:04
00:00:17
00:00:29
00:00:22
00:00:10
00:00:22
00:00:06
00:00:32
00:00:48
00:00:17
00:00:10
00:00:00
00:01:47
00:00:01
00:00:16
00:01:02
00:00:24
-------00:19:15
-------00:25:14
00:00:01
-------00:25:16
-------.
.
.
--------
CPU
TIME
-------00:01:07
00:00:18
00:00:00
00:00:00
00:00:00
00:00:00
00:00:00
00:00:00
00:00:01
00:00:06
00:00:00
00:00:00
00:00:00
00:00:00
00:00:00
00:00:00
00:00:03
00:00:01
-------00:00:35
-------00:00:52
00:00:00
-------00:00:52
-------.
.
.
--------
CPU
TIME
-------67.35
18.15
0.543
0.303
0.500
0.523
0.806
0.207
1.080
6.003
0.557
0.330
0.040
0.753
0.043
0.540
3.363
1.846
-------35.59
-------52.73
0.063
-------52.79
-------.
.
.
--------
SIO
COUNT
-------60899
16371
476
416
497
441
677
325
848
1636
623
385
227
869
230
710
1707
1136
-------27574
-------35875
371
-------36246
-------.
.
.
--------
Chapter 14: VSE/POWER Reports 535
Prewritten VSE/POWER Accounting Reports
Commands
The following commands produce a Job and Step Report:
TAB ACNUMB ACIDEN(E) SORT ALPHA VSE PACCNT ACNAME AND,
VSE PACCNT ACUSER AND,
VSE PACCNT EXPID
TAB2 ACSTRT VSE PACCNT ACSTOP SORT ASCENDING AND,
VSE PACCNT ACDATE
AND,
VSE PACCNT EXDJOB
AND,
VSE PACCNT EXPHASE
AND,
VSE PACCNT EXDCANC
AND,
VSE PACCNT EXJDUR
AND,
VSE PACCNT EXCPUTM
VSE PACCNT EXCPUTM
AND,
NXTIME
AND,
VSE PACCNT EXSIO
END
RUN
Command Functions
Some of the functions performed by the preceding commands are as follows:
■
The ID option ACNUMB organizes the tabular report by VSE/POWER job
number.
■
The ID option and identifier ACIDEN(E) causes the report data to be taken
from execution records.
■
The ID option ACSTRT organizes the subtable produced by the TAB2
command by the start time of each step in the job.
■
The variable option NXTIME converts the time variable VSE PACCNT
EXCPUTM from hh:mm:ss format into ssss.lll format, where ssss is
seconds and lll is milliseconds.
536 Report Reference Guide
Prewritten VSE/POWER Accounting Reports
Jobname and Device Report
The Jobname and Device Report contains information about the execution of
each job with detailed information about the devices each job used.
The following is a sample Jobname and Device Report:
POWER
JOB
JOB
DUR
CPU
CPU
CPU
SIO
DISK
TAPE
DISK
JOB NAME COUNT
DURATION
AVG
TIME
AVG
LOAD COUNT
SIO
SIO
CUU
-------- -------- -------- -------- -------- -------- ---- -------- -------- -------- -------GLR100T
2
00:05:01 00:02:30 00:00:21
10.648 7.1 17914
17914
050E
0632
0225
0862
.
.
.
-------SUMMARY
-------DELSRST
2
00:02:34 00:01:17 00:00:03
1.605 2.1
2600
2203
397
0225
0113
0385
000C
.
.
.
-------SUMMARY
-------CIN0190
2
00:01:33 00:00:46 00:00:09
4.578 9.8 15325
15325
050E
000C
000D
0742
.
.
.
-------SUMMARY
--------------- -------- -------- -------- -------- -------- ---- -------- -------- -------- -------SUMMARY
38
02:32:18 00:04:00 00:08:13
12.993 5.4
288K
258K
30020
-------- -------- -------- -------- -------- -------- ---- -------- -------- -------- --------
SIO
COUNT
-------10402
2070
1987
742
.
.
.
-------17914
-------490
441
397
212
.
.
.
-------2600
-------5359
4796
2606
529
.
.
.
-------15325
----------------------
Chapter 14: VSE/POWER Reports 537
Prewritten VSE/POWER Accounting Reports
Commands
The following commands produce a Jobname and Device Report:
DEFINE VAR VSE PACCNT EXCPUPCT = ( VSE PACCNT EXCPUTM * 1000 ) / VSE PACCNT
EXJDUR
DEFINE VAR VSE PACCNT EXDURA = ( VSE PACCNT EXJDUR )
/ VSE PACCNT EXJOBCNT
DEFINE VAR VSE PACCNT EXCPUA = ( VSE PACCNT EXCPUTM ) / VSE PACCNT EXJOBCNT
TAB ACNAME ACIDEN(E),
VSE PACCNT EXJOBCNT
AND,
VSE PACCNT EXJDUR
VSE PACCNT EXDURA
AND,
XTIME HDR1(DUR) HDR2(AVG)
VSE PACCNT EXCPUTM
VSE PACCNT EXCPUA
AND,
AND,
FORMAT(NNNN.NNN) HDR1(CPU) HDR2(AVG)
VSE PACCNT EXCPUPCT FORMAT(NN.N)
AND,
HDR1(CPU) HDR2(LOAD) AND,
VSE PACCNT EXSIO
AND,
VSE PACCNT EXSIO DEVID(04*,05*,06*,07*) HDR1(DISK) HDR2(SIO)
VSE PACCNT EXSIO DEVID(03*)
AND,
HDR1(TAPE) HDR2(SIO)
TAB2 DEVID VSE PACCNT EXSIO
END
RUN
Command Functions
Some of the functions performed by the preceding commands are as follows:
■
The first DEFINE command defines a new variable, VSE PACCNT
EXCPUPCT, which calculates the percentage of CPU load that each step
consumed.
■
The second DEFINE command defines a new variable, VSE PACCNT
EXDURA, which calculates the average amount of CPU time that each job
took to execute.
■
The third DEFINE command defines a new variable, VSE PACCNT EXCPUA,
which calculates the average CPU time consumed.
■
The ID option ACNAME organizes the tabular report by VSE/POWER
jobname. Each line in the report represents all occurrences of each job.
■
The ID option ACIDEN(E) causes the report data to be taken from
execution records.
■
The variable option XTIME converts the time variable VSE PACCNT
EXDURA into hh:mm:ss format.
■
The variable option FORMAT(NNNN.NNN) defines three decimal positions
for output of the variable VSE PACCNT EXCPUA.
■
The TAB2 command together with the ID option DEVID creates a subtable
of devices used by each job.
538 Report Reference Guide
Prewritten VSE/POWER Accounting Reports
Modifying the Commands
The ID options and identifiers DEVID(04*,05*,06*,07*) and DEVID(03*) are
used with the variable VSE PACCNT EXSIO to calculate SIO counts for disks
and tapes separately. Modify the identifiers to meet your site's configuration.
List Output Report
The List Output Report contains information about all list output, sorted by
VSE/POWER jobname.
The following is a sample List Output Report:
POWER
START
JOB
TIME
----------------APR250
09.24.05
CIN0190 08.57.41
GLR320
08.10.59
GLR320
08.11.19
IC1145
09.03.19
IND028
08.47.15
IN0057
09.12.25
IN0057
09.30.40
LIBR
08.37.24
LIBR
09.04.03
RCR545
09.22.01
RCR545
09.24.53
RCR545
09.25.22
RIE0100 08.59.12
TICM050 09.41.50
TICW02Z 09.39.15
TICW02Z 09.40.04
TICW02Z 09.40.21
TICW333 09.49.58
TICW333 09.52.01
TICW333 09.53.10
TNR066
09.01.52
TNR066
09.01.58
TN0090
09.51.23
TST061
09.01.10
TST061
09.36.21
TST061
09.38.16
VMR215
08.52.23
----------------SUMMARY
-----------------
STOP
TIME
-------09.24.53
08.59.12
08.11.04
08.18.18
09.04.03
08.49.17
09.21.55
09.36.21
08.38.21
09.05.00
09.24.05
09.25.22
09.25.43
08.59.31
09.44.34
09.40.04
09.40.20
09.40.31
09.51.23
09.53.10
09.54.20
09.01.58
09.03.19
09.52.01
09.01.51
09.38.16
09.39.15
08.52.50
--------
USER
POWER
PRT PRT
LINES
EXTRA
TOTAL
PAGES
EXTRA
TOTAL
INFO
CC
CL PRI CUU FORM PRINTED
RECORDS
LINES
PRINTED
PAGES
PAGES
-------- ----- -- --- --- ---- ---------- ---------- -------- ---------- ---------- ------KRE0700
10
A
3 50A 1485
1,106
116
1222
23
4
27
++O KAE
10
M
4 50A 1485
2,265
2265
41
41
GLR320
30
A
4 50A 1485
GLR320
10
A
4 50A 1485
11,930
116
12046
227
4
231
BIM AKW
10
M
3 50A 1485
743
743
13
13
REGULAR
10
V
9 50A INVO
2,002
116
2118
104
4
108
++C KEK
30
M
4 50A 1485
++C KEK
10
M
4 50A 1485
9,485
9485
189
189
SYSTEMS
10
A
3 50A
125
116
241
5
4
9
++T TDM
10
M
6 50A
125
116
241
5
4
9
RC9330
10
A
3 50A 1485
468
456
924
10
12
22
RC9335
10
A
3 50A 1485
468
116
584
10
4
14
RC2034
10
A
3 50A 1485
462
116
578
10
4
14
RIE0100
10
M
4 50A 1485
377
116
493
8
4
12
IC1012
10
M
3 50A 1285
3,853
116
3969
83
4
87
IC0410
10
M
3 50A 1485
1,157
116
1273
33
4
37
IC0420
10
M
3 50A 1485
312
116
428
6
4
10
IC0412
10
M
3 50A 1485
131
116
247
3
4
7
IC0333
10
M
3 50A 1485
1,824
116
1940
44
4
48
IC0333
10
M
3 50A 1485
1,810
116
1926
43
4
47
IC0333
10
M
3 50A 1485
1,822
116
1938
44
4
48
FIREARM
10
M
3 50A 1485
34
116
150
2
4
6
REGULAR
10
M
3 50A 1485
2,114
116
2230
54
4
58
++C KEK
10
M
4 50A 1485
1,075
1075
26
26
IC0061
10
M
3 50A 1485
845
116
961
38
4
42
IC0061B
10
M
3 50A 1285
47
221
268
2
8
10
IC0061
10
M
3 50A 1485
798
116
914
36
4
40
VM0241
30
B
3 50A 1285
2
58
60
2
2
-------- ----- -- --- --- ---- ---------- ---------- -------- ---------- ---------- ------45,380
2,939
48319
1,059
98
1157
-------- -------- -------- ----- -- --- --- ---- ---------- ---------- -------- ---------- ---------- ------DATE
-------10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
--------
Chapter 14: VSE/POWER Reports 539
Prewritten VSE/POWER Accounting Reports
Commands
The following commands produce a List Output Report:
DEFINE ID MYKEY ACNAME ' ' ACSTRT
DEFINE VAR VSE PACCNT TOTLINE
= VSE PACCNT LSTNUM + VSE PACCNT LSTEXR
DEFINE VAR VSE PACCNT TOTPAGE
= VSE PACCNT LSTPAG + VSE PACCNT LSTEXP
TAB MYKEY ACIDEN(L) SORT ALPHA HDR1(POWER
HDR2(JOB
START),
TIME ),
VSE PACCNT ACSTOP
AND,
VSE PACCNT ACDATE
AND,
VSE PACCNT ACUSER FORMAT(8C)
AND,
VSE PACCNT ACCANC
AND,
VSE PACCNT LSTOCL
AND,
VSE PACCNT LSTOPR
AND,
VSE PACCNT LSTADR
AND,
VSE PACCNT LSTFOR
AND,
VSE PACCNT LSTNUM
AND,
VSE PACCNT LSTEXR
VSE PACCNT TOTLINE
AND,
HDR1(TOTAL) HDR2(LINES) AND,
VSE PACCNT LSTPAG
AND,
VSE PACCNT LSTEXP
VSE PACCNT TOTPAGE
AND,
HDR1(TOTAL) HDR2(PAGES)
END
RUN
Command Functions
Some of the functions performed by the preceding commands are as follows:
■
The first DEFINE command defines a new key, MYKEY, which is made up of
the following:
■
ACNAME—VSE/POWER jobname.
■
ACSTRT—Time the list output started to print.
■
The second DEFINE command defines the new variable VSE PACCNT
TOTLINE, which represents the total number of lines printed.
■
The third DEFINE command defines the new variable VSE PACCNT
TOTPAGE, which represents the total number of pages printed.
■
The ID option and identifier ACIDEN(L) causes the report data to be taken
from VSE/POWER list records.
■
The variable option FORMAT(8C) alters the length of the variable VSE
PACCNT ACUSER from 16 characters to 8 characters.
540 Report Reference Guide
Prewritten VSE/POWER Accounting Reports
Print Forms Report
The Print Forms Report contains a summary of printed output, sorted by print
form ID.
The following is a sample Print Forms Report:
FORM
LINES
PRINTED
EXTRA
TOTAL
PAGES
EXTRA
TOTAL
ID
PRINTED
COPIES RECORDS
LINES
PRINTED
PAGES
PAGES
---- ---------- -------- ---------- -------- ---------- ---------- -------1485
39,226
20
2,196
41422
860
72
932
1285
3,902
4
395
4297
85
14
99
INVO
2,002
1
116
2118
104
4
108
---- ---------- -------- ---------- -------- ---------- ---------- -------SUM
45,380
27
2,939
48319
1,059
98
1157
---- ---------- -------- ---------- -------- ---------- ---------- -------
Commands
The following commands produce a Print Forms Report:
DEFINE VAR VSE PACCNT TOTLINE
= VSE PACCNT LSTNUM + VSE PACCNT LSTEXR
DEFINE VAR VSE PACCNT TOTPAGE
= VSE PACCNT LSTPAG + VSE PACCNT LSTEXP
TAB LSTFOR VSE PACCNT LSTNUM
AND,
VSE PACCNT LSTCOP
AND,
VSE PACCNT LSTEXR
AND,
VSE PACCNT TOTLINE HDR1(TOTAL) HDR2(LINES) AND,
VSE PACCNT LSTPAG
AND,
VSE PACCNT LSTEXP
AND,
VSE PACCNT TOTPAGE HDR1(TOTAL) HDR2(PAGES)
END
RUN
Command Functions
Some of the functions performed by the preceding commands are as follows:
■
The first DEFINE command defines the new variable VSE PACCNT
TOTLINE, which represents the total number of lines printed.
■
The second DEFINE command defines the new variable VSE PACCNT
TOTPAGE, which represents the total number of pages printed.
■
The ID option LSTFOR organizes the tabular report by form ID.
Chapter 14: VSE/POWER Reports 541
Prewritten VSE/POWER Accounting Reports
Spool Access Report
The Spool Access Report contains information about get-spool and put-spool
activity performed against a list queue entry (for example, an external laser
printer that uses VSE/POWER spool access).
The following is a sample Spool Access Report:
POWER
START
JOB
TIME
----------------ARR051
08.55.33
DPD010
08.52.17
DPD010
08.57.13
GLR320
07.54.15
IC1145
08.58.42
IND028
08.08.45
IND028
08.26.17
IND028
08.26.19
IND028
08.26.32
IND028
08.52.31
IND028
08.52.33
RIM010
08.57.03
RIM010
08.58.42
RIM010
09.03.01
RIM010
09.03.07
RI0035
08.04.29
VMR215
08.52.44
VMR215
08.53.26
VMR215
08.57.17
----------------SUMMARY
-----------------
STOP
TIME
-------09.31.06
08.52.44
08.57.13
08.29.21
08.58.42
08.26.17
08.26.19
08.26.20
08.26.32
08.52.31
08.52.33
08.57.34
08.58.44
09.03.01
09.03.07
08.04.31
08.52.45
08.55.33
08.57.17
--------
USER
POWER REQ
FORM
NUMBER
RECORD
EXTRA
PAGE
EXTRA
INFO
CC
TYP CL PRI DISP
ID
COPIES
COUNT
RECORDS
COUNT
PAGES
-------- ----- --- -- --- ---- -------- -------- -------- -------- -------- -------ARR051
B0
G A
3
L
1485
1
115
3
DP5777
40
G B
9
L
1285
1
4215
78
DP5777
B0
G B
9
L
1285
1
4
1
GLR320
B0
G A
4
L
1485
1
2107
41
BIM AKW
10
P M
3
D
1485
1
743
13
IN0065
40
G B
9
L
1285
1
38
1
IN0116-A 40
G B
9
L
1285
1
39
2
IN0116-C 40
G B
9
L
1285
1
1
IN0065
B0
G B
9
L
1285
1
3
1
IN0116-A B0
G B
9
L
1285
1
3
1
IN0116-C B0
G B
9
L
1285
1
1
GL0250
40
G B
3
L
1285
1
5269
104
RI8300
40
G B
3
L
1285
1
139
4
GL0250
B0
G B
3
L
1285
1
3
1
RI8300
B0
G B
3
L
1285
1
3
1
BIM GHB
10
P M
3
D
1485
1
1781
31
VM0242
40
G B
3
L
1285
2
4
4
VM0241
B0
G A
3
L
1285
2
4
4
VM0242
B0
G B
3
L
1285
2
3
-------- ----- --- -- --- ---- -------- -------- -------- -------- -------- -------22
14475
8
282
-------- -------- -------- ----- --- -- --- ---- -------- -------- -------- -------- -------- -------DATE
-------10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
--------
542 Report Reference Guide
Prewritten VSE/POWER Accounting Reports
Commands
The following commands produce a Spool Access Report:
DEFINE ID MYKEY ACNAME ' ' ACSTRT
TAB MYKEY ACIDEN(X) XSPQUID(L) SORT ALPHA HDR1(POWER
HDR2(JOB
VSE PACCNT ACSTOP
AND,
VSE PACCNT ACDATE
AND,
START),
TIME ),
VSE PACCNT ACUSER FORMAT(8C) AND,
VSE PACCNT ACCANC
AND,
VSE PACCNT XSPREQT
AND,
VSE PACCNT XSPCLSS
AND,
VSE PACCNT XSPPRIO
AND,
VSE PACCNT XSPDISP
AND,
VSE PACCNT XSPFORM
AND,
VSE PACCNT XSPCOPY
AND,
VSE PACCNT XSPREC#
AND,
VSE PACCNT XSPEXR#
AND,
VSE PACCNT XSPPGE#
AND,
VSE PACCNT XSPEXP#
END
RUN
Command Functions
Some of the functions performed by the preceding commands are as follows:
■
The first DEFINE command defines a new key, MYKEY, which is made up of
the following:
■
ACNAME—VSE/POWER jobname.
■
ACSTRT
■
The ID option and identifier ACIDEN(X) causes the report data to be taken
from VSE/POWER XSPOOL records.
■
The ID option and identifier XSPQUID(L) causes the report data to be
taken from VSE/POWER XSPOOL records with a queue type of L.
■
The variable option FORMAT(8C) alters the length of the variable VSE
PACCNT ACUSER from 16 characters to 8 characters.
—Time the list output started to print.
Chapter 14: VSE/POWER Reports 543
Prewritten VSE/POWER Accounting Reports
Start, Stop, and Date Report
The Start, Stop, and Date Report contains information about each step that
was executed, in chronological order. Each line in the report represents the
execution of one step.
A sample Start, Stop, and Date Report is shown as follows:
START
STOP
TIME
TIME
DATE
-------------------------07.33.59 08.06.31 10/30/04
07.39.15 08.04.30 10/30/04
07.56.40 08.08.45 10/30/04
07.57.43 08.00.59 10/30/04
08.00.42 08.00.53 10/30/04
08.00.53 08.01.15 10/30/04
08.00.59 08.01.00 10/30/04
08.01.00 08.03.30 10/30/04
08.01.15 08.01.23 10/30/04
08.01.24 08.01.49 10/30/04
08.01.49 08.02.03 10/30/04
08.02.03 08.02.31 10/30/04
08.02.31 08.02.56 10/30/04
08.02.56 08.03.16 10/30/04
08.03.16 08.03.26 10/30/04
08.03.26 08.03.57 10/30/04
08.03.30 08.03.31 10/30/04
08.03.57 08.04.07 10/30/04
08.04.08 08.05.01 10/30/04
08.04.30 08.04.32 10/30/04
08.04.32 08.05.02 10/30/04
08.05.01 08.05.03 10/30/04
08.05.02 08.05.31 10/30/04
.
.
.
.
.
.
.
.
.
-------------------------SUMMARY
--------------------------
POWER
NAME
-------DPD070
TICW02Y
IND028
DPD010
CRI0750
GL0002
DPD010
DPD010
GL0002
GL0135J
GL0135J
GL0150J
GL0150J
GL0000
GL0000
PR5115
DPD010
PR5115
TGL0002
TICW02Y
IC0061
TGL0002
IC0061
.
.
.
--------
JOB
DURATION
-------00:32:31
00:25:14
00:12:04
00:03:16
00:00:10
00:00:21
00:00:01
00:02:29
00:00:08
00:00:25
00:00:13
00:00:28
00:00:24
00:00:19
00:00:09
00:00:30
00:00:01
00:00:10
00:00:53
00:00:01
00:00:29
00:00:01
00:00:28
.
.
.
-------02:32:18
-------- -------- ---- -------- -------- ---- --- --------
544 Report Reference Guide
USER
PART
VSE
INFO
ID JOB NAME
-------- ---- -------BG DPD070
++T RBT
F5 TICW02Y
F4 IND028
SYSTEM
F7 DPD010
++O GHB
F3 CRI0750
++C AN2
F3 GL0002
SYSTEM
F7 DPD010
SYSTEM
F7 DPD010
++C AN2
F3 GL0002
++C JEK
F3 GL0135J
++C JEK
F3 GL0135J
++C JEK
F3 GL0150J
++C JEK
F3 GL0150J
++C JEK
F3 GL0000
++C JEK
F3 GL0000
++C JEK
F3 PR5115
SYSTEM
F7 DPD010
++C JEK
F3 PR5115
++T AN2
F3 TGL0002
++T RBT
F5 TICW02Y
++C RBT
F5 IC0061
++T AN2
F3 TGL0002
++C RBT
F5 IC0061
.
.
.
.
.
.
.
.
.
-------- ---- --------
PHASE
NAME
-------CPYDT
PO0041
IN0070
EXPUTIL
LNKEDT
FCOBOL
TDYNASN
EXPUTIL
LNKEDT
FCOBOL
LNKEDT
FCOBOL
LNKEDT
FCOBOL
LNKEDT
FCOBOL
TDYNASN
LNKEDT
GL0002T
PO0042ZT
FCOBOL
LISTLOG
LNKEDT
.
.
.
--------
REC
TYPE
---L
S
S
S
L
S
S
S
L
S
L
S
L
S
L
S
S
L
S
L
S
L
L
.
.
.
----
VSE
CC
--10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
FF
10
10
10
.
.
.
---
CPU
TIME
-------00:01:07
00:00:52
00:00:18
00:00:05
00:00:00
00:00:01
00:00:00
00:00:04
00:00:00
00:00:02
00:00:00
00:00:03
00:00:00
00:00:01
00:00:00
00:00:02
00:00:00
00:00:00
00:00:10
00:00:00
00:00:02
00:00:00
00:00:00
.
.
.
-------00:08:13
--------
CPU
SIO
LINES
PAGES
LOAD COUNT
SPOOLED
SPOOLED
---- -------- ---------- ------3.5 60899
3.5 35875
2.5 16371
3.0
5052
9
1
4.1
504
42
2
4.9
1046
527
13
3.9
235
2.9
4863
5
1
5.8
488
78
3
9.2
3165
2,601
54
5.2
671
134
3
11.7
4734
3,828
76
3.4
823
150
4
5.5
1137
579
15
5.0
524
74
3
7.8
2462
3,740
73
4.2
236
5.2
527
83
3
20.2
994
5
3.5
371
77
3
8.1
2499
4,225
84
2.6
221
6
1
2.5
728
133
3
.
.
.
.
.
.
.
.
.
.
.
.
---- -------- ---------- -----5.4
288K
136,262
2,909
---- -------- -----------------
Prewritten VSE/POWER Accounting Reports
Commands
The following commands produce a Start, Stop, and Date Report:
DEFINE ID MYKEY ACSTRT ' ' ACSTOP ' ' ACDATE
DEFINE VAR VSE PACCNT EXCPUPCT = ( VSE PACCNT EXCPUTM * 1000 ) / VSE PACCNT
EXJDUR
TAB MYKEY ACIDEN(E) SORT ALPHA HDR1(START
HDR2(TIME
STOP
),
TIME
DATE),
VSE PACCNT ACNAME
AND,
VSE PACCNT ACUSER FORMAT(8C)
AND,
VSE PACCNT EXPID
AND,
VSE PACCNT EXDJOB
AND,
VSE PACCNT EXPHASE
AND,
VSE PACCNT EXTYPE
AND,
VSE PACCNT EXDCANC
AND,
VSE PACCNT EXJDUR
AND,
VSE PACCNT EXCPUTM
AND,
VSE PACCNT EXCPUPCT FORMAT(NN.N) HDR1(CPU) HDR2(LOAD) AND,
VSE PACCNT EXSIO
AND,
VSE PACCNT EXNLN
AND,
VSE PACCNT EXNPG
END
RUN
Command Functions
Some of the functions performed by the preceding commands are as follows:
■
The first DEFINE command defines a new key, MYKEY, which is made up of
the following:
■
ACSTRT—Start time of the step.
■
ACSTOP—Stop time of the step.
■
ACDATE—Date of the step.
■
The second DEFINE command defines the new variable VSE PACCNT
EXCPUPCT, which represents the percentage of CPU load that each step
consumed.
■
The ID option and identifier ACIDEN(E) causes the report data to be taken
from execution records.
■
The variable option FORMAT(8C) alters the length of the variable VSE
PACCNT ACUSER from 16 characters to 8 characters.
■
The variable option FORMAT(NN.N) defines one decimal position for output
of the newly defined variable VSE PACCNT EXCPUPCT. When this variable
is defined, the CPU time is multiplied by 1000 before being divided by the
duration. This causes the percentage value that is created to contain one
decimal position.
Chapter 14: VSE/POWER Reports 545
Prewritten VSE/POWER Accounting Reports
Unique Job Report
The Unique Job Report contains information about each job executed, sorted
by VSE/POWER job number.
The following is a sample Unique Job Report:
POWER
JOB
-------17922
18772
18759
18800
18792
18797
18776
18777
18781
18788
18808
18798
18802
18807
18778
18806
18814
18816
18784
18785
18793
18828
18842
.
.
.
-------SUMMARY
--------
START
TIME
-------07.33.59
07.39.15
07.56.40
07.57.43
08.00.42
08.00.53
08.01.24
08.02.03
08.02.56
08.03.26
08.04.08
08.04.32
08.05.03
08.05.31
08.05.54
08.06.31
08.08.38
08.08.54
08.10.08
08.10.56
08.11.31
08.16.48
08.19.20
.
.
.
--------
STOP
TIME
-------08.06.31
08.04.32
08.20.10
08.03.31
08.00.53
08.01.23
08.02.03
08.02.56
08.03.26
08.04.07
08.05.03
08.05.31
08.08.37
08.05.54
08.10.55
08.10.59
08.08.54
08.10.08
08.11.31
08.20.39
08.16.48
08.22.46
08.26.35
.
.
.
--------
USER
PART
JOB
CPU
CPU
CPU
SIO
DISK
TAPE
INFO
ID DURATION
TIME
TIME
LOAD COUNT
SIO
SIO
---------------- ---- -------- -------- -------- ---- -------- -------- -------BG 00:32:31 00:01:07 67.35
3.5 60899
41194
19705
++T RBT 07.39.13 F5 00:25:16 00:00:52 52.79
3.5 36246
36246
F4 00:19:15 00:00:35 35.59
3.1 27574
27500
74
SYSTEM
F7 00:05:48 00:00:10 10.28
3.0 10386
9848
538
++O GHB 07.52.36 F3 00:00:10 00:00:00 0.440
4.1
504
504
++C AN2 07.56.28 F3 00:00:29 00:00:01 1.530
5.1
1534
1534
++C JEK 07.44.14 F3 00:00:39 00:00:03 3.046
7.8
3836
3836
++C JEK 07.44.30 F3 00:00:53 00:00:04 4.143
7.8
5557
5557
++C JEK 07.50.03 F3 00:00:29 00:00:01 1.580
5.4
1661
1661
++C JEK 07.53.09 F3 00:00:40 00:00:02 2.919
7.1
2989
2989
++T AN2 08.02.34 F3 00:00:55 00:00:10 10.86
19.6
1215
1215
++C RBT 07.57.19 F5 00:00:58 00:00:03 3.153
5.4
3227
3227
++T RBT 07.58.30 F3 00:03:34 00:00:04 4.506
2.1
2405
2025
380
++C KLO 08.00.28 F5 00:00:22 00:00:01 1.830
8.0
2360
2360
++T JEK 07.45.36 F5 00:05:01 00:00:21 21.29
7.1 17914
17914
BG 00:04:27 00:00:53 53.80
20.1
7616
7616
++O MJS 08.07.53 F3 00:00:15 00:00:01 1.619
10.2
6071
6071
++O MJS 08.07.53 F3 00:01:13 00:00:04 4.033
5.5
5238
5238
++T BIM 07.51.56 F3 00:01:22 00:00:01 1.993
2.4
2071
2071
++T RBT 07.52.10 F5 00:09:43 00:01:02 62.65
10.7 18061
15989
2072
++T JEK 07.54.53 F3 00:05:16 00:00:09 9.432
3.0
8536
8536
++T BNW 08.12.25 F3 00:05:57 00:00:02 2.499
0.7
4920
4646
274
++T AN1 08.19.06 BG 00:07:15 00:01:27 87.04
20.0
6860
1846
5014
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
---------------- ---- -------- -------- -------- ---- -------- -------- -------02:32:18 00:08:13 493.7
5.4
288K
258K
30020
-------- -------- -------- -------- ---------------- ---- -------- -------- -------- ---- -------- -------- -------DATE
-------10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
10/30/04
.
.
.
--------
546 Report Reference Guide
POWER
NAME
-------DPD070
TICW02Y
IND028
DPD010
CRI0750
GL0002
GL0135J
GL0150J
GL0000
PR5115
TGL0002
IC0061
TRSTRJNL
SG0462
GLR100T
GLR320
CDP0008
CDP0008
TWSR020
TICW333
TPR5115
MNTTAPE
TEST11
.
.
.
--------
Prewritten VSE/POWER Accounting Reports
Commands
The following commands produce a Unique Job Report:
DEFINE VAR VSE PACCNT EXCPUPCT = ( VSE PACCNT EXCPUTM * 1000 ) / VSE PACCNT
EXJDUR
TAB ACNUMB ACIDEN(E),
VSE PACCNT ACSTRT SORT ASCENDING
AND,
VSE PACCNT ACSTOP
AND,
VSE PACCNT ACDATE
AND,
VSE PACCNT ACNAME
AND,
VSE PACCNT ACUSER
AND,
VSE PACCNT EXPID
AND,
VSE PACCNT EXJDUR
AND,
VSE PACCNT EXCPUTM
VSE PACCNT EXCPUTM
AND,
NXTIME
AND,
VSE PACCNT EXCPUPCT FORMAT(NN.N) HDR1(CPU) HDR2(LOAD) AND,
VSE PACCNT EXSIO
AND,
VSE PACCNT EXSIO DEVID(04*,05*,06*,07*) HDR1(DISK) HDR2(SIO)
AND,
VSE PACCNT EXSIO DEVID(03*) HDR1(TAPE) HDR2(SIO)
END
RUN
Modifying the Commands
The ID options DEVID(04*,05*,06*,07*) and DEVID(03*) are used with the
VSE PACCNT EXSIO variable to calculate SIO counts for disks and tapes
separately. Modify the identifiers to meet your site's configuration.
Command Functions
Some of the functions performed by the preceding commands are as follows:
■
The first DEFINE command defines the new key MYKEY, which is made up
of the following:
■
ACNAME—VSE/POWER jobname.
■
ACSTRT—Time the list output started to print.
■
The second DEFINE command defines the new variable VSE PACCNT
EXCPUPCT, which represents the percentage of CPU load that each step
consumed.
■
The ID option ACNUMB organizes the tabular report by VSE/POWER job
number. Each line in the report represents one VSE/POWER job.
■
The ID option and identifier ACIDEN(E) causes the report data to be taken
from execution records.
Chapter 14: VSE/POWER Reports 547
Prewritten VSE/POWER Accounting Reports
■
The variable option NXTIME converts the time variable VSE PACCNT
EXCPUTM from hh:mm:ss format into ssss.lllll format, where ssss is
seconds and llll is milliseconds.
■
The variable option FORMAT(NN.N) defines one decimal position for output
of the variable VSE PACCNT EXCPUPCT.
Unique Step Report
The Unique Step Report contains information about each step executed, sorted
by jobname. Each line in the report represents the execution of one step. The
following is a sample Unique Step Report:
POWER
VSE
STEP
START
JOB
JOB
NAME
TIME
----------------------------------CATPROC CATPROC LIBR
17.51.37
CATPROC CATPROC LIBR
17.56.25
CATPROC CATPROC LIBR
17.56.44
EXPDASM EDECK
ASSEMBLY 17.48.36
EXPDASM EXPDASM ASSEMBLY 17.51.38
TST2COPY TST2COPY LIBR
17.56.45
TST2COPY TST2COPY LIBR
17.58.32
XMERROK EDECK
ASSEMBLY 17.39.53
XMERROK XMERROK ASSEMBLY 17.57.36
XMERROK XMERROK LIBR
17.40.55
XMEXPC
EDECK
ASSEMBLY 17.42.13
XMEXPC
XMEXPC
ASSEMBLY 17.56.59
XMEXPC
XMEXPC
LIBR
17.43.45
XMPLIST EDECK
ASSEMBLY 17.42.41
XMPLIST EDECK
ASSEMBLY 17.53.17
XMPLIST XMPLIST LIBR
17.43.57
----------------------------------SUMMARY
-----------------------------------
548 Report Reference Guide
STOP
TIME
-------17.51.53
17.56.32
17.56.50
17.48.47
17.51.51
17.56.52
17.58.36
17.40.04
17.57.45
17.41.01
17.42.27
17.57.08
17.43.48
17.42.50
17.53.26
17.43.59
--------
USER
PART
DATE
INFO
ID
-------- -------- ---02/19/04
F6
02/19/04
F6
02/19/04
F6
02/19/04
F6
02/19/04
F8
02/19/04
F8
02/19/04
F6
02/19/04
F6
02/19/04
F6
02/19/04
F6
02/19/04
F6
02/19/04
F6
02/19/04
F6
02/19/04
F6
02/19/04
F6
02/19/04
F6
-------- -------- ----
REC
TYPE
---L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
L
----
VSE
CC
--10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
10
---
JOB
DURATION
-------00:00:16
00:00:07
00:00:06
00:00:11
00:00:13
00:00:08
00:00:04
00:00:11
00:00:09
00:00:06
00:00:14
00:00:09
00:00:04
00:00:10
00:00:09
00:00:02
-------00:02:17
-------- -------- -------- ---- ---- --- --------
CPU
TIME
-------00:00:04
00:00:01
00:00:00
00:00:01
00:00:01
00:00:00
00:00:00
00:00:01
00:00:01
00:00:00
00:00:01
00:00:01
00:00:00
00:00:01
00:00:01
00:00:00
-------00:00:11
--------
CPU
SIO
LINES
PAGES
LOAD COUNT
SPOOLED SPOOLED
---- -------- -------- -------23.6 21177
8658
292
8.1
3697
37
2
6.4
3648
37
2
6.1
1241
77
5
4.8
1240
77
5
2.3
327
41
2
4.2
328
41
2
6.0
1420
143
4
7.2
1417
143
4
2.0
261
37
2
5.2
2184
359
8
7.8
2181
359
8
3.3
339
37
2
7.4
1973
302
7
7.8
1971
302
7
5.5
308
37
2
---- -------- -------- -------7.9 43712
10687
354
---- -------- -------- --------
Prewritten VSE/POWER Accounting Reports
Commands
The following commands produce a Unique Step Report:
DEFINE ID MYKEY ACNAME ' ' EXDJOB ' ' EXPHASE ' ' ACSTRTDEFINE VAR VSE PACCNT
EXCPUPCT = ( VSE PACCNT EXCPUTM * 1000 ) / VSE PACCNT EXJDUR
TAB MYKEY ACIDEN(E) SORT ALPHA HDR1(POWER
HDR2(JOB
VSE
STEP
START),
JOB
NAME
TIME),
VSE PACCNT ACSTOP
AND,
VSE PACCNT ACDATE
AND,
VSE PACCNT ACUSER FORMAT(8C)
AND,
VSE PACCNT EXPID
AND,
VSE PACCNT EXTYPE
AND,
VSE PACCNT EXDCANC
AND,
VSE PACCNT EXJDUR
AND,
VSE PACCNT EXCPUTM
AND,
VSE PACCNT EXCPUPCT FORMAT(NN.N) HDR1(CPU) HDR2(LOAD)
AND,
VSE PACCNT EXSIO
AND,
VSE PACCNT EXNLN
AND,
VSE PACCNT EXNPG
FROM 02/19/04 17:40:00
TO 02/19/04 18:00:00
END
RUN
Command Functions
Some of the functions performed by the preceding commands are as follows:
■
The first DEFINE command defines the new key MYKEY, which is made up
of the following:
■
ACNAME—VSE/POWER jobname.
■
ACSTRT—Time the list output started to print.
■
If the ID option ACNAME were used instead of MYKEY, each line in the
report would represent the sum of all the steps executed for each job.
■
The second DEFINE command defines the new variable VSE PACCNT
EXCPUPCT, which represents the percentage of CPU load that each step
consumed.
■
The ID option and identifier ACIDEN(E) causes the report data to be taken
from execution records.
■
The variable option FORMAT(8C) alters the length of the variable VSE
PACCNT ACUSER from 16 characters to 8 characters.
■
The variable option FORMAT(NN.N) defines one decimal position for output
of the variable VSE PACCNT EXCPUPCT.
Chapter 14: VSE/POWER Reports 549
Appendix A: User Exits
This appendix discusses the user exits supplied with CA Explore PM for z/VSE.
This section contains the following topics:
User Exit Execution (see page 551)
User Exit Execution
The CA Explore PM for z/VSE report writer lets you specify a user exit routine.
The report writer loads the exit routine during initialization and then passes
control to the routine according to the exit command you have specified.
Two user exit routines, EVSEGUX and PRTGUX, are supplied with CA Explore
PM for z/VSE. The following table shows the user exits, when the report writer
passes control to each, and the exit command used to specify that routine:
User Exit When Control Is Passed
Exit Command
EVSEGUX
After each record is read and before
the report writer processes the record
EXITRTN
PRTGUX
Before each line is printed
PRTEXIT
Source Code
The source code for the supplied user exits is given in the following members
in the CA Explore PM for z/VSE residence library.sublibrary:
Exit
Member
PRTGUX
PRTGUX.A
EVSEGUX
EVSEGUX.A
Important! If you modify either of the supplied user exits, make a backup
copy of the member using another name. When you install a new version of
CA Explore PM for z/VSE, PRTGUX.A and EVSEGUX.A will be overwritten.
Unless you have a backup copy of the member, you will lose any modifications
you made.
Appendix A: User Exits 551
Index
$ * (asterisk) • 144, 401, 419
comment line delimiter • 144
generic character in identifiers • 419
in output report • 401
including in reports • 188
Blank spaces • 144, 188
in commands • 144
replacing blank identifiers in reports • 188
replacing zero values in reports • 188
Braces, convention for use of • 145
Brackets, convention for use of • 145
BSC (RJE Bisynch) PACCNT variables • 287,
379
+ C + (plus sign) generic character in identifiers •
419
Cache • 79
statistics, canned report on • 79
CAEXPLORE • 17
report writer, introduction to • 17
Canned reports • 71, 72, 76, 149
CANRPT command, syntax of • 71
creating your own • 74, 75
deciding whether to use • 23
defined • 71
descriptions of • 76
expansion • 72
how canned reports work • 71, 149
running • 75
user-created reports • 75
tailoring • 73
VSE.CACHE.STAT • 79
VSE.CHANNEL.STAT • 80, 90
VSE.CICS.STAT • 81
VSE.CONTENTION.ANALYSIS • 83
VSE.CPU.ANALYSIS.STAT • 86
VSE.DELAY.ANALYSIS • 88
VSE.DISK.DSN.STAT • 91
VSE.DISK.STAT • 95
VSE.DSN.STAT • 96
VSE.GETVIS.STAT • 97
VSE.JOB.STAT • 100
VSE.LOCK.STAT • 101
VSE.LPAR.CPU.STAT • 103
VSE.PACCNT.STAT • 104
VSE.PAGE.STAT • 106
VSE.PID.CPU • 107
VSE.PRINT.FORMS.STAT • 108
VSE.PROGRAM.LOAD.STAT • 109
VSE.SAMCPU.BUSYR.STAT • 111
VSE.SAMPLE.COUNT.STAT • 117
$ (dollar sign) marking syntax error • 143
* ¬ ¬ (not sign) generic character in identifiers •
419
A Advanced Function Printing (AFP) PACCNT
variables • 287, 378
AFP (Advanced Function Printing) PACCNT
variables • 287, 378
ALONE operand • 199, 200, 203, 466
of PLOT command • 199, 466
of PLOT2 command • 199, 200
of RANGE command • 203
Archive file • 23, 31, 181, 188
description of • 23
JCL for reports using • 31
minimizing disk space using RECSTAT
operand of OPTION command • 188
using as input • 31, 181
Asterisk (*) • 144, 401, 419
comment line delimiter • 144
generic character in identifiers • 419
in output report • 401
AVERAGE line, printing in reports • 188
AVERAGE operand of OPTION command • 188
AVERAGED operand of EACH command • 160
B Banner in output, including • 34
Blank lines • 144, 188
in jobstream • 144
Index 553
VSE.SAMPLE.RATE.STAT • 118
VSE.SEEK.STAT • 120
VSE.SVC.STAT • 121
VSE.SYSCPU.BUSYR.STAT • 124
VSE.SYSCPU.BUSYV.STAT • 127
VSE.SYSTEM.STAT • 130
VSE.THRESHOLD.STAT • 133
VSE.VERSION4.DATA • 135
VSE.VM.CPU.STAT • 139
VSE.XA.DEVICE.STAT • 140
CANRPT command • 71, 73, 75
running canned reports • 75
user-created reports • 75
syntax • 71
using secondary commands with • 73
CARDLEN command • 149
Channel activity canned report • 80
CHAR1 operand • 68, 201, 468, 475, 477, 486,
488, 493, 499, 508, 509
of GRAF command • 508, 509
of GRAF2 command • 68
of MPLOT command • 493, 499
of PLOT command • 468
of PLOT2 command • 201
of VPLOT command • 475, 477
of VPLOT2 command • 486, 488
CHAR2 operand • 201, 468
of PLOT command • 468
of PLOT2 command • 201
Characters, nonprintable • 188
Charge-back reports • 150, 460
COST command description • 150
example • 460
Column headings • 41, 70, 441
changing • 441
in tabular reports • 441
meanings of • 41, 70
in FLASHBACK reports • 70
in tabular reports • 41
Combination Report • 532
Comma, for continuing to new line • 144
Command expansions • 72
Commands • 71, 143, 144, 149, 188
blank lines in jobstream • 144
blank spaces in jobstream • 144
CANRPT • 71
CARDLEN • 149
case • 143
COMMENT • 150
554 Report Reference Guide
comment lines in jobstream • 144
continuing to new line • 144
control cards, setting length of • 149
conventions for showing syntax • 145
COST • 150
COUNT • 153
DEFINE • 154, 431
using with ID options • 431
using with variables • 154
EACH • 159
END • 36, 162
EXCLUDE • 162
EXITRTN • 163
FLASHBACK • 164, 514
FROM • 165
GLOBAL • 169
GOTO • 170
GRAF • 503
GRAF2 • 64, 172
GROUP • 174
HEADER • 176
HPLOT • 177
HPLOT Plot reports • 497
HPLOT command • 497
IF • 178
INCLUDE • 179
INPUT • 180
INVOICE • 183
line length, setting • 149
LINECOUNT • 186
listing before printing • 34, 188
setting from EXEC statement • 34
setting with OPTION command • 188
MPLOT • 186, 490
OPTION • 187
OUTPUT • 195
PERIOD • 197
PLOT • 464
PLOT2 • 199, 200
position in line • 144
processing order • 144
PRTEXIT • 202
RANGE • 203
rules for entering • 143
RUN • 36, 205
secondary report • 27
SELECT • 206
SHIFT • 207
syntax conventions for presenting • 145
TAB2 • 212, 213
TABulate • 208, 436
TITLEn • 213
TO • 165
VPLOT • 215, 470
VPLOT2 • 217, 486
COMMENT command • 150
Comment line • 144, 150
delimiter, asterisk (*) as • 144
in jobstream • 144
in output reports • 150
CONTENTION variable class • 224, 316
Continuation character in commands • 144
Conventions • 20, 145
for syntax of commands • 145
vertical ellipses in reports • 20
COST command • 150, 460
description • 150
examples • 460
COUNT command • 153
COUNT variable option • 400
CPU • 103, 107, 111, 114, 124, 127
activity, canned reports on • 103, 111, 114,
124, 127
LPAR • 103
real • 111, 124
from sample record • 111
from system record • 124
virtual • 114, 127
from sample record • 114
from system record • 127
usage, canned report on • 107
CPU variable class • 228, 319
D Data set • 91, 96
activity, canned reports on • 91, 96
by start I/O count • 96
by volume • 91
DATAONLY operand • 34, 188
using with EXEC statement • 34
using with OPTION command • 188
DATASPACE variable class • 231, 323
DATE operand • 514
of FLASHBACK command • 514
DATEFRMT operand • 34, 188
with EXEC statement • 34
with OPTION command • 188
Dates • 34, 162, 166, 167, 179, 188, 214,
436, 526
excluding dates or date ranges • 162
for limiting report data • 166, 167
actual date • 166
relative date • 167
format of, setting • 34, 188
with EXEC statement • 34
with OPTION command • 188
including column for • 436, 526
in flashback report • 526
in tabular report • 436
including dates or date ranges • 179
including in report titles • 214
DATETIME operand • 436, 526
of FLASHBACK command • 526
of TAB command • 436
DAY operand • 437, 514
of FLASHBACK command • 514
of TAB command • 437
Decimal positions in output fields • 400
Default value, convention for presenting • 19,
145
DEFEREXT operand of OPTION command • 188
DEFERRED operand • 150, 203, 456, 523
of COST command • 150
of RANGE command • 203, 456, 523
description • 203
examples • 456, 523
with FLASHBACK command • 523
with TAB command • 456
DEFINE command • 104, 109, 154, 431, 433,
533, 538, 540, 543
using with ID options • 109, 431, 433, 540,
543
description • 431
examples • 109, 433, 540, 543
using with variables • 104, 154, 533, 538,
540
description • 154
examples • 104, 533, 538, 540
Delay statistics, canned report on • 86, 88
Devices • 79, 83, 90, 537
cache statistics, canned report on • 79
statistics, canned report on • 83, 90
VSE/POWER jobs, report on devices used •
537
Diagnostic dump of input • 188
Diagnostic tracing facility • 188
Index 555
DIFF variable option • 443, 444
description • 443
examples • 443, 444
Disk • 95, 188
activity, canned report on • 95
space, minimizing use of using RECSTAT
operand of OPTION command • 188
Disk file, sending output to • 195
Dollar sign ($) marking syntax error • 143
DUMP operand of OPTION command • 188
Dump, printing diagnostic dump of input • 188
E EACH command • 159, 200, 436, 441, 465,
473, 491, 498, 499, 511
description • 159
examples • 200, 436, 441, 465, 473, 491,
498, 499, 511
with GRAF • 511
with HPLOT and VPLOT • 499
with HPLOT command • 498
with MPLOT command • 491
with PLOT command • 465
with PLOT2 command • 200
with TAB command • 436, 441
with VPLOT command • 473
ECHO operand • 34, 188
with EXEC statement • 34
with OPTION command • 188
Ellipsis • 20, 145
horizontal, convention for use of • 145
vertical, convention for use of • 20
END command • 36, 162
End-of-file • 153, 188
on I/O error • 188
when maximum TO time is exceeded • 188
when specified number of records read •
153
ERPT267 message • 188
ERPT274 message • 188
ERPTTAB macro • 75
Errors • 143, 188
excluding messages from print and display
• 188
I/O, forcing end-of-file on • 188
in syntax, dollar sign ($) marking • 143
EVSEGUX (supplied user exit) • 163
EXITRTN command • 163
EXCLUDE command • 162
556 Report Reference Guide
Excluding identifiers with generic character •
419
EXEC statement • 33
parameters • 33
Execution (EXEC) PACCNT variables • 289, 380
EXITRTN command • 163, 551
description • 163
using • 551
Expansion, canned report • 72
EXPL-- variable classes • 224, 228, 316, 319
CONTENTION • 224, 316
CPU • 228, 319
DATASPACE • 231, 323
GETVIS • 244, 334
INTERRUPT • 247, 337
INTERVAL • 247, 337
JOB • 250, 340
LOCK • 251, 341
LPAR • 253, 343
LTA • 254, 344
MCPU • 256, 346
OPERATOR • 258, 348
OTHER • 259, 350
PAGE • 261, 351
PHASE • 263, 354
REAL • 265, 356
SVC • 274, 366
VM • 282, 373
WAIT • 282, 374
EXPRDT phase • 74
F File, sending output to • 195
FLASHBACK command • 69, 164, 514, 515
default report • 515
reading flashback reports • 69
syntax • 164, 514
Flashback file • 22, 30, 181
description of • 22
JCL for reports using • 30
using as input • 30, 181
Flashback reports • 69, 513, 514, 515
default report • 515
description of • 513
limiting output • 514
reading • 69
FOR operand • 47, 66, 449, 450, 508, 509,
510
of GRAF command • 508, 509, 510
of GRAF2 command • 66
of TAB command • 449, 450
with reports organized by identifier • 449
with reports organized by time and date
• 450
of TAB2 command • 47
FORMAT variable option • 109, 400, 430
using with ID options • 109, 430
using with variables • 400
description • 400
Formatting identifiersx_format • 429
FROM command • 165, 200, 436, 465, 473,
486, 491, 493, 505, 515, 516
description • 165
examples • 200, 436, 465, 473, 486, 491,
493, 505, 515, 516
with FLASHBACK command • 515, 516
with GRAF command • 505
with MPLOT command • 491, 493
with PLOT command • 465
with PLOT2 command • 200
with TAB command • 436
with VPLOT command • 473
with VPLOT2 command • 486
G Generic characters in identifiers • 419, 448,
455, 458, 468, 507
descriptions of • 419
examples • 448, 455, 458, 468, 507
in GRAF report • 507
in PLOT report • 468
in TAB report • 448, 455, 458
GETVIS • 49, 97, 244, 334, 460
GETVIS variable class • 244, 334
usage • 49, 97, 460
canned report • 97
sample reports • 49, 460
GLOBAL command • 169
description • 169
Global commands • 18
definition of • 18
Global values, excluding from a plot • 466
GOTO command • 170
GRAF command • 61, 503
reading GRAF reports • 61
syntax • 503
GRAF report • 503
GRAF2 command • 63, 64, 172
reading GRAF2 reports • 63
syntax • 64, 172
Graph reports • 61, 63, 67, 503, 509, 510
changing the scale of • 67, 509
defined • 503
reading • 61, 63
GRAF reports • 61
GRAF2 reports • 63
overview • 61
sorting • 510
GROUP command • 174, 458
description • 174
examplesgroupexamples • 458
H HDR operand • 470, 486, 490
of MPLOT command • 490
of VPLOT command • 470
of VPLOT2 command • 486
HDR1 operand • 441, 470, 486, 490
of MPLOT command • 490
of TAB command • 441
of VPLOT command • 470
of VPLOT2 command • 486
HDR2 operand • 441, 470, 486, 490
of MPLOT command • 490
of TAB command • 441
of VPLOT command • 470
of VPLOT2 command • 486
HEADER command • 176
Hexadecimal, specifying identifiers using • 420
HEXID operand of OPTION command • 188
HIGHLIGHT operand of RANGE command • 203
History reporting • 19, 39
command syntax • 19
commands in job stream • 39
Horizontal reports • 464, 496
HPLOT command • 60, 177, 497, 498, 499
reading HPLOT reports • 60
syntax • 177, 497
using with MPLOT command • 499
using with VPLOT command • 498
I I/O errors, end-of-file on • 188
ID operand • 162, 180, 447
of the EXCLUDE command • 162, 447
using with the SELECT option • 447
of the INCLUDE command • 180, 447
Index 557
using with the SELECT option • 447
ID options • 18, 26, 409, 410, 419, 420, 425,
426, 428, 430, 431
defining new • 431
definition of • 18, 410
formatting • 430
introduction to • 26
redefining • 431
specifying identifiers with • 419, 420
using with • 420, 425, 426, 428
both commands and variables • 428
commands • 420
commands or variables--the difference •
426
variables • 425
Identifiers • 18, 26, 178, 188, 410, 419, 420,
429
assigning new values for • 178
definition of • 18, 410
description of • 419
excluding with generic character • 419
formattingx_format • 429
generic characters • 419
hexadecimal specification • 420
introduction to • 26
INVALID (for nonprintable identifier) • 188
purpose of • 419
specifying with ID options • 419
string printed when no identifier exists •
188
IF command • 178
INCLUDE command • 179
Input • 153, 165, 180, 181, 182, 188, 401,
405, 440, 463
files, list of • 181
INPUT command • 180
limiting records read • 153, 165
by count • 153
by date and time • 165
printing diagnostic dump of used or
corrupted records • 188
producing statistics on • 188
using both VSE and another CA Explore's
data • 182
using both VSE and another CA EXPLORE's
data • 440, 463
using records with negative values • 401
zero values, including records with • 405
INPUT command • 180, 440
558 Report Reference Guide
description • 180
examples • 440
INTERRUPT variable class • 247, 337
INTERVALvariable class • 247, 337
INVALID, used for nonprintable identifiers •
188
INVOICE command • 183
IOERR operand of OPTION command • 188
J JCL for running reports • 30, 31, 32, 33
using archive file • 31
using flashback file • 30
using log file • 32, 33
from disk • 33
from tape • 32
Job and Step Report • 535
Jobname and Device Report • 537
Jobs • 100, 250, 340, 532, 535, 537, 539, 546
job information, canned report on • 100
JOB variable class • 250, 340
VSE/POWER jobs, prewritten reports on •
532, 535, 537, 539, 546
JOBZONE operand of OPTION command • 188
L LINECOUNT command • 186
Lines on a page, number of • 186
List Output Report • 539
LIST PACCNT variables • 291, 382
Lock statistics, canned report on • 101
LOCK variable class • 251, 341
Log file • 23, 32, 33, 181
description of • 23
JCL for reports using • 32, 33
disk log file • 33
tape log file • 32
using as input • 32, 33, 181
LOGICAL variable option • 401
Lowercase • 143, 145
convention for use of • 145
using in commands • 143
LPAR CPU activity, canned report on • 103
LPAR variable class • 253, 343
LTA variable class • 254, 344
M MAX variable option • 402
MAXDATE variable option • 402, 403
MAXTIME variable option • 402, 403
MAXTO operand of OPTION command • 188
MCPU variable class • 256, 346
Messages • 188
ERPT267 • 188
ERPT274 • 188
excluding from print and display • 188
status messages • 188
MIN variable option • 402
MONETARY operand of OPTION command •
188
MPLOT command • 57, 186, 490, 491, 493,
499
examples • 491, 493
reading MPLOT reports • 57
syntax • 186, 490
using with the HPLOT command • 499
N n/a, printing instead of blank identifier • 188
Negative values, treating as unsigned • 401
Network (PNET) PACCNT variables • 294, 384
NJE Transmitter PACCNT variables • 302, 393
Nonprintable characters • 188
Not sign (¬) generic character in identifiers •
419
NULLID operand of OPTION command • 188
NULLINE operand of OPTION command • 188
NXTND variable option • 407, 458
description • 407
example • 458
O Operand • 18
definition of • 18
OPERATOR variable class • 258, 348
OPTION command • 187
Or-sign, convention for use of • 145
OTHER variable class • 259, 350
OUTPUT command • 195
P PACCNT variables • 287, 289, 291, 294, 295,
297,
Advanced Function Printing (AFP) • 287,
378
Execution (EXEC) • 289, 380
LIST • 291, 382
Network (PNET) • 294, 384
NJE Transmitter (TRANS) • 302, 393
PUNCH • 295, 386
READER • 297, 388
Receiver (RECV) • 298, 389
RJE Bisynch (BSC) • 287, 379
Spool-Access-Connect (XCONN) • 304, 395
Spool-Access-Operation (XSPOOL) • 305,
396
System Network Architecture (SNA) • 300,
391
System-up (SYS) • 301, 392
Page length, setting • 186
PAGE variable class • 261, 351
Paging statistics canned reports • 106
Parentheses, convention for use of • 19, 145
PerCenT variable option • 403
PERIOD • 50, 188
line in plot reports • 50, 188
line in tabular reports • 188
PERIOD command • 197
PERIOD operand of OPTION command • 188
PGMSTOR operand of OPTION command • 188
PHASE variable class • 263, 354
PLOT command • 50, 464
syntax • 464
Plot report • 50
Plot reports • 50, 52, 53, 55, 57, 60, 200, 463,
464, 470, 486, 490
description of • 463
MPLOT command • 490
PLOT command • 464
PLOT2 command • 200
reading • 50, 52, 53, 55, 57, 60
HPLOT reports • 60
MPLOT reports • 57
overview • 50
PLOT2 reports • 52
VPLOT reports • 53
VPLOT2 reports • 55
VPLOT command • 470
VPLOT2 command • 486
PLOT2 command • 52, 199, 200
reading PLOT2 reports • 52
syntax • 199, 200
Plus sign (+) generic character in identifiers •
419
PNET (Network) PACCNT variables • 294, 384
Primary report commands • 18, 35, 147
definition of • 18, 147
Index 559
list of • 35, 147
Print Forms Report • 541
Printing statistics, canned report on • 108
Program load statistics, canned report on • 109
PRTEXIT command • 202, 551
description • 202
using • 551
PUNCH PACCNT variables • 295, 386
PWRDATE operand of OPTION command • 188
PWRPREFIX operand of OPTION command •
188
R RANGE • 50, 188
line in plot reports • 50, 188
RANGE command • 73, 203, 455, 456, 458,
523
description • 203
examples • 73, 455, 456, 458, 523
with canned report • 73
with FLASHBACK command • 523
with TAB command • 455, 456, 458
RANGE operand of OPTION command • 188
RANGE variable option • 457
RATE variable option • 201, 403, 404, 444,
469
description • 403
examples • 201, 444, 469
with PLOT • 469
with PLOT2 • 201
with TAB command • 444
restriction • 403
READER PACCNT variables • 297, 388
REAL variable class • 265, 356
RECAP operand of OPTION command • 188
Receiver (RECV) PACCNT variables • 298, 389
RECSTAT operand of OPTION command • 188
RECV (Receiver) PACCNT variables • 298, 389
report • 114
Report commands • 18
definition of • 18
Report definition table (RDT) • 74, 75
Report writer • 17, 18, 29
concepts • 18
introduction • 29
introduction to • 17
Report writer commands • 18
definition of • 18
Reports • 17,
560 Report Reference Guide
banner, including • 34
defining field length • 400
EXEC statement parameters • 33
Flashback • 513
formats available • 23
GETVIS usage, examples • 460
GRAF • 503
horizontal • 464, 496
including lines with no activity in reports •
188
input • 153, 165, 180
limiting records read • 153, 165
COUNT command • 153
FROM command • 165
TO command • 165
specifying files read • 180
JCL for running • 30, 31, 32, 33
using archive file • 31
using flashback file • 30
using log file • 32, 33
from disk • 33
from tape • 32
listing commands used • 34, 188
setting from EXEC statement • 34
setting with OPTION command • 188
minimal commands for writing • 36
MPLOT • 470
overview of • 17
printing zeros in • 188
reading • 50, 61, 69
flashback reports • 69
graph reports • 61
plot reports • 50
sample JCL • 30, 31, 32, 33
using archive file • 31
using flashback file • 30
using log file • 32, 33
from disk • 33
from tape • 32
setting page length of • 186
tailoring with secondary report commands •
38
titles • 213
types of • 23
vertical • 470
vertical ellipses in • 20
VPLOT • 470
VPLOT2 • 470
writing • 29
REWIND operand of OPTION command • 188
Rewinding tape after input • 188
RIGHT variable option • 447
RJE Bisynch (BSC) PACCNT variables • 287,
379
RPTSTAT operand of OPTION command • 188
RUN command • 205
S Sample fields, displaying • 117, 118
as counts, VSE.SAMPLE.STAT canned report
• 117
as rates, VSE.SAMPLE.RATE.STAT canned
report • 118
SCALE operand • 67, 200, 467, 473, 475, 477,
486, 488, 491, 493, 498, 509, 510
of GRAF command • 509, 510
of GRAF2 command • 67
of HPLOT command • 498
of MPLOT command • 491, 493
of PLOT command • 467
of PLOT2 command • 200
of VPLOT command • 473, 475, 477
of VPLOT2 command • 486, 488
SCATTER operand of HPLOT command • 501
Secondary report commands • 18, 36, 38, 147,
148
definition of • 18, 36, 147
list of • 148
using to tailor reports • 38
SEEKCHAR operand of OPTION command • 188
Seeks • 120, 478
creating seek analysis reports • 478
seek activity, canned report on • 120
SELECT command • 109, 206
description • 206
examples • 109, 206
SELECT variable option • 446
SELZERO variable option • 405
SHIFT command • 207, 510
description • 207
example with GRAF command • 510
SNA (System Network Architecture) PACCNT
variables • 300, 391
SORT operand • 64, 213, 450, 510
of GRAF command • 510
of GRAF2 command • 64
of TAB command • 450
of TAB2 command • 213
Sorting • 450, 510
graph reports • 510
tabular reportsxsorting • 450
Spool Access Report • 542
Spool-Access-Connect (XCONN) PACCNT
variables • 304, 395
Spool-Acess-Operation (XSPOOL) PACCNT
variables • 305, 396
STACK operand of VPLOT command • 484
Start, Stop, and Date Report • 544
Steps • 535, 544, 548
VSE/POWER jobsteps, reports on • 535,
544, 548
Storage • 188
acquiring above or below 16M line • 188
printing storage statistics • 188
tracing storage requests • 188
usage by report writer, displaying • 188
STORAGE operand of OPTION command • 188
STORSTAT operand of OPTION command • 188
Summary line in tabular reports • 188
SUMMARY operand of OPTION command • 188
SVC • 121, 274, 366
activity, canned report on • 121
SVC variable class • 274, 366
Syntax • 143, 145
conventions for presenting commands • 145
errors, marked with dollar sign • 143
System activity, canned report on • 130
System Network Architecture (SNA) PACCNT
variables • 300, 391
System-up (SYS) PACCNT variables • 301, 392
T TAB2 command • 44, 212, 213
reading TAB2 reports • 44
syntax • 212, 213
TAB2SKIP operand of OPTION command • 188
Tabular reports • 42, 43, 44, 435, 450
introduction to • 435
reading • 42, 43, 44
complex TAB reports • 43
simple TAB reports • 42
TAB2 reports • 44
simple reports • 42
sortingxsorting • 450
TABulate command • 208, 211
syntax • 208, 211
Tape file, sending output to • 195
Index 561
Tape, rewinding after input • 188
Thresholds • 133
threshold information, canned report on •
133
Time • 162, 166, 167, 179, 188, 197, 207,
214, 406, 436, 526
defining shifts • 207
defining time periods • 197
excluding time ranges • 162
format for output • 406
hhh • 406
mm • 406
ss • 406
lll • 406
ssss.llll • 406
including column for • 436, 526
in flashback report • 526
in tabular report • 436
including in report titles • 214
including time ranges • 179
specifying for report data • 166, 167
actual time • 166
relative time • 167
zone, setting • 188
TIME operand • 438, 514
of FLASHBACK command • 514
of TAB command • 438
TITLEn command • 213
description • 213
TO command • 165, 188, 200, 436, 465, 473,
486, 491, 493, 505, 515, 516
description • 165
examples • 200, 436, 465, 473, 486, 491,
493, 505, 515, 516
with FLASHBACK command • 515, 516
with GRAF command • 505
with MPLOT command • 491, 493
with PLOT command • 465
with PLOT2 command • 200
with TAB command • 436
with VPLOT command • 473
with VPLOT2 command • 486
maximum TO time checking • 188
TOTAL variable option • 405, 406
Trace (diagnostic tracing facility) • 188
TRACE operand of OPTION command • 188
TRANS (NJE Transmitter) PACCNT variables •
302, 393
562 Report Reference Guide
U UNDERLINE operand of RANGE command •
203
Underscoring, convention for use of • 19, 145
Unique Job Report • 546
Unique Step Report • 548
Uppercase • 19, 143, 145
convention for use of • 19, 145
using in commands • 143
User exits • 163, 188, 202, 551
defining exit to be called • 163, 202, 551
EXITRTN command • 163, 551
PRTEXIT command • 202, 551
processing order • 188, 551
supplied user exits • 551
EVSEGUX • 551
PRTGUX • 551
V Variable options • 18, 400, 401, 402, 403,
405, 406, 407, 430, 443, 444, 446, 447
COUNT • 400
definition of • 18
DIFF • 443
FORMAT • 400, 430
using with ID options • 430
using with variables • 400
LOGICAL • 401
MAX • 402
MAXDATE • 402
MAXTIME • 402
MIN • 402
NXTIME • 406
NXTND • 407
PerCenT • 403
RATE • 403, 444
RIGHT • 447
SELECT • 446
SELZERO • 405
syntax • 400
TOTAL • 405
XTIME • 406
XTIMEM • 406
XTND • 406
Variables • 145, 188, 224, 316, 444
changing from count to rate • 444
convention for presenting • 145
defining new • 154
digits in output • 406
forming • 217, 309
negative, including in input • 401
negative, treating as unsigned • 401
parts of • 217, 309
printing • 188, 402, 403, 405, 406, 407
as a maximum or minimum value • 402
as a percentage • 403
as a rate • 403
as a total • 405
date of highest value • 402
fewer digits • 407
more digits • 406
time of highest value • 402
zero values • 188
purpose of • 26
time format of • 406
hhh • 406
mm • 406
ss • 406
lll • 406
ssss.llll • 406
zero values, including records with • 405
VARS operand of GRAF2 command • 68
Vertical bar, convention for use of • 145
Vertical reports • 470
VM variable class • 282, 373
VPLOT command • 53, 215, 470, 498
reading VPLOT reports • 53
syntax • 215, 470
using with the HPLOT command • 498
VPLOT2 command • 55, 217, 486
reading VPLOT2 reports • 55
syntax • 217, 486
VSE.CACHE.STAT report • 79
VSE.CHANNEL.STAT report • 80, 90
VSE.CICS.STAT report • 81
VSE.CONTENTION.ANALYSIS report • 83
VSE.CPU.ANALYSIS.STAT report • 86
VSE.DELAY.ANALYSIS report • 88
VSE.DISK.DSN.STAT report • 91
VSE.DISK.STAT report • 95
VSE.DSN.STAT report • 96
VSE.GETVIS.STAT report • 97
VSE.JOB.STAT report • 100
VSE.LOCK.STAT report • 101
VSE.LPAR.CPU.STAT report • 103
VSE.PACCNT.STAT report • 104
VSE.PAGE.STAT report • 106
VSE.PID.CPU report • 107
VSE.PRINT.FORMS.STAT report • 108
VSE.PROGRAM.LOAD.STAT report • 109
VSE.SAMCPU.BUSYR.STAT report • 111
VSE.SAMPLE.COUNT.STAT report • 117
VSE.SAMPLE.RATE.STAT report • 118
VSE.SEEK.STAT report • 120
VSE.SVC.STAT report • 121
VSE.SYSCPU.BUSYR.STAT report • 124
VSE.SYSCPU.BUSYV.STAT report • 127
VSE.SYSTEM.STAT report • 130
VSE.THRESHOLD.STAT report • 133
VSE.VERSION4.DATA report • 135
VSE.VM.CPU.STAT report • 139
VSE.XA.DEVICE.STAT report • 140
VSE/POWER • 104, 188, 530, 531, 532, 535,
537, 539, 541, 542, 544, 546, 548
jobs, reports on • 104, 532, 537, 539, 546
jobsteps, reports on • 535, 544, 548
printed outputs, report on • 541
reports • 188, 530, 531, 532, 535, 537,
539, 541, 542, 544, 546, 548
format for dates • 188
limiting reports • 531
organizing reports • 530
prewritten reports • 532, 535, 537, 539,
541, 542, 544, 546, 548
Combination • 532
Job and Step • 535
Jobname and Device • 537
List Output • 539
Print Forms • 541
Spool Access • 542
Start, Stop, Date • 544
Unique Job • 546
Unique Step • 548
reading records • 188
using ID options with • 531
W WAIT variable class • 282, 374
WEEK operand of OPTION command • 188
X XCONN (Spool-Access-Connect) PACCNT
variables • 304, 395
XMSG operand of OPTION command • 188
XSPOOL (Spool-Access-Operation) PACCNT
variables • 305, 396
XTIME variable option • 406
Index 563
XTIMEM variable option • 406
XTND variable option • 406
Z Zeroes • 188, 405
in input, including records with • 405
including lines with no activity in reports •
188
printing in reports • 188
ZEROFLD operand of OPTION command • 188
Zone (time zone) • 188
564 Report Reference Guide