GRAPHDET / PLOTDET

Purpose

The GRAPHDET and PLOTDET subcommands allow displaying selected parts of the performance data accumulated in the monitor redisplay buffer or in one of the detailed history data logs in the form of history graphics or plots.

Both subcommands will create detailed history displays where elapsed time is plotted on the horizontal x-axis, while the corresponding values of up to four performance variables are plotted on the vertical y-scale. Data will be plotted for up to 140 measurements, where each plot position is determined by the average value of two consecutive measurements if the default monitor interval of 60 seconds is used. Only one measurement will be shown per plot position if the monitor interval is two minutes or more.

Two display modes are possible:
  • The GRAPHDET subcommand requires GDDM services (Graphical Data Display Manager V.2 or 3) and a display terminal with graphics capability for generating and displaying real graphics output. It cannot operate without these prerequisites.
  • The PLOTDET subcommand uses the same data, but it generates a simple plot using ordinary display characters for the output. It will work on any display terminal, and it has no additional software prerequisites.

Format

Read syntax diagramSkip visual syntax diagramGRAPHdetPLOTdet1y var1 CUMulatFilefn ft fmFRomhh:mm*o=- 2Char'xxxx'cc
Notes:
  • 1 Up to 4 times.
  • 2 Valid with PLOTdet only, there is no effect when used with GRAPHdet.

Parameters

y-var1, y-var2, ...
define the variables whose values are to be plotted on the vertical y-axis.

All y-var names define performance variables from either the monitor redisplay screen (default), from a HISTLOG or PERFLOG file with general system performance data, or from an object's benchmark log file on disk.

See REDISP (PERFxxx files), REDHIST (HISTxxx files) for a list of performance variables and their description, or see the description of the selected benchmark log display for information on the selectable performance variables (note that only numerical fields with load data can be selected).

You must enter the full variable names exactly as shown (no abbreviations allowed), except for the case of the maximum user fields ('Max. CPU', 'Max. Vector', ...) of PERFLOG and HISTLOG files where the first eight characters only need be entered. Do not enter the apostrophes: they have been included only to indicate that two words are required for selecting these values.

In addition to these basic performance variables you can also specify the names of any 'user variables' which you previously defined by means of the FC USERVAR subcommand.

CUMulat
Indicates that the y-variable values are to be plotted cumulatively, i.e. each value added to the previous one. The string 'Cumul.' will be inserted above the y-axis when a cumulative display has been selected.
File fn ft fm
Describes the input file to be analyzed, when specified. Current REDISP data in storage will be assumed as input if no input file is specified.

The input file can be a detailed system performance log file (HISTLOG, PERFLOG or RMONLOG), a user benchmark log file (such as MTUSRLG, USERLOG, etc.), or one of the supported I/O device benchmark log files (CACHELG, DEVLOG, etc.).

Char 'xxxx'cc
Defines the four plot characters to be used for the selected variables. This argument is intended for use with the PLOTDET subcommand only, it has no effect when used with GRAPHDET. Strings specified between apostrophes (') are interpreted as hexadecimal representation of special characters, i.e. the specification of 'f1f2f3'* would result in the characters 123* being used. Specification of plot characters in hex format allows the use of special graphic symbols for plotting, provided they are supported by the hardware. (Some terminal emulators used with work stations allow display of special symbols from the currently active code page, and some of these graphic symbols make very nice bar charts.) The default setting is '*o=-'. If less than four characters are defined, the corresponding default characters will be inserted for the remaining variables.
FRom hh:mm
Defines the starting time for plotting. If the specified time is not within the time frame of the measurements currently available in the redisplay buffer, the oldest measurements will be shown (first entries in buffer).

Results

See Detailed Performance History Display for more information on the specific displays caused by this subcommand, and Graphical Displays of Performance History Data for more general information.