DATA Step Graphics Interface Dictionary

GRAPHLIST

Finds the names of segments in the current catalog

Operating States:	GKOP, SGOP, WSAC, WSOP
Return Codes:	0, 8

Syntax
Description
Argument Definitions
See Also

Syntax

CALL GASK('GRAPHLIST', n, name-array, return-code-variable);

Description

The GASK('GRAPHLIST', . . . ) routine lists the first n names of the graphs that are in the current catalog. If a catalog has not been previously specified with the GRAPH('CATALOG', . . . ) function, the routine returns names from the default catalog, WORK.GSEG.

The names returned are any of the following:

those specified in the GRAPH('CLEAR', . . . ) function
if the name is omitted from the GRAPH('CLEAR' . . . ) function, some form of DSGI: for example, DSGI, DSGI1, or DSGI2.
the name specified in the NAME= option of a graphics procedure
graphs previously created by other graphics procedures and already in the catalog.

Argument Definitions

n	numeric variable name; tells the maximum number of graph names you want returned. If you express n as a variable, the variable must be initialized to the maximum number of graph names you want returned.
name-array	list of character variable names into which the graph names are returned. The list of variable names can be members of an array or OF argument lists (where the arguments are variables). If you are using an array, name-array must be declared as an array. The dimension of the array is determined by the number of color indexes you want returned. See the discussion for ARRAY in SAS Language Reference: Dictionary for more information about OF argument lists.
return-code-variable	numeric variable names; returns the return code of the routine call.