DCMT DISPLAY AREA Command

DCMT DISPLAY AREA displays information about one are, multiple areas, or all areas.
idmscu19
DCMT DISPLAY
AREA
displays information about one area, multiple areas, or all areas.
This article describes the following information:
2
2
Syntax
►►─── DCMT ─┬───────────────────┬─────────────────────────────────────────────► └─
broadcast-parms
─┘ ►─── Display ────────────────────────────────────────────────────────────────► ►─┬─ ARea ─┬─
segment-name.area-name
─┬──────────┬─┬─┬───────────────────────►◄ │ │ ├─ Buffer ─┤ │ │ │ │ ├─ File ───┤ │ │ │ │ ├─ LOC ────┤ │ │ │ │ └─ All ────┘ │ │ │ └─
area-star-name
──────────────────────┘ │ └─ AReas ─┬───────────────────┬────────────────────┘ ├─ SOrted By Name ──┤ └─ SOrted By Pages ─┘
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
    syntax, see the section How to Broadcast System Tasks.
  • ARea
    Specifies the area to be displayed.
    • segment-name
      The name of the segment associated with the area.
    • area-name
      The name of the area.
    • Note
      Within 64-bit storage, if a percentage of a file is cached, the display shows that memory is cached,
      MemCache Yes
      and shows the percentage of the file that is cached
      MemCache
      Y-
      NN
      %,
      where
      NN
      specifies the percentage of the file size that is cached.
  • Buffer
    Displays information about the area and its associated buffers.
  • File
    Displays information about the area and its associated files. For files using shared cache, displays the shared cache status (Yes, No, or Available) and the name of the cache for the named file or files to which the area is mapped.
  • LOC
    Displays the address of the area control block.
  • All
    Displays information about the area and its associated files and buffers.
  • area-star-name
    Displays information about all areas whose names begin with the same specified alphanumeric characters.
    Area-star-name
    specifies any alphanumeric description that ends with an asterisk (*) to denote wild card characters.
    In this example, CA IDMS displays information about areas associated with segments that begin with EMP:
    dcmt d ar emp*
    In this example, CA IDMS displays information about all areas in the EMPLOYEE segment with area names that begin with the letter H:
    dcmt d ar employee.h*
  • AReas
    Displays information about all areas.
  • SOrted By Name
    Displays the areas sorted alphabetically by area name.
  • SOrted By Pages
    Displays the areas sorted by page group and page range.
Usage
DCMT DISPLAY AREA displays the following information for each area:
Field
Value
Area
Area name
Lock
Area status:
AVL -- Available, but the area has not been accessed
OFL -- Offline
RET -- Available for retrieval
UPD -- Available for update
TR -- Available for transient retrieval
Lo-Page
Low page number.
Hi-Page
High page number.
#Ret
Number of retrieval transactions actively using the area.
#Upd
Number of update transactions actively using the area.
#Tret
Number of transient retrieval transactions actively using the area.
#Ntfy
Number of notify locks currently being held .
Stamp
The date and time the definition of the area was last changed.
Pg grp
The page group.
Stat
File status: zero or an error status code. If not zero, then a DBIO error status has been signalled.
Pnd
Ready status to which an area will be varied (displayed while the area is waiting to be quiesced).
Share/Noshare
Shows the sharability state of the area.
ICVI/NoICVI
Shows if there is inter-CV-interest in the area.
Perm/NoPerm
Shows if the area status was established with the PERMANENT option.
If the area is the target of an outstanding VARY operation, the status to which it is being varied is also shown.
Example
DCMT DISPLAY AREAS
D AREAS ---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy APPLDICT.DDLDML Upd 60001 62000 0 0 0 0 Stamp: 2003-05-05-09.48.14.948912 Pg grp: 0 NoShare NoICVI NoPerm APPLDICT.DDLDCLOD Upd 70001 70500 0 2 0 0 Stamp: 2003-05-05-09.48.15.080204 Pg grp: 0 NoShare NoICVI NoPerm CATSYS.DDLCAT Upd 1 300 0 0 0 0 Stamp: 2003-05-05-09.48.15.091931 Pg grp: 0 NoShare NoICVI NoPerm CATSYS.DDLCATX Upd 801 900 0 0 0 0 Stamp: 2003-05-05-09.48.15.135608 Pg grp: 0 NoShare NoICVI NoPerm CATSYS.DDLCATLOD Upd 901 950 0 0 0 0 Stamp: 2003-05-05-09.48.15.118508 Pg grp: 0 NoShare NoICVI NoPerm DBCR.BRNCHTEL Ret 680001 685012 0 0 0 0 Stamp: 2000-07-11-04.32.28.733988 Pgrp: 15 Share NoICVI NoPerm DBCR.ACCTHIST Ret 690001 740040 0 0 0 0 Stamp: 2000-07-11-04.32.28.744494 Pgrp: 15 Share NoICVI NoPerm EMPDEMO.EMP-DEMO-REGION Ret 75001 75100 0 0 0 0 Stamp: 2001-11-16-08.38.17.121905 Pg grp: 0 NoShare NoICVI NoPerm EMPDEMO.INS-DEMO-REGION Ret 75101 75150 0 0 0 0 Stamp: 2001-11-16-08.38.17.129740 Pg grp: 0 NoShare NoICVI NoPerm EMPDEMO.ORG-DEMO-REGION Ret 75151 75200 0 0 0 0 Stamp: 2001-11-16-08.38.17.135896 Pg grp: 0 NoShare NoICVI NoPerm PROJSEG.PROJAREA Ret 77401 77450 0 0 0 0 Stamp: 2003-05-05-09.48.15.221458 Pg grp: 0 NoShare NoICVI NoPerm
SQLDEMO.EMPLAREA Ret 77001 77100 0 0 0 0 Stamp: 2003-05-05-09.48.15.261838 Pg grp: 0 NoShare NoICVI NoPerm SQLDEMO.INFOAREA Ret 77201 77250 0 0 0 0 Stamp: 2003-05-05-09.48.15.295553 Pg grp: 0 NoShare NoICVI NoPerm SQLDEMO.INDXAREA Ret 77301 77350 0 0 0 0 Stamp: 2003-05-05-09.48.15.307901 Pg grp: 0 NoShare NoICVI NoPerm SYSDIRL.DDLDCLOD Ret 4001 4010 0 0 0 0 Stamp: 2003-05-05-09.48.15.383358 Pg grp: 0 NoShare NoICVI NoPerm SYSDIRL.DDLDML Ret 5001 7000 0 0 0 0 Stamp: 2003-05-05-09.48.15.327241 Pg grp: 0 NoShare NoICVI NoPerm SYSLOC.DDLOCSCR Ofl 55001 57000 0 0 0 0 Stamp: 1999-01-10-14.39.48.189056 Pg grp: 0 NoShare NoICVI NoPerm SYSMSG.DDLDCMSG Ret 10001 14000 2 0 0 0 Stamp: 1999-01-12-09.00.03.530382 Pg grp: 0 NoShare NoICVI NoPerm SYSSQL.DDLCAT Ret 20001 22000 0 0 0 0 Stamp: 2003-05-05-09.48.15.452536 Pg grp: 0 NoShare NoICVI NoPerm MemCache Yes SYSSQL.DDLCATLOD Ret 25001 25500 0 0 0 0 Stamp: 2003-05-05-09.48.15.521617 Pg grp: 0 NoShare NoICVI NoPerm SYSSQL.DDLCATX Ret 28001 28500 0 0 0 0 Stamp: 2003-05-05-09.48.15.492441 Pg grp: 0 NoShare NoICVI NoPerm MemCache Y-01% SYSTEM.DDLDML Ret 1001 2000 4 0 0 0 Stamp: 2003-05-05-09.48.15.543262 Pg grp: 0 NoShare NoICVI NoPerm SYSTEM.DDLDCLOD Ret 3001 3100 0 0 0 0 Stamp: 2003-05-05-09.48.15.605066 Pg grp: 0 NoShare NoICVI NoPerm SYSTEM.DDLDCLOG Ret 30001 34000 3 0 0 0 Stamp: 2003-05-05-09.48.15.639484 Pg grp: 0 NoShare NoICVI NoPerm SYSTEM.DDLDCRUN Upd 40001 41000 0 2 0 0 Stamp: 2001-06-25-08.43.57.409403 Pg grp: 0 Share ICVI NoPerm SYSTEM.DDLDCSCR N/av 50001 52000 0 0 0 0 Stamp: 2003-05-05-09.48.15.706002 Pg grp: 0 NoShare NoICVI NoPerm SYSUSER.DDLSEC Ret 48001 48500 2 0 0 0 Stamp: 2003-05-05-09.48.15.739596 Pg grp: 0 NoShare NoICVI NoPerm
DCMT DISPLAY AREA area-name
D AREA APPLDICT.DDLDML ---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy APPLDICT.DDLDML Upd 60001 62000 0 0 0 0 Stamp: 2003-05-05-09.48.14.948912 Pg grp: 0 NoShare NoICVI NoPerm
DCMT DISPLAY AREA area-name BUFFER
D AREA APPLDICT.DDLDML BUFFER ---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy APPLDICT.DDLDML Upd 60001 62000 0 0 0 0 Stamp: 2003-05-05-09.48.14.948912 Pg grp: 0 NoShare NoICVI NoPerm --- Data Buffer -- Size In-use Max Getstg Prfetch-Min Prefetch DEFAULT_BUFFER 4276 30 60 OPSYS 500 Not-Allowd Synonym Table User-Defined System-Calculated Total-Space Used 50 128 712 Allocation Initial Addit'l Num-Alloc Size-Init Size-Add'l Tot-Space 30 30 1 136k 0 136k Storage Stg-Pools Getmain'd Above-16mb Below-16mb Total 5k 137k 142k 0 142k
DCMT DISPLAY AREA area-name ALL
D AREA APPLDICT.DDLDML ALL ---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy APPLDICT.DDLDML Upd 60001 62000 0 0 0 0 Stamp: 2005-09-02-09.17.48.016148 Pg grp: 0 NoShare NoICVI NoPerm -------- Data File -------- Mode Stat Pg-Size Fl-Type M-Cache S-Cache DD-Name APPLDICT.DICTDB Upd 0 4276 non-VSAM Yes No DICTDB Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: CULL05 DSname: (DMCL).. DBDC.SYSTEM72.APPLDICT.DDLDML DISP=SHR --- Data Buffer -- Size In-use Max Getstg Prfetch-Min Prefetch DEFAULT_BUFFER 4276 30 60 OPSYS 500 Not-Allowd Synonym Table User-Defined System-Calculated Total-Space Used 50 128 712 Allocation Initial Addit'l Num-Alloc Size-Init Size-Add'l Tot-Space 30 30 1 136k 0 136k Storage Stg-Pools Getmain'd Above-16mb Below-16mb Total 5k 137k 142k 0 142k
DCMT DISPLAY AREA area-name FILE
D AREA APPLDICT.DDLDML FILE ---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy APPLDICT.DDLDML Upd 60001 62000 0 0 0 0 Stamp: 2005-09-02-09.17.48.016148 Pg grp: 0 NoShare NoICVI NoPerm -------- Data File -------- Mode Stat Pg-Size Fl-Type M-Cache S-Cache DD-Name APPLDICT.DICTDB Upd 0 4276 non-VSAM Yes No DICTDB Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: CULL05 DSname: (DMCL).. DBDC.SYSTEM72.APPLDICT.DDLDML DISP=SHR
If the area is the target of an outstanding VARY operation, the status to which it is being varied is also shown.
DCMT DISPLAY AREA
(if memory caching is used)
If 64-bit memory caching is defined on the area, a MemCache field displays Yes or Y-nn%. If memory caching is not defined on the area, the MemCache field does not display, even if files in the area are defined with memory caching.
---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy EMPDB.EMP-DEMO-REGION Upd 75001 75100 0 0 0 0 Stamp: 2014-09-03-14.39.07.041552 Pg grp: 0 NoShare NoICVI NoPerm MemCache Yes EMPDB.INS-DEMO-REGION Upd 75101 75150 0 0 0 0 Stamp: 2014-09-03-14.39.07.047219 Pg grp: 0 NoShare NoICVI NoPerm MemCache Y-50% EMPDB.ORG-DEMO-REGION Upd 75151 75200 0 0 0 0 Stamp: 2014-09-03-14.39.07.052427 Pg grp: 0 NoShare NoICVI NoPerm