paqe of GC20-1807-7 As Updated April 1, 1981 by TNL GN25-0829
No completion code is returned, and the condition code remains
unchanged.DIAGNOSE Code X'04' -- Examine Real Storage Execution of a DIAGNOSE Code X'04' allows a user with command class C or E to examine real storage. The register specified as Rx
contains the virtual address of a list ofCP (real) addresses to be
examined. The Ry register contains the count of entries in the list.
Ry+1 contains the virtual addressof the result field. The result field
contains the values retrieved from the specified real locations.
For each address in the list ofCP addresses, VM/370 provides a
fullword of data obtained from the specified address in real storage.VK/370 stores this data into the result field identified by the Ry+1
register.
There is a one-to-one correspondence between entries in the list of
addresses and entries in the result field. For example, data obtained
from the address in the first entry of the address list is stored in the
first entry of the result field, data obtained from the second entry of
the address list is stored in the second entry of the result field, and
so forth.
Note: The request and result tables must be in the same page of virtual
storage, and that page must be resident in real storage, at the time theDIAGNOSE is executed. This is guaranteed if the instruction itself is
also in the same paqe.
In the attached processor environment, each processor has a prefix
register to relocate addresses between0 and 4095 to another page frame
in main storaqe. The prefix register enables each processor to use a
different paqe frame in order to avoid conflict with the other processor
for such activity as interrupt code recording. Thus, the range0 through 4095 refers to different areas of storage, depending upon which
processor generates the address.
All references to main storage from either processor are handled as
if they were made on the main processor. Existing user programs remain
valid for performance data; in the attached processor environment, they
receive the statistics for the main processor.
References to thePSA of the attached processor may be made as
follows: first, retrieve the value ofPREFIXB, the value of the prefix
register for the other processor (the attached processor in this case).
Next, specify addresses that are the sum of the value ofPREFIXB and the PSA displacement. References to 0 through 4095 are made by summing the
value ofPREFIXA and the PSA displacement to form the request address.
Several system values that are processor independent are maintained in0 through 4095, such as the restart PSW and the trace table vectors. DIAGNOSE Code X'08' -- Virtual Console Function DIAGNOSE Code X'08' enables a virtual machine running in supervisor
state to issueCP commands. The virtual machine must specify the
command, the command parameters, and whetherCP is to return the command
response to the user's terminal or to a buffer. In addition to
returning the command response,CP sets a completion code in the Ry
register and may set a condition code.18U IBM VM/370 Programmer's Gui1e
No completion code is returned, and the condition code remains
unchanged.
contains the virtual address of a list of
examined. The Ry register contains the count of entries in the list.
Ry+1 contains the virtual address
contains the values retrieved from the specified real locations.
For each address in the list of
fullword of data obtained from the specified address in real storage.
register.
There is a one-to-one correspondence between entries in the list of
addresses and entries in the result field. For example, data obtained
from the address in the first entry of the address list is stored in the
first entry of the result field, data obtained from the second entry of
the address list is stored in the second entry of the result field, and
so forth.
Note: The request and result tables must be in the same page of virtual
storage, and that page must be resident in real storage, at the time the
also in the same paqe.
In the attached processor environment, each processor has a prefix
register to relocate addresses between
in main storaqe. The prefix register enables each processor to use a
different paqe frame in order to avoid conflict with the other processor
for such activity as interrupt code recording. Thus, the range
processor generates the address.
All references to main storage from either processor are handled as
if they were made on the main processor. Existing user programs remain
valid for performance data; in the attached processor environment, they
receive the statistics for the main processor.
References to the
follows: first, retrieve the value of
register for the other processor (the attached processor in this case).
Next, specify addresses that are the sum of the value of
value of
Several system values that are processor independent are maintained in
state to issue
command, the command parameters, and whether
response to the user's terminal or to a buffer. In addition to
returning the command response,
register and may set a condition code.