DUMPGDG

Description

Controls whether or not dumps should be written to a GDG data set through UNIX services.

This parameter is applicable to the SYSTEM control statement (see SYSTEM statement).

Format

DUMPGDG [Yes|No|ON|OFF]
   DUMPBASE gdgbasename
   DUMPUNIT unitdevicetype
   DUMPSMSCLS smsdataclass
   DUMPPSPACE numberofcylinders
   DUMPSSPACE numberofcylinders

Default: DUMPGDG No

Usage

If set to Yes or ON the parameter specifies that dumps should be written to a GDG data set through UNIX services.

When an abend occurs, a UNIX call will be made to clone the address space. The cloned child will then allocate the (+1) generation level data set within the GDG and write a SNAP dump to it. If a failure is encountered during this then an error message will be issued and a dump will be taken to spool using the normal non-GDG method. Note that, because this dump will be taken in a UNIX cloned address space, it will have the UNIX name BPXAS on the spool. The header line of the SNAP dump, however, will contain the name of the parent address space.

When a dump is taken, message 133 will be issued. Because the UNIX call is almost instantaneous, we recommend adding an INFORM group to message 133 so that the necessary people are informed that an ABEND has occurred.

The Dump GDG will be allocated as a variable blocked (VB) data set with a record length of 125 and a block size of 1632. If a failure is encountered whilst writing out the dump then an error message will be issued and a dump will be taken using the normal non-GDG method.

Subparameters

Subparameters under the DUMPGDG parameter are:

DUMPBASE gdgbasename

Default: None.

This is a mandatory subparameter if DUMPGDG is set to Yes. This specifies the dump GDG base name which forms the prefix of the dump GDG data set name to be allocated during IBM Session Manager dump taking - that is, DSN=gdgbasename(+1).

gdgbasename specified must be 1 to 35 characters in length.

DUMPUNIT unitdevicetype

Default: SYSDA

This specifies the type of device upon which the dump GDG data set will reside. Must be between 1 and 8 characters in length.

DUMPSMSCLS smsdataclass

Default: None

This specifies the SMS data class if the dump GDG is SMS-managed. This must be between 1 and 8 characters in length.

DUMPPSPACE numberofcylinders

Default: 50

This specifies the primary space allocation, in cylinders, to assign to the dump GDG data set. This must be a numeric value between 1 and 999.

DUMPSSPACE numberofcylinders

Default: 5

This specifies the secondary space allocation, in cylinders, to assign to the dump GDG data set. This must be a numeric value between 1 and 999.

Parent topic:

Related topics: