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.