SNAP Function

The SNAP function can be used to write a thread dump of the application, without terminating the application. The purpose of this function is to help debugging applications.

Format

The format for the SNAP function is:

SNAP (retcode,header,retnumber)
retcode A fullword where Com-plete places the return code.
header address of a 77 byte character string to become the dump header. First 7 bytes are recommended to contain a message ID to be shown in UDUMP ALL (UDUMP will prefix it with "USR", indicating that this dump was produced using the SNAP function).
retnumber A fullword where the dump number is returned upon successful completion.
arealist Optional. A fullword containing the address of a list of up to six 16-byte entries describing areas of memory to be included in the dump. Each entry must be built according to the following structure:

  1. a fullword containing the length of the area;

  2. a fullword containing the starting address of the area;

  3. an eight byte character string identifying the area.

The table must be terminated by an entry with a zero length field.
Return Codes:
0 dump taken
8 no dump taken (suppressed or error)
Abends:

There are no abends expected with the normal usage of this function.