Control Statements and Tables › CA JARS Control Statements › SYSUSE1 and SYSUSE2 Statements

SYSUSE1 and SYSUSE2 Statements

These two statements are optional. They provide parameters for tailoring the System Use Reports to meet your specific reporting requirements. The SYSUSE1 statement contains parameters which affect multiple reports. The SYSUSE2 statement contains parameters which address a specific report. All parameters have logical and consistent default values which make it necessary to use these statements only if you desire a specific report format or content alteration.

The System Use Reports are requested by the System Use Reports selection indicators on the SELECT statement. Refer to the SELECT Statement. For a discussion of each report, refer to System Use Reports.

The following fields appear on the SYSUSE1 statement:

The CPU identification field ensures that data for only one CPU is processed for a given run of CA JARS to produce the System Use Reports. These reports are designed to illustrate the performance of a single CPU. If it is necessary to restrict these reports to a blank (X'40') CPU identification, place a question mark (?) in this field.

The required records indicator can force the use of job level data instead of step (program) level data. While job level data causes some loss of precision in prorated statistics on some System Use Reports, it generates the Job Activity Analysis Reports showing the exceptional users of system resources by job name instead of by program (phase) name. Job names also replace program names on the Multiprogramming Activity Report when this indicator is set to select job level data.

The legend for the CPU Utilization graph can replace the default values or change the order of occurrence of the symbols on the graphs. The default values, in order, are:

CPU under TCB:  Batch, B and TSO, T.
CPU under SRB:  Batch, O and TSO, 0.
Overhead Time:  '-'.

If any overrides are supplied, all of the defaults are dropped. The characters used for CPU under TCB also represent batch and TSO on the System Occupancy, Paging Activity and Tape Drive Occupancy Graphs. The characters used for CPU under SRB also represent Batch Allocation and TSO Logon Delay Time on the System Occupancy Graph.

Shift identifiers allow you to define shift time boundaries appropriate to your installation. Reports covering 24-hour periods can be made more meaningful by setting the shift start time for the first shift to a time other than midnight. When shift oriented reports are produced, it may be convenient to eliminate a shift that is known to have no activity or irrelevant data. To do this, use the shift suppression indicator after the start time of each shift to be suppressed. Enter the start time (hhmm) for each shift. Each shift is assumed to end at the start of the next defined shift, with the last shift ending at the beginning of the first shift on the next day. If omitted, the shift identifiers field defaults to one 24-hour shift starting at midnight.

The shift and day flags determine how much data is to be presented in each System Use Report. The shift flag requests shift oriented reports at the daily level, or for all days combined, or both. Shift-oriented reports can be suppressed by coding an S in the shift flag.

The day flag can request 24-hour reports at the daily level or for all days combined, or both. Each 24-hour report includes all data for the period, even if a shift has been suppressed. 24-hour reports can be suppressed by coding an S in the day flag.

The time interval can be supplied to get more or less resolution in the data on all time graphs and Multiprogramming Activity Reports. The time interval is specified in minutes and must divide evenly into 1440. Possible values are 1, 2, 3, 4, 5, 6, 8, 9, 10, 12, 15, 16, 18, 20, 24, 30, 32, 36, 40, 45, 48, 60, 72, 80, and 90 minutes.

The graph collapse flag produces a uniform vertical time scale on graphs and Multiprogramming Activity Reports that cover long periods of down time. If this flag is not used, these periods of low activity are represented on appropriate reports by a message giving the duration of down time. A minimum of five consecutive low activity time intervals must be present before such collapsing occurs.

The page control flag forces page headings on each page of all the graphs and Multiprogramming Activity Reports. In the absence of this flag, page headings will only appear at the beginning of each 24-hour period, producing reports that may extend past page boundaries in the interest of preserving continuity from one time interval to the next without page breaks.

Graph Characters

Note: OPTION Statement settings can affect the contents of certain CPU and I/O files.

The following fields appear on the SYSUSE2 statement:

The paging rate (or number of initiators for the Occupancy Graph) and the Disk/Tape EXCP Rate Scale Factors fix the degree of resolution for the Paging Activity/System Occupancy and the Disk and Tape EXCP Rates time graphs, respectively.

Once determined, the scale factors can standardize the horizontal scale of the graphs from one execution of CA JARS to another. If no scale factors are supplied, the horizontal scales are determined dynamically at run time based on the data present for the Paging Activity and the Disk and Tape EXCP Rates graphs.

The scale for the System Occupancy graph defaults to 15 initiators. Dynamically determined, the scales automatically adjust so that resolution is maximized without allowing any interval to exceed the 100% activity level. This enables you to select standard scale factors for subsequent runs so that sets of graphs can be compared visually without mentally adjusting utilization percentages to compensate for varying scales.

Device type suppression flags are available so certain classes of I/O devices can be easily excluded from the Device Occupancy Graph. These flags relate to information on the CONFIG/CONFIGX statements regarding which I/O devices should be displayed on the report.

The program/job limit indicator sets the maximum number of detail lines to be displayed on any Program/Job Activity Analysis Report. This is the number of different job or program names that are shown as exceptional users of the resource being analyzed by each report.

The highlight flag suppresses the overprinting of the numbers depicting the utilization of the resource being analyzed by each Program/Job Activity Report. Overprinting usually produces a visually enhanced report, but it slows down the printer.

MPA field IDs #1, #2, and #3 allow you to select the data elements to be displayed on the Multiprogramming Activity Report. Selected MPA field IDs #1 and #2 are displayed for each program and again for the totals. MPA field ID #3 is displayed only for the totals.

Data elements available for display include raw data (CPU time, total EXCP count, total page count, and service units); utilization rates relative to the amount of CPU time used in each interval (I/O index and CPU page rate); utilization rates relative to total elapsed time used in each interval (CPU rate and elapsed page rate); service units relative to active time (service rate); and CPU utilization as a percentage of the defined interval.