dsmLogEventEx

Online bearbeiten

Mit dem Funktionsaufruf dsmLogEventEx wird eine Benutzernachricht in der Serverprotokolldatei und/oder im lokalen Fehlerprotokoll protokolliert. Dieser Aufruf muss während des Zustands InSession innerhalb einer Sitzung ausgeführt werden. Der Aufruf kann nicht in einem Sende-, Abruf- oder Abfrageaufruf durchgeführt werden.

Zusammenfassungszustandsdiagramm: Eine Übersicht über die Sitzungsinteraktionen finden Sie im Zusammenfassungszustandsdiagramm im folgenden Abschnitt:

Abb. 1

Die Wertigkeit bestimmt die Nachrichtennummer für IBM® Storage Protect . Um auf dem Server protokollierte Nachrichten anzuzeigen, verwenden Sie den Befehl query actlog über den Verwaltungsclient. Verwenden Sie die IBM Storage Protect-Client-Option errorlogretention, um die Client-Fehlerprotokolldatei zu beschneiden, wenn die Anwendung zahlreiche Client-Meldungen erzeugt, die in das Client-Protokoll geschrieben werden, dsmLogType entweder logLocal oder logBoth. Weitere Informationen finden Sie in der Dokumentation zum IBM Storage Protect -Server.

Syntax

extern dsInt16_t DSMLINKAGE  dsmLogEventEx(
       dsUint32_t            dsmHandle,
       dsmLogExIn_t          *dsmLogExInP,
       dsmLogExOut_t         *dsmLogExOutP
);

Parameter

dsUint32_t dsmHandle(I)

Die Kennung, die diesen Aufruf einem vorherigen Aufruf dsmInitEx zuordnet.

dsmLogExIn_t *dsmLogExInP

Diese Struktur enthält die Eingabeparameter.

dsmLogSeverity severity;

Dieser Parameter gibt die Ereignisdringlichkeit an. Gültige Werte sind:

   logSevInfo,       /* information ANE4990 */
   logSevWarning,    /* warning     ANE4991 */
   logSevError,      /* Error       ANE4992 */
   logSevSevere      /* severe      ANE4993 */

char appMsgID[8];

Dieser Parameter ist eine Zeichenfolge zum Identifizieren der spezifischen Anwendungsnachricht. Ein geeignetes Format sind drei Zeichen, gefolgt von vier Zahlen, beispielsweise DSM0250.

dsmLogType logType;

Dieser Parameter gibt an, wohin das Ereignis übertragen werden soll. Für diesen Parameter gibt es die folgenden gültigen Werte:

logServer
logLocal
logBoth

char *message;

Dieser Parameter gibt den Text der zu protokollierenden Ereignisnachricht an. Bei dem Text muss es sich um eine Zeichenfolge handeln, die auf null endet. Die maximale Länge ist DSM_MAX_RC_MSG_LENGTH.

Einschränkung: Nachrichten, die an den Server gesendet werden, müssen in Englisch vorliegen. Nachrichten in anderen Sprachen als Englisch werden nicht korrekt angezeigt.

dsmLogExOut_t *dsmLogExOutP

Diese Struktur enthält die Ausgabeparameter. Momentan sind keine Ausgabeparameter definiert.

Rückkehrcodes

Die Rückkehrcodenummern sind in runden Klammern ( ) angegeben.

Tabelle 1. Rückkehrcodes für dsmLogEventEx
Rückkehrcode	Erläuterung
`DSM_RC_STRING_TOO_LONG (2120)`	Die Nachrichtenzeichenfolge ist zu lang.