LA 6,C!!D LA 10,C!!DL DC X'83',X'61',XL2'OOOS' C!!D DC C!!DL EQU C'QUEBY FILES' *-C!!D If the high-order byte of the Ry register is an X'40', the output of
the command is returned to the user's virtual storage area; otherwise,
it is at the user's terminal. A completion code is returned to the user
as a value in the register specified as By. In the exaaple above, it
would be register 10. A completion code of 0 signifies noraal
coapletion. If there is an error, the coapletion code is the binary
value of the nuaeric portion of the error aessage. For instance, the
error message D!KCF!045E userid NOT LOGGED ON returns "045" in the By register. The condition code reaains unchanged.
If a CP coamand is to be executed, the instruction acts as a no-ope If
Ry contains a zero, CP is entered. The BEGIN coamand then returns
control to your prograa.
The user can have the response returned in a buffer rather than to his
console. He is entirely responsible for setting up the buffer,
providing the buffer address, and exaaining and processing the returned
response (contents of the buffer). To have the response returned in the
buffer, the user sets up registers as follows: Rx contains the virtual address of the CP console functions command and paraaeters. Rx.1 contains the virtual address of the buffer to receive the
response.
Ry contains the length of the CP console function coaaand (up to
132 characters) with an X'40' in the high-order byte.
Ry+1 contains the length of the response buffer (a positive nuaber
not greater than 8192).
Neither Rx nor By can be register 15; Bx and Ry cannot be consecutive
registers. When returned in a buffer, the DIAGNOSE code X'08' output will also have
the following successful or unsuccessful conditions set: I I If the response fits into the user's buffer, the condition
set to zero and the number of response characters returned
user's buffer is returned in By.1. code is
in the I I. If the response does not fit in the user'S buffer, the condition code I is set to one, and the aaount of overflow (number of response bytes I that would not fit in the user's buffer) is returned in register I By.1. 1-52 IBM VM/370 System Logic and Problem Deteraination--Voluae 1
Execution of DIAGNOSE code X'OC' causes CP to store four doublewords of
time information in the user's virtual storage. The register specified
as Rx contains the address of the 32-byte area where the time information is to be stored. The address must be on a doubleword
boundary.
The first eight bytes contain the month/day-of-month/year. The next
eight bytes contain the time of day in hours:minutes:seconds.
One-hundredths of seconds are not returned. The last 16 bytes contain
the virtual and total processor time used by the virtual machine that
issued the DIAGNOSE. These times are expressed as doubleword, unsigned
integers, in microseconds. No completion code is returned, and the
condition code reaains unchanged. Pages of virtual storage can be released by issuing a DIAGNOSE code X'10'. When a page is released, it is considered all zero. The
register specified by Rx contains the address of the first page to be
released, and the Ry register contains the address of the last page to
be released. Both addresses must be on page boundaries. 1 page
boundary is a storage address whose low-order three digits, expressed in
hexadecimal, are zero. No completion code is returned, and the
condition code remains unchanged. !Qte: DIAGNOSE code X'10' is not to be used to release discontiguous
storage. See DIAGNOSE code X'64' for releasing discontiguous storage.
Execution of DIAGNOSE code X'14' causes D!KDRDER to perform input spool
file manipulation. Depending upon the value of the function subcode,
the register specified as Rx contains a buffer address, a copy count, or
a spool file identifier. The Ry register, which must be an even
register, contains either the virtual address of a spool input card
reader or, if Ry.1 contains X'OFFF', a spool file ID number. Ry+1
contains a hexadecimal code indicating the file manipulation to be
performed. The codes are:
Code 0000 0004 0008 OOOC 0010 0014 0018 001C 0020 OFFF Function Read:n;xt spool buffer (data record)
Read next print spool file block (SFBLOK)
Read next punch spool file block (SFBLOK)
Select a file for processing
Repeat active file nn times
Restart active file-at beginning
Backspace one record
Read next monitor spool file block
Read next monitor spool record Retrieve subsequent file descriptor CP Introduction 1-53
Previous Page Next Page