TMF Reference Manual (G06.24+)

TMFCOM Commands
HP NonStop TMF Reference Manual522418-002
3-22
ADD DATAVOLS
TMF State Requirement
Before you can enter the ADD DATAVOLS command, TMF must be started.
Usage Guidelines
When the ADD DATAVOLS command completes successfully, TMF automatically
recognizes the specified volumes and immediately attempts to start them.
In the ADD DATAVOLS command, you can specify only unconfigured volumes;
furthermore, the audit trail you specify must already exist in the configuration.
Attributes not specified in the ADD DATAVOLS command are given values set by any
SET DATAVOLS commands issued earlier in the same TMFCOM session; otherwise,
the default values, if they exist, are used.
After a data volume is added to the TMF configuration, you cannot change its audit trail
usage until you first delete the volume from the configuration. The ADD DATAVOLS
command associates each data volume with an audit trail. If you have configured
more than one audit trail, and you want to switch the data volume from one audit trail to
another, you must delete the data volume from the configuration, and then add it again.
Adding a data volume potentially increases the number of audit records generated.
So, the audit trail you specify to store records for the new data volume must be large
enough to accommodate those records: you may have to increase the size of the audit
trail.
Setting RECOVERYMODE to ONLINE means that the audit-trail files required to
recover the data volume remain on the active or overflow-audit volumes. This way, the
volume recovery process does not have to restore audit trail files from archive media.
Because ONLINE keeps audit-trail files pinned on the active-audit trail longer, there
must be sufficient space to hold the files until they are no longer needed for volume
recovery. (A pinned file is an audit-trail file that cannot be reused or purged from an
active or overflow-audit volume because it contains or is receiving audit information.)
Setting RECOVERYMODE to ARCHIVE means that the audit-trail files required to
recover this data volume are copied to tape or disk. ARCHIVE is allowed only if the
audit trail for this data volume is configured for audit dumping. ARCHIVE frees audit
trail space sooner, which can prevent overflow or begin-transaction-disable conditions.
If you specify ARCHIVE, be sure that the TMF catalog retains sufficient audit dumps to
recover the data volume. Perform regular online dumps to ensure that the audit dumps
stay current in the catalog. If the catalog does not contain an online dump for any file
on a data volume configured with RECOVERYMODE set to ARCHIVE, TMF may
reuse the media containing the required audit dumps, making volume recovery
impossible.
You should usually configure data volumes with online recovery mode, which is the
default. Archive mode might be used only in exceptional circumstances; it could be
used, for example, when a volume will be down for a long time while other OLTP
operations must not be disrupted, and the volume will later require recovery. In these