Graphics Options and Device Parameters Dictionary

GSFMODE

Specifies the disposition of records written to a graphics stream file (GSF) or to a device or communications port by the device driver.

Used in:	GOPTIONS statement; GDEVICE procedure; GDEVICE Host File Options window
Default:	REPLACE
Restriction:	not supported by Java or ActiveX
See also:	GACCESS, GSFNAME

Syntax
Details

Syntax

GSFMODE=APPEND | PORT | REPLACE

APPEND

adds the records to the end of a GSF designated by the GACCESS= or GSFNAME= graphics option or device parameter. If the file does not already exist, it is created.

The destination can be either a specific file or an aggregate file storage location.

If the destination of the GSF is a specific file and you specify APPEND, SAS/GRAPH will add the new records to an existing GSF of the same name.

If the destination of the GSF is a file location and not a specific file, SAS/GRAPH will add the records to an external file whose name matches the name of the newly created catalog entry. For more information on how SAS/GRAPH names catalog entries, see Specifying the Graphics Output File Type for Your Graph.

Note: Some viewers of bitmapped output can view only one graph, even though multiple graphs are stored in the file. Therefore it might appear that a file contains only one graph when in fact it contains multiple graphs. [cautionend]

PORT

sends the records to a device or communications port. The GACCESS= graphics option or device parameter should point to the desired port or device.

REPLACE

replaces the existing contents of a GSF designated by the GACCESS= or GSFNAME= graphics option or device parameter. If the file does not exist, it is created. REPLACE is always the default, regardless of the destination of the GSF.

If the destination of the GSF is a specific file and you specify REPLACE, SAS/GRAPH will replace an existing GSF with the contents of a newly created GSF of the same name.

If the destination of the GSF is a file location and not a specific file, SAS/GRAPH will replace an external file whose name matches the name of the newly created catalog entry. For more information on how SAS/GRAPH names catalog entries, see Specifying the Graphics Output File Type for Your Graph.

Details

When you create a GSF, the GSFNAME= or GACCESS= graphics option or device parameter controls where the output goes, and GSFMODE= controls how the driver writes graphics output records. If the output is to go to a file, specify APPEND or REPLACE. If the output is to go directly to a device or to a communications port, specify PORT. See Specifying the Graphics Output File Type for Your Graph for more information on creating a graphics stream file.

Top of Page