Storage Management Services (buffer use) trace

The Storage Management Services trace provides information about the use and availability of VTAM® buffer pools.

The trace entries are written after a specified number of requests for VTAM buffers. The IBM® default causes an entry after every 1000 (x'3E8') buffer requests. This threshold is specified by the halfword at label RACBSNAP in VTAM module ISTRACON. This can be changed by using z/OS's SPZAP (SUPERZAP) facility.

This trace facility is very similar to the display buffer use command in VTAM. It should not be confused with the SMS option in the VTAM internal trace.

GTF should be started with option=USR before you start the SMS trace with the following command:

F VTAMDDF,TRACE,TYPE=SMS,ID=VTAMBUF
(F          is the z/OS modify command
 VTAMDDF    is the name of the VTAM startup procedure
 TRACE      indicates that the trace is being turned on
 TYPE=SMS   indicates the storage management services
             trace
 ID=VTAMBUF required for the SMS trace.)

The formatters can again be used to print the SMS trace. ACFTAP, however, gives only a hex dump of the trace record. IPCS formats the SMS trace records into a more readable form. Figure 1 shows a record that is formatted by using IPCS.

There is an entry for each of the VTAM buffer types:

  • AP APBUF, Application Program Pageable pool
  • CR CRPLBUF, Copied RPL pool
  • IO IOBUF, IO buffer pool
  • LF LFBUF, Large Fixed pool
  • LP LPBUF, Large Pageable pool
  • SF SFBUF, Small Fixed pool
  • SP SPBUF, Small Pageable pool
  • WP WPBUF, Working Set Pageable pool.

PPBUFs, NPBUFs, and UEBUFs are no longer used by VTAM, though they still appear in the output listings.

The following columns are in the output:

  • MAXU. Records the maximum number of buffers in use in the pool at any one time.
  • MAXQ. Records the maximum number of requests for buffers that were queued waiting for storage at any one time.
  • AVNO. Number of buffers available when the trace entry was written.
  • TEXP. Number of times the buffer pool expanded.
  • MBUF. Records the maximum number of buffers, used and unused, that were in the pool. This includes the static and expansion parts of the pool.
  • TOTL. Records the total number of buffers in the pool at the time the trace entry was written.

Each time a trace entry is written these counters are reset. So, MAXU, MAXQ, TEXP, and MBUF are counters relevant since the last trace entry was written.

Similarly, for a display of buffer use by the D NET, BFRUSE command, the values in the resulting display are valid since the last trace entry was written; or, since the last VTAM startup, if the SMS trace is not running.