How to obtain the correct CA 1 Audit File % of used space to ensure that it will be sufficient to log all tape activity.

Document ID : KB000010122
Last Modified Date : 03/07/2018
Show Technical Document Details
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. 

Background:

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:
Z/OS - CA 1 
Instructions:

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) 
-----------------------------------------------------------------------------------------------------------------------------

  1. Do the following calculation: 
    AUDIT ALLOCATED - 1ST AUDIT REC = Y                                       
         Y + NEXT AVAIL = USED                                               
         USED / ALLOCATED = X                
      % AUDIT USED SPACE = X * 100
 
  1. Compare this value with the threshold parameter THAUDT value set in hlq.CTAPOPTN(TMOOPTxx) member in order to decide possible actions.