GACCESS
Specifies the format or the destination or both
of graphics data written to a device or graphics stream file (GSF).
Used by: |
GOPTIONS statement, GDEVICE procedure, GDEVICE Host File Options window |
Default: |
device-dependent |
Restriction: |
not supported by Java, ActiveX, or shortcut devices.
See
|
Note: |
Using Graphics Devices for more information
about devices.
|
Syntax
GACCESS=output-format | 'output-format destination'
Parameter Values
- 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 edit 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.
- 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 about 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 about specifying the physical name of
a destination, see the SAS documentation for your operating environment.
Note: In the
Gaccess
field of the
Host File Options window,
you can specify a destination without an output format. In that 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 might be able to specify
other values for GACCESS=. See the SAS companion for your operating
environment for additional values.