Chapter Contents

Previous

Next

GSFMODE

Used in:	GOPTIONS statement; GDEVICE procedure; GDEVICE Host File Options window
Default:	REPLACE
See also:	GACCESS, GSFNAME

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 Exporting SAS/GRAPH Output with Program Statements.

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

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 Exporting SAS/GRAPH Output with Program Statements.

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 About Graphics Stream Files for more information on creating a graphics stream file.

Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.