The DB2® dump formatter
provides a way to analyze the usage of DB2 storage
with the Storage Manager (SM) options. Each level of the SM option
provides more detailed information than the previous level.
Table 1 summarizes
the information generated for each value of SM and for SMSA.
All
storage manager reports show information about local storage, global
storage (z/OS® CSA/ECSA), and
EDM pool statistics.
To obtain the simplest local storage report,
run the DSNWDMP statement with SM=1. The local storage report is divided
into two sections: one for fixed storage and one for variable storage.
Fixed storage is storage that has a predetermined length, and each
element has the same length.
The following example shows a local
storage report that is generated for the following DSNWDMP statement:
DSNWDMP 'SUBSYS=VA1A,SM=1'
Figure Label
Description
1
Pool header block address
2
Pool name
3
Fixed (fix) or variable (var) storage
4
Size of pool
5
DB2 storage
class
6
z/OS subpool
When you specify SM=1, DSNWDMP also generates storage
statistics. The following shows an example of a storage statistics
report.
To obtain a local storage report with SHB control blocks,
run the DSNWDMP statement with SM=2. In a fixed storage pool, the
storage always follows the SHB, so only the SHB address is listed
in the report. Each block of variable storage has a varying length.
With variable storage, the SHB is not in the same place as the storage,
so the address of the storage is listed after the address of the SHB.
The
following shows an example of a local storage report that is generated
for the following DSNWDMP statement:
DSNWDMP 'SUBSYS=VA1A,SM=2,SMSA=2D'
Figure Label
Description
1
SHB address
2
Address of storage that SHB relates to
3
Length of storage
Within a storage pool, the sum of the segment (SHB) lengths
should always equal the length that is described by the pool header
block (PHB). In the previous example, the PHB length, 32 KB, is equal
to the sum of the SHB lengths: 12 KB+8 KB+8 KB+4 KB.
Use SM=4
and SM=5 to check for fragmentation within blocks and storage use
within individual variable storage pool blocks. The report includes
the total length of allocated and free elements for each segment of
storage and the total for the storage pool. The total for the storage
pool appears after the last SHB for the pool.
The following
shows an example of a local storage report that is generated for the
following DSNWDMP statement:
DSNWDMP 'SUBSYS=VA1A,SM=4,SMSA=2D'
Use SM=5 to display the first 16 bytes, with their hexadecimal
equivalents, of each allocated element. For the module that made a
request to DB2 storage manager
for storage, DSNWDMP attempts to display the following extra information:
The owner token for the storage
The CSECT and offset within the CSECT of the storage allocation
request
The maintenance level of the module
It is not always possible to determine the CSECT name. Therefore,
this name might be incorrect or absent in some cases.
The following
shows an example of a local storage report that is generated for the
following DSNWDMP statement:
DSNWDMP 'SUBSYS=VA1A,SM=5,SMSA=2D'
Figure Label
Description
1
Owner token for the storage
2
CSECT and offset of the storage allocation request
3
Maintenance level
You can specify DS options with SM options to display
storage information by thread. This information includes the short,
long and vlong pool addresses. These addresses are addresses of storage
pools within the DBM1 address space.
The following shows an
example of a storage report that is generated for the following DSNWDMP
statement:
DSNWDMP 'SUBSYS=VA1A,DS=1,SM=5,SMSA=2D'
This
example shows that a CICS® thread
signed on as user USRT001, running plan TSTA85, on correlation ID
PT01XA85 is using ADMF local pool 7F2C4510. The thread uses 32 KB
of storage, of which 21 KB is currently allocated.
For all storage reports, DSNWDMP displays EDM pool statistics.
Those statistics are the same ones that you obtain through DB2 statistics trace reports. The
following shows an example report.