Chapter Contents

GACCESS

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

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:

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.

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.

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

specifies that records are to be written to the SAS log.

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

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

Chapter Contents
Previous
Next
Top of Page

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