GRAPHLIST

Finds the names of segments in the current catalog

Operating state:

GKOP, SGOP, WSAC, WSOP

Syntax

Details

Syntax

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

Required Arguments

n: numeric variable name; tells the maximum number of graph names that you want returned. If you express n as a variable, the variable must be initialized to the maximum number of graph names that 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 that you want returned. See the discussion for ARRAY in SAS Statements: Reference for more information about OF argument lists.

return-code-variable: numeric variable names; returns the return code of the routine call, which can be 0 or 8. See Return Codes for DSGI Routines and Functions.

Details

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