DMCP Use the DMCP com.and to print the contents of real storage locations on
the user's virtual spooled printer. The output format is eight words
per line with EBCDIC translation. Multiple storage locations and ranges aay be specified. In a system running with an attached processor,
values that are displacements from the assigned locaticns of the Prefix Storage Area (PS!) of the main or attached processor can also be dumped. To get the output printed on the real printer, the virtual spooled
printer must be terminated with a CLOSE command. The format of the DMCP command is: DMCP MLhexloc1 NLhexloc1
MThexloc1
NThexloc1 Mhexloc1 Nhexloc1
Lhexloc1
Thexloc1
hexloc1
o
r , r , 1 MLhexloc 11 1 1 NLhexloc 11 1 IMThexloc111 r , 1 NThexloc 111{-} 1 hexloc2 I 1 Mhexloc111 : I I I Nhexloc 11 1 L .J I Lhexloc 11 1 i Thexloc 1 i i I hexloc111 I Q II L .JI r , I { } Ibytecount 1 1 1 L L [*dumpid]
specifies the first storage location to be dumped. If hexloc1
is the only operand, it specifies the cnly storage location to
be dumped. If hexloc1 is not specified, L or T must be
specified and dumping starts with storage location O. An
EBCDIC translation is included with the dump contents. If
hexloc1 is followed by a period and is not on a full word
boundary, it is rounded down to the next lover fullword.
In attached processor systems, M specifies that addresses be
interpreted as if the main processor generated them. Thus, MO refers to location 0 of the PSA of the main processor. The N operand specifies that addresses be interpreted as if the
attached processor generated the.. The absence of M or N results in' the address being interpreted as an absolute
address. N is valid only if the attached processor is
operational. M is valid if the system has been generated for
an attached processor. The prefixes M or N are not meaningful
for a uniprocessor generated system. Section 3. CP Commands 69
r , Ihexloc21 lEND I L .J
is a range of real storage locations to be dumped. To dump to
the end of real storage, hexloc2 may be specified as END or
not specified at all, in which case END is assulled by default. r , {.}Ibytecountl lEND I L .J
is a hexadecimal integer designating the number of bytes of
real storage (starting with the byte at hexloc1) to be typed
at the printer. The sua of hexloc1 and the bytecount must be
an address that does not exceed the size of real storage. If
this address is not on a fullword boundary, it is rounded up
to the next higher fullword. If the "." is used for a range,
hexloc2 is defined as the number of hexadecimal storage
locations (in bytes) to be dumped starting at hexloc1. If
hexloc2 is specified as a length in this way, it must have a
value such that when added to hexloc1 it will not exceed the
storage size. *dumpid is specified for identification purposes. If specified, it becomes the first line printed preceding the dump data. Up to 100 characters with or without blanks may be specified after
the asterisk prefix. If du.pid is specified, hexloc2 or
bytecount must be specified. The asterisk (*) is required to
identify the dumpid.
1. Normally, a user defines beginning and ending dump locations in the
following manner: 70 dmcp Lhexloc-hexloc
or --
There must not be any blanks between length or range symbols (: or
- or .) or between any of the operands except for the blank(s)
between the command and the first operand. A blank is also
required between each set of operands when more than one set of
operands are entered. Note that only one period (.), colon (:),
dash (-) or no delimiter may be used within each set of operands.
If, however, a blank immediately follows the designated type
character, the default dump starting and ending locations are assumed to be the beginning and/or end of virtual storage.
Similarly, if the range or length symbol separates the first
character froll a blank or END, all of real storage is dumped. Blanks separate operands or sets of operands if more than one
operand is entered on the same command line. Blanks should not
occur on the right or left of the range or length symbol, unless it
is intended to take the default value of the missing operand
defined by the blank. Thus, all of the following produce full
storage dumps. Vft/370 Operator's Guide
Previous Page Next Page