DCMT DISPLAY MEMORY Command

DCMT DISPLAY MEMORY displays the layout or contents of a selected area of DC/UCF memory.
idmscu19
DCMT DISPLAY MEMORY displays the layout or contents of a selected area of DC/UCF memory.
This topic describes the following information:
2
2
Syntax
  ►►─ DCMT ─┬───────────────────┬────────────────────────────────────────►           └─ broadcast-parms ─┘  ►─ Display MEmory ────────────────────────────────────────────────────►    ►─┬─┬──────────┬─ EREs ─────────────────────────────────────────────┬─►◄    │ └─ ACTive ─┘                                                    │    ├─ element-specification ─────────────────────────────────────────┤    ├─┬─ EP entry-point-name ────────┬─┬──────────────────────────┬───┤    │ └─ MODule nucleus-module-name ─┘ └─ memory-specification-1 ─┘   │    ├─ hex-address ─┬──────────────────────────┬──────────────────────┤    │               └─ memory-specification-2 ─┘                      │    ├─ storage-id-specification ──────────────────────────────────────┤    ├─ MAP ───────────────────────────────────────────────────────────┤    ├─ NUCleus ───────────────────────────────────────────────────────┤    ├─ PDE program-specification ─┬──────────────────────────┬────────┤    │                             └─ memory-specification-3 ─┘        │    ├─ PROgram program-specification ─┬──────────────────────────┬────┤    │                                 └─ memory-specification-1 ─┘    │    ├─ STr ─┬─ C ◄─┬─ ‘search-string’ ─┬──────────────────┬───────────┤    │       └─ X ──┘                   └─ search-options ─┘           │    ├─ SVC ─┬──────────────────────────┬──────────────────────────────┤    │       └─ memory-specification-1 ─┘                              │    └─ dc/ucf-table-keyword ─┬──────────────────────────┬─────────────┘                             └─ memory-specification-1 ─┘               
Expansion of element-specification
►►─┬─┬─ CCE ────────────────────────┬─┬──────────────────────────┬─┬──►◄    │ ├─ CSA ────────────────────────┤ └─ 
memory-specification-2
 ─┘ │    │ ├─ DDT ────────────────────────┤                              │    │ ├─ DMCL ───────────────────────┤                              │    │ ├─┬─ DPR  ─┬─ 
area-name
 ───────┤                              │    │ │ └─ AREa ─┘                   │                              │    │ ├─ ESE ────────────────────────┤                              │    │ ├─┬─ FCB  ─┬─ 
file-name
 ───────┤                              │    │ │ └─ FILe ─┘                   │                              │    │ ├─┬─ JCB     ─┬─ 
journal-name
 ─┤                              │    │ │ └─ JOUrnal ─┘                │                              │    │ ├─ LTT ────────────────────────┤                              │    │ ├─ OPT ────────────────────────┤                              │    │ ├─ PDT ────────────────────────┤                              │    │ ├─ QDT ────────────────────────┤                              │    │ ├─ RCA ────────────────────────┤                              │    │ ├─ SCT ─┬─────────────┬────────┤                              │    │ │       └─ (
sct-num
) ─┘        │                              │    │ ├─ SEGment 
segment-name
 ───────┤                              │    │ ├─ TCA ────────────────────────┤                              │    │ └─ TDT ────────────────────────┘                              │    └─┬─ DDE destination-id ─────────┬─┬──────────────────────────┬─┘      ├─ LTE lterm-id ───────────────┤ └─ 
memory-specification-3
 ─┘      ├─ PLE line-id ────────────────┤      ├─ PTE pterm-id ───────────────┤      ├─ QDE queue-id ───────────────┤      └─ TDE task-code ──────────────┘  
Expansion of memory-specification-1
►►─┬────────────────┬──┬──────────────┬───────────────────────────────►◄    └─ + 
hex-offset
 ─┘  ├─ 16 ◄────────┤                        └─ 
byte-count
 ─┘
Expansion of memory-specification-2
►►─┬────────────────┬─────────────────────────────────────────────────►    └─ + 
hex-offset
─┘ ►►─┬────────────────────────────────────────────────────────────┬─────►◄    ├─ byte-count1 ──────────────────────────────────────────────┤      └─ 
indirect-address
 ─┬────────────────────┬─┬──────────────┬─┘                          └─ 
indirect-address
 ─┘ ├─ 16 ◄────────┤                                                └─ 
byte-count
 ─┘  
Expansion of memory-specification-3
►►─┬────────────────┬─────────────────────────────────────────────────►    └─ + 
hex-offset
 ─┘  ►─┬────────────────────────────────────────────────────────────┬─────►◄    └─ 
indirect-address
 ─┬────────────────────┬─┬──────────────┬─┘                          └─ 
indirect-address
 ─┘ ├─ 16 ◄────────┤                                                └─ 
byte-count
 ─┘  
Expansion of indirect-address
►►─ % ─┬────────────────┬─────────────────────────────────────────────►◄        └─ + 
hex-offset
 ─┘ 
Expansion of storage-id-specification
►►─ ID ─┬─ C ◄─┬─ ‘
storage-id
’ ─┬────────────────────┬────────────────►         └─ X ──┘                └─ LTE long-term-id ─┘              ►────────┬──────────────────────────┬───────────────────────────────►◄           └─ 
memory-specification-1
 ─┘  
Expansion of program-specification
►►───┬───────────────────┬─ program-name ─┬────────────────────────┬──►◄      └ 
dictnode.dictname
 ┘                └ 
Version version-number
 ┘
Expansion of search-options
►►──┬──────────────────────┬─┬──────────────┬─────────────────────────►     ├─ (1) ◄───────────────┤ ├─ 16 ◄────────┤     └─ (
occurrence-count
) ─┘ └─ 
byte-count
 ─┘  ►──┬─ Addr 
hex-address search-length
 ─┬──────────────────────────────►◄     ├─ Lte 
logical-terminal-id
 ────────┤     └─ Taskid 
task-id
─────────────────┘  
Parameters
  • broadcast-parms
    Executes the DCMT command on all or a list of data sharing group members.
    For more information on broadcasting and broadcast-parms syntax, see the section "How to Broadcast System Tasks" in the
    System Tasks and Operator Commands
    G
    uide
    .
  • element-specification
    Identifies an area of memory to display.
  • PROgram
    program-specification
    Specifies a program or a nucleus module as the base location of the memory to display. program-specification must identify a program or a module residing in the DC/UCF address space. To identify a program that was loaded from an alternate data dictionary, specify DICTNODE or DICTNAME as described in the Expansion of program-specification.
  • memory-specification-1
    Provides additional information about the location and length of the memory to display.
  • memory-specification-2
    Provides additional information about the location and length of the memory to display.
  • memory-specification-3
    Provides additional information about the location and length of the memory to display.
Expansion of element-specification
  • DMCl
    Displays memory content beginning at the start of the DMCL's DM58 control block.
  • DPR|AREa
    Displays memory content beginning at the start of the DPR (PR60) control block for the named area. Both keywords are synonymous and give the same result.
    • segment.area-name
      Identifies the area whose DPR control block is to be displayed. segment.area-name must identify a physical area included in the DMCL.
  • FCB|FILe
    Displays memory content beginning at the start of the FCB (FC59) control block for the named file. Both keywords are synonymous and give the same result.
    • segment.file-name
      Identifies the file whose FCB control block is to be displayed. segment.file-name must identify a file included in the DMCL.
  • JCB|JOUrnal
    Displays memory content beginning at the start of the JCB (JD62) control block for the named journal. Both keywords are synonymous and give the same result.
    • journal-name
      Identifies the journal whose JCB control block is to be displayed. journal-name must identify a journal included in the DMCL.
  • SEGment
    Displays memory content beginning at the start of the SEG (SG49) control block for the named segment.
    • segment
      Identifies the segment whose SEG control block is to be displayed. segment must identify a segment included in the DMCL.
Expansion of memory-specification-1
  • + hex-offset
    Displays memory content beginning at the specified hexadecimal offset from the requested starting location.
    Default:
    0 (zero)
  • byte-count
    Specifies the number of bytes to be displayed, rounded to the next multiple of 4.
    Default:
    16 bytes
Expansion of memory-specification-2
  • + hex-offset
    Identifies a location in memory as a hexadecimal offset from the requested starting location.
    Default:
    0 (zero).
    If an
    indirect-address
    is not specified, the offset identifies the start of the memory to display.
    If an
    indirect-address
    is specified, the offset identifies a location whose content is an address.
  • byte-count1
    If no indirect-address is specified, byte-count1 is the number of bytes to be displayed, rounded to the next multiple of 4.
    Default:
    The length of the specified control block.
  • indirect-address
    Indicates that the location in memory identified by the preceding parameters contains an address that is to be used in identifying the memory to be displayed.
    The last
    indirect-address
    specified identifies the start of the memory to be displayed.
  • byte-count
    Specifies the number of bytes to be displayed, rounded to the next multiple of 4.
    Default:
    16 bytes.
Expansion of memory-specification-3
  • + hex-offset
    Identifies a location in memory as a hexadecimal offset from the requested starting location.
    Default:
    0 (zero).
    If an
    indirect-address
    is not specified, the offset identifies the start of the memory to be displayed.
    If an
    indirect-address
    is specified, the offset identifies a location whose content is an address.
  • indirect-address
    Indicates that the location in memory identified by the previous parameters contains an address that is to be used in identifying the memory to display.
    The last indirect-address specified identifies the start of the memory to display.
  • byte-count
    Specifies the number of bytes to be displayed, rounded to the next multiple of 4.
    Default:
    16 bytes.
Expansion of indirect-address
  • %
    Indicates that the location in memory identified by the preceding parameters is an address of a location of memory.
  • + hex-offset
    Identifies a location in memory as a hexadecimal offset from the indirectly addressed location.
Expansion of program-specification
  • dictnode
    Optional. Specifies the DDS node that controls the data dictionary from where the named program was loaded.
  • dictname
    Optional. Specifies the alternate data dictionary from where the named program was loaded.
    Although dictnode and dictname are both optional parameters, if dictnode is specified and dictname is not specified, a period must be used to represent the missing dictname parameter.
  • program-name
    Identifies the name of a program or nucleus module that resides in the DC/UCF address space.
  • Version
    version-number
    Specifies the version number of the named program.
    Default:
    1
    Limits:
    1 - 9999
Usage
Unspecified search domain
If you do not specify a search domain (that is, ADDR, LTE, or TASKID) on the STR search string option, the domain of the search is defined by the bounds of the DC/UCF region.
Examples
Example Display Memory Outputs
The following example illustrates displaying the DPR control block for an area.
DCMT D MEM AREA EMPDEMO.EMP-DEMO-REGION                                      <Addr>   <Offset>                 <Hex>                    <Character>      36F11598  00000000  D7D9F6F0 1080C5D4 D7C4C5D4 D64BC5D4  *PR60..EMPDEMO.EM*  36F115A8  00000010  D760C4C5 D4D660D9 C5C7C9D6 D5404040  *P-DEMO-REGION   *  36F115B8  00000020  40016632 8F8AA1D5 C0000000 000124F9  * ......N{......9*  36F115C8  00000030  0001255C 0000FF08 00000000 0000084A  *...*...........¢*  36F115D8  00000040  36F11778 36F116F8 36F116C8 36F11168  *.1...1.8.1.H.1..*  36F115E8  00000050  36F11778 00000000 0000FF03 00010000  *.1..............*  36F115F8  00000060  00000000 00000000 00000000 36F11598  *.............1.q*  36F11608  00000070  36F11598 03030000 0000C008 36F116F8  *.1.q......{..1.8*  36F11618  00000080  36F116C8 00000000 00000000 00000000  *.1.H............*  36F11628  00000090  00000000 00000000 00000000 00000000  *................*  36F11638  000000A0  00000000 00000000 00000000 00000000  *................*  36F11648  000000B0  00000000 00000000 00000000 40800000  *............ ...*  36F11658  000000C0  00000000 00000000 00000000 00000000  *................*  36F11668  000000D0  00000000 00000000 00000000 00000000  *................*  36F11678  000000E0  00000000 00000000 00000000 00000000  *................*  36F11688  000000F0  00000000 00000000 00000000 00000000  *................*  36F11698  00000100  00000000 C5D4D760 C4C5D4D6 60D9C5C7  *....EMP-DEMO-REG*  36F116A8  00000110  C9D6D540 40400000 40000000 00000000  *ION   .. .......*  36F116B8  00000120  00000000 00000000 00000000 00000000  *................* 
The following example illustrates the use of indirect addressing to display the first file associated with an area:
DCMT D MEM AREA EMPDEMO.EMP-DEMO-REGION +44 % +10 % 200                     <Addr>   <Offset>                 <Hex>                    <Character>     36F111A8  00000000  C6C3F5F9 0190C5D4 D7C4C5D4 D64BC5D4  *FC59..EMPDEMO.EM* 36F111B8  00000010  D7C4C5D4 D6404040 40404040 40404040  *PDEMO           * 36F111C8  00000020  40016632 8F8AA1D5 C0C5D4D7 C4C5D4D6  * ......N{EMPDEMO* 36F111D8  00000030  40000000 000010B4 00000064 40404040  * ...........    * 36F111E8  00000040  40404040 40404040 40404040 40400000  *              ..* 36F111F8  00000050  36F112F8 36F112F8 36F116F8 36F0CD48  *.1.8.1.8.1.8.0..* 36F11208  00000060  00000000 36F11168 00000000 00000000  *.....1..........* 36F11218  00000070  00000000 00000000 00000000 00000000  *................* 36F11228  00000080  00000000 00000000 36F112A8 00000000  *.........1.y....* 36F11238  00000090  00000000 00000000 00000000 00000000  *................* 36F11248  000000A0  36F116F8 00000000 00000000 36F112F8  *.1.8.........1.8* 36F11258  000000B0  00000000 08180000 00000001 00000000  *................* 36F11268  000000C0  00000000 36F1D490                    *.....1M.