SNAPCTL parameter

Summary

Default value

At initialization only:

Hex setting	Bits summed
X '41' (z/VM)	Bits X '01' and X '40'
X '44' (z/OS, z/VSE)	Bits X '04' and X '40'

Parameter type

System

Where set

On User 0's parameter line or reset by system manager

Related products

All

Introduced

Model 204 V6.1 or earlier

Description

The snap and dump action Model 204 takes when a snap is produced

The table below shows the basic settings of SNAPCTL with their associated actions. The top four actions (X '80' through X '10') are the snap options, and the next four actions (X '08' through X '01') are the dump options.

As explained below the table, any SNAPCTL specification actually results in both a snap action and a dump action, because Model 204 adds a default snap or dump action to your specification.

Snap and dump settings

Hex	Dec	Action
X '80'	128	Do not produce a snap
X '40'	64	Snap whatever the individual message specifies
X '20'	32	Snap PDL (pushdown list)
X '10'	16	Produce a complete formatted snap
X '08'	8	Do not produce a dump
X '05'	5	Enable an asynchronous dump
X '04'	4	Dump whatever the individual message specifies
X '02'	2	Dump whatever the individual message specifies and spin off SNAPs (z/OS)
X '01'	1	Produce a complete region dump
X '00'	0	Do not produce a dump

SNAP and dump half-bytes

The above table is divided into the hexadecimal and decimal settings corresponding to the first (left) four bits of the SNAPCTL value byte, the second four bits, and the special case, zero.

One SNAPCTL byte, divided into a first half-byte and a second half-byte, controls both the snap action and the system dump action. Your specification for SNAPCTL activates both a snap action and an operating system dump action.

The first SNAPCTL half-byte controls the snap action, and the second half-byte controls the dump action, as shown below.

Including half-byte defaults

The SNAPCTL default takes effect at initialization. If you set or reset SNAPCTL, Model 204 overrides the initialization default and replaces it with separate defaults for each SNAPCTL half-byte. X '40' is the snap half-byte default; X '04' is the dump half-byte default.

The default for a half-byte takes effect only if your SNAPCTL setting includes none of the bits of that half-byte. For example, if you specify SNAPCTL=X '08', you are including none of the snap half-byte bits. Model 204 sets the X '08' dump action ("no dump") and includes the snap half-byte default action (X '40', "Snap whatever the message specifies").

Your specification of X '08' is translated to X '48'. When a snap is called for, Model 204 snaps whatever the message specifies and produces no dump. If you VIEW SNAPCTL, Model 204 displays:

SNAPCTL X'48' SNAP/DUMP OPTIONS

Similarly, if you specify SNAPCTL=X '20', Model 204 sets the X '20' snap action ("snap PDL") and includes the dump half-byte default action (X '04', "dump whatever the message specifies"). Your specification of X '20' is translated to X '24'. If you VIEW SNAPCTL, Model 204 displays:

SNAPCTL X'24' SNAP/DUMP OPTIONS

If you specify a SNAPCTL setting that includes bits from both half-bytes, neither half-byte default action is automatically included. For example, if you specify SNAPCTL=X '41', Model 204 combines the X '40' action ("snap whatever the message specifies") and the X '01' action (region dump). If you VIEW SNAPCTL, Model 204 displays:

SNAPCTL X'41' SNAP/DUMP OPTIONS

You cannot specify a combination of two snap half-byte bits or two dump half-byte bits. With one exception, the bit settings within each half-byte are mutually exclusive. For example, if you specify SNAPCTL=X '60' (X '40' plus X '20'), you get an error message stating that conflicting attributes prevent the resetting of SNAPCTL.

X '02' is the only bit setting that you can combine with other bits in its half-byte. For example, if you specify SNAPCTL=X '43', you get the combined actions of X '02', X '01', and X '40'.

Special settings

The following SNAPCTL settings require further comment.

SNAPCTL setting	Comments...
X '00'	The zero bit is treated as if it belongs to the dump half-byte. Specifying SNAPCTL=X '00' is equivalent to specifying SNAPCTL=X '08'.
X '02'	Under only z/OS, you can spin off a snap. Spinning off a snap means dynamically allocating the snap to SYSOUT, making output available immediately rather than waiting for the end of the run.
X'05'	Under only z/OS, you can enable a complete region asynchronous dump. See "Asynchronous dump option for Z/OS" below for details.
X '20'	If SNAPCTL=X '20', Model 204 takes a snap of the registers, module link map, allocated storage map, pushdown list trace, KOMM, disk buffers containing Model 204 file pages held by the current user (maximum of 4), and patch information. See SNAPPDLX: PDL SNAP extender if you are having Horizon thread problems.

Asynchronous dump option for z/OS

You can generate asynchronous SVC dumps and write to SYS1.DUMP data sets on Model 204 ABENDs. Model 204 continues as soon as the pages are copied to the DUMPSERV address space. All physical I/O is done from DUMPSERV, which frees the Online system sooner.

You can enable the asynchronous dump by specifying SNAPCTL=X'05', which is a separate setting that produces a complete region asynchronous dump.

WARNING: Familiarize yourself with the memory requirements of the asynchronous dump process to ensure that enough expanded and page space is available. Memory shortage can cause severe system degradation while an asynchronous dump is processing the DUMPSERV address space. If you use this setting and you have not properly configured the DUMPSERV memory requirements, you risk locking your z/OS system.

If the dump is not taken, due to suppression by Dump Analysis Elimination (DAE) or an z/OS problem, the following IBM error message is written to the operator:

'DUMP FAILED - REASON XX'

The reason codes are listed in the SDUMPX macro in the z/OS Auth Assm Service Reference LLA-SDU. The number of the manual varies according to the release of z/OS.

Comparing snapCTL to MSGCTL

The SNAPCTL parameter settings correspond to the following MSGCTL command options:

SNAPCTL setting	MSGCTL option
1	DUMPALL
8	NODUMP
16	SNAPALL
32	SNAPPDL
128	NOSNAP