The GREPLAY Procedure

PROC GREPLAY Statement

Determines whether the procedure starts in a windowing or nonwindowing environment, and whether the session is used for catalog management or output presentation.

Syntax

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

Options

Each PROC GREPLAY statement option has an equivalent statement that you can use instead.

BYLINE

specifies that the BY statement information for the SAS catalog entries should be displayed. The BY statement information appears directly beneath the primary description of the entry. By default, the BY statement information is displayed.

CC=color-map-catalog

identifies the color map catalog to be used with the GREPLAY procedure. Use the CMAP= option to assign a current color map that is contained in color-map-catalog.

To assign a current color map or create new color maps, you must assign a color map catalog with the CC= option.

To replay graphics output using a color map, you must assign a color map catalog and a current color map with the CC= and CMAP= options.

Featured in: Creating a Color Map

CMAP=color-map-entry

assigns a current color map to use when replaying graphics output, where color-map-entry names an existing color map in the catalog specified in the CC= option. If color-map-entry is not in the catalog, an error message is written to the SAS log. Color-map-entry must have a catalog entry type of CMAP.

If you do not specify a color map catalog using the CC= option when using the CMAP= option, a warning message is written to the SAS log.

To replay graphics output using a color map, you must assign a color map catalog and a current color map with the CC= and CMAP= options.

FS

specifies that the GREPLAY procedure should use windows. By 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 SAS catalog in which to save the graphics output that is produced by the GREPLAY procedure. In addition, catalog entries that contain graphics output can be copied to output-catalog. If you omit the libref, SAS/GRAPH looks for the catalog in the temporary library called WORK and creates the catalog if it does not exist. Output-catalog can be the same catalog that is specified in the IGOUT= option.

To copy catalog entries, you must assign an input and, optionally, an output catalog with the IGOUT= and GOUT= options.

See also: Storing Graphics Output in SAS Catalogs
Featured in: Replaying Graphics Output in a Template

IGOUT=<libref.>input-catalog

specifies the input catalog to use with the GREPLAY procedure. The input catalog that you specify with the IGOUT= option should be a catalog that contains the graphics output that will be replayed. If you omit the libref, SAS/GRAPH looks for the catalog in the temporary library called WORK. Input-catalog can be the same catalog that you specified in the GOUT= option.

To move, group, or delete catalog entries or to replay graphics output, you must assign an input catalog with the IGOUT= option.

To copy catalog entries, you must assign an input and, optionally, an output catalog with the IGOUT= and GOUT= options.

Featured in: Replaying Graphics Output in a Template

IMAGEMAP=output-data-set

must be used in conjuntion with the REPLAY statement (see REPLAY Statement). Creates a SAS data set that contains information about the graph that is replayed from the graphics catalog and about areas in that graph. This information includes the shape and coordinates of the areas, and is used to build an HTML file that links the graph areas to other files or images. This linking provides drill-down functionality on the graph. The Imagemap data set also contains the information that is stored in the HTML variable in the data set that generated the original graph. Therefore, in order to use IMAGEMAP= to create an HTML file, the procedure that originally stored the graph in the graphics catalog must have used an HTML variable in the data set that was used to generate the graph, and it must also have specified HTML=, or HTML_LEGEND=, or both.

NOBYLINE

suppresses the BY statement information for the SAS catalog entries. The BY statement information appears directly beneath the primary description of the entry. By default, the BY statement information is displayed.

NOFS

specifies that the GREPLAY procedure should use line mode. By default, if your device supports windows, the GREPLAY procedure uses windows. If your device does not support windows, the procedure uses line mode, regardless of whether you used the FS option or the NOFS option.

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 the catalog entries. You can only replay graphics output from the PRESENTATION window; you cannot manage catalogs or create templates and color maps from this window.

You must use the IGOUT= option when you use the PRESENTATION option. The PRESENTATION option overrides the NOFS option on full-screen devices.

TC=template-catalog

identifies the template catalog to use with the GREPLAY procedure. Use the TEMPLATE= option to assign a current template from template-catalog.

To assign a current template or create new templates, you must assign a template catalog with the TC= option.

To replay graphics output in a template, you must assign a template catalog and a current template with the TC= and TEMPLATE= options.

Featured in: Creating a Template

TEMPLATE=template-entry

assigns a current template to use when replaying graphics output where template-entry names an existing template in the template catalog that is specified in the TC= option. If template-entry is not in the catalog, an error message is written to the SAS log. Template-entry must have a catalog entry type of TEMPLATE.

When you use the TEMPLATE= option, you must also specify the name of a template catalog with the TC= option. Otherwise, a warning message is written to the SAS log.

Featured in: Replaying Graphics Output in a Template

Details

When you submit the PROC GREPLAY statement, the mode of operation depends on both the environment in which the statement is submitted and whether the NOFS option is included, as shown in Ways of Invoking the GREPLAY Procedure.

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

***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 switch back and forth between windows and line-mode within a session.

Chapter Contents
Previous
Next
Top of Page

See also:	Storing Graphics Output in SAS Catalogs
Featured in:	Replaying Graphics Output in a Template