SET AUTODUMP

Authorization

General User

Purpose

Use the SET AUTODUMP command to control the type of dump created by CMS in case of an abend, and when an automatic dump of the virtual machine will occur.

You can create a dump for irrecoverable CMS system abends, for all abends that occur in your virtual machine, or you can turn off the automatic dump creation.

You can choose to dump part of, or the entire, virtual machine.

Operands

OFF

indicates you do not want a dump for any abends. This is the initial setting.

CMS

indicates you want to take a dump whenever an irrecoverable CMS system abend occurs and CMS enters a disabled wait state.

ALL

indicates you want to take a dump for all abends within the virtual machine, both recoverable and irrecoverable.

ENTirevm

when specified with ALL or CMS, indicates automatic dumps will contain the following:

• The entire virtual machine
• Any saved segments the machine is currently using

In addition to the dump, any data spaces currently in use that contain SFS data are dumped (in VMDUMP format).

If ENTIREVM is not specified, the default dump will contain:

• The DMSNUC region of CMS
• The storage management work area
• The page allocation table
• The loader tables

Initial Setting

AUTODUMP OFF

Usage Notes

1. If you specify SET AUTODUMP CMS, a dump will be taken for the following irrecoverable CMS system errors:
   • Program checks within nucleus resident modules
   • Irrecoverable errors in the file system
   • Irrecoverable storage management errors
   • Errors that result in a disabled wait PSW
2. For some severe irrecoverable file system errors detected by CMS, an entire virtual machine dump will be generated unless SET AUTODUMP OFF has been specified.
3. If you specify SET AUTODUMP ALL, a dump will be taken for the errors mentioned in Usage Note 1, as well as these conditions:
   • All program checks
   • Use of the ABEND macro
   • Use of the DMSABN macro
4. If you have set AUTODUMP to ALL or CMS, the dump is produced using the CP VMDUMP facility. The dump is sent to the reader of the virtual machine where the abend occurred.
5. You can use the DUMPLOAD utility to process the dump, and the DUMPSCAN command (CMSPOINT subcommand) of the Dump Viewing Facility to view it. For more information on the DUMPLOAD utility, see z/VM: CP Commands and Utilities Reference. For more information on the Dump Viewing Facility and the DUMPSCAN command, see z/VM: Dump Viewing Facility.

Responses

'DMSABE2047I AUTODUMP dump started; please wait'

'DMSABE1297I Dump has been taken'

'DMSABE1297I Dump failed; condition code = cc; return code = rc'

'DMSDDS2047I AUTODUMP dump started for data space:
ASIT  = xxxxxxxxxxxxxx; please wait'

'DMSABE1297I Dump has been taken'

'DMSABE1297I Dump failed; condition code = cc; return code = rc'

For the list of return codes and reason codes, see the DIAGNOSE X'94' in z/VM: CP Programming Services.

Messages and Return Codes

Additional system messages may be issued by this command. The reasons for these messages and their location are: