Interpretation der HTTP -Statuscodes und NSM-Fehlercodes

Online bearbeiten

Wenn ein NSM-Clientbenutzer einen ungültigen Befehl ausführt, der zu einem Fehler führt, werden ein HTTP -Statuscode und ein NSM-Fehlercode zurückgegeben. Der Statuscode von HTTP enthält Informationen darüber, ob eine Anfrage beim NSM-Server eingegangen ist. Die NSM-Fehlercodes geben Aufschluss darüber, warum NSM die Anforderung fehlgeschlagen ist.

Format von Fehlerantworten von URI-Anforderungen

Wenn eine URI-Anfrage einen Fehler verursacht, haben der zurückgegebene HTTP -Statuscode und der NSM-Fehlercode folgendes Format:

Response code: 404
Response message: NSM-ERR-XX

Dabei ist XX der NSM-Fehlercode. Wenn NSM beispielsweise die angeforderte Geräte-ID nicht finden kann, sieht der NSM-Clientbenutzer Folgendes:

Response code: 404
Response message: NSM-ERR-1

Der NSM-Fehlercode 1 bedeutet, dass eine Einheit nicht gefunden wurde.

In Tabelle 1 sind alle NSM-Fehlercodes und ihre Bedeutung aufgelistet.

Format der Fehlerantworten von der Befehlszeilenschnittstelle

Wenn der Fehler auftritt, während der Benutzer das Befehlszeilen-Tool verwendet, haben der Statuscode und die Meldung von HTTP folgendes Format:

An error occurred in request processing, a HTTP Status Code of [404] with a Message 
of [Not Found] was received. 
See the Intelliden.log for details.

Der Benutzer sollte dann in der Intelliden.log nach weiteren Informationen zu dem aufgetretenen Fehler suchen, einschließlich des NSM-Fehlercodes. Der Standardpfad für die Datei Intelliden.log ist /opt/IBM/tivoli/netcool/ncm/logs.

Der Statuscode von HTTP kann eine der folgenden Antworten sein:

HttpStatus.NOT_FOUND 404
HttpStatus.FORBIDDEN 403
HttpStatus.UNAUTHORIZED 401
HttpStatus.BAD_REQUEST 400

Für das Beispiel, in dem die ID der NSM-Serviceschablone nicht gefunden wird, kann Intelliden.log Folgendes anzeigen:

2012/10/24,12:41:10.250,com.ibm.tivoli.itncm.logging.ItncmLogger,THR:246,ERROR, 
NotFoundException - NSM Error Code: 3 SERVICETEMPLATE_NOT_FOUND
com.ibm.tivoli.nsm.web.exceptions.NotFoundException: Unable to find Service Template with ID :[101]

In Tabelle 1 sind alle NSM-Fehlercodes und ihre Bedeutung aufgelistet.

Tabelle 1. NSM-Fehlercodes und Beschreibungen
NSM-Fehlercode	Bedeutung des NSM-Fehlercodes
`1`	Die Einheit wurde nicht gefunden. Dieser Fehler kann auftreten, wenn die Geräte-ID in der XML fehlt, wenn neue Services übergeben werden. Dieser Fehler kann auch auftreten, wenn der Benutzer des NSM-Clients die URIs der NSM-REST-Einheiten verwendet und sie keine Berechtigung zum Anzeigen der Geräte-ID haben oder die Geräte-ID auf dem NCM-System nicht vorhanden ist.
`2`	Das Realm ist nicht vorhanden. Dieser Fehler kann auftreten, wenn eine Realm-ID an den Realm-NSM-REST-URI übergeben wird, der auf dem NCM-System nicht vorhanden ist.
`3`	Die Serviceschablone wurde nicht gefunden. Dieser Fehler kann auftreten, wenn keine übereinstimmende Implementierung in einer vorhandenen NSM-Serviceschablone gefunden wurde, die auf dem VTMOS der bereitgestellten Einheit und den in den Implementierungen angegebenen Regeln für den regulären Ausdruck DeviceType basiert. Dieser Fehler kann auch auftreten, wenn die angegebene NSM-Serviceschablone -ID auf dem NCM-System nicht vorhanden ist. Dieser Fehler kann auftreten, wenn der NSM-Service-Entwickler das Befehlszeilentool in NSM-Serviceschablonenverwendet. Dieser Fehler kann auch auftreten, wenn der NSM-Clientbenutzer die NSM-REST- NSM-Serviceschablone URIs verwendet oder neue Services übergibt.
`4`	Die aufzurufende Einfügemethode wurde nicht angegeben. Dieser Fehler kann auftreten, wenn eine NSM-Serviceschablone mit Inject-Parametern erstellt wurde, für die Argumente definiert sind, aber keine JavaScript -Methode zum Aufrufen vorhanden ist.
`5`	Beim Ausführen des Einfügeparameters ist ein Fehler aufgetreten. Dieser Fehler kann während der Serviceausführung während der Verarbeitung von Inject-Parametern auftreten.
`6`	Der Einfügeparameter wurde nicht ordnungsgemäß konfiguriert. Dieser Fehler kann auftreten, wenn eine NSM-Serviceschablone mit Inject-Parametern erstellt wurde, denen Code oder Argumente fehlen.
`7`	Dieser Fehler kann beim NSM-Start auftreten, wenn der Work Manager nicht ordnungsgemäß initialisiert wurde.
`8`	Während die JavaScript -Engine das JavaScript ausführt, das dem Einfügeparameter zugeordnet ist, ist ein Fehler aufgetreten.
`9`	Beim Marshalling einer NSM-Serviceschablone in XML ist während der Serviceausführung ein Fehler aufgetreten.
`10`	Ein SQL-Parameter wurde in einer NSM-Serviceschablonefalsch konfiguriert; er hat keine Parameter.
`11`	Bei der Sicherheit (Verschlüsselung) eines Datenbankkennworts in einer NSM-Serviceschabloneist ein Fehler aufgetreten.
`12`	Die auszuführende SQL-Abfrage wurde in einem SQL-Parameter, der in einer NSM-Serviceschablonedefiniert ist, übergangen.
`13`	Ein SQL-Parameter wurde in einer NSM-Serviceschablonenicht ordnungsgemäß konfiguriert. Es sind keine SQL Query und keine Parameter definiert.
`14`	Die HTTP URL wurde im HTTP -Parameter ausgelassen, der in einer NSM-Dienstvorlage definiert ist.
`15`	Während der Serviceausführung wurde ein Parameterargument nicht gefunden.
`16`	Während der Serviceausführung wurde ein Parameterargument berechnet, aber ein leerer Wert erzeugt.
`17`	Beim Ausführen eines GET für einen HTTP -Parameter ist ein Fehler im NSM-System aufgetreten.
`18`	Beim Ausführen eines GET für einen HTTP -Parameter ist auf dem Zielserver ein Fehler aufgetreten.
`19`	Beim Ausführen eines GET für einen HTTP -Parameter ist ein allgemeiner HTTP -Fehler aufgetreten.
`20`	Aufgrund einer fehlerhaften SQL-Grammatik in einer SQL-Abfrage eines SQL-Parameters in einer NSM-Serviceschabloneist ein Fehler aufgetreten.
`21`	Es konnte keine Datenbankverbindung für einen SQL-Parameter in einer NSM-Serviceschablonehergestellt werden.
`22`	Es ist nicht zulässig, einen Parameter zu haben, der ein Argument erfordert, das ein anderer Parameter ist, der den ersten Parameter als Argument erfordert. Dies ist ein Beispiel für eine Endlosschleife, daher können die Parameter nicht berechnet werden.
`23`	Beim Auswerten eines Parameters in einer NSM-Serviceschabloneist ein Fehler aufgetreten.
`24`	Die Serviceinstanz wurde auf dem NCM-System nicht gefunden. Hinweis: Die Serviceinstanz wurde möglicherweise vom Scheduler auf der Basis des Attributs `timeToDelete` gelöscht, das in der NSM-Serviceschablone zum Erstellen der Serviceinstanz verwendet wurde.
`25`	Das Arbeitselement wurde nicht im NCM-System gefunden.
`26`	Es wurden mehrere Einheiten gefunden, die mit dem angegebenen Einheitennamen übereinstimmen.
`27`	Es ist ein Fehler aufgetreten, da die als persistent zu definierende Entität bereits vorhanden ist.
`28`	Der angegebene Konstantenparameter (`<constantParameter>`), Clientparameter (`<clientParameter>`) oder Clientparameterliste (`<clientParameterList>`) hat keinen Wert.
`29`	Der in der NSM-Serviceschablone angegebene Operationstyp ist ungültig.
`30`	Der Parameter der Operation (`<operation>`) wurde weder im globalen noch im lokalen Parameter für diese NSM-Serviceschablonegefunden.
`31`	In der NSM-Serviceschablonewurde eine doppelte Regel gefunden.
`32`	Eine NSM-Serviceschablone wurde ohne eine Regel des Typs `DeviceType` (`<rule type="DeviceType">`) definiert.
`33`	Bei der Suche nach Geräten mit den Einheiten-URIs der NSM-REST-API wurde eine ungültige Suchrichtung für Geräte verwendet.
`34`	Bei der Suche nach Einheiten mithilfe der NSM-REST-API Einheiten-URIs wurde eine ungültige Einheitensuchaktion verwendet.
`35`	Beim Erstellen einer Service-UOW auf dem NCM-System ist während der Serviceausführung ein Fehler aufgetreten.
`36`	Für ein Befehlszeilentool wurde ein ungültiges Datumsformat angegeben. Verwenden Sie das Datumsformat JJJJ-MM-TT.
`37`	Ein interner NSM-Fehler ist aufgetreten. Überwachen Sie `Initelliden.log` auf weitere Informationen.
`38`	Das Attribut für die Operationsreihenfolge (beispielsweise `<operation order="1">`), das in einer NSM-Serviceschablone definiert ist, darf keinen negativen Wert enthalten.
`39`	Die angegebene XML konnte anhand der NSM-XML-Schemadefinition nicht validiert werden.
`40`	Die HTTP Anforderung für die NSM REST API- URI war ungültig.
`41`	Die Serviceinstanz kann nicht gelöscht werden, da der Servicestatus nicht `SUCCESS`ist.
`42`	Die Serviceinstanz ist auf dem NCM-System nicht vorhanden.
`43`	Während der Serviceausführung wurde keine Serviceoperation in der NSM-Serviceschablone gefunden.
`44`	Die NSM-Serviceschablone enthält ein Attribut `timeToDelete` (z. B. `<serviceTemplate timeToDelete="5">`), aber die Serviceinstanz konnte nicht zum Löschen geplant werden.
`45`	Die NSM-Serviceschablone kann nicht gelöscht werden, da sie als angewendete NSM-Serviceschablone in einer vorhandenen Serviceinstanz referenziert wird.
`46`	Die empfangenen Werte für das Reihenfolgeattribut einer Clientparameterliste (z. B. `<value order="1">`) wurden nicht ordnungsgemäß ausgefüllt.
`47`	Die empfangenen Werte für eine Clientparameterliste (`<clientParameterList>`) haben eine Abweichung in der Anzahl der Werte, die für die zugehörigen Parameter empfangen wurden.
`48`	In der NSM-Serviceschablonewurden doppelte Parameternamen gefunden.
`49`	Es wurde weder ein Attribut `timeToDelete` (z. B. `<serviceTemplate name="FirewallCreateZones" timeToDelete="5">`) noch eine Serviceoperation des Typs `DELETE` (z. B. `<serviceOperation name="deleteOperation" type="DELETE">`) gefunden. Es muss ein Löschmechanismus für Services angegeben werden.
`50`	Ein Attribut `timeToDelete` (z. B. `<serviceTemplate timeToDelete="5">`) und eine Serviceoperation des Typs `DELETE` (z. B. `<serviceOperation name="deleteOperation" type="DELETE">`) wurden in einer NSM-Serviceschablonegefunden. Es muss ein Löschmechanismus für Services angegeben werden.
`51`	Die in einer NSM-REST-URI-Anforderung angegebene Servicereferenz-ID (z. B. `POST http://www.example.com:16310/nsm/service/{"Doc56789}`) ist auf dem System bereits vorhanden.
`52`	Es wurde eine ungültige Regel NSM service template gefunden.
`53`	Ein SQL-Parameter wird in einer Serviceausführung referenziert, aber eine erforderliche Datenbankverbindung wurde nicht gefunden.
`54`	An invalid `ruleProperty` (for example, `<ruleProperty name="VENOR" value="Cisco"/>` ) has been found in the NSM-Serviceschablone.
`55`	Manuelle Aktualisierungen von automatisch generierten NSM-Serviceschablonen sind nicht zulässig.
`56`	Allgemeiner Gültigkeitsfehler. Die Begleitnachricht enthält ausführlichere Informationen.
`57`	Es wurde ein Wert für ein optionales Element angegeben, aber dieser Wert war leer.
`58`	Es wurde ein ungültiger Serviceoperationstyp gefunden.
`59`	Ungültiger Rollbacktyp für Operation wurde gefunden
`60`	Die Serviceschablone wurde fälschlicherweise für das Löschen von Services konfiguriert. Die Begleitnachricht enthält ausführlichere Informationen.
`61`	Eine Serviceschablonen-ID ist erforderlich.
`62`	Ein Serviceschablonenname ist erforderlich.
`63`	Für die Serviceschablone ist eine Geräte-ID erforderlich.
`64`	Es wurde angefordert, einen Serviceeintrag über die Befehlszeilenschnittstelle zu entfernen, aber der angeforderte Service befand sich nicht in einem gültigen Status zum Entfernen.