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 new-device-entry
required-parameters
<optional-parameters>;

required-parameters are all of the following:

MODULE=driver-module

XMAX=width <IN | CM>

YMAX=height <IN | CM>

XPIXELS=width-in-pixels

YPIXELS=height-in-pixels

plus one or both of the following parameter pairs:

LCOLS=landscape-columns

LROWS=landscape-rows

or

PCOLS=portrait-columns

PROWS=portrait-rows

optional-parameters can be one or more of the following:

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

SFNAME=fileref

GSIZE=lines

GSTART='string' <...'string-n'>

HANDSHAKE=HARDWARE | NONE | SOFTWARE | XONXOFF

HEADER='command'

HEADERFILE=fileref

ORIGIN=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

SPEED=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: all 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 will be created if you do not use it. However, the GDEVICE procedure issues an error message if you do not specify at least one color for COLORS=. [cautionend]

Details

The ADD statement is rarely used because it initializes parameter values to NULL and you have to set values for all the parameters. The best way to add a new driver is to copy an existing driver and modify it.

Chapter Contents
Previous
Next
Top of Page

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.