ADDSEVERITY(3C-SVR4)RISC/os Reference Manual ADDSEVERITY(3C-SVR4)



NAME
     addseverity - build a list of severity levels for an appli-
          cation for use with fmtmsg

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 condition, and string is a pointer to
     a string describing the condition (string is not limited to
     a specific 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
     previously 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:

          MM_HALT       indicates that the application has
                        encountered a severe fault and is halt-
                        ing.  Produces the print string HALT.

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

          MM_WARNING    indicates a condition that is out of the
                        ordinary, that might be a problem, and
                        should be watched.  Produces the print
                        string WARNING.

          MM_INFO       provides information about a condition
                        that is not in error.  Produces the print
                        string INFO.

          MM_NOSEV      indicates that no severity level is sup-
                        plied for the message.




                        Printed 11/19/92                   Page 1

ADDSEVERITY(3C-SVR4)RISC/os Reference Manual ADDSEVERITY(3C-SVR4)



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

EXAMPLES
     When the function addseverity is used as follows:
          addseverity(7,"ALERT")
     the following call to fmtmsg:
          fmtmsg(MM_PRINT, "UX:cat", 7, "invalid syntax", "refer
          to manual", "UX:cat:001")
     produces:
          UX:cat: ALERT: invalid syntax
          TO FIX: refer to manual   UX:cat:001

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

DIAGNOSTICS
     addseverity returns MM_OK on success or MM_NOTOK on failure.





































 Page 2                 Printed 11/19/92