addsev(3C)                                                addsev(3C)


       NAME
             addsev - define additional severities

       SYNOPSIS
             #include <pfmt.h>
             int addsev(int int_val, const char *string);

       DESCRIPTION
             The function addsev defines additional severities for use in
             subsequent calls to pfmt.  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, string will be used as the severity.

             Passing a NULL string removes the severity.

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

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

       USAGE
                   #define Panic     5
                   setlabel("APPL");
                   setcat("my_appl");
                   addsev(Panic, gettxt(":26", "PANIC"));
                   /* ... */

             will display the message to stderr and forward to the logging
             service:

       REFERENCES
             gettxt(1), pfmt(3C)

       NOTICES
             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.





                           Copyright 1994 Novell, Inc.               Page 1