GRAPH
The valid parameters, indicated by a plus (+) symbol, used for each graph type specified by the TYPE parameter are listed and explained following the table.
The GRAPH statement uses data collected by the TRACE76 Extractor control statement. The values must be specified in the MEASURE parameter of the GRAPH statement for reporting.
Valid parameters for graph types
Parameter | Plot | KIVAT | PIE | TAB | DISTRIB | PROFILE | TRACE |
---|---|---|---|---|---|---|---|
INTERVAL | + | + | + | + | + | + | + |
PLOTFILL | + | + | + | ||||
CIRCLE | + | + | |||||
AXES | + | ||||||
LPI | + | + | |||||
CPI | + | + | |||||
LINES | + | + | |||||
FILLCHAR | + | + | + | + | + | ||
MEASURE | + | + | + | + | + | + | + |
LIMIT | + | + | + | + | + | ||
CPU | + | + | + | + | + | + | |
IPS | |||||||
NORMALIZE | + |
Parameters
The parameters for the GRAPH control statement are as follows:
TYPE= | specifies the type of graph to be produced The default for TYPE is PLOT.
|
---|---|
TRCETYPE= | specifies atrace-type value to be associated with the entries on the MEASURE parameter The trace-type values and the measure names are positional. Tn—specifies the trace-type value for the nth measure name Up to 12 trace-type values and measure names can be entered. The default value is AVG. The trace-type values can be any of the following values:
TRACE76 measures can be included on the measure list with other graphics measures for other graphics displays (PLOT, PROFILE, KIVIAT, TAB, and so on.). The default value, AVG, is assigned to any measure name that does not have a TRCETYPE value associated with it for any graph type except TRACE. |
INTERVAL= | specifies the time divisions on the graph INTERVAL= can be specified with the following values:
The defaults are:
Specifying an interval that is less than the Extractor recording interval has the same effect as specifying the Extractor recording interval. The GRAPH interval is used to gather data in multiples of the Extractor record interval. Data cannot be prorated over time. A data collection key is generated for each Extractor record encountered that meets date-time qualification requirements. The equation for this record key is Record key = Extractor record start time / GRAPH interval If the start of the Extractor record cycle and the size of the GRAPH interval parameter are known, you can determine which GRAPH record contains which Extractor record group. |
PLOTFILL= | specifies the format of the plots in which two or more measures are shown When you specify YES, a continuous string of characters leads from the plotted value on one line to the plotted value on the next line, making it easier to see the changes in values. When you specify NO, the point plotting format is produced. Whenever two or more characters occupy the same space, the character O is produced. The default is YES. |
CIRCLE= | specifies whether a circle of asterisks should be printed to mark the outer boundary of the Kiviat graph or Pie chart The default is YES. |
AXES= | specifies whether periods should be printed to mark the location of the axis for each measure in the Kiviat graph The default is YES. |
CPI= | specifies the height and width of print characters Set CPI to characters per inch. The default is CPI=10. If CPI is set incorrectly, the resulting Kiviat graph or Pie chart is elliptical. |
LPI= | specifies the height and width of print characters Set LPI to lines per inch. The default is LPI=6. If LPI is set incorrectly, the resulting Kiviat graph or Pie chart is elliptical. |
LINES= | specifies the number of lines per page to be used for Kiviat or pie graphs You cannot specify a value greater than 60. Kiviat and pie graphs are always printed one to a page, but unusual page sizes can be accommodated with this parameter. The default is 60. All other graph types print without page breaks until the graph is complete. |
FILLCHAR= | for Kiviat graphs, specifies the character to use to fill the interior of the polygon; the default is * For plot graphs, specify one FILLCHAR for each measure requested; the default is *+=:-<.#12345678. |
MEASURE= | specifies the measures to be graphed See Measure-and-trace-values for acceptable values. You can specify up to 16 measures for the Kiviat, Plot, Profile, and Distribution graphs and Pie chart. You can specify up to 12 measures for the Tabular Subreport or Trace graph; if you specify more, only the first 12 are recognized. |
LIMIT= | specifies a limit value to be associated with each measure There is a one-to-one correspondence between the MEASURE and LIMIT parameters for the Kiviat and distribution graphs. For the plot and profile graphs, the highest limit specified is used. To establish useful graphs of measures that have a range of values exceeding 100, run the tab graph first, to determine a proper set of limit specifications. Two decimal places are implied for each LIMIT= value. The default for each value is 10000 (100.00). A value less than 1000 (10.00) causes results to be unpredictable. The limit value should be high enough to accommodate the measure being graphed. For example, if the PAGEIO measure is being graphed and it is estimated that the value is in the thousands, specify a limit value of 1000000 (10,000.00). Erroneous graphs can result if the limit value is too small. |
CPU= | specifies the CPU ID (as a hexadecimal value) for which CPU data is to be displayed Acceptable IDs are 0 through 1F, and ALL. ALL is the default. |
NORMALIZ= | specifies if the distribution graph is to be normalized If normalized, the X-axis starts at the minimum value instead of zero (does not apply to percent), and the Y-axis ends at 50% (if no distribution exceeds 50%). The default is YES. |
Examples
Determine which GRAPH interval contains Extractor record data for CPU busy, as of 10:15 A.M., on March 28, 2010:
- Extractor start time is 00:15 A.M. on March 28, 2010.
- INTERVAL value on the Extractor REPORT control statement is QTR.
- GRAPH INTERVAL value is 02:00:00.
From this information, you know that the following statements are true:
- Data collection begins at 00:15:00 (from Extractor start time).
- There are 12 GRAPH intervals that cover the 24-hour period encompassing the data of March 28, 2010. (This figure is calculated by dividing 24 hours by the GRAPH interval value of 2; the result is 12.)
- A maximum of eight Extractor intervals can be summed into each GRAPH data collection interval. (This figure is calculated by dividing the GRAPH collection interval of 2 by the Extractor QTR (1/4) hour interval; the result is 8.)
The following table shows the GRAPH intervals and interval time range for this situation. Interval Number 06 contains the Extractor record data for CPU busy at 10:15 A.M.
GRAPH interval time range for 12 intervals
GRAPH interval number | GRAPH interval time range | Comments |
---|---|---|
01 | 00:00:00 - 02:00:00 | |
02 | 02:00:00 - 04:00:00 | |
03 | 04:00:00 - 06:00:00 | |
04 | 06:00:00 - 08:00:00 | |
05 | 08:00:00 - 10:00:00 | |
06 | 10:00:00 - 12:00:00 | 10:15:00 EXTR RECORD |
07 | 12:00:00 - 14:00:00 | |
08 | 14:00:00 - 16:00:00 | |
09 | 16:00:00 - 18:00:00 | |
10 | 18:00:00 - 20:00:00 | |
11 | 20:00:00 - 22:00:00 | |
12 | 22:00:00 - 24:00:00 |
When using the SHIFT control statement with a GRAPH control statement containing the interval parameter, use the following equation to generate the record key:
- (January 1, 2010)
+ (Extractor record start time))
/ GRAPH interval
For example:
GRAPH MEASURE=CPU,INTERVAL=02:00:00
Determine which GRAPH interval contains Extractor record data for CPU busy, as of 10:15 A.M., on March 28, 2010, if the following statements are true:
- Extractor start time is 00:15 on March 28, 2010.
- INTERVAL value on the Extractor REPORT control statement is QTR.
- GRAPH parameter interval value is 02:00:00.
- SHIFT request time ranges are 010000 to 090000 and 090000 to 170000.
From this information you know that these statements are true:
- Data collection begins at 01:00:00 (from the SHIFT control statement request).
- There are four GRAPH intervals within each SHIFT time range definition defined on the SHIFT control statement. (This figure is calculated by dividing the 8 hour time range by the GRAPH interval value of 2; the result is 4.)
- A maximum of eight Extractor intervals can be summed into each GRAPH data collection interval. (This figure is calculated by dividing the GRAPH collection interval of 2 by the Extractor QTR hour (¼) hour interval; the result is 8.)
The following table shows the GRAPH intervals and GRAPH interval time range for this situation. The GRAPH interval 05 contains the Extractor record data for CPU busy, at 10:15 A.M.
GRAPH interval time range for eight intervals
GRAPH interval number | GRAPH interval time range | Comment |
---|---|---|
01 | 01:00:00 - 03:00:00 | |
02 | 03:00:00 - 05:00:00 | |
03 | 05:00:00 - 07:00:00 | |
04 | 07:00:00 - 09:00:00 | |
05 | 09:00:00 - 11:00:00 | 10:15:00 EXTR RECORD |
06 | 11:00:00 - 13:00:00 | |
07 | 13:00:00 - 15:00:00 | |
08 | 15:00:00 - 17:00:00 |