Step 4: Rename the SAS ITRM 3.1.1 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 and SAS IT Resource Management 3.2 are not shared, then this step is not required. You can use the %RMDMPATH macro to rename the pathnames and data sets in the metadata for the new SAS IT Resource Management 3.2 IT data marts. This renaming is done so that existing SAS IT Resource Management 3.1.1 physical data libraries are not overwritten when the physical data is unpackaged in step 5. This step should be performed only if the file systems used by both SAS IT Resource Management 3.1.1 and SAS IT Resource Management 3.2 are shared. If the file systems are shared, then unpackaging the data that was previously packaged by the %RMDMPKG macro might result in errors.
The SAS IT Resource Management 3.1.1 libraries might also be inadvertently overwritten. This situation could occur because the pathnames (or data set names on z/OS) that were in the SAS IT Resource Management 3.1.1 IT data mart metadata were transferred to the SAS IT Resource Management 3.2 IT data marts without modification by the SAS Deployment Wizard. Thus, the pathnames are identical. Because the %RMDMUPKG macro uses the SAS IT Resource Management 3.2 pathnames to unpackage the data, errors might result since those libraries already exist. For information, see Macros That Are Used for the Migration Process.

Examples

Example for Windows Environments

In this example, the pathname for one of the aggregation libraries in the SAS IT Resource Management 3.1.1 IT data mart is c:\MyDatamart\summary\sum2278. It resides on a PC named WIN1. Also, the server tier for SAS IT Resource Management 3.2 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

In this example, the data set name for one of the aggregation libraries in the SAS IT Resource Management 3.1.1 IT data mart is ITRM.SUMMARY.SUM3445. It resides on a mainframe named ZOS1. The server tier for SAS IT Resource Management 3.2 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.2 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.2 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.2 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 =C:\sas9\my32dm,
    OLD_ROOTPATH=C:\sas9\my311dm,
    DORENAMES=YES
    );
This specifies that all SAS libraries that start with C:\sas9\my311dm are renamed to start with C:\sas9\my32dm. For example, a SAS library with a pathname of C:\sas9\my311dm\summary\sum2557 would be renamed to C:\sas9\my32dm\summary\sum2557. The matching of the value of the OLD_ROOTPATH parameter to the pathnames in the SAS IT Resource Management 3.2 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 3.2: Administrator’s Guide.