Finding the percent full value for Datacom log file (LXX)

Products

• Datacom
• Datacom/AD
• Datacom/DB

Issue/Introduction

Is there an easy way to see the current utilization and usage of the Datacom log file, or how full the (LXX) is?

Environment

z/OS

Datacom 15.1

Resolution

With Datacom/DB 15.1 PTF RO93585, the Datacom Multi-User (MUF) console command STATUS_LOG displays message DB00322I with the %FULL column, indicating how full the log file is.

For example:
/Fmufjobnm,STATUS_LOG (mufjobnm is the jobname of the MUF region) returns:

DB01311I - STATUS_LOG
DB00322I - LOG LXX LRSN-10,304 LBSN-1,771 WRAP-0 SGMNT-0 RSTRB-N SPILLING-N %FULL-26

This shows that the LXX is currently 26% full. Note that this value is dynamic, and will be constantly changing.

STATUS_LOG is a console-only command, and the result is only available on the MUF JESMSGLG.

If the check must be executed in batch, run an SQL query on the MUF_LOGGING dynamic system table (DST). Here is a sample query:

SELECT IN_USE_BLOCKS, TOTAL_BLOCKS,
(IN_USE_BLOCKS*100/TOTAL_BLOCKS) AS PERCENT_FULL
FROM SYSADM.MUF_LOGGING;

This will return a single-line report that will look similar to this:

IN_USE_BLOCKS  TOTAL_BLOCKS PERCENT_FULL 
_____________ _____________ ____________ 
         1513          2397           63 
___ 1 row returned ___                   

This query can be run in batch via DBSQLPR and it can also be executed online using DQRY, DDOL, or other SQL processes.

Additional Information

For more information about the STATUS_LOG command, please see the documentation section Modify MUF Startup Options and Console Commands.

For more details about the MUF_LOGGING Datacom Dynamic System Table, please see the System Tables documentation section for this table.

To use a TSO command with the SYSVIEW Rexx API, please review Knowledge Base article 36991, titled "Using the SYSVIEW API to monitor Datacom LXX usage".