addsev(3C)                                                          addsev(3C)


NAME
     addsev - define additional severities

SYNOPSIS
     int addsev(int int_val, const char *string);

DESCRIPTION
     The function addsev defines additional severities for use in subsequent
     calls to pfmt or lfmt.  addsev associates an integer value int_val in the
     range [5-255] with a character string.  It overwrites any previous string
     association between int_val and string.

     If int_val is ORed with the flags passed to subsequent calls to pfmt or
     lfmt, string will be used as the severity.

     Passing a N.ULL string removes the severity.

     Add-on severities are only effective within the applications defining
     them.

EXAMPLE
     #define Panic     5
     setlabel("APPL");
     setcat("my_appl");
     addsev(Panic, gettxt(":26", "PANIC"));
     /* ... */
     lfmt(stderr, MM_SOFT|MM_APPL| Panic, " :12:Cannot locate database\n");

     will display the message to stderr and forward to the logging service:
          APPL: PANIC: Cannot locate database

SEE ALSO
     gettxt(1), lfmt(3C), pfmt(3C)

DIAGNOSTICS
     addsev returns 0 in case of success, -1 otherwise.

NOTES
     Only the standard severities are automatically displayed per the locale
     in effect at run time.  An application must provide the means for
     displaying locale-specific versions of add-on severities.


                                                                        Page 1