DCMT DISPLAY FILE Command

The DCMT DISPLAY FILE command displays information about database, journal, and SYSTRK files. When displaying information about a database file, it also displays information about its associated area(s) and buffer.
idmscu19
The DCMT DISPLAY FILE command displays information about database, journal, and SYSTRK files. When displaying information about a database file, it also displays information about its associated area(s) and buffer.
Syntax
►►─── DCMT ─┬───────────────────┬─────────────────────────────────────────────► └─
broadcast-parms
─┘ ►─── Display ────────────────────────────────────────────────────────────────► ►─┬─ File ─┬─
segment-name
.
file-name
─┬──────────┬─┬─┬───────────────────────►◄ │ │ ├─ ARea ───┤ │ │ │ │ ├─ Buffer ─┤ │ │ │ │ ├─ LOC ────┤ │ │ │ │ └─ ALl ────┘ │ │ │ ├─
file-star-name
──────────────────────┤ │ │ ├─
journal-file-name
───────────────────┤ │ │ └─
SYSTRK-file-name
────────────────────┘ │ └─ Files ──────────────────────────────────────────┘
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.
  • File
    Displays information about one or more specified files.
    • segment-name
      The name of the segment associated with the file.
    • file-name
      The name of the file.  If you specify AREA, BUFFER, or ALL, you receive information on the associated area(s), buffer(s), or both.
      ARea: Displays information about the specified database file and its associated area or areas. Buffer: Displays information about the specified database file and its associated buffer.
      LOC: Displays the address of the file control block. ALl: Displays information about the specified database file and its associated area(s) and buffer.
    • file-star-name
      Displays information about all files associated with the database whose names begin with the same specified alphanumeric characters.
      file-star-name
      specifies any alphanumeric description that ends with an asterisk (*) to denote wild card characters.
      In this example, CA IDMS displays information about all files that begin with the letters EMP:
      dcmt d f emp*
    • journal-file-name
      Specifies the name of a disk or archive journal file.
    • SYSTRK-file-name
      Specifies the name of a SYSTRK file.
Files
Displays information about all files associated with the database.
Usage
File Information Displayed
The following information is displayed for each file:
Field
Value
Data File
The file name.
Mode
File access mode:
Upd -- Available for update
Ret -- Available for retrieval or transient retrieval
blank
-- Not open
Status
An error code if the last access of the file resulted in an I/O error or zero.
Pg-Size
The page size of the area(s) associated with the file. If the file is not open, the page size is 0.
Fl-Type
The access method for the file (VSAM or BDAM).
M-Cache
Indicates if the current data set is cached in memory: Yes, No, or Y-
NN
%, where
NN
is the cache storage limit percentage.
The memory cache can be located in 64-bit storage or an ESA dataspace.
S-Cache
Indicates if the current data set is assigned to a shared cache: Yes or No
DD-Name
The DD name of the file.
Pre-fetch
The status chained read processing -- allowed or disabled.
Pages per Track
Pages per track for the file.
DISP
Current disposition of the data set.
DSname
The data set name of the file.
VOLSER
Volume name.
Cache-name
(Sysplex environment only) Name of the shared cache to which the current file is assigned.
Example
DCMT DISPLAY FILES
DISPLAY FILES -------- Data File -------- Mode Stat Pg-Size Fl-Type M-Cache S-Cache DD-Name ASFNWK.ASFDML Upd 0 4276 non-VSAM Y-01% No ASFDML Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: IDMS03 DSname: (DMCL).. DBDC.SYSQA10.ASFDML DISP=SHR Cache-name: IDMSQACACHE002 ASFNWK.ASFLOD Upd 0 4276 non-VSAM Y-01% No ASFLOD Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: IDMS03 DSname: (DMCL).. DBDC.SYSQA10.ASFLOD DISP=SHR Cache-name: IDMSQACACHE002 ASFNWK.ASFDEFN Upd 0 4276 non-VSAM No Yes ASFDEFN Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: IDMS03 DSname: (DMCL).. DBDC.SYSQA10.ASFDEFN DISP=SHR Cache-name: IDMSQACACHE002 ASFNWK.ASFDATA Upd 0 4276 non-VSAM No Yes ASFDATA Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: IDMS03 DSname: (DMCL).. DBDC.SYSQA10.ASFDATA DISP=SHR Cache-name: IDMSQACACHE002 A31APPL.APPLDML Upd 0 4276 non-VSAM No No A31DML Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: IDMS03 DSname: (DMCL).. DBDC.SYSQA10.A31DML DISP=SHR A31APPL.APPLLOD Upd 0 4276 non-VSAM No No A31LOD Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: IDMS03 DSname: (DMCL).. DBDC.SYSQA10.A31LOD DISP=SHR CATSYS.DCCAT Upd 0 4276 non-VSAM No No DCCAT Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: IDMS03 DSname: (DMCL).. DBDC.SYSQA10.DCCAT DISP=SHR CATSYS.DCCATX Upd 0 4276 non-VSAM No No DCCATX Pre-fetch: Not-Allowed (DMCL) Pages per Track 11 VOLSER: IDMS03 DSname: (DMCL).. DBDC.SYSQA10.DCCATX DISP=SHR CATSYS.DCCATL Upd 0 18452 non-VSAM No No DCCATL Pre-fetch: Not-Allowed (DMCL) Pages per Track 3 VOLSER: IDMS03 DSname: (DMCL).. DBDC.SYSQA10.DCCATL DISP=SHR
DCMT DISPLAY FILE file-id
DISPLAY FILE EMPDEMO.INSDEMO -------- Data File -------- Mode Stat Pg-Size Fl-Type M-Cache S-Cache DD-Name EMPDEMO.INSDEMO Clos 0 4276 non-VSAM No No INSDEMO Pre-fetch: Not-Allowed (DMCL) UNALLOCATED DSname: (DMCL).. DBDC.SYSTEM72.EMPDEMO.INSDEMO DISP=SHR
DCMT DISPLAY FILE file-id ALL
DISPLAY FILE EMPDEMO.INSDEMO ALL -------- Data File -------- Mode Stat Pg-Size Fl-Type M-Cache S-Cache DD-Name EMPDEMO.INSDEMO Clos 0 4276 non-VSAM No No INSDEMO Pre-fetch: Not-Allowed (DMCL) UNALLOCATED DSname: (DMCL).. DBDC.SYSTEM72.EMPDEMO.INSDEMO DISP=SHR ---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy EMPDEMO.INS-DEMO-REGION Ret 75101 75150 0 0 0 0 Stamp: 2005-09-02-09.17.48.279585 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 FILE file-id AREA
DISPLAY FILE EMPDEMO.INSDEMO AREA -------- Data File -------- Mode Stat Pg-Size Fl-Type M-Cache S-Cache DD-Name EMPDEMO.INSDEMO Clos 0 4276 non-VSAM No No INSDEMO Pre-fetch: Not-Allowed (DMCL) UNALLOCATED DSname: (DMCL).. DBDC.SYSTEM72.EMPDEMO.INSDEMO DISP=SHR ---------- Area ----------- Lock Lo-Page Hi-Page #Ret #Upd #Tret #Ntfy EMPDEMO.INS-DEMO-REGION Ret 75101 75150 0 0 0 0 Stamp: 2005-09-02-09.17.48.279585 Pg grp: 0 NoShare NoICVI NoPerm
For a list of information displayed, see the following topics:
More Information
For more information about the CREATE FILE and ALTER FILE statements, see "Administrating CA IDMS Database" in the CA IDMS documentation.