| Standards / Extensions | C or C++ | Dependencies |
|---|---|---|
| Language Environment | both |
#include <ctest.h>
int csnap(char *dumptitle);Creates a display of the activation stack, including the Dynamic Storage Area (DSA), for each presently active function. Other environmental control blocks that may be required by IBM® Service are also displayed. Under Language Environment, these consist of the Common Anchor Area (CAA) and the z/OS® XL C/C++ CAA information. The output is identified with dumptitle. See the CEE3DMP Language Environment callable service in z/OS Language Environment Programming Guide, to determine where the output is written to.
To avoid infringing on the user's name space, this nonstandard function has two names. One name is prefixed with two underscore characters, and one name is not. The name without the prefix underscore characters is exposed only when you use LANGLVL(EXTENDED).
To use this function, you must either invoke the function using its external entry point name (that is, the name that begins with two underscore characters), or compile with LANGLVL(EXTENDED). When you use LANGLVL(EXTENDED) any relevant information in the header is also exposed.
If successful, csnap() returns 0.
If unsuccessful, csnap() returns nonzero.
#include <ctest.h>
int main(void) {
int rc;
rc = csnap("Sample csnap output");
}