The user employs the PRINT-REPORTS statements to select the report groups to be analyzed. The INFORMATION operand is used to define the type of output.
The user employs the group names in the REPORT-LIST operand to address report groups logically related to one another. Which variable reports belong to which report group is depicted in the Table of report groups.
The REPORT-NUMBER operand allows selection of individual reports in a report group using their report numbers. The default value REPORT-NUMBER=*STD means that the most important reports of a report group are analyzed. The relevant report numbers can be found in the Table of report groups.
The CONDITIONED-REPORTS operand specifies whether or not subreports whose monitoring data is within a certain range are to be output for a given report group.
For an overview of the reports and a detailed list of the individual variables, see Table of variables reports.
Format
PRINT-REPORTS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
INFORMATION =
Defines how the analyzed data is to be output.
INFORMATION = *DIAGRAMS
The monitoring data is output as time series in the form of charts and statistical tables.
INFORMATION = *STATISTICS
The monitoring data is output in the form of statistical tables.
INFORMATION = *INTERFACE
The requested monitoring data is output to a transfer file. The link name for the transfer file is EVALDTA.
REPORT-LIST =
Defines the report groups to be analyzed (in a list).
REPORT-LIST = *STD
The CHANNEL, CPU, DISK, IO, MEMORY, RESPONSE-TIME, TASK and WORKING-SET report groups are analyzed.
REPORT-LIST = *ALL(...)
All report groups (except DEVICE and VOLUME) are analyzed.
REPORT-NUMBER =
The report numbers can be used to select specific reports in a group (in this case all reports or the standard reports).
REPORT-NUMBER = *ALL
All reports in a report group are analyzed.
REPORT-NUMBER = *STD
The most important reports in a report group are analyzed. The corresponding report numbers are contained in the report group table, see "Table of report groups".
CONDITIONED-REPORTS =
It is possible to suppress subreports whose monitoring data lies within the preset range. See also section "Reducing the number of monitored objects to be output" for details on the preset ranges.
CONDITIONED-REPORTS = *NO /*YES
The subreports whose monitoring data lies within the predefined range are either output or suppressed.
REPORT-LIST = *BCAM-CONNECTION(...)
The report group BCAM-CONNECTION is analyzed.
CONNECTION-SET =
Defines the selected connection sets and calculates statistics and charts for them.
CONNECTION-SET = *ALL
Analyzes the response data for all the connection sets present in the SM2 output file.
CONNECTION-SET = list-post(32): <alpahnum-name 1..16>
Specifies the name of the connection set that is to be analyzed. The name of the connection set is defined in SM2 (ADD-BCAM-CONNECTION-SET).
REPORT-LIST = *CATALOG-MANAGEMENT(...)
The CATALOG-MANAGEMENT report group is analyzed.
CATALOG-ID =
Specifies the catalog IDs to be analyzed.
CATALOG-ID = *ALL
Analyzes all monitored catalog IDs.
CATALOG-ID = list-poss(32): <catid>
Specifies the catalog ID to be analyzed.
REPORT-LIST = *CATEGORY-CPU(...)
The CATEGORY-CPU report group is analyzed.
CATEGORY =
Specifies the categories to be analyzed. For each category, a separate chart is output and a separate group entry is made in the table.
CATEGORY = *ALL
Analyzes all monitored categories.
CATEGORY = list-poss(32): <alphanum-name 1..7>
Specifies the name of the category to be analyzed. The following abbreviations can be used for the category name:
TP | Transaction tasks category |
The self-defined categories can also be used.
REPORT-LIST = *CATEGORY-IO(...)
The CATEGORY-IO report group is analyzed. The structure and meaning of this operand value is the same as described under *CATEGORY-CPU.
REPORT-LIST = *CATEGORY-QUEUE(...)
The CATEGORY-QUEUE report group is analyzed. The structure and meaning of this operand value is the same as described under *CATEGORY-CPU.
REPORT-LIST = *CATEGORY-WORKING-SET(...)
The CATEGORY-WORKING-SET report group is analyzed. The structure and meaning of this operand value is the same as described under *CATEGORY-CPU.
REPORT-LIST = *CHANNEL(...)
The CHANNEL report group is analyzed.
CHANNEL-PATH-ID =
Specifies channels to be analyzed. For each specified channel, a chart is output or a group is entered in the table.
CHANNEL-PATH-ID = *ALL
Analyzes all the monitored channels.
CHANNEL-PATH-ID = list-poss(32): <x-string 1..4>
Analyzes only the specified channel addresses. The values from x'0' to x'1FF' are permitted as channel addresses.
In SM2 the channel path ID is always output in hexadecimal form.
REPORT-LIST = *CPU(...)
The CPU report group is analyzed.
PROCESSOR-SPLITTING =
Defines whether the values of individual processors are to be analyzed if SM2 has monitored a multiprocessor system.
PROCESSOR-SPLITTING = *NO
The average values of the processors are indicated in the chart or in the group of tables.
PROCESSOR-SPLITTING = *YES
The individual values of the processors are indicated as a subreport in one chart each or in one group of tables.
REPORT-LIST = *DAB(...)
The DAB report group is analyzed.
CACHE-ID =
Specifies the DAB cache areas to be analyzed.
CACHE-ID = *ALL
Analyzes all monitored DAB cache areas.
CACHE-ID = list-poss(32): <alphanum-name 1..32>
Specifies the name of the DAB cache area to be analyzed.
REPORT-LIST = *DEVICE(...)
The DEVICE report group is analyzed.
DEVICE =
Specifies devices for which an analysis is to be carried out. A chart or a group in the table is output for each device specified.
DEVICE = *ALL
Analyzes all monitored devices.
DEVICE = *SPECIFIED(...)
Analyzes only the specified devices. The mnemonic device name and/or the device type defines the individual devices.
DEVICE = *NOT-SPECIFIED
No devices are selected on the basis of their device names.
DEVICE = list-poss(256): <alphanum-name 1..4>
The mnemonic device names of the devices to be analyzed are specified.
DEVICE-TYPE = *NOT-SPECIFIED
No devices are specified on the basis of their device type.
DEVICE-TYPE = *TAPE
All tape devices are analyzed.
DEVICE-TYPE = *TD
All devices with the FAMILY name TD are analyzed.
REPORT-LIST = *DILATION(...)
The DILATION report group is analyzed. The dilation value output in this report is an internally computed value, i.e. not the PCS dilation value. The structure of this operand value and its meaning are the same as described for the operand *CATEGORY-CPU.
REPORT-LIST = *DISK(...)
The DISK report group is analyzed.
SPECIFIED =
Specifies the devices and volumes to be analyzed. A new subreport is output if the device or volume changes.
SPECIFIED = *ALL
All devices and volumes of the *DISK report group are analyzed.
SPECIFIED = *DEVICE(...)
The specified devices and all the corresponding volumes are analyzed.
DEVICE = list-poss(32): <alphanum-name 2..4>
Specifies the device.
SPECIFIED = *VOLUME-AND-DEVICE(...)
The specified devices and volumes are analyzed.
DEVICE-VOLUME = list-poss(32): *SELECT(...)
The specified devices and volumes are analyzed.
DEVICE = <alphanum-name 2..4>
Specifies the device.
VOLUME = <vsn 1..6>
Specifies the volume assigned to the device.
REPORT-LIST = *FILE(...)
The FILE report group is analyzed.
FILE-NAME =
Specifies the files for which a special analysis is to be performed. A chart page or a group in the table is output for each specified file.
FILE-NAME = *ALL
Analyzes all files which have been monitored.
FILE-NAME = list-poss(32): <filename>
Analyzes only the specified files. The name of the file specified must be a fully qualified name. Values of files not specified are not included in the list.
REPORT-LIST = *IO(...)
The IO report group is analyzed.
PROCESSOR-SPLITTING =
Specifies whether the I/O values of the individual processors are to be analyzed if SM2 has monitored a multiprocessor system.
PROCESSOR-SPLITTING = *NO
The cumulative I/O values of the processors are shown in the chart or in the group of tables.
PROCESSOR-SPLITTING = *YES
The individual I/O values of the processors are shown as one subreport in each chart or in the group of tables.
REPORT-LIST = *ISAM(...)
The ISAM report group is analyzed.
ISAM-POOL =
Specifies the ISAM pools to be analyzed.
ISAM-POOL = *ALL
Analyzes all ISAM pools.
ISAM-POOL = list-poss(32): <alphanum-name 1..8>
Specifies a list of ISAM pools to be analyzed.
REPORT-LIST = *ISAM-FILE(...)
The ISAM-FILE report group is analyzed.
FILE-NAME =
Specifies the ISAM file to be analyzed.
FILE-NAME = *ALL
Analyzes all ISAM files.
FILE-NAME = list-poss(32): <alphanum-name 1..54>
Specifies a list of ISAM files to be analyzed.
REPORT-LIST = *PCS(...)
The PCS report group is analyzed. The structure of this operand value and its meaning are the same as described for the operand *CATEGORY-CPU.
REPORT-LIST = *PERIODIC-TASK-JOBNAME(...)
The PERIODIC-TASK-JOBNAME report group is analyzed.
JOBNAME =
Specifies the job names of the tasks to be analyzed.
JOBNAME = *ALL
All tasks selected via job names are analyzed.
JOBNAME = list-poss(32): <alphanum-name 1..8>
The tasks with the specified job names are analyzed.
REPORT-LIST = *PERIODIC-TASK-TSN(...)
The PERIODIC-TASK-TSN report group is analyzed.
TASK =
Specifies the tasks to be analyzed.
TASK = *ALL
Analyzes all the monitored tasks.
TASK = *SPECIFIED(...)
Analyzes only the specified tasks.
TSN =
Specifies the TSNs of the tasks to be analyzed.
TSN = *NOT-SPECIFIED
No tasks are selected on the basis of their TSN.
TSN = list-poss(32): <alphanum-name 1..4>
The tasks with the specified TSNs are analyzed.
USER-ID =
Specifies the user IDs of the tasks to be analyzed.
USER-ID = *NOT-SPECIFIED
No tasks are selected on the basis of their user ID.
USER-ID = list-poss(32): <alphanum-name 1..8>
The tasks with the specified user IDs are evaluated.
REPORT-LIST = *PERIODIC-TASK-USERID(...)
The PERIODIC-TASK-USERID report group is analyzed.
USERID =
Specifies the user IDs of the tasks to be analyzed.
USERID = *ALL
All tasks selected via user ID are analyzed.
USERID = list-poss(32): <alphanum-name 1..8>
The tasks with the specified user IDs are analyzed.
REPORT-LIST = *PFA(...)
The PFA report group is analyzed.
CACHE-ID =
Specifies the cache areas.
CACHE-ID = *ALL
All cache areas are analyzed.
CACHE-ID = list-poss(32): <alphanum-name 1..4>
The specified cache areas are analyzed.
REPORT-LIST = *PRIOR-ACF(...)
The PRIOR-ACF report group is analyzed.
RESOURCES =
Specifies the resources to be analyzed.
RESOURCES = *ALL
A chart containing the table of statistical values per group entry is output for the resources central processor, main memory and paging.
RESOURCES = *CPU
Analyzes the entries for the CPU.
RESOURCES = *MEM
Analyzes the entries for main memory.
RESOURCES = *PAG
Analyzes the entries for paging.
REPORT-LIST = *RESPONSE-TIME(...)
The RESPONSE-TIME report group is analyzed. Reports 89 to 93, which are part of this group, are broken down by categories, provided that SM2 has registered category-specific information (in record 39). If so, the category name is included in the page header, and SM2R1 outputs a separate chart and separate statistics for each monitoring definition. Unless otherwise specified, multiple definitions are processed in the order in which they occur. Only the first 32 definitions are used.
CONNECTION-SET =
Specifies selected connection sets and computes statistics and draws charts for them.
CONNECTION-SET = *ALL
Analyzes the response data of all the connection sets included in the SM2 output file.
CONNECTION-SET = *GLOBAL
Analyzes the response data for the connection of all applications, partners and processors.
CONNECTION-SET = list-poss(32): <alphanum-name 1..16>
Specifies the name of the connection set to be analyzed. The name of the connection set is defined by SM2 (ADD-CONNECTION-SET).
CONNECTION-SET = *ALL-EXCEPT(...)
Selects a connection set that is not to be analyzed.
SET-NAME = <alphanum-name 1..16>
Specifies the name of the connection set that is not to be analyzed.
REPORT-LIST = *RST(...)
The RST report group is analyzed. The structure of this operand value and its meaning are the same as described for the operand *CATEGORY-CPU.
REPORT-LIST = *SERVICETIME(...)
The SERVICETIME report group is evaluated.
DEVICE =
Specifies devices for which an analysis is to be carried out. A chart or a group in the table is output for each device specified.
DEVICE = *ALL
Analyzes all the monitored devices.
DEVICE = list-poss(256): <alphanum-name 1..4>
Analyzes the devices that are specified by means of their mnemonic device name.
REPORT-LIST = *STD(...)
The CHANNEL, CPU, DISK, IO, MEMORY, RESPONSE-TIME, TASK and WORKING-SET report groups are analyzed.
REPORT-LIST = *SVC(...)
The SVC report group is analyzed.
SVC-NUMBER =
Specifies the SVC numbers to be analyzed.
SVC-NUMBER = *ALL
All SVC numbers are to be analyzed.
SVC-NUMBER = list-poss(64): <integer 0..255>
The specified SVC numbers are analyzed.
REPORT-LIST = *TLM(...)
The TLM report group is analyzed.
LOCK-NAME =
Specifies the names of the locks to be analyzed.
LOCK-NAME = *ALL
All locks are analyzed.
LOCK-NAME = list-poss(32): <alphanum-name 1..8>
The locks with the specified names are analyzed.
REPORT-LIST = *UTM(...)
The UTM report group is analyzed.
APPLICATION =
Specifies the UTM applications.
APPLICATION = *ALL
All UTM applications are analyzed.
APPLICATION = list-poss(32): <alphanum-name 1..8>
The specified UTM applications are analyzed.
Report groups
Group names allow selection of a group of monitoring data reports for analysis. Monitored objects can be specified for report groups in the same way as for monitoring data reports. A new page is used for each monitored object.
In all reports which allow variable numbers of monitored objects, ALL is preset as the default value. This takes all monitored objects in the SM2 output file into account.
You will find an overview of all group names and reports starting in the Table of report groups.
values for all processors
values for each individual processor
If REPORT-LIST=*ALL is specified, the *DEVICE report group is not analyzed.
Report names
The report name is contained in the heading of each report page. For a list of report names see the Table of report names.
Reducing the number of monitored objects to be output
The user can specify whether subreports which contain “normal” monitored data, i.e. whose data lies within a defined range, are to be output or not
A range is defined for every value monitored. If even one item of monitoring data lies outside this range, the subreport is still output and contains all monitoring data.
This reduction in the number of subreports to be output applies to charts and statistics. All reports are always output in the interface file and the summaries.
The ranges are preset as follows (see MODIFY-REPORT-CONDITIONS statement for an explanation of the names):
With these report groups, the CONDITIONED-REPORTS operand in the PRINT-REPORTS statement is preset to *YES.
The ranges for all other monitoring data are preset as follows (these settings mean that all reports are suppressed):
REPORT GROUP | REPORT NUMBER | ITEM NUMBER | LOWER LIMIT | UPPER LIMIT | SUPPRESS CONDITION | COMPARE VALUE |
*DEVICE | 11 | 1 | 0 | 15 | *INSIDE | *MAXIMUM |
2 | 0 | 15 | *INSIDE | *MAXIMUM | ||
35 | 1 | 0 | 15 | *INSIDE | *MAXIMUM | |
36 | 1 | 0 | 0,3 | *INSIDE | *MEAN-VALUE | |
100 | 1 | 0 | 100 | *INSIDE | *MEAN-VALUE | |
2 | 0 | 50 | *INSIDE | *MEAN-VALUE | ||
230 | 1 | 0 | 1 | *INSIDE | *MEAN-VALUE | |
2 | 0 | 0,5 | *INSIDE | *MEAN-VALUE | ||
*DISK | 124 | 1 | 0 | 15 | *INSIDE | *MAXIMUM |
2 | 0 | 15 | *INSIDE | *MAXIMUM | ||
125 | 1 | 0 | 15 | *INSIDE | *MAXIMUM | |
126 | 1 | 0 | 0,3 | *INSIDE | *MEAN-VALUE | |
127 | 1 | 0 | 2 | *INSIDE | *MEAN-VALUE | |
227 | 1 | 0 | 1 | *INSIDE | *MEAN-VALUE | |
2 | 0 | 1 | *INSIDE | *MEAN-VALUE | ||
228 | 1 | 0 | 10 | *INSIDE | *MEAN-VALUE | |
2 | 0 | 5 | *INSIDE | *MEAN-VALUE | ||
229 1 | - | - | - | *INSIDE | *MEAN-VALUE | |
*CHANNEL | 10 | 1 | 0 | 10 | *INSIDE | *MAXIMUM |
2 | 0 | 10 | *INSIDE | *MAXIMUM | ||
100 | 1 | 0 | 80 | *INSIDE | *MEAN-VALUE | |
2 | 0 | 250 | *INSIDE | *MEAN-VALUE | ||
102 | 1 | 0 | 40 | *INSIDE | *MAXIMUM | |
2 | 0 | 40 | *INSIDE | *MAXIMUM | ||
3 | 0 | 40 | *INSIDE | *MAXIMUM | ||
*PERIODIC-TASK | 152,156,160 | 1 | 0 | 1000 | *INSIDE | *MAXIMUM |
153,157,161 | 1 | 0 | 5 | *INSIDE | *MEAN-VALUE | |
154,158,162 | 1 | 0 | 10 | *INSIDE | *MEAN-VALUE | |
2 | 0 | 10 | *INSIDE | *MAXIMUM | ||
155,159,163 | 1 | 0 | 1000 | *INSIDE | *MEAN-VALUE | |
*TLM | 96 | 1 | 0 | 2 | *INSIDE | *MAXIMUM |
97 | 1 | 0 | 10 | *INSIDE | *MEAN-VALUE | |
*SVC | 123 | 1 | 0 | 20 | *INSIDE | *MEAN-VALUE |
2 | 0 | 20 | *INSIDE | *MEAN-VALUE | ||
*MSCF | 166 | 1 | 0 | 50 | *INSIDE | *MEAN-VALUE |
2 | 0 | 0,1 | *INSIDE | *MEAN-VALUE | ||
167 | 1,2 | 0 | 4 | *INSIDE | *MAXIMUM | |
168 | 1 | 0 | 50 | *INSIDE | *MEAN-VALUE | |
169 1 | 2 | 0 | 0,1 | *INSIDE | *MEAN-VALUE | |
*TCP-IP | 186 | 1,2 | 0 | 1 | *INSIDE | *MAXIMUM |
187 | 1,2 | 0 | 300 | *INSIDE | *MAXIMUM | |
*SERVICETIME | 231 | 1 | 0 | 15 | *INSIDE | *MEAN-VALUE |
2 | 0 | 5 | *INSIDE | *MEAN-VALUE | ||
3 | 0 | 1 | *INSIDE | *MEAN-VALUE | ||
4 | 0 | 10 | *INSIDE | *MEAN-VALUE | ||
5 | 0 | 2 | *INSIDE | *MEAN-VALUE |
1Information on a reduction of the number of monitored objects to be output is not meaningful.
LOWER-LIMIT = 0 UPPER-LIMIT = 1 * 10 (63) SUPPRESS-CONDITION = *INSIDE-RANGE COMPARE-VALUE = *MEAN-VALUE
In addition, the user can change the preset ranges for a session using the MODIFY-REPORT-CONDITIONS statement.