Die Administration USERAREA ist ein Task-spezifischer Trace-Bereich in KDCROOT. Dieser Bereich dient dazu, die an der Programmschnittstelle vom Teilprogramm an openUTM übergebenen Daten mitzuprotokollieren.
Da die übergebenen Daten sehr umfangreich sein können, werden nur die Daten eines Aufrufs in dem Bereich abgelegt. Der Bereich besteht also nur aus einem Record und fasst 4140 Bytes. Der Bereich wird nur für die Aufrufe beschrieben, bei denen Daten an openUTM übergeben werden. Es wird der Inhalt der data area oder der Inhalt der selection area protokolliert, je nachdem, welcher Bereich bei dem Aufruf verwendet wurde. Wird der Bereich für die Diagnose benötigt, so muss darauf geachtet werden, dass der entsprechende Aufruf der letzte Aufruf ist, für den Daten mitprotokolliert werden, damit der Bereich nicht durch einen nachfolgenden Aufruf überschrieben wird.
Wird in der data area für einen Benutzer ein Passwort übergeben, dann wird dieses nicht mitprotokolliert, sondern mit binär Null überschrieben.
Ein Record hat folgende Struktur:
Byte | Bedeutung | |
dez. | hexadez. | |
0-1 | 00-01 | Zähler des zugehörigen Eintrages in der Administration DIAGAREA |
2-3 | 02-03 | irrelevant |
4-59 | 04-3B | parameter area |
60-4139 | 3C-102B | Inhalt data area bzw. selection area in der übergebenen Länge |
Aufbau der Administration USERAREA
Der Inhalt der parameter area und die übergebenen Daten werden im UTM-Systemcode mitprotokolliert. Die parameter area wird so protokolliert, wie sie vom Teilprogramm übergeben wird, also ohne besetzte Rückgabewerte. Der Subreturncode ist auf Null gesetzt.
Der Eintragszähler wird nach der Rückkehr aus dem UTM-Systemcode vor dem Rücksprung in das Teilprogramm mitprotokolliert.