TMF Reference Manual (G06.24+)

TMFCOM Commands
HP NonStop TMF Reference Manual—522418-002
3-32
ADD DUMPS
Usage Guidelines
When an audit or online dump occurs, information describing the dump is recorded in
the TMF catalog. Dump entries contain the names of the files dumped, the names of
the tape or disk volumes containing the dumps, dump serial numbers, and other
related information. If a dump entry is damaged, lost, or mistakenly deleted, you can
restore it by issuing the ADD DUMPS command.
The ADD DUMPS command can add to the TMF catalog dump entries for files on
virtual and physical volumes managed by the NonStop Storage Management
Foundation (SMF). Physical volumes within the SMF storage pool must be enabled for
TMF, however, or TMFCOM Error 283 may occur.
Each audit dump to disk is associated with two disk file records: one for the
DISKMEDIA file and the other for the LABELS file. When you enter the ADD DUMPS
command, TMF adds the DISKMEDIA record and also automatically creates the
LABELS file and adds its record.
Always include the TIME option in this command to avoid problems during recovery. If
you do not specify TIME, the time and date that you issue an ADD DUMPS command
are included in the dump entry inserted into the TMF catalog.
You must use separate ADD DUMPS commands to add to the TMF catalog entries for
dumps having different audit trail sequence numbers.
Note. When working with the ADD DUMPS command, you can use output from a previous
INFO DUMPS, OBEYFORM command rather than manually entering the data based on dump
reports. This approach can make your effort much simpler and easier.
At frequent intervals, use the INFO DUMPS, OBEYFORM command provided by TMFCOM to
create a command file for re-adding the dump entries. This command reads the audit or online
dump entries in the TMF catalog and creates a command file containing TMFCOM ADD
DUMPS commands referencing those dump entries. If you save this file, you can use it later to
collectively re-add the entries to the TMF catalog at any time through the TMFCOM OBEY
command.
If you do not use the INFO DUMPS, OBEYFORM command, however, the only alternative way
to create a command file that has information for rebuilding dump entries is to use the
SCANADDDUMPS command provided by the SNOOP utility. This command reads the dumps
on an audit dump tape or online dump tape and creates a command file containing TMFCOM
ADD DUMPS commands referencing those dumps. You can then re-add the dump entries by
using the command file as input to the TMFCOM OBEY command. The SNOOP utility is
provided with the TMF product, and is documented in the file named
$SYSTEM.SYSnn.SNOOPDOC. For more information about the SCANADDDUMPS
command, see the SNOOPDOC file.
Caution. Without the TIME option, even if you add the dump entries in the order in which the
dumps were made (that is, in ascending dump serial-number sequence), you risk destruction
of your database if recovery procedures become necessary; when you issue a RECOVER
FILES command to initiate a file recovery to the timestamp, you will probably not recover all
the data you need.