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
thecommand is returned to the user's virtual storage area; otherwise,
it is at the user'sterminal. A completion code is returned to the user
as a value in the register specified asBy. In the exaaple above, it
would be register10. 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
errormessage 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 ano-ope If
Ry contains a zero, CP is entered. The BEGINcoamand 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, andexaaining 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 functioncoaaand (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 norBy 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 thenumber of response characters returned
user's buffer is returned inBy.1. code is
in theI 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
the
it is at the user's
as a value in the register specified as
would be register
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
If a CP coamand is to be executed, the instruction acts as a
Ry contains a zero, CP is entered. The BEGIN
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
response (contents of the buffer). To have the response returned in the
buffer, the user sets up registers as follows:
response.
Ry contains the length of the CP console function
132 characters)
Ry+1 contains the length of the response buffer (a positive nuaber
not greater than 8192).
Neither Rx nor
registers.
the following successful or unsuccessful conditions set:
set to zero and the
user's buffer is returned in
in the