The GDEVICE Procedure

ADD Statement

Adds a new device entry to the catalog selected by the CATALOG= option in the PROC GDEVICE statement. The device entry is initialized with NULL values for most parameters.

Requirements:	You must have write access to the device catalog in order to add entries, and use CATALOG= in the PROC GDEVICE statement.
Restriction:	Not valid in browse mode.

ADD device-entry
required-parameters
<optional-parameters>;

required-parameters are all of these parameters:

	MODULE=driver-module
	XMAX=width <IN \| CM>
	YMAX=height <IN \| CM>
	XPIXELS=width-in-pixels
	YPIXELS=height-in-pixels

plus one or both of these parameter pairs:

	LCOLS=landscape-columns
	LROWS=landscape-rows

	PCOLS=portrait-columns
	PROWS=portrait-rows

optional-parameters can be one or more of these options:

	ASPECT=scaling-factor
	AUTOCOPY=Y \| N
	AUTOFEED=Y \| N
	CBACK=background-color
	CELL=Y \| N
	CHARACTERS=Y \| N
	CHARREC=(charrec-list(s))
	CHARTYPE=hardware-font-chartype
	CIRCLEARC=Y \| N
	CMAP=('from-color : to-color' <...,'from-color-n : to-color-n'>)
	COLORS=(<colors-list>)
	COLORTYPE=NAME \| RGB \| HLS \| GRAY \| CMY \| CMYK \| HSV \| HSB
	DASH=Y \| N
	DASHLINE='dashed-line-hex-string'X
	DESCRIPTION='text-string'
	DEVMAP=device-map-name \| NONE
	DEVOPTS='hardware-capabilities-hex-string'X
	DEVTYPE=device-type
	DRVINIT1='system-command(s)'
	DRVINIT2='system-command(s)'
	DRVQRY \| NODRVQRY
	DRVTERM1='system-command(s)'
	DRVTERM2='system-command(s)'
	ERASE=Y \| N
	FILECLOSE=DRIVERTERM \| GRAPHEND
	FILL=Y \| N
	FILLINC=0...9999
	FORMAT=CHARACTER \| BINARY
	GACCESS=output-format \| 'output-format > destination'
	GCOPIES=current-copies
	GEND='string' <...'string-n'>
	GEPILOG='string' <...'string-n'>
	GPROLOG='string' <...'string-n'>
	GPROTOCOL=module-name
	GSFLEN=record-length
	GSFMODE=APPEND \| REPLACE \| PORT
	GSFNAME=fileref
	GSIZE=lines
	GSTART='string' <...'string-n'>
	HANDSHAKE=HARDWARE \| NONE \| SOFTWARE \| XONXOFF
	HEADER='command'
	HEADERFILE=fileref
	HORIGIN=horizontal-offset <IN \| CM>
	HOSTSPEC='text string'
	HSIZE=horizontal-size <IN \| CM>
	ID='description'
	INTERACTIVE=USER \| GRAPH \| PROC
	LFACTOR=line-thickness-factor
	MAXCOLORS=number-of-colors
	MAXPOLY=number-of-vertices
	MODEL=model-number
	NAK='negative-handshake-response'X
	PAPERFEED=feed-increment <IN \| CM>
	PATH=angle-increment
	PENSORT=Y \| N
	PIEFILL=Y \| N
	POLYGONFILL=Y \| N
	POSTGRAPH1='system-command(s)'
	POSTGRAPH2='system-command(s)'
	PREGRAPH1='system-command(s)'
	PREGRAPH2='system-command(s)'
	PROCESS='command'
	PROCESSINPUT=fileref
	PROCESSOUTPUT=fileref
	PROMPT=0...7
	PROMPTCHARS='prompt-chars-hex-string'X
	QMSG \| NOQMSG
	RECTFILL='rectangle-fill-hex-string'X
	REPAINT=redraw-factor
	ROTATE=LANDSCAPE \| PORTRAIT
	ROTATION=angle-increment
	pen-speed
	SWAP=Y \| N
	SYMBOL=Y \| N
	SYMBOLS='hardware-symbols-hex-string'X
	TRAILER='command'
	TRAILERFILE=fileref
	TRANTAB=table \| user-defined-table
	TYPE= CAMERA \| CRT \| EXPORT \| PLOTTER \| PRINTER
	UCC='control-characters-hex-string'X
	VORIGIN=vertical-offset <IN \| CM>
	VSIZE=vertical-size <IN \| CM>

Required Arguments

new-device-entry: specifies the one-level name of the new device entry. New-device-entry must be a valid name for a SAS catalog entry for your operating environment and cannot already exist in the current catalog.
required-parameters: specify the required parameters for the device. All of the required parameters for the ADD statement correspond to device parameters of the same name. Refer to Graphics Options and Device Parameters Dictionary for a description of each parameter.

Options

All optional parameters for the ADD statement correspond to device parameters of the same name. Refer to Graphics Options and Device Parameters Dictionary for a description of each parameter.

Note: The COLORS= device parameter is not required; the device entry is created even if you do not specify it. However, the GDEVICE procedure issues an error message if you do not specfy at least one color for the COLORS= option. [cautionend]

Best Practice

The best way to add a new driver is to copy an existing driver and modify the parameters. The ADD statement initializes all the parameter values to NULL, and you have to set values for all of the parameters to something other than NULL.

Top of Page