addseverity(3C)                                             addseverity(3C)

NAME
     addseverity - Liste mit Warnstufen erstellen

SYNTAX
     #include <fmtmsg.h>

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

BESCHREIBUNG
     Die Funktion addseverity() erstellt für eine Anwendung eine Liste mit
     Warnstufen, welche mit dem Meldungsformatierer fmtmsg() verwendet
     wird. severity ist eine ganze Zahl, die die Dringlichkeit der Bedin-
     gung angibt, und string ist ein Zeiger auf eine Zeichenkette, welche
     die Bedingung beschreibt. Die Zeichenkette ist dabei nicht auf eine
     bestimmte Länge beschränkt.

     Wenn addseverity() mit einem Zahlenwert aufgerufen wird, der vorher
     nicht definiert wurde, nimmt die Funktion diesen neuen Zahlenwert auf
     und schreibt die Zeichenkette in die bestehende Menge der Warnstufen.

     Wird addseverity() mit einem Zahlenwert aufgerufen, der vorher bereits
     definiert wurde, ordnet die Funktion diesem Zahlenwert die neue Zei-
     chenkette zu. Definierte Warnstufen können durch eine NULL-
     Zeichenkette gelöscht werden. Wenn addseverity() mit einer negativen
     Zahl oder den Werten 0, 1, 2, 3 oder 4 aufgerufen wird, schlägt die
     Funktion fehl und liefert -1 zurück. Die Werte 0-4 sind für die stan-
     dardmäßigen Warnstufen reserviert undkönnen nicht verändert werden.
     Die Bezeichner für die standardmäßigen Warnstufen sind:

     MMHALT     zeigt an, daß die Anwendung auf einen schwerwiegenden Feh-
                 ler gestoßen ist und die Bearbeitung anhält. Die Zeichen-
                 kette HALT wird ausgegeben.

     MMERROR    zeigt an, daß die Anwendung einen Fehler erkannt hat. Die
                 Zeichenkette ERROR wird ausgegeben.

     MMWARNING  zeigt an, daß ein außergewöhnlicher Zustand eingetreten
                 ist, der ein Problem darstellen könnte und daher beobach-
                 tet werden sollte. Die Zeichenkette WARNING wird ausgege-
                 ben.

     MMINFO     liefert Informationen über einen Zustand, der keinen Feh-
                 ler darstellt. Die Zeichenkette INFO wird ausgegeben.

     MMNOSEV    zeigt an, daß für die Meldung keine Warnstufe angegeben
                 wurde.

     Warnstufen können auch zur Laufzeit über die Umgebungsvariable
     SEVLEVEL angegeben werden [siehe fmtmsg(3C)].






Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

addseverity(3C)                                             addseverity(3C)

BEISPIELE
     Wird die Funktion addseverity() wie folgt verwendet:

          addseverity(7,"FEHLER")

     liefert der folgende Aufruf von fmtmsg:

          fmtmsg(MMPRINT, "UX:cat", 7, "falsche Syntax", \
          "siehe Handbuch", "UX:cat:001")

     das folgende Ergebnis:

          UX:cat: FEHLER: falsche Syntax
          TO FIX: siehe Handbuch  UX:cat:001

ERGEBNIS
     addseverity() liefert bei Erfolg MMOK und MMNOTOK bei Fehler.

SIEHE AUCH
     fmtmsg(1), fmtmsg(3C), gettxt(3C), printf(3S).


































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98