Commands › GRAF2 Command-Produce Subgraphs

GRAF2 Command-Produce Subgraphs

Only a brief description of the GRAF2 command is given here. A more detailed description can be found in the chapter “Graph Reports.”

Use the GRAF2 command to produce one or more subgraphs for each individual resource included by the GRAF command. These subgraphs can do either of the following:

• Graph the performance of a second, related set of resources.

  For example, if your GRAF command graphs by terminal, a GRAF2 command could do the following:

  • List each transaction used by each terminal
  • Show the average terminal response time for each
• Graph the values of one or more variables for each resource.

  For example, if your GRAF command graphs by transaction, a GRAF2 command could show the usage, CPU use, and average lifetime of each transaction.

You cannot use the GRAF2 command without the GRAF command.

This command has the following syntax:

GRAF2 [VARS|idoption[(identifiers)]] variable [options]
 [HDR(text)][CHAR1(x)] [SCALE({n},{mX},{COMMON})] [SORT order] 
 [FOR n] [AND,|[variable [options] [HDR(text)] [CHAR1(x)]] [AND,...]

VARS

Indicates that there is more than one variable in this GRAF2 report.

idoption(identifiers)

Includes any ID option that is valid for the variable, specified with or without identifiers. Specifying this operand organizes the resulting subgraphs 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 subgraphs. You can use this operand only if you specify a single variable with the GRAF2 command.

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.

HDR(text)

Overrides the default heading for the variable. Replace text with a heading of 15 or fewer characters.

CHAR1(x)

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

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

By default, the highest value of a bar graph axis 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, this graph is useful only for determining relative performance.

To have the same scale used for both variables, specify SCALE(COMMON). You can specify the SCALE operand only with the first variable you specify with the GRAF2 command.

SORT order

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

• (Default) DESCENDING

  Sorts identifiers in descending order of value of the variable specified.

• ASCENDING

  Sorts identifiers in ascending order of value of the variable specified.

You can specify the SORT operand only with the first variable you specify with the GRAF2 command.

FOR n

Limits the report to the n identifiers in each time period that would appear first in the report, where n is 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. You can specify the FOR operand only with the first variable you specify with the GRAF2 command.

AND,

Signals that another variable is being specified. The comma after AND lets you continue to the next line. If you specify multiple variables, use the VARS operand.

Example: GRAF2 Command

The following commands produce a report showing the following:

• The maximum lifetime for the ten transactions with the longest maximum lifetimes each day
• The 20 highest maximum terminal response times for each

  GRAF  TRANSACTION MAXLIFE FOR 10 SCALE(10.0)
   GRAF2 TERMINAL MAXRESP    FOR 20 SCALE(10.0)
   EACH DAY
  END
  RUN