addseverity(3C)      COMPATIBILITY FUNCTIONS      addseverity(3C)



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  rede-
     fines  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 halt-
                        ing.  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 WARNING.

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

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

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



                Last change: Essential Utilities                1

addseverity(3C)      COMPATIBILITY FUNCTIONS      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 manual   UX:cat:001

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

DIAGNOSTICS
     addseverity returns MMOK on success or MMNOTOK on failure.








































                Last change: Essential Utilities                2