Instanzen von JRas-Managern und -Protokollfunktionen

Sie können JRas-Erweiterungen im integrierten, eigenständigen oder kombinierten Modus verwenden. Die Konfiguration der Anwendung hängt vom Betriebsmodus ab, aber die Verwendung der Protokollfunktionen (Logger) zum Protokollieren von Nachrichten oder Traceeinträgen ist in allen Betriebsmodi gleich.

Veraltet: Das JRas-Framework, das in dieser Task und den untergeordneten Tasks beschrieben wird, wird nicht weiter unterstützt. Sie können jedoch ähnliche Ergebnisse mit der Java™-Protokollierung erzielen.

Der integrierte Modus ist der Standardbetriebsmodus. In diesem Modus werden Nachrichten- und Traceereignisse an die Protokolle von WebSphere Application Server gesendet.

Im kombinierten Modus werden Nachrichten- und Traceereignisse an die Protokolle von WebSphere Application Server und an benutzerdefinierte Protokolle gesendet.

Im eigenständigen Modus werden Nachrichten- und Traceereignisse nur an benutzerdefinierte Protokolle gesendet.

Nachrichten- und Traceprotokollfunktionen verwenden

Unabhängig vom Betriebsmodus ist die Verwendung von Nachrichten- und Traceprotokollfunktionen dieselbe.

Nachrichtenprotokollfunktion verwenden

Die Nachrichtenprotokollfunktion ist so konfiguriert, dass sie das Ressourcenpaket DefaultMessages verwendet. Es müssen Nachrichtenschlüssel an die Nachrichtenprotokollfunktionen übergeben werden, wenn die Protokollfunktionen die API message verwenden.
msgLogger.message(RASIMessageEvent.TYPE_WARNING, this, 
     methodName, "MSG_KEY_00");
... msgLogger.message(RASIMessageEvent.TYPE_WARN, this, 
     methodName, "MSG_KEY_01", "some string");
Wenn die Nachrichtenprotokollfunktionen die API msg verwenden, können Sie den Namen eines neuen Ressourcenpakets angeben.
msgLogger.msg(RASIMessageEvent.TYPE_ERR, this, methodName, 
                  "ALT_MSG_KEY_00", "alternateMessageFile");
Sie können auch eine Textnachricht protokollieren. Wenn Sie die API textMessage verwenden, wird keine Nachrichtenformatierung vorgenommen.
msgLogger.textMessage(RASIMessageEvent.TYPE_INFO, this, methodName,"String and Integer", 
"A String", new Integer(5)); 

Traceprotokollfunktion verwenden

Da der Trace normalerweise deaktiviert ist, sollten Tracemethoden aus Gründen der Leistungsfähigkeit überwacht werden.
private void methodX(int x, String y, Foo z) 
{ 
   // Trace eines Einstiegspunktes. Mit Hilfe der Überwachung prüfen, ob die Traceerstellung aktiviert ist.
   // Prüfen Sie dies, bevor Sie Parameter zusammenstellen, für die ein Trace durchgeführt werden soll. 
   if (trcLogger.isLoggable(RASITraceEvent.TYPE_ENTRY_EXIT) { 
        // Da ein Trace für drei Parameter durchgeführt werden soll, diese in ein Object[] packen 
        Object[] parms = {new Integer(x), y, z}; 
        trcLogger.entry(RASITraceEvent.TYPE_ENTRY_EXIT, this, "methodX", parms); 
  } 
... logic 
  // a debug or verbose trace point 
  if (trcLogger.isLoggable(RASITraceEvent.TYPE_MISC_DATA) { 
        trcLogger.trace(RASITraceEvent.TYPE_MISC_DATA, this, "methodX" "reached here"); 
  } 
  ... 
  // Eine weitere Klassifizierung des Traceereignisses. Es wurde eine wichtige Statusänderung festgestellt, 
  // daher wird ein anderer Tracetyp verwendet.
  if (trcLogger.isLoggable(RASITraceEvent.TYPE_SVC) {
     trcLogger.trace(RASITraceEvent.TYPE_SVC, this, "methodX", "an important event"); 
  } 
 ... 
  // Bereit zum Verlassen der Methode, Trace. Kein Rückgabewert an den Trace 
    if (trcLogger.isLoggable(RASITraceEvent.TYPE_ENTRY_EXIT)) { 
        trcLogger.exit(RASITraceEvent.TYPE_ENTRY_EXIT, this, "methodX"); 
   } 
} 

Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ctrb_jrasmkmgrs
Dateiname:ctrb_jrasmkmgrs.html