Erstellen eines Ereignisprotokolls aus einer IBM 3270- oder 5250-Sitzung

Im Zusammenhang mit der Fehlersuche bei Problemen in einer IBM 3270- oder 5250-Sitzung werden Sie von den Mitarbeitern des technischen Kundendienstes möglicherweise aufgefordert, ein oder mehrere Ereignisprotokolle zu erstellen. Drei verschiedene Arten von Ereignisprotokollen sind möglich: Hostdatenprotokoll, Befehlsprotokoll und HLLAPI-Protokoll.

Dateityp für das Ereignisprotokoll	Beschreibung
Hostdatenprotokoll (*.hst)	Zeichnet Informationen auf, die zwischen einer Terminal- oder Druckersitzung und dem Host übertragen werden. Diese Art von Ereignisprotokollierung ist sinnvoll, wenn eine Hostverbindung besteht, die Terminal- bzw. Druckersitzung sich jedoch nicht erwartungsgemäß verhält. Wenn keine Verbindung zum Host hergestellt werden kann, bringt die Ereignisprotokollierung keine wichtigen Informationen.
Befehlsprotokoll (*.cmd)	Erfasst Aktionen in Reflection. Jede Aktion, wie das Klicken auf eine Schaltfläche oder das Eingeben von Text, stellt einen eigenen Befehl dar. Mithilfe von Befehlsprotokollen können Sie ermitteln, ob Befehle in einem Skript, Makro oder Programm unter Verwendung der OLE-Automatisierung ordnungsgemäß funktionieren. Darüber hinaus lässt sich feststellen, welcher Befehl in einem Skript verwendet werden muss. Zeigen Sie das Befehlsprotokoll in einem Text-Editor an, um bestimmen zu können, welche Befehle für die jeweilige Aufgabe erforderlich sind.
HLLAPI-Protokoll	Erfasst die HLLAPI-Aufrufe der Anwendung einschließlich der entsprechenden Rückgabecodes. (Bei HLLAPI handelt es sich um eine von IBM spezifizierte API zum Automatisieren von Terminalaufgaben.)

Dateityp für das Ereignisprotokoll

Beschreibung

Hostdatenprotokoll (*.hst)

Zeichnet Informationen auf, die zwischen einer Terminal- oder Druckersitzung und dem Host übertragen werden. Diese Art von Ereignisprotokollierung ist sinnvoll, wenn eine Hostverbindung besteht, die Terminal- bzw. Druckersitzung sich jedoch nicht erwartungsgemäß verhält. Wenn keine Verbindung zum Host hergestellt werden kann, bringt die Ereignisprotokollierung keine wichtigen Informationen.

Befehlsprotokoll (*.cmd)

Erfasst Aktionen in Reflection. Jede Aktion, wie das Klicken auf eine Schaltfläche oder das Eingeben von Text, stellt einen eigenen Befehl dar. Mithilfe von Befehlsprotokollen können Sie ermitteln, ob Befehle in einem Skript, Makro oder Programm unter Verwendung der OLE-Automatisierung ordnungsgemäß funktionieren.

Darüber hinaus lässt sich feststellen, welcher Befehl in einem Skript verwendet werden muss. Zeigen Sie das Befehlsprotokoll in einem Text-Editor an, um bestimmen zu können, welche Befehle für die jeweilige Aufgabe erforderlich sind.

HLLAPI-Protokoll

Erfasst die HLLAPI-Aufrufe der Anwendung einschließlich der entsprechenden Rückgabecodes. (Bei HLLAPI handelt es sich um eine von IBM spezifizierte API zum Automatisieren von Terminalaufgaben.)

So erstellen Sie ein Hostdaten- oder Befehlsprotokoll

Öffnen oder erstellen Sie eine Sitzung.
Geben Sie im Dialogfeld Ereignisprotokoll ein einen Namen für die Ereignisprotokolldatei an. Wenn Sie mit einem Kundendienstmitarbeiter gesprochen haben, geben Sie Ihre Serviceanforderungsnummer als Namen der Ereignisprotokolldatei an.

Ereignisprotokolltyp

Erweiterung

Hostdaten

.HST

Befehl

.CMD
Klicken Sie auf Speichern.

In der Statusleiste von Reflection wird durch die Meldung "Ereignisprotokollierung gestartet..." angezeigt, dass die Ereignisprotokollierung aktiv ist.
Führen Sie die Aktionen durch, bei denen das aufzuzeichnende Problem erfahrungsgemäß auftritt.
Halten Sie die Ereignisprotokollierung an.
Laden Sie die Ereignisprotokolldatei als Binärdatei auf http://upload.attachmate.com hoch. Wenn das Problem mit einer Serviceanforderung zusammenhängt, an der Sie gerade mit einem Techniker arbeiten, fügen Sie dem Ereignisprotokoll die Micro Focus-Serviceanforderungsnummer hinzu, und informieren Sie den Techniker, wenn der Upload der Datei abgeschlossen wurde.

Ereignisprotokolltyp	Erweiterung
Hostdaten	.HST
Befehl	.CMD

So erstellen Sie ein HLLAPI-Protokoll

Klicken Sie auf die Windows-Schaltfläche Start.
Geben Sie im Suchen-Feld die Zeichenfolge win.ini ein, und drücken Sie die Eingabetaste, um die Datei WIN.INI im Windows-Editor zu öffnen.
Fügen Sie am Ende der Datei die folgenden beiden Zeilen ein:
```
[Reflection HLLAPI]
ExtTraceOn=1
```
Öffnen oder erstellen Sie im Reflection-Arbeitsbereich eine Sitzung, um eine Verbindung zum IBM-Host herzustellen.
Starten Sie die HLLAPI-Anwendung.
Führen Sie die Aktionen durch, bei denen das aufzuzeichnende Problem erfahrungsgemäß auftritt.
Schließen Sie die HLLAPI-Anwendung.

Die Protokolldatei erhält automatisch den Namen HLL*.TMP, wobei * für eine zufällig generierte Hexadezimalzahl steht. Die Datei wird im TEMP-Verzeichnis des PCs abgelegt, sofern in den Einstellungen für die Systemumgebung ein TEMP-Verzeichnis definiert wurde. Andernfalls wird die Datei im Stammverzeichnis von Windows gespeichert.
Öffnen Sie die Datei WIN.INI erneut, und setzen Sie den Wert der ExtTraceOn-Einstellung in der letzten Zeile der Datei auf null:
```
ExtTraceOn=0
```
Laden Sie die Ereignisprotokolldatei als Binärdatei auf http://upload.attachmate.com hoch. Wenn das Problem mit einer Serviceanforderung zusammenhängt, an der Sie gerade mit einem Techniker arbeiten, fügen Sie dem Ereignisprotokoll die Micro Focus-Serviceanforderungsnummer hinzu, und informieren Sie den Techniker, wenn der Upload der Datei abgeschlossen wurde.