How to obtain the correct CA 1 Audit File % of used space to ensure that it will be sufficient to log all tape activity.
Article ID: 10122
Updated On:
Products
Issue/Introduction
By default CA 1 provides a list of health checks to alert of conditions that could prevent it from running properly, if left uncorrected. They are activated automatically at product start.
One of the is CA1_AUDIT_VRFY_WITHIN_LOW_THRSH , which will monitor the CA 1 Audit file percentage of used space to ensure that it is sufficient to log all tape activity.
In general Health Checks alert you of conditions that could prevent CA 1® Tape Management System from running properly if left uncorrected, and they guide you in addressing the problem. These health checks provide best practices for running CA 1® Tape Management System.
The following Health Checks are provided for CA1 Audit File monitoring:
CA1_AUDIT_VRFY_WITHIN_LOW_THRSH
Monitors space in the CA 1® Tape Management System Audit file to help ensure that sufficient
space is available to log all tape activity.
CA1_AUDIT_VRFY_WITHIN_MED_THRSH
Monitors space in the CA 1® Tape Management System Audit file that is triggered after no steps were taken to address the problem that the low threshold check identified.
Anyway these checks provide the AUDIT % of used space only in Console and when they are automatically issued.
There is another procedure in order to get this same percentage running a batch job whenever it is necessary to maintain this value under control and/or take actions on the basis of this value so that no impact could be caused to CA1 functionality at all.
Environment
Resolution
These are the steps to follow in order to obtain in batch the CA1 Audit File percentage of used space:
1) Run TMSBINQ batch utility with HEADERS control statement in the //SYSIN input card.
2) Into the ‘Report 12 Batch Inquiry Headers’ section of the output got , research for the values of the following fields:
AUDIT ALLOCATED
1ST AUDIT REC
NEXT AVAIL
(These values can also be found using CA1 TSO/ISPF Interface)
There are 2 different situations:
1st CASE : NEXT AVAIL > 1ST AUDIT REC
---------------------------------------------------------------------
3) Do the following calculation:
% AUDIT USED SPACE = ((NEXT AVAIL - 1ST AUDIT REC) * 100) / AUDIT ALLOCATED
Here is an example:
AUDIT ALLOCATED=00180000 1ST AUDIT REC=00066997 NEXT AVAIL=00083786
% AUDIT USED SPACE = ((83786 - 66997) * 100) / 180000 = 9.3%
4) Compare this value with the threshold parameter THAUDT value set in hlq.CTAPOPTN(TMOOPTxx) member in order to decide possible actions.
2nd CASE : NEXT AVAIL < 1ST AUDIT REC (this means the Audit wrapped)
-----------------------------------------------------------------------------------------------------------------------------
- Do the following calculation:
AUDIT ALLOCATED - 1ST AUDIT REC = Y
Y + NEXT AVAIL = USED
USED / ALLOCATED = X
- Compare this value with the threshold parameter THAUDT value set in hlq.CTAPOPTN(TMOOPTxx) member in order to decide possible actions.
Feedback
