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: The table must be terminated by an entry with a zero length field.
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.
- 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.