SYNTAX

#include "worgen.h"

FUNCTION c_errmsg (message, key, vrity)

     char *message;
     char *key;
     long *vrity;

PARAMETERS

message (input, character, length (ERRLEN))

Character string to be displayed. If the message cannot fit on an 80 column line it will be reformatted into multiple lines where the message is split at a "white space" character (blanks or tabs).

key (input, character, length (*))

Message key. The type of message being displayed. A null or a blank key indicates a general error. The default key for a general fatal error is "[general-error]", and the key for a general nonfatal error is "[informational]". Any other value is interpreted as a key to be used by the TAE message facility. The maximum length of a message key is 17 characters.

vrity (input, integer)

Success/Fail indicator flag. Zero or negative values indicate a fatal error and terminate the process. Positive values indicate a nonfatal condition and return control to the calling process.

DESCRIPTION

The c_errmsg() call is used to output an error message in a standard format to the terminal screen and to the TAE session log.

RETURN VALUE

c_errmsg() has no return values.