Previous Topic: GOTO Command—Jump to Specified LocationNext Topic: GRAF2 Command-Produce Subgraphs

Commands › GRAF Command-Produce a Graph

GRAF Command-Produce a Graph

Only a brief description of the GRAF command is given here. For a more detailed description, see the chapter “Graph Reports.”

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 TERMINAL variable produces a bar graph of the variable for each terminal.

This command has the following syntax:

GRAF [idoption[(identifiers)]] variable [options]
 [SCALE({n},{mX})] [SORT order] [FOR n] CHAR1(x)
idoption(identifiers)

Includes any ID option that is valid for the variable, specified with or without identifiers. Specifying this operand organizes the resulting report 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 TRANsaction variable by default graphs the value of that variable for each transaction.

Specifying the ID option and identifier TRANID(TRAN1) graphs the value of the variable for transaction TRAN1 only. Specifying the ID option TERMID graphs the value for each terminal.

variable

Indicates any Report Writer variable.

options

Specifies any valid variable options or ID options. Each ID option you specify must include at least one identifier.

SCALE(n,mX) or SCALE(n) or SCALE(mX)

By default, the highest value of the axis of a bar graph is set to the highest value of the graphed variables. For variables that represent percentages, the default maximum value is 100 percent.

To override this dynamic scale, specify n as the maximum value. If the variable that you use 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 are 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. Because the resulting bar graphs no longer correspond numerically to the scale, mX is useful only for determining relative performance.

SORT order

Sorts the report. Replace order with one of the following:

FOR n

Limits the report to the n identifiers in each time period that would appear first in the report, n must be an integer. For reports sorted in descending order, these limits are the n most active identifiers. For reports sorted in ascending order, these limits are the n least active identifiers.

CHAR1(x)

Specifies the plot character. Replace x with any valid EBCDIC character.