Sample output for storage analysis

In this example, the following PARM file was submitted:

sms sms(lengths)  sms(match)  sms(outstanding)
stoptime(02:04:10)  noformat
DESC This example shows storage analysis with a stop time.

The resulting Summary, Detailed, and Outstanding data sets follow.

Note:

Ellipses indicate that part of the output has been omitted.
STOPTIME is described in Using the timing options.
NOFORMAT and DESC are described in Using the I/O options.
General parameter coding information is described in Creating your own parameter data set.

The following example shows a Summary report for storage analysis, which is written to the data set name that you specify to receive the report. The DD name for the data set must be SUMMARY. The first line of all reports shows the VTAM® level, the 20-character title (the default is Trace Analysis), and the date that the report was processed. The description, if specified, follows the title.

The next several lines of the report are the specified parameters and the defaults. These are followed by observations that are included to highlight important properties of the trace that were encountered during processing. The observations will vary depending on the trace content and the options specified. The option choices are storage analysis, RU counting, and VIT extraction.

The trace statistics section contains the first and last time stamps, the record type count, the VIT entry count, and the VIT option count. For example, there may be 6 PIU VIT entries and 18 PIU2 entries, for a total of 24 PIU VIT option occurrences. Some VIT entries are not associated with a VIT option. If entries of this type are found, the total is listed beside N/A in the VIT option counts. If SNAP entries are found, the total is listed beside ? in the VIT option counts.

VTAM V4     Trace Analysis       Summary            92.325 11/20 11:28:47 LOC
 
This example shows storage analysis with a stop time.
 
Wrapped:     No
Formatting:  No
Interval:    None
Start time:  Beginning of trace
Stop time:   91.199 07/18 02:04:10.000 LOC (A43572C3 51A80000)
SMS:         Yes
   ASIDs:    All
   Options:  MATCH LENGTHS OUTSTANDING
   GBLK:     All
   DS Pools: All
   DSNAMEs:  All
   GETS:     All
   VTAL:     All
   REQS:     All
   CSM:      All
RU:          No
VITEXT:      No
 
********************************************************************************
Observations
 
Only 27 GBLK entries were found in this VIT.  The findings should be verified
on a larger trace.
 
Only 7 VTAL entries were found in this VIT.  The findings should be verified on
a larger trace.
 
The high water mark is 392 bytes allocated by VTAL.  This occurred at
02:04:07.715 LOC (record 115).
 
Only 18 REQS entries were found in this VIT.  The findings should be verified
on a larger trace.
 
********************************************************************************
Trace Statistics
 
First GTF Timestamp: 91.199 07/18 02:03:13.266 LOC (A435728D 36BFAE01)
First VIT Timestamp: 91.199 07/18 02:03:13.266 LOC (A435728D 36BFAE01)
 
Last VIT Timestamp:  91.199 07/18 02:04:07.716 LOC (A43572C1 240D7002)
Last GTF Timestamp:  91.199 07/18 02:04:10.866 LOC (A43572C4 2529DC02)
 
Summary of GTF Record Types
 
                   1 Timestamp control records
                 116 VIT records
                     -----------------
                 117 Total GTF records
 
Count of VIT Entry and Option Occurrences
 
     VIT Entry Occurrences
                  33 FBLK              27 GBLK
                   6 PIU               18 PIU2
                  19 RELS              18 REQS
                   7 VTAL               5 VTFR
 
     VIT Option Occurrences
                  24 PIU
                 109 SMS
                     -----
                 133 Total

The following example shows a Detailed Report for storage analysis, which is written to the data set name that you specify to receive the report. The DD name for the data set must be DETAILS. In this example, the get block (GBLK) pool totals follow the title and description. The totals are listed first for each GBLK pool in the "Home" data space, then for each pool in other data spaces, if any exist. For each pool, the pool number is shown in decimal and hexadecimal, followed by the pool name, an indication of allocation from private storage or CSA, and the data space name.

After the counts of total entries, matches, bytes allocated and freed, and other entries, you will find a summary number for the allocate and freed entries in this pool for each storage size. This section is written only if the LENGTHS option is specified. In this example, there were 9 GBLK entries, each of which allocated 152 bytes and requested 152 bytes. The largest number of GBLK entries not matched to a free block (FBLK) at one time was five. There were 9 FBLK entries, each of which freed 152 bytes.

The totals for all GBLK pools are listed after the GBLK pool counts for each pool. Next, the VTAL pools are listed like the GBLK pools, and finally the REQS are listed.

VTAM V4     Trace Analysis       Detailed Report    92.194 07/12 18:51:44 LOC
 
This example shows storage analysis with a stop time.
 
GBLK Pool Totals:
 
Home Data Space:
 
GBLK Pool 0 (X'00'): RUPEPRIV (Private)  Data space: Home
                    9 GBLK entries (including failures, if any)
                    9 FBLK entries (including failures, if any)
                    5 GBLK and FBLK matches
                    5 Largest number of GBLK entries at one time
                1,368 Bytes allocated
                1,368 Bytes allocated above the 16M line
                1,368 Bytes requested
                1,368 Bytes requested above the 16M line
                1,368 Bytes freed
                1,368 Bytes freed above the 16M line
                  608 Bytes not freed
                  760 Most unfreed bytes
 
          Bytes          Bytes           GBLK        Maximum           FBLK
      Allocated      Requested        Entries      Requested        Entries
            152            152              9              5              9
⋮
GBLK Totals:
                   27 GBLK entries (including failures, if any)
                   33 FBLK entries (including failures, if any)
                   16 GBLK and FBLK matches
                   13 Largest number of GBLK entries at one time
                    5 Largest number of GBLK entries at one time in one pool
                      was in pool 0 (X'00') in Home data space
                4,192 Bytes allocated
                3,696 Bytes allocated in private storage
                  496 Bytes allocated in CSA
                4,192 Bytes allocated above the 16M line
                3,375 Bytes requested
                2,888 Bytes requested in private storage
                  487 Bytes requested in CSA
                3,375 Bytes requested above the 16M line
                3,672 Bytes freed
                3,304 Bytes freed in private storage
                  368 Bytes freed in CSA
                3,672 Bytes freed above the 16M line
                2,160 Bytes not freed
                1,880 Bytes not freed in private storage
                  280 Bytes not freed in CSA
                2,824 Most unfreed bytes
                      was at 02:04:07.715 LOC at record 116
                1,536 Most unfreed bytes in one pool
                      was in pool 32 (X'20') in Home data space
 
                       ***************************************

VTAL Subpool Totals:
 
Subpool 13 (X'0D'): Private
                    3 VTAL entries (including failures, if any)
                    2 VTFR entries (including failures, if any)
                    2 VTAL and VTFR matches
                    1 Largest number of VTAL entries at one time
                  288 Bytes allocated
                  288 Bytes allocated above the 16M line
                  192 Bytes freed
                  192 Bytes freed above the 16M line
                   96 Bytes not freed
                   96 Most unfreed bytes
 
          Bytes           VTAL      Most VTAL           VTFR
      Allocated        Entries        Entries        Entries
             96              3              1              2
⋮
VTAL Totals:
                    7 VTAL entries (including failures, if any)
                    5 VTFR entries (including failures, if any)
                    5 VTAL and VTFR matches
                    2 Largest number of VTAL entries at one time
                    1 Largest number of VTAL entries at one time in one pool
                      was in pool 13 (X'0D')
                1,344 Bytes allocated
                  768 Bytes allocated in private storage
                  576 Bytes allocated in CSA
                1,344 Bytes allocated above the 16M line
                  952 Bytes freed
                  672 Bytes freed in private storage
                  280 Bytes freed in CSA
                  952 Bytes freed above the 16M line
                  392 Bytes not freed
                   96 Bytes not freed in private storage
                  296 Bytes not freed in CSA
                  392 Most unfreed bytes
                      was at 02:04:07.715 LOC at record 115
                  368 Most unfreed bytes in private
                  296 Most unfreed bytes in CSA
                  368 Most unfreed bytes in one pool
                      was in pool 47 (X'2F')
 
                       ***************************************

REQS Totals by Buffer Pool:
 
REQS Buffer Pool IOBUF
                    5 REQS entries (including failures, if any)
                    7 RELS entries (including failures, if any)
                    4 RELS entries were matched
                    5 Buffers allocated
                    5 Buffers allocated above the 16M line
                    4 Buffers freed
                    4 Buffers freed above the 16M line
                    1 Buffers not freed
                    2 Largest number of buffers at one time
 
    Buffers per           REQS      Most REQS
        Request        Entries        Entries
              1              5              2
⋮
REQS Totals:
                   18 REQS entries (including failures, if any)
                   19 RELS entries (including failures, if any)
                   15 RELS entries were matched
                   18 Buffers allocated
                   18 Buffers allocated above the 16M line
                   15 Buffers freed
                   15 Buffers freed above the 16M line
                    3 Buffers not freed
                    5 Largest number of buffers at one time
                      was at 02:03:44.609 LOC at record 71
                    3 Largest number of buffers at one time in one pool
                      was in the LPBUF pool

CSM Totals:
 
                    8 GTBF entries (including failures, if any)
                    1 GTBF entries with error return code
                    5 ASNB output entries (including failures, if any)
                    1 ASNB output entries with error return code
                    5 FRBF entries (including failures, if any)
                    1 FRBF entries with error return code
                    3 GTBF entries were matched by FRBF
                    2 ASNB output entries were matched by FRBF
                    2 GTBF or ASNB buffer tokens duplicated
                   13 Buffers actually allocated by GTBF
                   13 Buffers requested for allocation by GTBF
                    5 Buffers actually assigned by ASNB
                    5 Buffers requested for assignment by ASNB
                    2 Buffers actually released by FRBF
                    3 Buffers actually freed by FRBF
                    6 Buffers requested to be freed by FRBF
                    9 Buffers not freed
                   12 Largest number of buffers at one time

The following example shows an outstanding report for storage analysis, which is written to the data set name that you specify to receive the report. The DD name for the data set must be OUTSTAN. After the title and description, the unmatched GBLK entries are listed by pool number for each data space. Next, the unmatched VTAL entries are listed by subpool number. Then the unmatched REQS and REQ2 entries are listed by buffer name.

Note:

The REQ2 entries consist of the VIT entry name (REQ2) followed by one to seven addresses. Instead of showing the actual REQ2 entry, which does not contain the data shown on the REQS entry, each buffer address is shown as if it had appeared in a REQS entry.
The queued REQS entries that have not been matched by a QREQ entry are also listed in the OUTSTAN data set. These REQS have a buffer address of 0.

Figure 1. Storage analysis with a stop time

VTAM V4     Trace Analysis       Outstanding Report 92.194 07/12 18:51:44 LOC
 
This example shows storage analysis with a stop time.
 
********************************************************************************
* List of outstanding GBLK entries                                             *
********************************************************************************
 
Home Data Space:
 
GBLK Pool 0 (X'00'): RUPEPRIV (Private)  Data space: Home
 
Outstanding GBLK at 02:03:52.888 LOC (record 89)
C7C2D3D2 0C000000 06638480 06357218 823D6340 00000098 864EBCF8 00000098 *GBLK......d.....b.. ...qf+.8...q*
 
Outstanding GBLK at 02:04:01.276 LOC (record 102)
C7C2D3D2 0C000000 066388E0 06357218 823D6340 00000098 864EBCF8 00000098 *GBLK......h\....b.. ...qf+.8...q*
 
Outstanding GBLK at 02:04:01.276 LOC (record 105)
C7C2D3D2 0C000000 066385C0 06357218 823D6340 00000098 8644B2B8 00000098 *GBLK......e ....b.. ...qf......q*
 
Outstanding GBLK at 02:04:03.374 LOC (record 108)
C7C2D3D2 0C000000 06638340 06357218 823D6340 00000098 864EBCF8 00000098 *GBLK......c ....b.. ...qf+.8...q*
⋮
********************************************************************************
* List of outstanding VTAL entries                                             *
********************************************************************************
 
Subpool 13 (X'0D'): Private
 
Outstanding VTAL at 02:04:05.615 LOC (record 112)
E5E3C1D3 0C000000 067A3FA0 0000000D 82478930 00000060 00000000 00000000 *VTAL.....:. ....b.i....-...
 
-------------------------------------------------------------
 
Subpool 15 (X'0F'): Private
 
Every valid VTAL in this pool was matched by a VTFR.
 
-------------------------------------------------------------
⋮
********************************************************************************
* List of outstanding REQS entries                                             *
* (Note: Each buffer from a REQ2 entry is listed as a separate REQS)           *
********************************************************************************
 
REQS Buffer Pool IOBUF
 
REQS waiting for QREQ or RELS at 02:03:25.703 LOC (record 35)
D9C5D8E2 0C000000 062EAE88 06321010 823B95F4 00010000 062DD648 00000000 *REQS.......h....b.n4......O.....*
 
-------------------------------------------------------------
⋮