gtpc2m67C/C++ Language Support User's Guide

serrc_op-Issue System Error: Operational

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