Displays information about the contents of a map entry. Also, creates a new map entry, replaces an existing entry, modifies the characteristics of an entry, or deletes an entry.
specifies one or more action definitions for the map.
controls how polygonal areas with identical ID values are treated.
copies, deletes, or updates data links between the chains data set and attribute data sets.
specifies the coordinate system used for the displayed spatial data.
specifies the background color of the map.
specifies the coverage entry to which the map refers.
specifies the coordinate units for the displayed spatial data when the coordinate system is geographic.
specifies a description for the map.
specifies whether detail coordinates are read for the entire map.
specifies that existing actions or attribute links might be overwritten during copy operations.
provides details for building an HTML version of a GIS map through ODS.
assigns or removes the specified label data set reference to the map.
specifies a list of layer (GISLAYER) entry names that are added to the map's current layer list.
specifies a list of layer (GISLAYER) entry names that define layers in the map entry
specifies a list of layer (GISLAYER) entry names that are removed from the map's current layer list.
adds the specified layer(s) to the LAYERSOFF list and deactivate any on-scale/off-scale settings for the specified layer(s).
removes the specified layer(s) from the LAYERSOFF list and deactivates any on-scale/off-scale settings for the specified layer(s).
specifies a layer (or list of layers) to be turned off for this map.
adds the specified layer(s) to the LAYERSON list and deactivates any on-scale/off-scale settings for the specified layer(s).
removes the specified layer(s) from the LAYERSON list and deactivates any on-scale/off-scale settings for the specified layer(s).
specifies a list of layer (GISLAYER) catalog entries that will be turned on for this map.
hides, displays, or removes map legends.
specifies a constant integer value by which spatial data coordinates are multiplied when the data are displayed.
specifies that messages are not to be issued about actions or attribute links that are not found during deletion.
changes the name of an existing layer in the map that is being updated.
adds layers to the current list of selectable layers.
lists the layers to be selectable when the map opens.
removes layers from the current list of selectable layers.
adds layers to the current list of unselectable layers.
lists the layers to be unselectable when the map opens. All other layers will be selectable.
removes layers from the current list of unselectable layers.
specifies the map entry that you want to create, delete, replace, or update. The map-name value must conform to the following rules for SAS names:
If you specify a one-level name, the map entry is assumed to be in one of two catalogs. It will be the catalog that is specified either in the CATALOG= argument with the PROC GIS statement or in the most recently issued CATALOG statement. An error occurs if no catalog has previously been specified.
An error occurs if a map entry with the specified name already exists. The MAP CREATE statement does not overwrite existing map entries. Use MAP REPLACE to overwrite an existing entry.
For a MAP CREATE statement, you must also specify the COVERAGE= and LAYERS= arguments.
removes the specified map entry. No additional arguments (other than the map entry name) are used with this operation. An error occurs if the specified map entry does not exist.
For the DELETE operation,
you can also specify the special value _ALL_
for
the map entry name argument to delete all map entries in the current
catalog.
CAUTION: |
For a REPLACE operation, you must also specify the COVERAGE= and LAYERS= options.
modifies the specified map entry by applying new values for specified arguments. An error occurs if there is no existing map entry with the specified name.
When you specify CREATE, REPLACE, or UPDATE for the MAP operation, you can specify one or more of the following options following the map-entry name. Separate the list of options from the map entry name argument with a slash (/).
specifies the commands to be run when either a COMMAND or a SYSTEMCOMMAND action is executed in the map. Valid values are:
To specify commands explicitly, enclose them in quotation marks. Separate multiple commands with semicolons.
specifies the variable containing the commands in the linked data set.
copies existing actions from one map entry to another. Specify the map entry that contains the actions to be copied with the FROM=map-entry argument. The actions are copied to the map that is specified in the MAP statement.
add a new action to the map.
removes an existing action from the map entry. Specify the action to be deleted with the NAME=action-name argument. You can specify NAME=_ALL_ to delete all actions. Use the NOWARN argument in the MAP statement to suppress messages when an action is not found.
CAUTION: |
specifies a formula catalog entry to be used by an FSVIEW action. A FORMULA entry must be a fully qualified three- or four-level name. If the name is three levels, it is assumed to be in the WORK library. FORMULA is used only by the VIEW type action, and it is an optional argument.
used with the ACTION argument COPY operation, FROM= specifies the source map entry that contains actions to be copied. Specify the actions to be copied from the map with the NAME=action-name argument.
specifies the name of the variable in the LINK= data set which contains the image to display for the current selected feature. IMAGEVAR is used only by an IMAGE type action, and it is a required argument.
specifies an attribute data set link. If the link does not exist, you can create it in the same MAP statement with the ATTRIBUTE= option. A LINK is required for all action types except a SPATIALINFO action.
specifies the name of the variable in the LINK= data set containing the three-level name of the map to be opened when a particular feature is selected. MAPVAR is used only by the TYPE=DRILLDOWN type action and is a required argument.
specifies the action to be copied, deleted, or updated. Action-name identifies a single action. Specify _ALL_ to indicate all actions.
Restriction | You cannot specify NAME=_ALL_ if you are using ACTION UPDATE with the RENAME argument. |
specifies an output data set. OUT= is required for DATA and PROGRAM actions. It is optional for COMMAND and SYSTEMCOMMAND type actions.
specifies how to the action writes to the OUTPUT data set.
overwrites the existing data set.
writes the observations to the end of the existing data set.
creates a new data set the first time the action is executed, and appends to this data set each additional time the action is executed.
Default | REPLACE |
opens the Redistricting window to adjust totals in adjoining areas.
specifies the name of the polygonal layer to be themed by the redistricting action. REDISTRICTLAYER= is used only by the REDISTRICT type action and is a required argument.
specifies the name of the variable in the LINK data set upon which the redistricting will be based. REDISTRICTVAR= is used only by the REDISTRICT type action and is a required argument.
renames the action that is specified in the NAME=action-name for UPDATE.
Restriction | You cannot specify RENAME if you have also specified NAME=_ALL_. |
replaces the named action, or, if it does not exist, creates a new action with that name.
specifies a screen catalog entry to be used by an FSBROWSE action. A SCREEN entry must be a fully qualified three- or four-level name. If the name is three levels, it is assumed to be in the WORK library. SCREEN is used only by the BROWSE type action, and it is an optional argument.
specifies the location of the source code for a PROGRAM type action. The following are valid locations:
an external file containing SAS code. The host-path filename must be enclosed in quotation marks.
the three- or four-level name of a catalog entry containing the SAS code. A three-level name is assumed to be in the WORK library. Valid values for type are SOURCE and SCL.
a one-level name is assumed to be a SAS fileref. If the fileref does not exist, the action is created, and a warning is printed to the log.
specifies a list of NUMERIC variables to display in the Redistricting window when a REDISTRICT type action is executed. Only NUMERIC variables are valid because redistricting sums the values for each new district. Specifying SUMMARYVAR=(_ALL_) displays sums for every numeric variable.
Default | _ALL_ |
Restriction | SUMMARYVAR= is used only by the REDISTRICT action. |
used with CREATE to select an action type. The following are valid arguments:
opens an FSBROWSE window on a data set.
runs a SAS command.
subsets the current selections and write attribute data into a data set.
opens another map associated with the current feature.
displays an image associated with the selected map feature.
creates a data set and run a SAS program against its observations.
opens the Redistricting window to adjust totals in adjoining areas.
displays the current feature in the Spatial Information window.
runs a command from the host operating system.
opens an FSVIEW window on a data set.
modifies existing actions in the map that is being updated. Specify the action to be updated with the NAME=action-name argument. You specify NAME=_ALL_ to update all actions. NAME= is required for UPDATE.
used with UPDATE to change the execution setting of the specified action.
The action is not executed when a layer feature is selected.
The action is executed as soon as a layer feature is selected.
The action's execution must be performed explicitly after a layer feature has been selected.
sets a flag so that polygonal areas with identical ID values are considered as one. For example, if you are selecting from the STATE layer and click North Carolina, all the Outer Banks islands are also selected.
sets a flag so that polygonal areas with identical ID values are treated independently. For example, if you are selecting from the STATE layer of the North Carolina map and click Emerald Isle, only that one island is selected.
Default | DISAGGREGATE |
lists spatial composite names when you create a new key link. These composites are paired with the attribute data set variables that are named in the DATAVAR= option. The composite names and the data set variable names can be the same. In this case, you can just specify them once with either the COMPOSITE= or DATAVAR= lists, and those names will be used for both.
copies existing attribute data links from one map entry to another. Specify the map entry that contains the links to be copied by using the FROM=map-entry argument. The links are copied to the map that is specified in the MAP statement.
adds a new attribute data link to the map.
specifies the attribute data set when you create a new key link.
lists attribute data set variables when you create a new key link. These variables are paired with the spatial composites that are named in the COMPOSITE= option. The data set variable names and the composite names can be the same. In this case, you can just specify them once with either the COMPOSITE= or DATAVAR= lists, and those names will be used for both.
removes an existing attribute data link from the map entry. Specify the link to be deleted with the NAME=link-name argument. If you specify NAME=_ALL_, you delete all data links. Use the NOWARN option in the MAP statement to suppress messages when a link is not found. This does not delete the attribute data set, only the link.
CAUTION: |
used with the ATTRIBUTE COPY operation, specifies the map entry that contains data links to be copied. Specify the links to be copied from the map with the NAME=link-name argument.
specifies the attribute data link to be copied, deleted, or updated. Link-name identifies a single data link. Specify _ALL_ to identify all data links.
Restriction | You cannot specify NAME=_ALL_ if you are using UPDATE with the RENAME argument. |
renames the link that is specified in NAME=link-name for the UPDATE operation.
Restriction | You cannot use the RENAME option if you have also specified NAME=_ALL_. |
modifies existing data links in the map that is being updated. Specify the link to be updated with the NAME=link-name argument. Specify NAME=_ALL_ to update all data links. NAME= is required for the UPDATE operation.
data is in an arbitrary rectangular (plane) coordinate system
data is in a geographic (spherical) coordinate system.
Default | LATLON |
Restriction | The map entry must use the same coordinate system as the spatial entry from which the map is derived. If the spatial entry specifies the CARTESIAN coordinate system, then you must also specify the CARTESIAN argument for the MAP statement. If the spatial entry specifies the LATLON coordinate system, then you must also specify the LATLON argument for the MAP statement. |
specifies the background color of the map. The color value must be one of the following:
Default | WHITE |
See | For more information about color naming schemes, see “Specifying Colors in SAS/GRAPH Programs” in SAS/GRAPH: Reference. |
specifies the coverage entry to which the map refers. The coverage determines the geographic extent of the map.
Note | The COVERAGE= argument is required when you use the CREATE or REPLACE operation. |
The unit system that you select defines the allowable range for coordinate values. For example, you can specify DEGREES. In this case, all X coordinate values must be in the range of -180 to 180 degrees. All Y coordinate values must be in the range of -90 to 90 degrees.
units for LATLON data are measured in decimal degrees.
units for LATLON data are measured in radians.
units for LATLON data are measured in seconds.
Default | RADIANS |
Default | Blank |
Default | NODETAILS |
Interaction | You can use the LAYER statement's DETAILS and DETAILON= options to control the display of detail coordinates for a particular layer. The MAP statement's DETAILS option overrides the LAYER statement's DETAILS option. |
specifies that existing actions or attribute links might be overwritten during copy operations. Use this argument with the COPY argument in the ACTION or ATTRIBUTE argument.
The following options are used to specify the linked data set and the URL-related variables for specific map layers:
declares that all of the selectable map layers use the URLs stored in the specified data set variable.
associates different URL-related variables with specific layers.
specifies the link name for the attribute data set that contains the URL-related variables.
Restriction | The IMAGEMAP= argument is valid only with the PRESENT operation in the MAP statement. |
assigns the specified data set reference to the map entry. An error occurs if the specified data set does not exist. If the libref is not specified, the default WORK library is used.
unassigns the current label data set from the map entry, but the data set is not deleted.
unassigns the current label data set from the map entry, and deletes the data set.
hides all of the labels in the target map. HIDEALL does not remove the label data set reference from the map entry.
displays all of the labels in the target map. UNHIDEALL does not display labels attached to layers that are not displayed, nor does it display labels that would not be displayed at the current scale of the map.
specifies a list of layer (GISLAYER) entry names that define layers in the map entry If the map entry already contains a list of layers, they are replaced by the specified layers.
Requirement | The LAYERS= argument is required when you use the CREATE or REPLACE operation. |
specifies a list of layer (GISLAYER) entry names that are removed from the map's current layer list. The layer entries are not deleted. They remain in their respective catalogs.
specifies a list of layer (GISLAYER) catalog entries that will be turned on for this map. All other layers will be turned off. Any on-scale/off-scale settings are deactivated. Specifying LAYERSON=(_ALL_) turns all layers on.
adds the specified layer(s) to the LAYERSON list and deactivates any on-scale/off-scale settings for the specified layer(s). See the LAYERSON= option for more information about restrictions and interactions.
removes the specified layer(s) from the LAYERSON list and deactivates any on-scale/off-scale settings for the specified layer(s). See the LAYERSON= option for more information about restrictions and interactions.
specifies a layer (or list of layers) to be turned off for this map. All other layers are turned on. Any on-scale/off-scale settings are deactivated. Specifying LAYERSOFF=(_ALL_) turns all layers off.
See the LAYERSON= option for more information about restrictions and interactions.
adds the specified layer(s) to the LAYERSOFF list and deactivate any on-scale/off-scale settings for the specified layer(s). See the LAYERSON= option for more information about restrictions and interactions.
removes the specified layer(s) from the LAYERSOFF list and deactivates any on-scale/off-scale settings for the specified layer(s). See the LAYERSON= option for more information about restrictions and interactions.
causes all existing legends to be hidden (not displayed) when the map is opened.
causes all existing legends to be displayed when the map is opened.
Restrictions | The LEGEND= option is valid only in with the UPDATE operation in the MAP statement. |
Only one of the LEGEND= options can be specified at a time. |
specifies a constant integer value by which spatial data coordinates are multiplied when the data are displayed. If the unit multiplier is too large, it is recomputed when the map is opened, and a note is printed to the SAS log showing the new value. If your map opens and appears to be empty, your MULT value might be too small.
Default | 1E7 |
specifies that messages are not to be issued about actions or attribute links that are not found during deletion. Use this argument when you specify the DELETE operation in the ACTION or ATTRIBUTE argument.
lists the layers to be selectable when the map opens. All other layers will be unselectable.
map create stores / coverage=mall layers=(store, fire, info, phone, restroom); run;