SNAP Function

#### Search Results

Search

# 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: a fullword containing the length of the area; a fullword containing the starting address of the area; 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.