gtpc2m67 | C/C++ Language Support User's Guide |
This function causes a storage dump to be issued by the system error
routine, and may optionally display a message at prime CRAS. The entry
control block (ECB) may be exited, if desired.
Format
#include <tpfapi.h>
void serrc_op(enum t_serrc status, int number, const char *msg,
void *slist[]);
- status
- The status of the ECB following the dump. This argument must belong
to enumeration type t_serrc, which is defined in
tpfapi.h. Code the defined term SERRC_EXIT
to force the ECB to exit, SERRC_RETURN to cause a return to the
calling program, or SERRC_CATA to cause a catastrophic
error.
- number
- The identification number for the dump. This argument is an integer
and should be a unique number ranging from 1 to X'FFFFFF'. This
number is prefixed with a U. If you want to control the character that
is used as a prefix, use serrc_op_ext.
- msg
- This argument is a pointer to type char, which is a message
text string to be displayed at the CRAS console and appended to the
dump. This string must be terminated by a \0 and must not exceed 255
characters. Strings longer than 255 characters are truncated at the
255th character. If no message is desired, code the defined term
NULL.
- slist
- This argument is a pointer to an array of pointers to type
void, indicating extra areas of storage that are to be displayed on
the dump. See TPF General Macros for a
detailed explanation of slist format and effects. If no
storage list exists, code this parameter as NULL.
Normal Return
Void.
Error Return
Not applicable.
Programming Considerations
None.
Examples
The following example forces a storage dump bearing ID number U012345 (U is
the default prefix) to be issued, with control returning to the program
following the dump. The message, ERROR OCCURRED, is displayed at the
prime CRAS and will be appended to the dump.
#include <tpfapi.h>
·
·
·
serrc_op(SERRC_RETURN,0x12345,"ERROR OCCURRED",NULL);
Related Information