references to main storage from either processor are handled as if they were made
on the IPL processor. Existing user programs remain valid for performance data;
they receive the statistics for the main (or IPL) processor.
References to the PSA of the attached processor (or non-IPL processor, in multi
processor mode) may be made as follows: first, retrieve the value of PREFIXB,
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 of PREFIXB and
the PSA displacement. References to0 through 4095 are made by summing the
value of PREFIXA 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.
Note: If a reference is made to a real page frame that CP has determined to be
disabled, results cannot be predicted. The CaRET ABLE entry corresponding to
the real page address is checked and, if a disabled condition is found, the operation
is terminated and a program check for a specification exception is presented to the
virtual machine.DIAGNOSE Code X'08' -- Virtual Console Function
Privilege class G
DIAGNOSE CodeX'08' enables a virtual machine running in supervisor state to
issue CP commands. The virtual machine must specify the command, the com
mand parameters, and whether CP 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.
Entry values: When DIAGNOSE CodeX'08' is issued, the Rx and Ry registers
must be set up as follows:
Rx --Rx must point to the character string in virtual storage that contains the
CP commands and parameters. If the character string contains multiple com
mands, each command and its associated parameters must be separated from
adjacent commands by the value X'15'.
Ry --The high-order byte contains flag bits; the other three bytes specify, in
bytes, the length of the CP commands and parameters. The maximum allow
able length is240 characters.
Set the flag bits as follows. If CP is to reject a password entered on the same line
as a LINK command, set the high-order bit to a value of one (X'80'). CP rejects
passwords only if the installation specified password suppression during system
generation. If CP is to return the command response in a buffer, set the second
flag bit to a value of one (X'40').
Exit values: If the Ry register contains the valueX'OOOOOOOO', the DIAGNOSE
Code acts as a no-operation (NaP) instruction. As a consequence, the issuing vir
tual machine is placed into a CP-READ state.
If the command response is to be returned in a buffer, Rx and Ry cannot be con
secutive registers nor can either be register 15. In addition, the Rx+ 1 and Ry+ 1
registers must be setup as follows:
DIAGNOSE Instruction in a Virtual Machine 225
on the IPL processor. Existing user programs remain valid for performance data;
they receive the statistics for the main (or IPL) processor.
References to the PSA of the attached processor (or non-IPL processor, in multi
processor mode) may be made as follows: first, retrieve the value of PREFIXB,
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 of PREFIXB and
the PSA displacement. References to
value of PREFIXA and the PSA displacement to form the request address. Several
system values that are processor independent are maintained in
Note: If a reference is made to a real page frame that CP has determined to be
disabled, results cannot be predicted. The CaRET ABLE entry corresponding to
the real page address is checked and, if a disabled condition is found, the operation
is terminated and a program check for a specification exception is presented to the
virtual machine.
Privilege class G
DIAGNOSE Code
issue CP commands. The virtual machine must specify the command, the com
mand parameters, and whether CP 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.
Entry values: When DIAGNOSE Code
must be set up as follows:
Rx --Rx must point to the character string in virtual storage that contains the
CP commands and parameters. If the character string contains multiple com
mands, each command and its associated parameters must be separated from
adjacent commands by the value X'15'.
Ry --The high-order byte contains flag bits; the other three bytes specify, in
bytes, the length of the CP commands and parameters. The maximum allow
able length is
Set the flag bits as follows. If CP is to reject a password entered on the same line
as a LINK command, set the high-order bit to a value of one (X'80'). CP rejects
passwords only if the installation specified password suppression during system
generation. If CP is to return the command response in a buffer, set the second
flag bit to a value of one (X'40').
Exit values: If the Ry register contains the value
Code acts as a no-operation (NaP) instruction. As a consequence, the issuing vir
tual machine is placed into a CP-READ state.
If the command response is to be returned in a buffer, Rx and Ry cannot be con
secutive registers nor can either be register 15. In addition, the Rx+ 1 and Ry+ 1
registers must be setup as follows:
DIAGNOSE Instruction in a Virtual Machine 225