Step 4: Rename the SAS ITRM 3.1.1, 3.2, 3.21, or 3.3 IT Data Mart Metadata Pathnames and Data Sets for Migration

When Should Metadata Pathnames and Data Sets be Renamed?

If the file systems that are used by SAS IT Resource Management 3.1.1, 3.2, 3.21, or 3.3 and SAS IT Resource Management 3.3 target system are not shared, then use the %RMDMPATH macro to rename the pathnames and data sets in the metadata for the new SAS IT Resource Management 3.3 IT data marts.
If the file systems of the source and target systems are shared, then this renaming is done so that existing SAS IT Resource Management 3.1.1, 3.2, 3.21, or 3.3 physical data libraries are not overwritten when the physical data is unpackaged in step 5.
For more information, see Migration Macros.

Examples

Example for Windows Environments; Renaming Pathnames Is Not Required

In this example, the pathname for one of the aggregation libraries in the SAS IT Resource Management IT data mart is c:\MyDatamart\summary\sum2278. It resides on a PC named WIN1. The server tier for SAS IT Resource Management 3.3 resides on a PC named WIN2. Unpackaging the package directory on this separate machine means that a new, identically named directory named c:\MyDatamart\summary\sum2278 will be created and populated with physical libraries. Since WIN1 and WIN2 do not share the same file systems, there is no conflict. Thus, there is no need to rename the pathnames.

Example for z/OS Environments; Renaming Pathnames Is Required

In this example, the data set name for one of the aggregation libraries in the SAS IT Resource Management IT data mart is ITRM.SUMMARY.SUM3445. It resides on a mainframe named ZOS1. The server tier for the new SAS IT Resource Management 3.3 resides on the same mainframe. Unpackaging the package directory on this same machine means that an attempt will be made to create a directory using the same name, ITRM.SUMMARY.SUM3445. This situation results in an error causing the unpackaging job to fail, because a data set by that name already exists. Because SAS IT Resource Management 3.1.1 and SAS IT Resource Management 3.3 are on the same machine, thus sharing the same file systems, renaming the data set names is required.
If you need to rename pathnames or data set names, use the %RMDMPATH macro. This macro scans the SAS IT Resource Management 3.3 metadata and renames a portion of pathname. The renaming is accomplished by using a simple string substitution algorithm.
Note: The pathnames that are being renamed are references in the SAS IT Resource Management 3.3 metadata. No physical data is actually renamed.
Typically, only the starting portion of the pathname is renamed, known as the root path. For example:
%RMDMPATH(
    DATAMART=NTSMFdatamart,
    METAPASS=mypassword,
    METAPORT=8561,
    METASERVER=my.metadata.server,
    METAUSER=admin,
    NEW_ROOTPATH =SYS2.MY.DATAMART,
    OLD_ROOTPATH=SYS1.MY.DATAMART,
    DORENAMES=YES,
    REPOS=Foundation
    );
This specifies that all SAS libraries that start with MY.OLDDM are renamed to start with MY.NEWDM. For example, a SAS library with a pathname of SYS1.MY.DATAMART.SUMMARY.SUM2557 would be renamed to SYS2.MY.DATAMART.SUMMARY.SUM2557. The matching of the value of the OLD_ROOTPATH parameter to the pathnames in the SAS IT Resource Management 3.3 metadata begins in column 1. If there is a match, the old value is replaced with the value specified by the NEW_ROOTPATH parameter.
Make sure that you specify the path parameters correctly. Both the OLD_ROOTPATH and NEW_ROOTPATH parameters are case sensitive, and no validity checking is performed to ensure that the pathname is technically correct. Run the %RMDMPATH macro in report-only mode initially so that only a report of what would be done is produced. This setting is the default value for the macro. To actually perform the renaming of the pathnames, specify YES for the DORENAMES parameter.
The following pathnames are renamed:
  • pathnames for SAS libraries
  • default root path for the IT data mart itself
Other pathnames, such as pathnames for external files, are not renamed.
You can turn off the renaming of the default root path by specifying NO for the DEFAULT_ROOTPATH parameter. However, this setting is usually not recommended because any new libraries that are created in the IT data mart by the Adapter Setup wizard will have the value of the old default root path. For more information about the default root path in the IT data mart, see Chapter 4, “IT Data Mart” in the SAS IT Resource Management: Administrator's Guide.