Procedure Syntax


Requirements: The NAME = argument is always required. To create a key map or device map, the DATA= argument is required. To output a data set, the OUT= argument is required.

PROC GKEYMAP NAME= map-name

  • data-set-argument

  • < option(s) >;

PROC GKEYMAP Statement

The PROC GKEYMAP Statement names the key map or device map to be created or output as a data set. If the procedure creates a key map or a device map, it identifies the data set that is used as input. If it outputs a map, it identifies the data set to which the map is written.

Syntax

  • PROC GKEYMAP NAME= map-name

    • data-set-argument

    • < option(s) >;

data-set-argument must be one or more of the following:

  • DATA = keymap -data-set

  • OUT= output-data-set

option(s) can be one or more of the following:

  • DEVICE= device-name

  • DEVMAP KEYMAP

  • TYPE=MAP11 MAP1N

  • MULTFONT

Required Arguments

NAME= map-name

  • identifies the map that is to be created or converted to a SAS data set. Key maps are stored as map-name . KEYMAP, and device maps are stored as map-name . DEVMAP. The value of the KEYMAP or DEVMAP option determines the type of map and the extension added to map-name . It is possible to use the same map-name value for both a key map and a device map.

    If you create a key map or device map, the map is stored as an entry in the catalog GFONT n .FONTS where n is a number from 1 to 9, and you must use a LIBNAME statement to specify a libref for GFONT n . See About the Libref GFONT0 on page 941 for details.

    If you specify an existing key map or device map, SAS/GRAPH software searches for the map using the same search path that it uses to search for fonts. See Font Locations on page 77 for details .

    Featured in: Example 1 on page 990.

DATA= keymap-data-set

  • identifies the input data set for the GKEYMAP procedure. Used only when you are creating a key map or device map.

    See also: SAS Data Sets on page 29 and About the GKEYMAP Data Set on page 987.

    Featured in: Example 1 on page 990.

OUT= output-data-set

  • identifies the output data set to which the data from a key map or device map are to be written. Used only when you output an existing key map or device map as a SAS data set.

    Featured in: Example 1 on page 990.

Options

  • You can specify as many options as you want and list them in any order.

DEVICE= device-name

  • specifies the device driver that a device map is associated with, where device-name is the name of an entry in a device catalog. DEVICE= is not required when creating a device map, but it can be used if you want to limit the use of the device map to one particular driver. If you do not use DEVICE=, the device map can be used with any device. DEVICE= is valid only if you are creating a device map.

DEVMAP KEYMAP

  • specifies whether you are working with a device map or a key map. The default is KEYMAP unless you use an option that can be used only with DEVMAP. This option also specifies the type of map you are outputting as a data set.

    Featured in: Example 1 on page 990.

TYPE=MAP11 MAP1N

  • specifies whether you are mapping characters in a device map one-to-one or one-to-many. If you specify TYPE=MAP11 (the default), each character in a graphics text string is mapped to only one character on the output device. If you specify TYPE=MAP1N, a single character in a graphics text string can be mapped to multiple characters on the output device. For example, if two characters have to be sent to the graphics output device to display a single hardware character, specify TYPE=MAP1N. Specify TYPE=MAP1N only when you create a device map.

MULTFONT

  • specifies that an alternate hardware character set is required to display one or more characters in the device map. Specify the MULTFONT option only when you create a device map.

Creating a Data Set from an Existing Key Map or Device Map

To generate a data set from an existing key map or device map, follow these steps:

  1. Specify the name of the key map or device map with the NAME= argument. If the map is user generated, you must first submit a LIBNAME statement to associate the libref GFONT0 with the location where the map is stored, and NAME= must specify the name that was specified for the key map or device map when it was created. If the map is an Institute-supplied map, it is located in the catalog SASHELP.FONTS, and you do not need to submit a LIBNAME statement to access it.

  2. In the OUT= argument, specify the name of the data set to which the data are to be written. By default, the data set is written to the temporary library WORK.

  3. Use the DEVMAP option if a device map is selected.

  4. Optionally, use the PRINT procedure to display the newly created data set (most values will be unprintable, so you should use a $HEX2. format for the FROM and TO variables ).

Creating and Using Key Maps and Device Maps

To create and use a key map or device map, follow these steps:

  1. Submit a LIBNAME statement that associates the libref GFONT0 with the location where your map is to be stored.

  2. Create a data set that contains the mapping information you need. You can use a DATA step to create all of the mapping information for the key map or device map, or you can create a data set from an existing key map or device map, then update that data set with the mappings that you need. This process is illustrated in Example 1 on page 990.

  3. Use the GKEYMAP procedure to create the key map or device map, using as input the data set that contains the mapping information. The GKEYMAP procedure stores the map in the catalog GFONT0.FONTS.

  4. Use the KEYMAP= or DEVMAP= option in a GOPTIONS statement to assign the key map or device map in your SAS session. The specified map is used automatically in your SAS/GRAPH programs. (The device map is used only when you use a hardware character set.)




SAS.GRAPH 9.1 Reference, Volumes I and II
SAS.GRAPH 9.1 Reference, Volumes I and II
ISBN: N/A
EAN: N/A
Year: 2004
Pages: 342

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net