Automatic cleanup of application traces
If you start many traces that perform logging tasks on a regular basis, you can easily reach the maximum number of trace entries that can be stored in the trace directory.
Reaching the maximum prevents the BBI-SS PAS from starting new traces until you delete the completed entries. Although you can use online history trace administration commands to delete the entries, in high-use environments, this manual process can become tedious.
You can enable the automatic deletion of completed entries by specifying the following parameter in BBPARM member BBIISPxx:
TLDSAGE=(nnn,DELDSN)
nnn represents the number of days between 1 and 999 after which a trace directory entry is automatically deleted from the trace directory. The DELDSN keyword also deletes the trace log data set.
The deletion process occurs during the following events:
- When the BBI-SS PAS initializes
- Daily after midnight
When you specify TLDSAGE, any migrated trace directories are recalled during BBI-SS PAS initialization. For this purpose alone, BMC recommends specifying a value of at least TLDSAGE=999 because traces that perform logging tasks will fail when the trace directory is migrated.
In addition to the new BBIISPxx parameter, this enhancement includes new messages which appear in the BBI-SS PAS journal and job logs to notify you that traces have been deleted:
BBQTDL08I Deleted xxx entries from the trace directory
The following example shows messages that are written to the BBI-SS PAS journal:
TL1031I BOLTSM.BCVTM67C.L1.T1220.V01 PURGED
The following example shows messages that are also written to the BBI-SS PAS journal when you specify the DELDSN keyword:
TL6800I IDC0550I ENTRY (C) BOLTSM.BCVTM67C.L1.T1220.V01 DELETED
Related topic