x

SET HAXIS=nn

where:

nn

Is a numeric value between 20 and 985 pixels.

x

SET VAXIS=nn

where:

nn

Is a numeric value between 20 and 518 pixels.

x

To set the parameters that control the GRAPH environment, use the appropriate variation of the SET parameter.

SET parameter=value,parameter=value...

For a list of supported GRAPH parameters, see Values and Functions of SET Parameters for Graphs.

Note:

• Repeat the command SET on each new line.
• When entering more than one parameter on a line, separate them with commas.
• You can use unique truncations of parameter names. You must make sure that they are unique.

Top of page

Example: Using SET Parameters With GRAPH Requests

The following shows how to set the height (Y-axis) and width (X-axis) for a graph.

SET HAXIS=75,VAXIS=40
GRAPH FILE filename 
.
.
.
END

x

Graph SET Parameter	Values	Parameter Function
3D	ON|OFF	When ON, a three-dimensional chart is produced. When OFF, a two-dimensional chart is produced. ON is the default.
AUTOTICK	ON|OFF	When ON, tick mark intervals are automatically set. ON is the default. (See also HTICK and VTICK.)
BARNUMB	ON|OFF	When ON, places the summary values at the ends of the bars on bar graphs or slices on pie graphs. OFF is the default.
BSTACK	ON|OFF	When ON, specifies that the bars on a bar graph are to be stacked rather than placed side by side. OFF is the default.
GRAPHEDIT	graphedit	Determines whether the Graph Editor is enabled at run time. For details, see Customizing Graphs With the Graph Editor.
GRID	ON|OFF	When ON, specifies that a grid is to be drawn on the graph at the horizontal and vertical class marks (see also VGRID). OFF is the default.
HAUTO	ON|OFF	When ON, specifies automatic scaling of the horizontal axis unless overridden by the user. If OFF, user must supply values for HMAX and HMIN. ON is the default.
HAXIS	20-770	Specifies the width in characters of the horizontal axis. This parameter can be adjusted for graphs generated offline. HAXIS is ignored for online displays since the width of the graph is automatically adjusted to the width of the display area.
HCLASS	nnn	Specifies the horizontal interval mark when AUTOTICK=OFF (see also HTICK).
HISTOGRAM	ON|OFF	When ON, a histogram is drawn instead of a curve when values on the horizontal axis are not numeric. OFF is the default.
HMAX	nnn	Specifies the maximum value on the horizontal axis when the automatic scaling is not used (HAUTO=OFF).
HMIN	nnn	Specifies the minimum value on the horizontal axis when the automatic scaling is not used (HAUTO=OFF).
HSTACK	ON|OFF	When ON, specifies that the bars on a histogram are to be stacked rather than placed side by side. OFF is the default.
HTICK	nnn	Specifies the horizontal axis tick mark interval when AUTOTICK is OFF (see also HCLASS).
LOOKGRAPH	option	Specifies the graph type. For more information, see Determining Graph Styles Using LOOKGRAPH.
PIE	ON|OFF	When ON, specifies that a pie graph is desired. OFF is the default.
VAUTO	ON|OFF	When ON, specifies automatic scaling of the vertical axis unless overridden by the user. If OFF, the user must supply values for VMAX and VMIN. ON is the default.
VAXIS	20-405	Specifies page length in lines. This parameter can be adjusted for graphs generated offline. VAXIS is ignored for online displays since the height of the graph is automatically adjusted to the display area.
VCLASS	nnn	Specifies the vertical interval mark when AUTOTICK=OFF (see also VTICK).
VGRID	ON|OFF	When ON, specifies that a grid is to be drawn on the graph at the horizontal and vertical class marks (see also GRID). OFF is the default.
VMAX	nnn	Specifies the maximum value on the vertical axis when the automatic scaling is not used (VAUTO=OFF).
VMIN	nnn	Specifies the minimum value on the vertical axis when the automatic scaling is not used (VAUTO=OFF).
VTICK	nnn	Specifies the vertical axis tick mark interval when AUTOTICK is OFF (see also VCLASS).
VZERO	ON|OFF	Determines whether values along the Y-axis are stored or ignored. If ON, missing data along the Y-axis is treated as zero. If OFF, missing data along the Y-axis is ignored and values are not stored in the plot matrix. OFF is the default.

x

SET HAUTO=OFF, HMAX=nn, HMIN=nn

where:

HAUTO

Is the automatic scaling facility. If HAUTO is ON, any values for HMAX and HMIN are overridden.

HMAX=nn

Sets the upper limit on the horizontal axis. The default is 0.

HMIN=nn

Controls the lower limit on the horizontal axis when HAUTO is OFF. The default is 0.

Note:

• When entering several SET parameters on one line, separate them with commas.
• If you define limits that do not incorporate all of the data values, OVER or UNDER will be displayed to indicate that some of the data extracted is not reflected on the graph.

x

SET VAUTO=OFF, VMAX=nn, VMIN=nn

where:

VAUTO

Is the automatic scaling facility. If VAUTO is ON, any values for VMAX and VMIN are overridden.

VMAX=nn

Sets the upper limit on the vertical axis when VAUTO is OFF. The default is 0.

VMIN=nn

Controls the lower limit on the vertical axis when VAUTO is OFF. The default is 0.

Note:

• When entering several SET parameters on one line, separate them with commas.
• If you define limits that do not incorporate all of the data values, OVER or UNDER will be displayed to indicate that some of the data extracted is not reflected on the graph.

x

The SET GRAPHEDIT command must be placed before the GRAPH FILE command in a procedure.

SET GRAPHEDIT = graphedit

where:

graphedit

Determines whether the Graph Editor is enabled at run time. Possible values are:

ON activates the Graph Editor. A button is displayed in the upper-right corner of the window that contains the graph. Click this button to access the Graph Editor.

OFF is where the Graph Editor will not be enabled at run time and a Java-rendered graph is returned.

SERVER generates a server-side graph. A GIF graph is created on the Web server and the image is returned to the client in the browser.

This is the default.

x

GRAPH FILE filename<graph commands>
ON GRAPH SET GRAPHSTYLE *
<API calls>
ENDSTYLE
[ON GRAPH SET STYLE *
<WEBFOCUS StyleSheet commands>
ENDSTYLE]
END

where:

filename

Specifies a data source for the graph.

API calls

For reference information about the Graph API, see the WebFOCUS Graphics manual.

WEBFOCUS StyleSheet commands

For details on StyleSheet commands, see Using an External Cascading Style Sheet.

Top of page

Example: Customizing Graphs Using the Graph API

The following annotated example illustrates how to customize a graph using ON GRAPH SET GRAPHSTYLE *. The Graph API code is highlighted in the request.

   GRAPH FILE SALES
   SUM RETURNS
   RETAIL_PRICE
   ACROSS PROD_CODE AS 'Product Code'
   ON GRAPH SET GRAPHSTYLE *
1. setLegendMarkerPosition(4);
2. setO1LabelRotate(0);
3. setTitleString("Sales Report");
4. setTextJustHoriz(getTitle(),1);
   ENDSTYLE
   ON GRAPH SET STYLE *
   DEFMACRO=COND0001, MACTYPE=RULE, WHEN=RETURNS GT 4,$
   TYPE=DATA,MACRO=COND0001,ACROSSCOLUMN=RETURNS,COLOR=RED,$
   ENDSTYLE
   END

where:

1. Displays legend text inside the legend marker.
2. Displays the x-axis labels horizontally.
3. Displays the title (Sales Report) without quotes.
4. Centers the title.

The output is: