INFOMAPS Procedure
SAVE Statement
Saves the current information map.
Note: |
The Save operation fails if the information map has no
valid data source.
|
Syntax
Summary of Optional Arguments
specifies whether the Save operation can overwrite
an existing information map that has a lower major version number.
specifies whether the Save operation can overwrite
an existing information map that has a lower minor version number.
specifies the name to use for saving the current
information map.
specifies the location within the SAS folders tree
where the information map is to be saved.
Optional Arguments
- ALLOW_MAJOR_VERSION_UPGRADE=YES | NO
- specifies whether the Save operation can overwrite
an existing information map that has a lower major version number. Information maps store
major and minor version numbers that indicate the release of SAS software
with which they were created. This enables applications to determine
whether the information maps might include features that they do not
support. By default, an error occurs when you attempt to replace an
existing information map that has a lower major version number. Specify
ALLOW_MAJOR_VERSION_UPGRADE=YES to enable the SAVE statement to replace
an existing map that has a lower major version number. After a major
version upgrade, an application that does not support information
maps with the new major version number will no long be able to access
the information map.
- ALLOW_MINOR_VERSION_UPGRADE=YES | NO
- specifies whether the Save operation can overwrite
an existing information map that has a lower minor version number. Information maps store
major and minor version numbers that indicate the release of SAS software
with which they were created. This enables applications to determine
whether the information maps might include features that they do not
support. By default, an error occurs when you attempt to replace an
existing information map that has a lower minor version number. Specify
ALLOW_MINOR_VERSION_UPGRADE=YES to enable the SAVE statement to replace
an existing map that has a lower minor version number. After a minor
version upgrade, an application that supports information maps with
a lower minor version number but the same major version number is
allowed to read in the information map. However, the application might
ignore or incorrectly handle features of the newer version. It is
up to the application to check the version number and decide whether
to read the information map.
- INFOMAP "information-map-name"
- specifies the name
to use for saving the current information map.
Default:If you do not specify a name in the SAVE statement,
the default is the name of the current information map.
Note:If you specified the AUTO_REPLACE=YES option when you
created the information map, then the SAVE command will overwrite
the existing information map without warning.
- MAPPATH="location" </CREATE>
- specifies the location within the SAS folders tree
where the information map is to be saved.
- /CREATE
-
specifies that the
location is created automatically, if it does not already exist.
Alias:LOCATION=
Default:If you do not specify a location, the default is determined
according to the following order of precedence:
-
1.The MAPPATH specified in the NEW INFOMAP or UPDATE
INFOMAP statement
-
2.The MAPPATH specified in the PROC INFOMAPS statement
Examples
Example 1
/* Save the current information map in the location specified */
/* when it was opened (or in the PROC INFOMAPS statement) */
/* using the name 'myMap' */
save infomap "myMap";
Example 2
/* Save the current information map in the specified location using */
/* its current name */
save mappath="/Users/myUserID/My Folder";
Example 3
/* Save the current information map in the specified location using */
/* the name 'myMap' */
save infomap "myMap" mappath="/Users/myUserID/My Folder";
Copyright © SAS Institute Inc. All rights reserved.