Diagnosehilfen

SHC-OSD ist ein nachladbares, von BS2000 entkoppeltes Subsystem.
Die von SHC-OSD erzeugten Tasks haben den Jobnamen SHCUSERT.
Das von SHC-OSD erzeugte POSIX Shared-Memory-Segment ist nicht eindeutig am ipcs-key zu erkennen: es verwendet den key 0 (PRIVATE).

Bei Problemen im Umfeld von SHC-OSD sind folgende Unterlagen zur Diagnose erforderlich:

1. SHC-OSD Ablauf- und Error-Traces und Tabellen, die in POSIX in folgenden Dateien zu finden sind, siehe „Erstellung von Diagnose-Unterlagen mit MODIFY-SHC-PROCESSING":
   /var/shcosd/log/dumptrac-<yyyymmdd-hhmm>.txt
/var/shcosd/log/dumptabl-<yyyymmdd-hhmm>.txt

2. CONSLOG-Datei

3. Ablaufprotokoll der SHC-OSD-Kommandos

4. Logging-Dateien von SHC-OSD aus dem Verzeichnis /var/shcosd/log (siehe „Logging-Dateien von SHC-OSD")

5. Logging-Dateien von StorMan (siehe "StorMan-Logging-Dateien") und ggf. Logging-Dateien des SMI-S Providers (ETERNUS DX/AF)

6. Abzug der SERSLOG-Datei (speziell bei Problemen beim Start des Subsystems):
   Schwere Fehler bzw. Fehler, die nicht im eigenen Error-Trace hinterlegt werden können, werden in der SERSLOG-Datei vermerkt. Dabei wird immer dieselbe Identifikation NDE2000 („Interner Fehler“) verwendet. Die mitgegebenen Bereiche (ein oder zwei) sind variabel und stammen vom Error-Trace-Eintrag.

7. Eingesetzte REP-Datei SYSREP.SHC-OSD.<ver> und der Lader-Stand von BS2000 und des NKVD-Subsystems

8. ggf. Systemdump

Erstellung von Diagnose-Unterlagen mit MODIFY-SHC-PROCESSING

Das Kommando /MODIFY-SHC-PROCESSING SAVE-TRACES=*YES, SAVE-TABLES=*YES schreibt SHC-OSD-Diagnosedaten (Traces und Tabellen) aus dem laufenden System in die beiden Dateien dumptrac-<yyyymmdd-hhmm>.txt und dumptabl-<yyyymmdd-hhmm>.txt im POSIX-Verzeichnis /var/shcosd/log.

Da diese eventuell sehr groß sein können, sollten sie extern gesichert und danach in POSIX gelöscht werden.

Logging-Dateien von SHC-OSD

Die Logging-Einträge von SHC-OSD werden in eine eigene Logging-Datei geschrieben. Die Logging-Datei wird jeden Tag neu angelegt.
Der Dateiname ist: /var/shcosd/log/shcosd-<jjjjmmtt>.log.

Das Logging von SHC-OSD läuft in einer eigenen Task (Fork) der Benutzertask von SHC-OSD (SHCUSERT). Die Benutzertask wird durch das SHC-OSD-Logging nicht blockiert.

Die Logging-Dateien von SHC-OSD können erheblichen Umfang annehmen (bis zu 1 MByte/Tag). Wenn das entsprechende Dateisystem voll ist, dann wird dies von POSIX gemeldet.

Veraltete Logging-Dateien von SHC-OSD werden automatisch gelöscht. Die Anzahl der Tage, bevor eine Logging-Datei gelöscht wird, kann in der SHC-OSD-Parameterdatei eingestellt werden, siehe Abschnitt „Konfiguration von SHC-OSD".

StorMan-Logging-Dateien

Zur Diagnose von Fehlern ist es notwendig, die StorMan-Logging-Dateien und das Repository zu sichern, siehe Handbuch „StorMan“ [15].