The GREPLAY Procedure

PROC GREPLAY Statement

Determines whether the procedure starts in a windowing or non-windowing environment. Defines whether the session is used for catalog management or output presentation.

Syntax

PROC GREPLAY <BYLINE>
<CC=color-map-catalog>
<CMAP=color-map-entry-type>
<FS>
<GOUT=<libref.>output-catalog>
<IGOUT=<libref.>input-catalog>
<IMAGEMAP=output-data-set>
<NOBYLINE>
<NOFS>
<PRESENTATION>
<TC=template-catalog>
<TEMPLATE=template-entry>;

Options

BYLINE

specifies that the BY statement information for the SAS catalog entries should be displayed.

Default:

BY statement information is displayed

CC=color-map-catalog

specifies the color map catalog where the color map entries are stored.

Note:	To replay graphics output using a color map, you must specify a color map catalog with the CC= option and a color map entry with the CMAP= option.
Featured in:	Creating a Color Map

CMAP=color-map-entry-type

specifies the type of catalog entry to use with the GREPLAY procedure. A color map entry option must have a catalog entry type of CMAP.

Note:	To replay graphics output using a color map entry, you must specify a color map catalog with the CC= option and a color map entry with the CMAP= option.
Featured in:	Creating a Color Map

FS

specifies that the GREPLAY procedure should use full-screen windows.

Default:

If your device supports windows, the GREPLAY procedure uses windows. If your device does not support windows, the procedure begins execution in line mode, and the FS option has no effect.

GOUT=<libref.>output-catalog

specifies the graphics output catalog. New GRSEG entries or GRSEG entries from other catalogs can be copied to an output catalog. If you omit the libref, SAS/GRAPH looks for the catalog in the temporary WORK library, and creates the GSEG catalog if it does not exist.

Note:	The output catalog can be the same catalog specified in the IGOUT= option.
See also:	Catalog Entries

IGOUT=<libref.>input-catalog

specifies the input catalog that stores the graphics output that you want to use with the GREPLAY procedure. If you omit the libref, SAS/GRAPH looks for the catalog in the temporary WORK library.

Note:	The input catalog can be the same catalog specified in the GOUT= option.
Featured in:	Replaying GSLIDE Procedure Output in a Template

IMAGEMAP=output-data-set

used with the REPLAY statement (see REPLAY Statement). The IMAGEMAP= option creates a temporary SAS data set that contains information about the graph. The graph is replayed from the graphics catalog. The image map data set contains the following information about the graph:

the shapes of the elements
the coordinates of the elements
the values that are associated with those element; in variables that are identified in the HTML= option
the values that are associated with those element; in variables that are identified in the HTML_LEGEND= option

The image map data set can be used to generate an HTML image map in an HTML output file using the IMAGEMAP macro. The IMAGEMAP macro takes two arguments: the image map data set name and the name or fileref of an HTML output file, as shown in this example:

%imagemap(imgmapds, myimgmap.html);

NOBYLINE

specifies that the BY statement information for the SAS catalog entries should be suppressed.

Default:

BY statement information is displayed

NOFS

specifies that the GREPLAY procedure should use line mode.

Default:	If your device does not support windows: NOFS
Featured in:	Creating a Template

PRESENTATION

specifies that the GREPLAY procedure should open the PRESENTATION window, and use the catalog specified by the IGOUT= option as the input catalog. The PRESENTATION option is often used in applications to prevent the application users from deleting or reordering catalog entries. You can only replay graphics output from the PRESENTATION window.

Note:

The PRESENTATION option overrides the NOFS option on full-screen devices.

TC=template-catalog

specifies the template catalog to use with the GREPLAY procedure, and identifies the template catalog where the template entry is stored to replay your graphics.

Note:	To replay graphics output using a template catalog, you must also assign the template entry with the TEMPLATE= option.
Featured in:	Creating a Template

TEMPLATE=template-entry

identifies the template entry to use with the GREPLAY procedure. The template entry must have a catalog entry type of TEMPLATE.

Note:	To replay graphics output using a template entry, you must also assign a current template catalog with the TC= option. If the template entry is not in the template catalog, an error message is written to the SAS log.
Featured in:	Replaying GSLIDE Procedure Output in a Template

Invoking the GREPLAY Procedure

The mode of operation for the PROC GREPLAY statement depends on both the environment in which the statement is submitted and whether the NOFS option is included.

Ways of Invoking the GREPLAY Procedure
Environment	Statement	Result
windowing	PROC GREPLAY;	GREPLAY procedure windows
windowing	PROC GREPLAY NOFS;	line mode
nonwindowing	PROC GREPLAY;	line mode

You can toggle back and forth between windows and line mode within a session.

Top of Page