INFOMAPS Procedure

SAVE Statement

Saves the current information map.
Note: The Save operation fails if the information map has no valid data source.

Syntax

SAVE <options>;

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.
Default:NO
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.
Default:NO
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. 1.The MAPPATH specified in the NEW INFOMAP or UPDATE INFOMAP statement
  2. 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";