CEEKSNP — produce a SNAP dump

This CWI generates a system SNAP dump of the runtime environment. Once complete, execution continues.

Syntax

void (*CEECELVKSNP) (id, reserved, [fc]);

INT4     *id;
VSTRING   *reserved;
FEED_BACK *fc;

CEECELVKSNP

Call this CWI interface as follows:

L     R15,CEECAACELV-CEECAA(,R12)   Address of CAA in R12
L     R15,3392,R15
BALR  R14,R15

id (input)

An integer in the range 0 to 255 used in an identification string within the SNAP output.

reserved (input)

A halfword-prefixed character string reserved for future use. Its value must be a zero-length character string.

fc (output/optional)

A 12-byte feedback code passed by reference. If specified as an argument, feedback information (a condition token) is returned to the calling routine. If not specified, and the requested operation was not successfully completed, the condition is signaled to the condition manager. The following symbolic conditions can result from this service:

Condition
CEE000	Severity	0
	Msg_No	N/A
	Message	The service completed successfully.
CEE33R	Severity	1
	Msg_No	3195
	Message	The SNAP dump file could not be opened.
	Explanation	The SNAP dump file could not be opened.
	Programmer Response	If a SNAP dump was desired, determine the reason the file could not be opened and correct the problem.
	System Action	No SNAP dump was taken.
CEE33S	Severity	1
	Msg_No	3196
	Message	The ID number was not in the allowed range.
	Explanation	The ID number must be in the range 0 to 255; it was not in that range.
	Programmer Response	This is an internal problem. Contact your service representative.
	System Action	The ID number 255 was used.
CEE33T	Severity	1
	Msg_No	3197
	Message	An invalid value for reserved was passed.
	Explanation	An invalid value for the reserved argument was passed to the SNAP dump service.
	Programmer Response	This is an internal problem. Contact your service representative.
	System Action	The invalid value was ignored.
CEE33U	Severity	3
	Msg_No	3198
	Message	A SNAP dump was requested on an unsupported system.
	Explanation	The SNAP dump service was called to produce a SNAP dump on an unsupported system.
	Programmer Response	This is an internal problem. Contact your service representative.
	System Action	The SNAP dump was not produced.
CEE33V	Severity	3
	Msg_No	3199
	Message	An error was returned from the SNAP system function.
	Explanation	The SNAP system function returned an error. The SNAP dump service could not be completed.
	Programmer Response	This is an internal problem. Contact your service representative.
	System Action	The SNAP dump was not produced.

Usage Notes:

This service is not available under CICS®. Calling it when executing under CICS results in feedback code CEE33U.
The ddname used is CEESNAP. If CEESNAP is not defined then no dump is produced and CEE33R is returned.
CEEKSNP uses the SDATA=(ALL) SNAP option, which dumps items such as the PSA, SQA, SWA, I/O supervisor control blocks, and the PDATA=(ALL) SNAP option, which dumps items such as the JPA, LPA, virtual storage subpools (0-127, 252).
The contents of the SNAP dump reflects the state of the registers and memory at the time the SNAP macro is called.