Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-TRACE-STATUS

&pagelevel(3)&pagelevel

Eigenschaften und Zustand von System-Traces ausgeben

Komponente:

BS2000

Funktionsbereich:

Fehlerprotokollierung

Anwendungsbereich:

ERROR-LOGGING

Privilegierung:

TSOS
OPERATING
SW-MONITOR-ADMINISTRATION

Berechtigungsschlüssel:

R

Funktionsbeschreibung

Das Kommando verschafft einen Überblick über alle Ablaufverfolger (Traces) des Systems.Die Standardausgabe umfasst die Liste der permanenten, nicht schaltbaren Ablaufverfolger sowie diejenigen temporären Traces, die die Systembetreuung mit den Kommandos START-TRACE und STOP-TRACE explizit zu- und wegschalten kann.

Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable"). 

Format

SHOW-TRACE-STATUS                                                                                                                             

 TRACE-IDENTIFICATION = *ALL(...) / list-poss(51): <name 1..8>(...) / *ALL(...)


*ALL(...)



|

SUBSYSTEM-NAME = *ALL / <name 1..8> / *NONE



|

,SUBSYSTEM-VERSION = *ALL / <product-version without-man-corr> /



|


<product-version mandatory-man-corr>


<name 1..8>(...)



|

SUBSYSTEM-NAME = *ALL / <name 1..8> / *NONE



|

,SUBSYSTEM-VERSION = *ALL / <product-version without-man-corr> /



|


<product-version mandatory-man-corr>

,SELECT = *ALL / *BY-ATTRIBUTES(...)


*BY-ATTRIBUTES(...)



|

STATUS = *ANY / *ON / *OFF



|

,TYPE = *ANY / *PERMANENT / *TEMPORARY

,INFORMATION = *NONE / *PARAMETERS(...)


*PARAMETERS(...)



|

TRACE-INFORMATION = *NO / *YES



|

,BUFFER-INFORMATION = *NO / *YES

,OUTPUT = *SYSOUT / *SYSLST(...)


*SYSLST(...)



|

SYSLST-NUMBER = 0 / <integer 0..99>

Operandenbeschreibung

TRACE-IDENTIFICATION =
Gibt an, über welche Traces Informationen ausgegeben werden sollen.

TRACE-IDENTIFICATION = *ALL(...)
Über alle definierten Traces sollen Informationen bereitgestellt werden.
Handelt es sich um Traces, die nicht statisch definiert sind, sind diese einem bestimmten Subsystem zugeordnet, das im Folgenden näher bezeichnet werden kann.

SUBSYSTEM-NAME =
Bezeichnet das Subsystem, dem der Trace zugeordnet ist.

SUBSYSTEM-NAME = *ALL
Die Informationen sollen in jedem Fall - unabhängig davon, welchem Subsystem sie zugeordet sind - angezeigt werden.

SUBSYSTEM-NAME = <name 1..8>
Genaue Bezeichnung des Subsystems, dem der Trace zugeordnet ist und über den Informationen ausgegeben werden sollen.

SUBSYSTEM-NAME = *NONE
Es sollen nur Informationen über statisch definierte Traces angezeigt werden, die generell keinem Subsystem zugeordnet sind.

SUBSYSTEM-VERSION =
Vereinbart die Version des bezeichneten Subsystems, dem der Trace zugeordnet ist.

SUBSYSTEM-VERSION = *ALL
Die Informationen über die bezeichneten Traces sollen für alle Versionen des ausgewählten Subsystems geliefert werden.

SUBSYSTEM-VERSION = <product-version without-man-corr> / <product-version mandatory-man-corr>
Vereinbart die Version.
Bei Angabe einer Version muss das hier angegebene Format mit dem bei der Definition des Subsystems benutzten Format übereinstimmen (Freigabe- und Korrekturstand dürfen nicht oder müssen angegeben werden; siehe auch „SDF-Syntaxdarstellung").

Mögliche Werte (für TRACE-ID=*ALL) siehe folgende Tabelle:

Trace-Id

Subsystem-Name

Schaltbar

Kurzbeschreibung

AIDSYS

*NONE

N

AIDSYS-Trace

ASTRA

*NONE

N

ASAM-Trace

CCOPY

CCOPY

J

CCOPY-Trace

CMSTRACE

*NONE

J

CMS-Trace

CUIRTR

*NONE

J

CUIR-Trace

DISKAI

*NONE

J

Trace für Disk Attention Interrupt Processing

DIVTRACE

DIV

J

DIV-Trace

DLMTRACE

DLMUSER

J

DLMUSER-Trace

DPRTCOM

DPRINTCM

J

DPRINTCM-Communication-Trace

DPSLOG

BS2CP

J

Trace für IMPORT-PUBSET und EXPORT-PUBSET-Vorgänge

EMMIO

*NONE

J

EMMIO-Trace

FITC

BS2CP

J

FITC-Trace

MAILCERR

MAILCLNT

N

Fehlertrace für MAILCLNT

MAILCEVT

MAILCLNT

J

Trace für MAILCLNT

MRSCAT

*NONE

J

MRSCAT-Occupation-Trace

MSCFLOG

MSCF

J

Trace für MSCF-Fehler

NDVMTRAC

*NONE

J

BAVOLMON-I/O-Trace

PAGING

*NONE

N

PAGING-Trace

PRNGDERR

PRNGD

N

Fehlertrace für PRNGD

PRNGDEVT

PRNGD

J

Trace für PRNGD

RECTRACE

*NONE

N

Rekonfiguration-Trace

SM2EVENT

SM2

J

SM2-Fehlertrace

SM2FUNCT

SM2

J

SM2-Trace für User-Aufruf

SYNTRACE

*NONE

N

ETMSYNCH-Trace

TBOURSE

*NONE

J

ETMBOWK-Trace

TDISAM

*NONE

J

K-ISAM-Trace

TDISAMNK

*NONE

J

NK-ISAM-Trace

TDJCTRL

*NONE

N

DJCTRL-Trace

TDRSRLER

*NONE

N

DRSRL-Error-Trace

TDRSRLSY

*NONE

N

DRSRL-System-Trace

TEMMSLT

*NONE

N

EMMSLT-Trace

TFASTPAM

FASTPAM

J

Trace der Zugriffsmethode

TJLOGLOW

*NONE

J

JMS-Trace

TJOBPOOL

*NONE

J

JMS-JOBPOOL-Trace

TLOCK

*NONE

J

Task-Lock-Management-Trace

TNBCADB

*NONE

N

NBCADS-Character-Trace

TNBCADG

*NONE

N

NBCADS-Big-Trace

TNBCCER

*NONE

N

NBCCER-Character-Trace

TNBCCNT

*NONE

N

NBCCNT-Character-Trace

TNBCCS

*NONE

N

NBCCNTS-Character-Trace

TNBCCSG

*NONE

N

NBCCNTS-I/O-Trace

TNBCENT

*NONE

N

NBCENTR-I/O-Trace

TNBCONS

*NONE

N

NBCONS-Trace

TNBCREC

*NONE

N

NBCRECK-I/O-Trace

TNBROUTE

*NONE

N

NBROUTE-Trace

TNDIDARM

*NONE

N

DAR-Manager-Trace

TNDM#ALL

BS2CP

J

Trace für alle NDM-FE

TNDM#ERR

BS2CP

N

NDM-Fehlertrace

TNDM#NKA

BS2CP

J

Trace für Module FE NKA

TNDM#NKD

BS2CP

J

Trace für Module FE NKD

TNDM#NKG

BS2CP

J

Trace für Module FE NKG

TNDM#NKL

DRV

J

Trace für Module FE NKL

TNDM#NKR

BS2CP

J

Trace für Module FE NKR

TNDM#NKS

NKS

J

Trace für Module FE NKS

TNDM#NKT

BS2CP

J

Trace für Module FE NKT

TNDM#NKV

NKVD

J

Trace für Module FE NKV

TRFA

*NONE

J

Remote-File-Access-Trace

TRSOADM

*NONE

N

RSO-Trace (alte RSO-Version)

TRSOADM

RSO

J

RSO-Trace

TSDVINT

*NONE

N

SDV- u. Interrupt-Trace

TSSVADM

*NONE

N

SPOOL-Trace (alte Spool-Version)

TSSVADM

SPOOL

J

SPOOL-Trace

UTLTRACE

*NONE

N

User-Table-Load-Trace

VMMALLOC

BS2CP

J

Trace für Allok. VM

Tabelle 164: Mögliche Werte für SHOW-TRACE-STATUS TRACE-ID=*ALL

TRACE-IDENTIFICATION = list-poss(51): <name 1..8>(...)
Vereinbart bis zu 51 Namen von Traces, über die Informationen angefordert werden sollen. Handelt es sich um Traces, die nicht statisch definiert sind, sind diese einem bestimmten Subsystem zugeordnet, das im Folgenden näher bezeichnet werden kann.

SUBSYSTEM-NAME =
Bezeichnet das Subsystem, dem der Trace zugeordnet ist.

SUBSYSTEM-NAME = *ALL
Die Informationen sollen in jedem Fall - unabhängig davon, welchem Subsystem sie zugeordet sind - angezeigt werden.

SUBSYSTEM-NAME = <name 1..8>
Genaue Bezeichnung des Subsystems, dem der Trace zugeordnet ist und über den Informationen ausgegeben werden sollen.

SUBSYSTEM-NAME = *NONE
Es sollen nur Informationen über statisch definierte Traces angezeigt werden, die generell keinem Subsystem zugeordnet sind.

SUBSYSTEM-VERSION =
Vereinbart die Version des bezeichneten Subsystems, dem der Trace zugeordnet ist.

SUBSYSTEM-VERSION = *ALL
Die Informationen über die bezeichneten Traces sollen für alle Versionen des ausgewählten Subsystems geliefert werden.

SUBSYSTEM-VERSION = <product-version without-man-corr> / <product-version mandatory-man-corr>
Vereinbart die Version.
Bei Angabe einer Version muss das hier angegebene Format mit dem bei der Definition des Subsystems benutzten Format übereinstimmen (Freigabe- und Korrekturstand dürfen nicht oder müssen angegeben werden; siehe auch SDF-Metasyntax).

SELECT =
Wählt die Traces anhand ihrer Eigenschaften aus.

SELECT = *ALL
Die Eigenschaften werden nicht spezifiziert.

SELECT = *BY-ATTRIBUTES(...)
Gibt die Eigenschaften an, anhand derer die Traces ausgewählt werden.

STATUS =
Selektionsparameter Status der Traces.

STATUS = *ANY
Alle Traces sollen unabhängig von ihrem Status ausgegeben werden.

STATUS = *ON
Nur Traces, die aktiviert sind (ON) bzw. sich in einem Zwischenzustand befinden (ON/OFF), sollen ausgegeben werden.

STATUS = *OFF
Nur Traces, die deaktiviert sind (OFF) bzw. sich in einem Zwischenzustand befinden (ON/OFF), sollen ausgegeben werden.

TYPE =
Selektionsparameter Schaltbarkeit der Traces.

TYPE = *ANY
Das Kriterium Schaltbarkeit soll bei der Auswahl der Ablaufverfolger nicht berücksichtigt werden.

TYPE = *PERMANENT
Nur Traces, die permanent eingeschaltet sind, sollen ausgegeben werden.

TYPE = *TEMPORARY
Nur Traces, die über Kommando schaltbar sind, sollen ausgegeben werden.

INFORMATION =
Art der Ausgabe.

INFORMATION = *NONE
Es sollen lediglich die Trace-Id und deren aktueller Zustand bei der Ausgabe angezeigt werden.

INFORMATION = *PARAMETERS(...)
Vereinbart weitere Attribute der Traces, die zusätzlich zur Trace-Id und zum aktuellen Zustand angezeigt werden sollen.

TRACE-INFORMATION =
Vereinbart, ob die Attribute Geltungsbereich und Schaltbarkeit der Traces zusätzlich ausgegeben werden.

TRACE-INFORMATION = *NO
Die Attribute Geltungsbereich und Schaltbarkeit sollen standardmäßig nicht zusätzlich ausgegeben werden.

TRACE-INFORMATION = *YES
Die Attribute Geltungsbereich und Schaltbarkeit der Traces sollen zusätzlich ausgegeben werden.

BUFFER-INFORMATION =
Vereinbart, ob die Attribute Größe und Speicherklasse der Trace-Puffer zusätzlich ausgegeben werden.

BUFFER-INFORMATION = *NO
Die Attribute Größe und Speicherklasse der Trace-Puffer sollen standardmäßig nicht zusätzlich ausgegeben werden.

BUFFER-INFORMATION = *YES
Die Attribute Größe und Speicherklasse der Trace-Puffer sollen zusätzlich ausgegeben werden.

OUTPUT =
Legt fest, wohin die Ausgabe erfolgen soll.

OUTPUT = *SYSOUT
Die tabellarisch aufbereitete Liste soll nach SYSOUT ausgegeben werden.

Für den Operator an der Konsole ist dies der einzig zulässige Operandenwert. Die Angabe OUTPUT=*SYSLST wird mit einer Fehlermeldung zurückgewiesen.

OUTPUT = *SYSLST(...)
Die tabellarisch aufbereitete Liste soll sowohl im Dialog- als auch im Batchbetrieb nach SYSLST ausgegeben werden.

SYSLST-NUMBER = 0 / <integer 0..99>
Nummer der SYSLST-Datei, die die Ausgabe aufnehmen soll. 

Beschreibung der Ausgabefelder

Feld                                        

Bedeutung / Inhalt

TRACE-IDENTIFICATION

Globale Informationen, die den Trace näher beschreiben:

  • NAME

Name des Trace

  • SS-NAME

Name des Subsystems, dem der Trace zugeordnet ist

  • SS-VERS

Version des Subsystems

STATUS



Zustand, in dem sich der Trace augenblicklich befindet.Die Zustandsbeschreibung zerfällt in zwei Hälften, wobei sämtliche Kombinationen auftreten können.

Teil 1 beschreibt den Puffer-Zustand:

DEF          

Puffer für den Trace nicht vorhanden oder dem Trace-Manager nicht bekannt (insbesondere nicht schaltbare Traces verwenden oft statische Puffer).

INI

Der Trace ist initialisiert, die Pufferdaten sind dem Trace-Manager bekannt

Teil 2 beschreibt den Schalt-Zustand:

ON

Trace ist eingeschaltet.

OFF          

Trace ist ausgeschaltet.

ON/OFF

Der Trace ist nur teilweise aktiviert

SCOPE

Geltungsbereich eines Trace:

SYSTEM

systemglobaler Trace

TASK

tasklokaler Trace

TYPE

Zeigt an, ob es sich um einen permanent eingeschalteten oder um einen schaltbaren Trace handelt:

PERM

permanent eingeschalteter Trace

TEMP

schaltbarer Trace

BUFFER

Informationen über den Trace-Puffer:

  • SIZE

Größe des Trace-Puffers in Byte.

  • CLASS

Speicherklasse des Trace-Puffers:

1

Klasse-1-Speicher

2

Klasse-2-Speicher

3

Klasse-3-Speicher

4

Klasse-4-Speicher

5

Klasse-5-Speicher

Tabelle 165: Ausgabefelder des Kommandos SHOW-TRACE-STATUS

Kommando-Returncode

(SC2)

SC1

Maincode

Bedeutung


0

CMD0001

Ohne Fehler

1


CMD0001

Kein Trace entsprechend der Anforderung

1

1

PDT0213

Operand OUTPUT=*SYSLST für Konsole nicht zulässig


32

CMD0221

Interner Fehler

1

64

PDT0200

Kein Trace wurde bearbeitet

2

64

PDT0200

Einer der in Liste angegebenen Traces wurde nicht bearbeitet


64

PDT0209

Keine Berechtigung für Kommando

Ausgabe in S-Variable

Der Operand INFORMATION des Kommandos legt fest, welche S-Variablen erzeugt werden. Folgende Angaben sind für INFORMATION möglich:

Schreibweise im Kommando

gekürzte Schreibweise in Tabelle

INFORMATION=*NONE

1

INFORMATION=*PAR(TRACE-INFORMATION=*YES, BUFFER-INFORMATION=*NO)

2

INFORMATION=*PAR(TRACE-INFORMATION=*NO, BUFFER-INFORMATION=*YES)

3

INFORMATION=*PAR(TRACE-INFORMATION=*YES, BUFFER-INFORMATION=*YES)

4

Ausgabe-Information

Name der S-Variablen

T

Inhalt

Bedingung

Speicherklasse des Trace-Puffers

var(*LIST).BUF-CLASS

I

<integer 1..5>

3,4

Größe des Trace-Puffers

var(*LIST).BUF-SIZE

I

<integer 0..231>

3,4

Zustand des Trace-Puffers

var(*LIST).BUF-STA

S

*DEFI
*INIT

1,2,3,4

Geltungsbereich des Trace

var(*LIST).SCOPE

S

*SYS
*TASK

2,4

Schaltzustand des Trace

var(*LIST).STA

S

*ON
*OFF
*ON-OFF

1,2,3,4

Name des Subsystems, dem der Trace zugeordnet ist

var(*LIST).SUBSYS-NAME

S

<c-string 1..8>

1,2,3,4

Version des Subsystems

var(*LIST).SUBSYS-VERSION

S

<c-string 1..4>
<c-string 1..7>

1,2,3,4

Trace-Identifier

var(*LIST).TRACE-ID

S

<c-string 1..8>

1,2,3,4

Schaltbarkeit des Trace

var(*LIST).TYPE

S

*PERM
*TEMP

2,4

Beispiel

/declare-var var-name=var(type=*structure),multiple-elem=*list
/exec-cmd cmd=(show-trace-status inf=*par(trace-inf=*yes,buffer-inf=*no)),
                                 text-output=*none,structure-output=var
/show-var var,inf=*par(val=*c-literal,list-index=*yes)

VAR#1.TRACE-ID = 'AIDSYS'
VAR#1.SUBSYS-NAME = '*NONE'
VAR#1.SUBSYS-VERSION = '00.0'
VAR#1.BUF-STA = '*DEFI'
VAR#1.STA = '*ON'
VAR#1.SCOPE = '*TASK'
VAR#1.TYPE = '*PERM'
*END-OF-VAR
VAR#2.TRACE-ID = 'ASTRA'
VAR#2.SUBSYS-NAME = '*NONE'
VAR#2.SUBSYS-VERSION = '00.0'
VAR#2.BUF-STA = '*INIT'
VAR#2.STA = '*ON'
VAR#2.SCOPE = '*SYS '
VAR#2.TYPE = '*PERM'
*END-OF-VAR
VAR#3.TRACE-ID = 'CMSTRACE'
VAR#3.SUBSYS-NAME = '*NONE'
VAR#3.SUBSYS-VERSION = '00.0'
VAR#3.BUF-STA = '*DEFI'
VAR#3.STA = '*OFF'
VAR#3.SCOPE = '*SYS '
VAR#3.TYPE = '*TEMP' 
*END-OF-VAR
.......
.......
.......
VAR#58.TRACE-ID = 'TSSVADM'
VAR#58.SUBSYS-NAME = 'SPOOL'
VAR#58.SUBSYS-VERSION = '04.9'
VAR#58.BUF-STA = '*INIT'
VAR#58.STA = '*ON'
VAR#58.SCOPE = '*SYS '
VAR#58.TYPE = '*TEMP'
*END-OF-VAR
Powered by Atlassian Confluence and Scroll Viewport.