CLEAR

Opens a graphics segment for output

Operating state:	WSAC
Resulting operating state:	SGOP

Syntax

Details

Syntax

return-code-variable=GRAPH ('CLEAR'<, name> <, des><, byline>);

Required Arguments

name: character string enclosed in quotes or character variable name; gives a name to the graph to be opened. If name is not specified, DSGI assigns the graph a name that is some form of DSGI: for example, DSGI, DSGI1, and DSGI2.

des: character string enclosed in quotes or character variable name; gives a description to the graph to be opened. If des is not specified, DSGI assigns the following description to the catalog entry: Graph from DATA Step Graphics Interface.

BY line: character string enclosed in quotes or character variable name; gives another line of description for the graph. The byline appears under the titles on the graph. DSGI does not provide a default byline.

Return Codes

This function returns:: 0, 3, 301, or 302. See Return Codes for DSGI Routines and Functions.

Details

The GRAPH('CLEAR', . . . ) function opens a graphics segment for output in the current catalog. The first parameter, 'CLEAR', is the only required one. The values of name, des, and byline are displayed in catalog listings and in catalog information in the GREPLAY procedure.

If the name specified is an existing graph, DSGI adds a suffix number to the name. If PIE is chosen for the name and it already exists, DSGI names the output PIE1; the next time the code is submitted, DSGI names the output PIE2, and so on.

This function moves the operating state from WSAC to SGOP.