Use Command Mode Commands › GRAPH › Change a Rule Literal Value › Qualifiers

Qualifiers

/FORMAT

Specifies the graph's output format. Options include:

REGIS=[CHARACTERISTICS=(COLOR,LINE,PATTERN)]
POSTSCRIPT=[CHARACTERISTICS=(COLOR,LINE,
PATTERN)]|TABULAR|ANSI[=(HEIGHT=n[,LINE])]
CSV

The default value depends on terminal characteristics. For more information, see the section Advise Performance Graph.

/NODE_NAME=nodename

Specifies the preparation of a graph for only one of the selected nodes. The BY_NODE graph processing option may be required during data selection if the metric is not a system metric. By default, the Performance Manager prepares graphs for all selected nodes (Composite graphs).

/OUTPUT=filespec

Creates an output file that contains the graphs. The default file extension for a ReGIS graph is .REG, the file type for ANSI and TABULAR formatted graphs is .RPT and the file extension for PostScript is .PS.

When you generate multiple graphs with a single command line, you can create a unique output file for each graph. To do this, omit the file name with the /OUTPUT qualifier. The Performance Manager generates a separate file for each graph created and uses the graph type keyword as the unique file name.

For example:

$ ADVISE PERFORMANCE GRAPH/NODE=SYSDEV/END=1/TYPE=(MEM,CPU_U,CPU_MODE) /OUTPUT=.REG
%PSPA-I-CREAGRAPHOUT, PSPA Graph created file MUMMS$DKA300:[CORREY]SYSDEV_CPU_UTILIZATION.REG;1
%PSPA-I-CREAGRAPHOUT, PSPA Graph created file MUMMS$DKA300:[CORREY]SYSDEV_MEMORY_UTILIZATION.REG;1
%PSPA-I-CREAGRAPHOUT, PSPA Graph created file MUMMS$DKA300:[CORREY]SYSDEV_CPU_MODES.REG;1

/SELECT[={GREATER_THAN[:percent] | LESS_THAN[:percent]}], /NOSELECT

Use /SELECT in conjunction with the optional threshold values which may be specified on a per graph type basis.

If this qualifier is present, before a graph is produced, a check is made to see if the values to be graphed fall within the threshold values for the indicated percentage of points. If so, then the graph (or pie chart) is produced. If not, no graph is produced. For details on THRESHOLD, see the /TYPE qualifier.

These keywords accept a single value representing the percentage of the points plotted that must meet the threshold criteria before the graph is produced. Each graph point value is determined by the sum (STACKED) of the items depicted (up to 6). If the GREATER_THAN keyword is specified without a value, then 50 percent is assumed. If the LESS_THAN keyword is specified without a value, then 90 percent is assumed.

If the /SELECT qualifier is present without a keyword, then GREATER_THAN:50 is assumed. For example:

$ ADVISE PERFORMANCE GRAPH /BEGINNING=10/ENDING=11/NODE=YQUEM - 
_$ /TYPE=(CPU_U:THRESHOLD:25,CPU_M:THRESHOLD:35,TOP_CPU_I:THRESHOLD:45)-
_$ /SELECT=GREATER/OUTPUT=.REGIS
%PSPA-I-CREAGRAPHOUT, PSPA Graph created file BADDOG:[CORREY.WORK.PSPA]YQUEM_CPU_UTILIZATION.REG;1

This command requests that three graphs be produced. The CPU Utilization graph is produced, if 50 percent or more of the data points exceed 25 percent CPU utilization. The CPU_MODES graph is produced if 50 percent or more of the data points exceed 35 percent CPU utilization. The TOP_CPU_IMAGES graph is produced if 50 percent or more of the data points exceed 45 percent CPU utilization. In this case only one graph is produced.

$ ADVISE PERFORMANCE GRAPH /BEGINNING=10/ENDING=11/NODE=YQUEM -
_$ /TYPE=(CPU_U:THRESHOLD:25,CPU_M:THRESHOLD:35,TOP_CPU_I:THRESHOLD:15)- 
_$ /SELECT=GREATER/OUTPUT=.REGIS
%PSPA-I-CREAGRAPHOUT, PSPA Graph created file BADDOG:[CORREY.WORK.PSPA]YQUEM_CPU_UTILIZATION.REG;3
%PSPA-I-CREAGRAPHOUT, PSPA Graph created file BADDOG:[CORREY.WORK.PSPA]YQUEM_TOP_CPU_IMAGES.REG;1

This command produced two of three graphs because threshold quantity for the last graph was lowered.

$ ADVISE PERFORMANCE GRAPH /BEGINNING=10/ENDING=11/NODE=YQUEM - 
_$ /TYPE=(CPU_U:THRESHOLD:25,CPU_M:THRESHOLD:35,TOP_CPU_I:THRESHOLD:15) -
_$ /SELECT=GREATER:90/OUTPUT=.REGIS 

$

The previous command generated none of the graphs because in all cases 90 percent of the graph points did not exceed the specified thresholds.

/STACK, /NOSTACK

Stacks the values for each category on the graph. Use /NOSTACK to overlay the values on the graph. ReGIS graphs using /NOSTACK may cause some occlusion if you do not specify /FORMAT=ReGIS=CHARACTERISTICS=LINE also. If you are requesting a series of graphs in one command, you can override the /[NO]STACK qualifier by specifying the [NO]STACK keyword following each graph type. See Chapter 4 for an illustration of the use of the /NOSTACK qualifier and for additional information about default behavior.

/TYPE={
(graph_type[=([NO]STACK,Y_AXIS_MAXIMUM=n,
THRESHOLD=m,TITLE=string)],...)|
ALL_GRAPHS[=([NO]STACK,THRESHOLD=m,Y_AXIS_MAXIMUM=n)]
CUSTOM=(see “/TYPE=CUSTOM in Chapter 6”)|
PROMPT}

Specifies which of the graphs you want generated.

The PROMPT keyword specifies that the Performance Manager prompt you for the graph types and custom metrics. Using PROMPT has the advantage of allowing an interactive user the ability to preview any predefined or custom graphs quickly and view any item categories to see what choices exist.

Use the TITLE keyword to override the Performance Manager supplied title. The text string may be a maximum of 40 characters.

The STACK keyword for a particular graph type overrides the setting established by the /STACK qualifier.

The THRESHOLD keyword specifies a threshold value associated with the graph. THRESHOLD does not apply to pie chart graphs and is ignored. The m specifier is a positive decimal value.

The Y_AXIS_MAXIMUM specifies a fixed y-axis to be used for the graph. The default behavior is to setup the y-axis so that the maximum data point appears near the top of the graph. This graph modifier allows you to specify the y-axis so that you can compare data from different graphs without having different scales on the y-axis. The n specifier is a positive decimal value.

You can specify multiple graphs in a single command. For example, you can specify /TYPE=(TOP_IO_DISKS,TOP_HARDFAULTING_IMAGES). Of course, /TYPE=ALL_GRAPHS generates all of the predefined graphs.

CPU_UTILIZATION is the default graph type.

For a list of valid graph types, see the chapter “Performance Manager Commands”.