Condition
Code
o
2
3
Meaning
Operation is successful.
Volume not found, not mounted, or not a valid directory
volume.
Fatal I/O error trying to read the directory
Diagnose Code X'40' --Clean-Up after Virtual IPL by Device I Privilege class G
This code is valid only during virtual IPL. Clean-up restores the user's page and
frees the real page if it is not in the V =R machine. If the real page is in the V =R
machine, the real page is not freed. The PSW from location zero of the virtual
machine is loaded and made the current PSW. Entry Values: Register Rx must contain a zero. Register Ry must point to the virĀ­
tual machine registers to be loaded. Usage: If the user issues a DIAGNOSE code X'40' outside of its use in DMKVMI,
a specification exception is returned. DIAGNOSE Code X'48' --Issue SVC 76 from a Second Level VM/370 or VM/SP Virtual
Machine
Privilege class G
A second level VM/370 or VM/SP operating system issues SVC 76 using this DIAGNOSE. SVC 76 handles I/O error recording for virtual operating systems.
For instance, a virtual machine issues SVC 76 to record data about hardware errors
that occur on devices dedicated to it.
Entry Values: Rl is the Rx register. The Ry register is not used in this DIAGNOSE. Rl must contain either of two values:
X'04' -indicates an SVC 76 request from a VM/370 or VM/SP virtual machine X'OS' -indicates that a VM/370 or VM/SP virtual machine issued DIAGNOSE X'4S'. Usage: CP checks first for the X'04' value. If it is present, CP sets VMSPMFLG in the virtual machine's VMBLOK to X'04' and processes the SVC 76 request on
behalf of the virtual machine.
If Rl contains a X'OS' value, CP sets VMSPMFLG in the virtual machine's
VMBLOK to X'OS'. It then reflects the SVC 76 back to the virtual machine. The
virtual machine then handles its own error recording.
For more information on SVC 76 and I/O error recording procedures, refer to
VM / SP OLTSEP and Error Recording Guide. DIAGNOSE Code X'4C' --Generate Accounting Records for the Virtual User I Privilege class G
DIAGNOSE Instruction in a Virtual Machine 243
This code can be issued only by a user with the account option (ACCT) in his
directory.
Entry Values: Rx contains the virtual address of either a 24-byte parameter list
identifying the "charge to" user, or a variable length data area that is to be stored
in the accounting record. The interpretation of the address is based on a
hexadecimal code supplied in Ry. If the virtual address represents a parameter list,
it must be double word aligned; if it represents a data area, the area must not cross
a page boundary. If Rx is interpreted as pointing to a parameter list and the value
in Rx is zeros, the accounting record is spooled with the identification of the user
issuing the DIAGNOSE instruction.
Ry contains a hexadecimal code interpreted by DMKHVC as follows:
Code Rx points to: 0000 a parameter list containing only a userid. 0004 a parameter list containing a userid and account number. 0008 a parameter list containing a userid and distribution number.
oooe a parameter list containing a userid, account number, and distribution
number. 0010 a data area containing up to 70 bytes of user information to be transferred
to the accounting card starting in column 9.
Notes:
1. For code X'0010', the only valid accounting record identification code
(ACNTCODE field of the ACNTBLOK) is "CO". For the other four codes
listed above, the accounting record identification code can be "C 1", "C02", etc. For more information on accounting record identification codes, see VM/SP Data Areas and Control Block Logic, Volume 1.
2. If Ry contains X'OO 1 0', Ry cannot be register 15.
Ry+ 1 contains the length of the data area pointed to by Rx. If Rx points to a
parameter list (Ry not equal to X'0010'), Ry+ 1 is ignored.
DMKHVC checks the VMACCOUN flag in VMPST AT to verify that the user has
the account option and if not, returns control to the user with a condition code of
one.
If Ry contains a code of X'0010', DMKHVC performs the following checks: ā€¢ If the address specified in Rx is negative or greater than the size of the user's '
virtual sturage, an addressing exception is generated. ā€¢ If the combination of the address in Rx and the length in Ry + 1 indicates that
the data area crosses a page boundary, a specification exception is generated. ā€¢ If the value in Ry+ 1 is zero, negative, or greater than 70, a specification excepĀ­
tion is generated.
244 VM/SP System Programmer's Guide
Previous Page Next Page