Creating A Maplog To Log Subvolume Name Mapping - HP NonStop RDF J-series RVUs Management Manual

MAP NAMES TEST1.* TO TEST2.*
Assume that the file $DATA01.TEST1.FILE on the primary system is modified. RDF applies the
mapping rule on this file and replicates its changes to the file $DATA01.TEST2.FILE on the
backup system.
Next, the file $DATA01.TEST2.FILE on the primary system is modified. RDF determines that
the mapping rule does not apply. If RDF had to replicate the changes, they would be replicated
to the file $DATA01.TEST2.FILE on the backup system. If this situation occurred, changes to the
files $DATA01.TEST1.FILE and $DATA01.TEST2.FILE on the primary system would be replicated
to the same file, $DATA01.TEST2.FILE, on the backup system. Instead, RDF detects the filename
collision, logs error 927, and abends.
The updater might not be able to prevent filename collisions when it:
• Closes files on the backup system because their corresponding source files on the primary
system have not been modified for at least ten minutes
• Encounters a restart condition (for example, file system error 122)
• Undergoes a process takeover
• Is stopped with a user-supplied STOP RDF/UPDATE command
• Is stopped for other reasons
If the updater is restarted under any of these circumstances, it cannot detect a filename collision
until and unless the files from both subvolumes on the primary system that are mapped to the
same subvolume on the backup system have both been modified within ten minutes.

Creating a Maplog to Log Subvolume Name Mapping

Maplog is an optional EDIT file into which the updater logs source filenames from the primary
system and their mapped destination filenames on the backup system. The updater logs the
entry of the data file only once until the time that the data file is open on the backup system.
However, if the data file is closed and reopened on the backup system, the updater logs multiple
entries for the same data file.
If the maplog file already exists at the cold start, it will be emptied with a Purgedata operation.
If the maplog does not exist, the ADD VOLUME and ALTER VOLUME MAPLOG commands
will create an empty maplog file on the backup system.
Use the RDFCOM SET command to specify the maplog filename and path in the updater's
configuration record, as described in
Record". You can turn off logging to the maplog by altering the maplog to none.
NOTE: The updater closes files on the backup system when their corresponding source files
on the primary system have not been modified for at least ten minutes. When this occurs, the
updater will also forget the filename collision information described in
Filename Collisions".
Use RDFCOM ALTER to turn off maplog logging. For example:
ALTER VOLUME $DATA01 MAPLOG
In this example, $DATA01 is the name of the volume on the primary system, and MAPLOG is
the keyword. Because MAPLOG is followed by end of line, it indicates that the maplog file on
the backup system be turned off.
You can also alter the maplog file to a different path. For example:
ALTER VOLUME $DATA01 MAPLOG $DATA05.NAPCONFG.MAPLOG2
If a maplog is not properly constructed or formatted, the updater generates errors. For information
about maplog-related RDF event messages and RDFCOM error messages, see
(page 365) and
"Adding a Mapfile and Maplog to an Updater's Configuration
"RDFCOM Messages" (page 413).
Creating a Maplog to Log Subvolume Name Mapping
"How an Updater Manages
"RDF Messages"
287