DCMT DISPLAY SCRATCH Command

The DCMT DISPLAY SCRATCH command displays the following information about scratch usage. 
idmscu19
The DCMT DISPLAY SCRATCH command displays the following information about scratch usage. 
  • Definition-related information, such as number of pages, page size, and location
  • Global statistics and high-water marks
  • Detailed information
For more information about scratch management, see Storage, Scratch, and Queue Management.
This article describes the following information:
2
2
DCMT DISPLAY SCRATCH Syntax
►►─── DCMT ─┬───────────────────┬─────────────────────────────────────────────►             └─ 
broadcast-parms
 ─┘  ►──── Display SCRatch ───────────────────────────────────────────────────────►  ►──────┬────────────────────────────────────────┬────────────────────────────►◄         │           ┌──────────────────────────┐ │         ├─ SORt ──┬ ▼ ┬─┬── DEScending ◄─┬────┬┴─┘         └─ ORDer ─┘   │ └── ASCending ───┘    │                       └─ BY ─┬─ SIZe ◄──────┬─┘                              ├─ LTErm ──────┤                              ├─ SCRatch id ─┤                              └─ USEr id ────┘
DCMT DISPLAY SCRATCH Parameters
  • broadcast-parms
    Indicates to execute the DCMT command on all or a list of data sharing group members.
    For more information about broadcasting and
    broadcast-parms
    , see the section How to Broadcast System Tasks.
  • Display SCRatch
    Displays global statistics, definition-related, and detailed information about scratch.
  • SORt or ORDer
    Requests sorted output.
    • DEScending
      Specifies to display the higher values first in the sorted output. This is the default.
    • ASCending
      Specifies to display the lower values first in the sorted output.
    • BY
      Identifies the sort criterion.
      • SIZe: 
        Specifies to sort by the scratch area size. This is the default.
      • LTErm: 
        Specifies to sort by the logical terminal name.
      • SCRatch id: 
        Specifies to sort by the scratch area ID. The scratch area ID specifies the area with which the object record is associated.
      • USEr id: 
        Specifies to sort by the user ID.
DCMT DISPLAY SCRATCH Usage
Output from DCMT DISPLAY SCRATCH
The header information reports on the following:
  • Scratch area definition
    • total number of pages
    • page size
    • location (file or in storage)
    • storage address (if scratch in storage)
    • primary and secondary extent (expressed in number of pages and bytes)
    • storage limit (expressed in number of pages and bytes)
  • Global run time information
    • the number of PUT, GET, and DELETE scratch requests
    • the number of scratch area IDs currently active
    • the number of scratch area IDs created
    • the number of pages in use of the scratch area (expressed as an absolute value and as a percentage)
    • the number of scratch buffers
    • the number of scratch pages found in buffer
    • the number of pages read and written
    • HWM (High Water Mark) values
  • Detail information that reports on currently active scratch area IDs
    • the scratch area ID name
    • the amount of space occupied for the scratch area ID (expressed in number of pages and as a percentage of the current total size)
    • the LTERM for which the scratch area ID was allocated
    • the user id signed on to the LTERM
DCMT DISPLAY SCRATCH Example
DCMT DISPLAY SCRATCH SORT DESCENDING BY SIZE
DCMT DISPLAY SCRATCH SORT DESCENDING BY SIZE Total   number of pages         391     Location                   ANY Storage Page size                      2676     Storage address      00000001 00900000 Primary   extent #pages         391     Primary   extent size             1 MB Secondary extent #pages         783     Secondary extent size             2 MB Storage   limit  #pages       11363     Storage   limit  size            29 MB PUT    scratch requests         223     Scratch Areas active                 9 GET    scratch requests          91     Scratch Areas created               12 DELETE scratch requests          44     HWM concurrent Scr. Areas            9 Pages in use                    240     HWM pages in use                   241 Pages in use percentage          61%    HWM pages in use  percentage        61% Buffers                         N/A     HWM pages in use  for 1 S.A.        141 Pages found in buffer           N/A     HWM pages found   for 1 S.A.        N/A Pages written                   N/A     HWM pages written for 1 S.A.        N/A Pages read                      N/A     HWM pages read    for 1 S.A.        N/A Scratch Area ID     Size: Pages / %     LTERM      User id OCF*FSEO                    140    35   VL72001    USER02 DDDLFSEI                     83    21   VL72002    USER01 SSCHFSEO                      6     1   VL72001    USER02 OCF*FSEI                      3    <1   VL72001    USER02 SSCHFSEI                      3    <1   VL72001    USER02 DDDLFSEO                      2    <1   VL72002    USER01 DDDLFSEC                      1    <1   VL72002    USER01 OCF*FSEC                      1    <1   VL72001    USER02 SSCHFSEC                      1    <1   VL72001    USER02