The DCMT DISPLAY MEMORY command was enhanced to give you the following capabilities:
These capabilities make it easier for you to locate areas of interest when diagnosing a problem. The enhancements also facilitate the inclusion of DCMT DISPLAY MEMORY commands in UCF batch scripts because they can be independent of the absolute address of the area you need to display.
The DCMT DISPLAY MEMORY command was enhanced to display portions of the DMCL and support indirect addressing.
The following diagram shows the complete syntax for the enhanced DCMT DISPLAY MEMORY command:
►►─ 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 ─────────────────┘
This section describes the new parameters that support the enhancements to the DCMT DISPLAY MEMORY command:
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 Guide.
Identifies an area of memory to display.
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.
Provides additional information about the location and length of the memory to display.
Provides additional information about the location and length of the memory to display.
Provides additional information about the location and length of the memory to display.
Displays memory content beginning at the start of the DMCL's DM58 control block.
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.
Identifies the area whose DPR control block is to be displayed. segment.area-name must identify a physical area included in the DMCL.
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.
Identifies the file whose FCB control block is to be displayed. segment.file-name must identify a file included in the DMCL.
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.
Identifies the journal whose JCB control block is to be displayed. journal-name must identify a journal included in the DMCL.
Displays memory content beginning at the start of the SEG (SG49) control block for the named segment.
Identifies the segment whose SEG control block is to be displayed. segment must identify a segment included in the DMCL.
Displays memory content beginning at the specified hexadecimal offset from the requested starting location.
Default: 0 (zero)
Specifies the number of bytes to be displayed, rounded to the next multiple of 4.
Default: 16 bytes
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.
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.
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.
Specifies the number of bytes to be displayed, rounded to the next multiple of 4.
Default: 16 bytes.
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.
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.
Specifies the number of bytes to be displayed, rounded to the next multiple of 4.
Default: 16 bytes.
Indicates that the location in memory identified by the preceding parameters is an address of a location of memory.
Identifies a location in memory as a hexadecimal offset from the indirectly addressed location.
Specifies the DDS node that controls the data dictionary from where the named program was loaded.
Specifies the alternate data dictionary from where the named program was loaded.
Note: Although dictnode and dictname are both optional parameters, if dictnode is specified and dictname is not specified, a “.” (period) must be included to represent the missing dictname parameter.
Identifies the name of a program or nucleus module that resides in the DC/UCF address space.
Specifies the version number of the named program.
Limits: 1 - 9999
Default: 1
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.
|
Copyright © 2010 CA.
All rights reserved.
|
|