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 by: |
GOPTIONS statement, GDEVICE procedure, GDEVICE Host File Options window |
| Default: |
REPLACE |
| Restriction: |
not supported by Java or ActiveX |
| See: |
GACCESS GSFNAME
|
Syntax
GSFMODE=APPEND | PORT | REPLACE
Parameter Values
- APPEND
-
adds the records to
the end of a GSF designated by the GACCESS= or GSFNAME= graphics option
or device parameter.
Note: The
APPEND option is useful only with the GIF graphics output device,
and the PCL and PostScript Universal Printer devices. When used with
other devices, such as PNG, SVG, or PDF, only the first graph is displayed
in the viewer.
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 about 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.
- 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 about 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
about creating a graphics stream file.