Previous Topic: DCMT DISPLAY MEMORY Command SyntaxNext Topic: DCMT DISPLAY MEMORY Command Usage


DCMT DISPLAY MEMORY Command 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 Guide.

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

Specifies the DDS node that controls the data dictionary from where the named program was loaded.

dictname

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.

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.

Limits: 1 - 9999

Default: 1

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.