Using the Plot Feature › Using the Plot Feature with REXX › PLOT DEFINE GRAPH Command Options › AXIS Option › LABEL Option

LABEL Option

This option specifies a title for the graph or labels for the X and Y axes. Indicates whether you are specifying text for one of the graph axes or for the graph title.

Use the following syntax for the LABEL option:

LABEL(XAXIS|YAXIS|TITLE,'label' [,COLOR(color)] [,LINE(n)])

TITLE

The title of the graph displays at the top center of the window for this graph. You can specify up to three lines of label text for the X axis, and up to seven lines for the Y axis.

XAXIS

The label displays centered on the X axis.

YAXIS

The label displays centered on the Y axis.

label

The text of the label, which must be enclosed in single quotation marks. The label for the graph or for the X axis can contain as many as 80 characters. The label for the Y axis can contain as many as 32 characters.

COLOR

The color of the label. Valid color values are:

LINE

The number of the line in the label text. A label can contain up to three lines of text. Your PLOT command must contain one LABEL clause for each line. The LINE(n) operand specifies whether the line being defined is line 2 or line 3 of the label text. Because the default for n is 1, you need to include the LINE(n) operand only in the second or third LABEL clauses of a PLOT command. For example, if you are defining a two-line label, the LABEL clause defining the second line is LINE(2).

Default: If you omit the LABEL option completely, the default is no labels. If a LABEL clause specifies no color, the default label color is white. If you omit the LINE(n) operand, CA Automation Point assumes that the label contains only one line of text.

Examples:

These commands create the title and one of the Y-axis labels:

"PLOT SPLPLOT DEFINE GRAPH",
  "LABEL(TITLE,'JES Spool Utilization',COLOR(TURQUOISE))"

"PLOT SPLPLOT DEFINE GRAPH",
  "LABEL(YAXIS,'S008',COLOR(RED),LINE(2))"

Note: If you define a graph with many lines using different colors, specify a Y-axis label for each line in the color of the line to make the graph easier to read.

Usage Information:

Use labels sparingly. If you use too many labels, the size of the plot area decreases to allow more space for the label areas. Avoid long YAXIS labels and multiline XAXIS and TITLE labels as much as possible.

If you have a dedicated Plot window (used only for displaying one plotted graph), you can specify a title for the window in a CA Automation Point session definition set (rather than specifying the LABEL operand). Doing so produces a more readable title and conserves space within the plot area.