RDF System Management Manual for H-Series RVUs (RDF 1.8)

• Volume names are not allowed in mapping strings. If the updater detects a $ character, it
logs an error.
• Reserved names are not allowed in mapping strings. See the examples of invalid mapping
strings listed below.
• When two or more mapping rules are present in a mapfile, the rule listed first always takes
precedence if it fits. For example, assume these two mapping strings are present:
MAP NAMES SUBVOL1.* TO SUBVOL2.*
MAP NAMES SUBVOL*.* TO SUBVOL3.*
The incoming source file is from subvolume SUBVOL1 on the primary system, its changes
are replicated to the destination subvolume SUBVOL2 on the backup system instead of
SUBVOL3. If the first mapping rule cannot be applied, a subsequent mapping rule that fits
will be applied, as when changes to the incoming source file from the subvolume SUBVOL4
on the primary system are replicated to SUBVOL3 on the backup system.
• If the destination subvolume set for one mapping string matches the source subvolume set
for another mapping string, the updater might abend. In other words, a mapped filename
on the backup system for a mapping string turns out to be the same as that of unmapped
filename on the primary system for another mapping string. For example, for these two
mapping strings in the mapfile for an updater, replication for the files $DATA01.TEST1.FILE
and $DATA01.TEST2.FILE on the primary system will fail:
MAP NAMES TEST1.* TO TEST2.*
MAP NAMES TEST2.* TO TEST3.*
An updater logs errors whenever it detects invalid mapping string content or format. For
information about mapfile-related RDF events and RDFCOM error messages, see “RDF Messages”
(page 342) and “RDFCOM Messages” (page 389).
Examples of valid mapping strings include:
MAP NAMES TEST1.* TO TEST2.*
MAP NAMES TEST*.* TO TEST1.*
MAP NAMES TEST*.* TO TEST2.*
MAP NAMES TES?*.* TO TEST2.*
Examples of invalid mapping strings, including disallowed reserved words, are:
MAP NAMES TEST*.* TO TEST*.*
MAP NAMES TEST1.* TO TEST*.*
MAP NAMES TEST1 TO TEST2
MAP NAMES $DATA01.TEST.* TO $DATA02.TEST1.*
MAP NAMES TEST1.* TO TEST2
MAP NAMES TEST1 TO TEST2.*
MAP NAMES TEST1.FILE1 TO TEST2.FILE1
MAP NAMES ZTMFAT.* TO TEST.*
MAP NAMES TEST.* TO ZTMFAT.*
MAP NAMES ZYS01.* TO TEST.*
MAP NAMES TEST.* TO ZYS01.*
MAP NAMES X01.* TO TEST.*
MAP NAMES Y01.* TO TEST.*
MAP NAMES Z01.* TO TEST.*
Once a mapfile has been created, these rules govern its use:
• You cannot modify the mapfile's path while RDF is running.
• Changes made to an existing mapfile do not take effect until the updater is stopped and
restarted.
• You cannot alter the mapfile path from the backup system through RDFCOM when the
primary system is accessible.
266 Subvolume Name Mapping