addseverity(3C)                                             addseverity(3C)

NAME
     addseverity - build a list of severity levels

SYNOPSIS
     #include <fmtmsg.h>

     int addseverity(int severity, const char *string);

DESCRIPTION
     The addseverity() function builds a list of severity levels for an
     application to be used with the message formatting facility, fmtmsg().
     severity is an integer value indicating the seriousness of the condi-
     tion, and string is a pointer to a string describing the condition.
     This string is not limited to any particular size.

     If addseverity() is called with an integer value that has not been
     previously defined, the function adds that new severity value and
     print string to the existing set of standard severity levels.

     If addseverity() is called with an integer value that has been previ-
     ously defined, the function redefines that value with the new print
     string. Previously defined severity levels may be removed by supplying
     the NULL string. If addseverity() is called with a negative number or
     an integer value of 0, 1, 2, 3, or 4, the function fails and returns
     -1. The values 0-4 are reserved for the standard severity levels and
     cannot be modified. Identifiers for the standard levels of severity
     are:

     MMHALT
          indicates that the application has encountered a severe fault and
          is halting. Produces the print string HALT.

     MMERROR
          indicates that the application has detected a fault. Produces the
          print string ERROR.

     MMWARNING
          indicates a condition that is out of the ordinary, that might be
          a problem, and should be watched. Produces the print string WARN-
          ING.

     MMINFO
          provides information about a condition that is not in error. Pro-
          duces the print string INFO.

     MMNOSEV
          indicates that no severity level is supplied for the message.

     Severity levels may also be defined at run time using the SEVLEVEL
     environment variable [see fmtmsg(3C)].





Page 1                       Reliant UNIX 5.44                Printed 11/98

addseverity(3C)                                             addseverity(3C)

EXAMPLES
     When the function addseverity() is used as follows:

          addseverity(7,"ALERT")

     the following call to fmtmsg():

          fmtmsg(MMPRINT, "UX:cat", 7, "invalid syntax", \
          "refer to manual", "UX:cat:001")

     produces:

          UX:cat: ALERT: invalid syntax
          TO FIX: refer to manualUX:cat:001

RESULT
     addseverity() returns MMOK on success or MMNOTOK on failure.

SEE ALSO
     fmtmsg(1), fmtmsg(3C), gettxt(3C), printf(3S).


































Page 2                       Reliant UNIX 5.44                Printed 11/98