How to change the percentage for "TRACWARN FULL IN EXTENTS" messages when the database files are getting full

Products

• Datacom
• DATACOM - AD
• Jobtrac

Issue/Introduction

When using Jobtrac with Datacom/AD, the Jobtrac task will issue messages - "TRACWARN - Database Area AT xx%  FULL IN ## EXTENTS " - regarding the Datacom/AD databases being used.

The default value of the percentage when the Jobtrac product starts is 80 percent. Can this value be changed?

Environment

Jobtrac with Datacom/AD

Resolution

Clients using Datacom/AD are often interested in monitoring the space used by their products. While the DBUTLTY CXX report is available to all Datacom/AD users (and to Datacom/DB users), this report must be run on a periodic basis, and provides only a snapshot at that particular moment. Certain Broadcom products have incorporated functionality into their product to automatically interrogate the Datacom System Tables about the product databases.

Jobtrac will periodically check these tables for the current usage of their databases, and if that usage exceeds a predefined percentage full, Jobtrac issues messages similar to this:

TRACWARN - database area file name AT ##% FULL IN ## EXTENTS ON VOL xxxxxx WITH #####
      FREE CYLS  
TRACWARN - DB Area Near Full: database area file name  

 

Messages like the above will be displayed for the IXX (Index) area and any of the data areas, once the area reaches 80% full, or the value of the WARNPCT setting. The percentage at which the displays begin can be changed by issuing the console command:

 	F taskname,WARNPCT=## 

 

In this command, ## must be numeric, greater than 0, and less than 100. Once the command has been processed, a message will be issued like this:

 	TRACINFO - taskname WILL NOW WARN ABOVE ##%.  

 	TRAC1068I WARNPCT=## command processing complete 

Note that the percentage can only be changed from the 80% default value via this command; there is no configuration setting to allow a permanent change. Further information about this command and messages can be found in the following:

It is also possible to run Datacom DBUTLTY to produce a CXX report to see if any areas are becoming full:

//REPORT   EXEC PGM=DBUTLTY,REGION=0M
//STEPLIB  DD DSN=hlq.CUSLIB,DISP=SHR
//         DD DSN=hlq.CAAXLOAD,DISP=SHR
//CXX      DD DSN=hlq.CXX
//SYSOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSPUNCH DD DUMMY
//SYSUDUMP DD SYSOUT=*
//SYSIN    DD *
COMM OPTION=STATS
REPORT AREA=CXX,DBID=161,TYPE=A 
/*

Additional Information

Jobtrac Job Management Message Guide - in the chapter "TRAC prefixed messages."
Jobtrac Job Management Operator Guide - in the chapter "Using Operator Commands" and section "Use Task Commands."