VMDUMP utility routine

A special VM2000 dump containing the relevant VM2000 data in convenient list form can be generated for the diagnosis of VM2000 errors. The VMDUMP utility routine is used to generate a VM2000 dump. The VM2000 dump is not required for regular operation of VM2000.

VMDUMP generates a VM2000 dump of the data of the current overall VM2000 system.

	On SU /390, the VM2000 dump contains the data of the VM2000 monitor as well as the data of the VM2000 hypervisor.
	On SU x86, the VM2000 dump contains only the data of the VM2000 monitor. It does not contain data of the Xen hypervisor or domain 0 (X2000).

Execution of VMDUMP as a separate program

To call VMDUMP as a separate program, the following operations are necessary:

1. The VMDUMP program is called by TSOS with /START-VMDUMP.

   VMDUMP can also be called by TSOS with /START-EXECUTABLE-PROGRAM FROM-FILE=$<userid>.SYSPRG.VM2000-UTIL.<ver>, if the user id <userid> under which the VM2000 dump is installed is known.

2. The input for VMDUMP is requested by the following message on the screen:

   ENTER VM2000 DUMP-COMMAND (H=HELP, A=APPLICATION HINTS, E=END)

3. The permissible VMDUMP input and its functions can be listed on the screen by entering H[ELP].

         VM2000 D U M P  -  C O M M A N D S
         ----------------------------------
   A            OUTPUT APPLICATION INSTRUCTIONS FOR DUMP
   B            PRINT DESCRIPTION OF DUMP OUTPUT
   C  <TEXT>    INSERT COMMENTARY LINE IN SYSLST
   D            PROCESS DUMP DATA OF CURRENT SESSION
   E / END      TERMINATE THE PROGRAM
   H / HELP     REQUEST INFORMATION ON VM2000 DUMP COMMANDS
   S            REQUEST STATUS INFORMATION ON VM2000 TRACE

4. The desired command can be input after the following output is displayed:
   ENTER VM2000-DUMP-COMMAND ...

5. The A command supplies notes on the use of VMDUMP.

   VM2000 D U M P  INSTRUCTIONS
   ----------------------------
    1) ERROR REPETITION (TEST PRIVILEGE (8.8))
      - DETERMINE VM2000 TRACE STATUS USING COMMAND "S"
      - SET DESIRED TRACE USING /MODIFY-VM-ATTRIBUTES
      - REPEAT ERROR
      - PRODUCE DUMP (SYSLST) USING COMMAND "D"
      - WITH INTERNAL TESTING: OUTPUT DUMP DESCRIPTION (IN
        GERMAN ONLY) USING COMMAND "B"
      - PRINT DUMP USING "/PRINT *SYSLST" AND SEND IT TO CUSTOMER
        SERVICE DEPARTMENT TOGETHER WITH CONSOLE LOG
    2) DUMP OF RUNNING SYSTEM (TEST PRIVILEGE (8,1))
      - COMMAND "D" PRODUCES DUMP; PRINT *SYSLST
   

6. The E[ND] statement terminates the VMDUMP program.

Automatic VMDUMP

In the event of errors, VM2000 automatically calls the VMDUMP utility to generate a VM2000 dump. The file with the VM2000 dump is given the name $SYSDUMP.SYS.VMDUMP.LST.VM<n>.<date>.<time>, where <n> is the index of the VM causing the error, or 0 if it is a VM2000 hypervisor error (on SU /390).

To permit VMDUMP to alter its test privilege without the consent of the operator when an automatic VM2000 dump is created, the user attribute TEST-OPTIONS, MODIFICATION should have the value *UNCONTROLLED for the TSOS user ID. This is also the default value for the TSOS user ID. See the MODIFY- and SHOW-USER-ATTRIBUTES commands in the "Commands" manual [13]).

The automatically generated VM2000 dump is an important component of the diagnostic documents.

You can view the VMDUMP file with the /SHOW-FILE command or the editor, or you can print it out on a standard printer using the following command:

/PRINT-DOCUMENT <filename>,LINE-SPACING=*BY-EBCDIC-CONTROL

The automatic VMDUMP is generated in the following cases:

• Errors in the VM2000 monitor (message: VMS2014)

• Errors in $VMCONS

On SU /390, the automatic VMDUMP is also generated in the case of:

• Undefined VM2000 errors in the VM2000 hypervisor (without a message)

• Errors in the hardware (message: VMS0017)

On SU /390, the diagnostic data of the VM2000 hypervisor is also contained in the SLED of a guest system (dump file section VM2HYPVS).