Important: If misused,
the change log inventory utility can compromise the viability and
integrity of the Db2 subsystem.
Only highly skilled people, such as the Db2 system
administrator, should use this utility, and then only after careful
consideration.
The DELETE statement removes information about
the bad data set from the BSDS. The NEWLOG statement identifies the
new data set as the new active log. The DELETE and NEWLOG operations
can be performed by the same job step. The DELETE statement precedes
the NEWLOG statement in the SYSIN input data set.
To ensure
consistent results, run the change log inventory utility on the same z/OS® system on which the Db2 online
subsystem runs.
Use the print log map utility before and after
you run the change log inventory utility to ensure correct execution
and to document changes.
When you use dual active logs, choose
a naming convention that distinguishes primary and secondary active
log data set. The naming convention should also identify the log data
sets within the series of primary or secondary active log data sets.
For example, the default naming convention that is established at Db2 installation time is as follows:
prefix.LOGCOPYn.DSmm
In
this convention, n=1 for all primary log data
sets, n=2 for all secondary log data sets, and mm is
the data set number within each series.
If a naming convention such as the default convention is used, pairs of data sets with equal
mm values are usually used together. For example,
prefix.LOGCOPY1.DS02 and prefix.LOGCOPY2.DS02 are used
together.
However, after you
run the change log inventory utility with the DELETE and NEWLOG statements,
the primary and secondary series can become unsynchronized. This situation
can occur even if the NEWLOG data set name that you specify is the
same as the old data set name. To avoid this situation, always do
maintenance on both data sets of a pair in the same change log inventory
execution:
- Delete both data sets together.
- Define both data sets together with NEWLOG statements.
The data sets themselves do not require deletion and redefinition.