Graphics Options and Device Parameters Dictionary

GACCESS

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
Restriction:	not supported by Java, ActiveX, or shortcut devices. See Using Graphics Devices for more information about devices.

Syntax

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 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. [cautionend]

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 Specifying the Graphics Output File Type for Your Graph 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 that case the format defaults to SASGASTD. When you specify a value in the Gaccess field, you do not need to quote it. [cautionend]

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. [cautionend]

Top of Page