addsev(3C)    27 Jan 1992 (C Programming Language Utilities)     addsev(3C)

NAME
     addsev - define additional severities

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

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

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

     Passing a NULL string removes the severity.

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

RETURN VALUE
     addsev() returns 0 in case of success, -1 otherwise.

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

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(3C), lfmt(3C), pfmt(3C).














Page 1                       Reliant UNIX 5.44                      1, 1927