addsev(3C)                     DG/UX 5.4R3.00                     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
       subsequent 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 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("myappl");
            addsev(Panic, gettxt(":26", "PANIC"));
            /* ... */
            lfmt(stderr, MMSOFT|MMAPPL| 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).















Licensed material--property of copyright holder(s)                         1