Specifies the format or the destination or both of graphics data
written to a device or graphics stream file (GSF).
| Used in: |
GOPTIONS statement; GDEVICE procedure;
GDEVICE Host File Options window
|
| Default: |
device dependent
|
|
GACCESS=output-format | 'output-format
destination'
|
-
output-format
- specifies the format or the destination
(the SAS log or a fileref) of the graphics data. Output-format
varies according to the operating environment. These values can be specified
in all operating environments:
- SASGASTD
- specifies that a continuous stream of data
is written. SASGASTD is the default for most devices and is typically appropriate
when the output file will be sent directly to a device. If you specify GACCESS=SASGASTD,
use the GSFNAME= and GSFMODE= graphics options or device parameters to direct
your graphics output to a GSF.
- SASGAEDT
- specifies that the file be host-specific
editable format. Some hosts allow editing by inserting characters at the end
of each record. SASGAEDT is typically used when the output file is to be edited
later. If you specify GACCESS=SASGAEDT, use the GSFNAME= and GSFMODE= graphics
options or device parameters to direct your graphics output to a GSF.
- SASGAFIX
- specifies that fixed-length records be written.
(The record length is controlled by the value of the GSFLEN= graphics option
or device parameter or the sixth byte of the PROMPTCHARS value.) The records
are padded with blanks where necessary. SASGAFIX is typically used when the
output file will be transferred to a computer that requires fixed-length records.
If you specify GACCESS=SASGAFIX, use the GSFNAME= and GSFMODE= graphics options
or device parameters to direct your graphics output to a GSF.
Note: The value of the GPROTOCOL= graphics option or device parameter
can greatly affect the length of the records; for example, if GPROTOCOL=SASGPLCL,
the length of the records is doubled. ![[cautionend]](../common/images/cautend.gif)
- SASGALOG
- specifies that records are to be written
to the SAS log.
- GSASFILE
- specifies that the records are to be written
to the destination whose fileref is GSASFILE. The fileref can point to a specific
external file or to an aggregate file location. See FILENAME Statement for more information
on specifying a fileref.
- 'output-format destination'
- specifies the destination in addition to
one of these output format values: SASGASTD, SASGAEDT, or SASGAFIX. Destination is the physical name of an external file or aggregate file
location, or of a device. For details on specifying the physical name of
a destination, see the SAS documentation for your operating environment.
This form is not available in all operating environments.
See About Graphics Stream Files
for more information on creating graphics stream files.
Note: In the
Gaccess field of the Host File Options window, you
can specify a destination without an output format, in which case the format
defaults to SASGASTD. When you specify a value in the
Gaccess field, you do not need to quote
it.
Operating Environment Information: Depending
on your operating environment,
you may be able to specify other values for GACCESS=. See the SAS companion
for your operating environment for additional values.
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.
