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

Output attributes and status of system traces

Component:

BS2000

Functional area:

Error logging

Domain:

ERROR-LOGGING

Privileges:

TSOS
OPERATING
SW-MONITOR-ADMINISTRATION

Routing code:

R

Function

The command provides an overview of all system traces. The default output includes a list of permanent, nonswitchable traces as well as those temporary traces which system administrators can explicitly activate and deactivate with the START-TRACE and STOP-TRACE commands.

The command supports structured output in S variables (see "Output in S variables"). 

Format

SHOW-TRACE-STATUS                                                                                                                            

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


*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>

Operands

TRACE-IDENTIFICATION =
Specifies the traces on which information is to be output.

TRACE-IDENTIFICATION = *ALL(...)
Information is to be provided on all defined traces.
If the traces involved are not statically defined, they are assigned to a specific subsystem that can be defined in more detail in the following operands.

SUBSYSTEM-NAME =
Specifies the subsystem to which the trace is assigned.

SUBSYSTEM-NAME = *ALL
Displays information in all cases, regardless of the subsystem to which the trace is assigned.

SUBSYSTEM-NAME = <name 1..8>
Exact specification of the subsystem to which the trace is assigned and about which information is to be output.

SUBSYSTEM-NAME = *NONE
Displays information only on statically defined traces that are not assigned to any subsystem.

SUBSYSTEM-VERSION =
Specifies the version of the subsystem to which the trace is assigned.

SUBSYSTEM-VERSION = *ALL
Information on the specified traces is to be provided for all versions of the selected subsystem.

SUBSYSTEM-VERSION = <product-version without-man-corr> / <product-version mandatory-man-corr>
Specifies the version number.
If a version number is specified, the format specified here must be identical to the format used when the subsystem was defined (release and correction status mandatory or not allowed; see also "SDF syntax representation").

Possible values (for TRACE-ID=*ALL) are listed in the following table:

TraceID

Subsystem name

Switchable

Brief description

AIDSYS

*NONE

N

AIDSYS trace

ASTRA

*NONE

N

ASTRA trace

CCOPY

CCOPY

Y

CCOPY trace

CMSTRACE

*NONE

Y

CMS trace

CUIRTR

*NONE

Y

CUIR trace

DISKAI

*NONE

Y

Trace for disk attention interrupt processing

DIVTRACE

DIV

Y

DIV trace

DLMTRACE

DLMUSER

Y

DLMUSER trace

DPRTCOM

DPRINTCM

Y

DPRINTCM communication trace

DPSLOG

BS2CP

Y

Trace of IMPORT-PUBSET and EXPORT-PUBSET operations

EMMIO

*NONE

Y

EMMIO trace

FITC

BS2CP

Y

FITC trace

MAILCERR

MAILCLNT

N

MAILCLNT error trace

MAILCEVT

MAILCLNT

Y

MAILCLNT trace

MRSCAT

*NONE

Y

MRSCAT occupation trace

MSCFLOG

MSCF

Y

Trace for MSCF errors

NDVMTRAC

*NONE

Y

BAVOLMON I/O trace

PAGING

*NONE

N

PAGING trace

PRNGDERR

PRNGD

N

PRNGD error trace

PRNGDEVT

PRNGD

Y

PRNGD trace

RECTRACE

*NONE

N

Reconfiguration trace 

SM2EVENT

SM2

Y

SM2 error trace

SM2FUNCT

SM2

Y

SM2 trace for user call

SYNTRACE

*NONE

N

ETMSYNCH trace

TBOURSE

*NONE

Y

ETMBOWK trace

TDISAM

*NONE

Y

K-ISAM trace

TDISAMNK

*NONE

Y

NK-ISAM trace

TDJCTRL

*NONE

N

DJCTRL trace

TDRSRLER

*NONE

N

DRSRL error trace

TDRSRLSY

*NONE

N

DRSRL error trace

TEMMSLT

*NONE

N

EMMSLT trace

TFASTPAM

FASTPAM

Y

Access method trace

TJLOGLOW

*NONE

Y

JMS trace

TJOBPOOL

*NONE

Y

JMS-JOBPOOL trace

TLOCK

*NONE

Y

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

Y

Trace for all NDM FE

TNDM#ERR

BS2CP

N

NDM error trace

TNDM#NKA

BS2CP

Y

Trace for FE NKA module

TNDM#NKD

BS2CP

Y

Trace for FE NKD module

TNDM#NKG

BS2CP

Y

Trace for FE NKG module

TNDM#NKL

DRV

Y

Trace for FE NKL module

TNDM#NKR

BS2CP

Y

Trace for FE NKR module 

TNDM#NKS

NKS

Y

Trace for FE NKS module

TNDM#NKT

BS2CP

Y

Trace for FE NKT module

TNDM#NKV

NKVD

Y

Trace for FE NKV module

TRFA

*NONE

Y

Remote file access trace

TRSOADM

*NONE

N

RSO trace (old RSO version)

TRSOADM

RSO

Y

RSO trace

TSDVINT

*NONE

N

SDV and interrupt trace

TSSVADM

*NONE

N

SPOOL trace (old SPOOL version)

TSSVADM

SPOOL

Y

SPOOL trace

UTLTRACE

*NONE

N

User table load trace

VMMALLOC

BS2CP

Y

Trace for VM allocation

Table 167: Possible values for SHOW-TRACE-STATUS TRACE-ID=*ALL

TRACE-IDENTIFICATION = list-poss(51): <name 1..8>(...)
Specifies up to 51 names of traces on which information is to be requested. If the traces involved are not statically defined, they are assigned to a specific subsystem that can be defined in more detail in the following operands.

SUBSYSTEM-NAME =
Specifies the subsystem to which the trace is assigned.

SUBSYSTEM-NAME = *ALL
Displays information in all cases, regardless of the subsystem to which the trace is assigned.

SUBSYSTEM-NAME = <name 1..8>
Exact specification of the subsystem to which the trace is assigned and about which information is to be output.

SUBSYSTEM-NAME = *NONE
Displays information only on statically defined traces that are not assigned to any subsystem.

SUBSYSTEM-VERSION =
Specifies the version of the subsystem to which the trace is assigned.

SUBSYSTEM-VERSION = *ALL
Information on the specified traces is to be provided for all versions of the selected subsystem.

SUBSYSTEM-VERSION = <product-version without-man-corr> /
<product-version mandatory-man-corr>
Specifies the version number.
If a version number is specified, the format specified here must be identical to the format used when the subsystem was defined (release and correction status mandatory or not allowed; see "product-version" (SDF syntax representation)).

SELECT =
Selects the traces according to their attributes.

SELECT = *ALL
No attributes are specified. 

SELECT = *BY-ATTRIBUTES(...)
Specifies the attributes according to which traces are selected.

STATUS =
Selects traces according to their status.

STATUS = *ANY
All traces are to be output, regardless of status.

STATUS = *ON
Only traces which are activated (ON), or which are in an intermediate state (ON/OFF), are to be output.

STATUS = *OFF
Only traces which are deactivated (OFF), or which are in an intermediate state (ON/OFF), are to be output.

TYPE =
Selects traces according to whether they can be switched on and off.

TYPE = *ANY
All traces are to be output, regardless of whether or not they can be switched on and off.

TYPE = *PERMANENT
Only traces which are permanently switched on are to be output.

TYPE = *TEMPORARY
Only traces which can be switched with a command are to be output.

INFORMATION =
Type of output.

INFORMATION = *NONE
Only the trace ID and its current trace status are to be output.

INFORMATION = *PARAMETERS(...)
Specifies further trace attributes to be output in addition to the trace ID and current status.

TRACE-INFORMATION =
Specifies whether the scope and type of the traces are also to be output.

TRACE-INFORMATION = *NO
The scope and type of the traces are not to be output by default.

TRACE-INFORMATION = *YES
The scope and type of the traces are also to be output.

BUFFER-INFORMATION =
Specifies whether the size and memory class of the trace buffer are also to be output.

BUFFER-INFORMATION = *NO
The size and memory class of the trace buffer are not to be output by default.

BUFFER-INFORMATION = *YES
The size and memory class of the trace buffer are also to be output.

OUTPUT =
Specifies the output destination.

OUTPUT = *SYSOUT
The tabular list is to be output to SYSOUT.
This is the only allowable operand value for the operator at the console. OUTPUT=*SYSLST will be rejected and an error message issued.

OUTPUT = *SYSLST(...)
The tabular list is to be output to SYSLST in both interactive and batch mode.

SYSLST-NUMBER = 0 / <integer 0..99>
Number of the SYSLST file to which output is directed.

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No error

1


CMD0001

Requested trace does not exist

1

1

PDT0213

OUTPUT=*SYSLST operand not permitted for console


32

CMD0221

Internal error

1

64

PDT0200

No trace processed

2

64

PDT0200

One of the traces specified in the list was not processed


64

PDT0209

No authorization for command

Description of the output fields

Field                                     

Meaning / contents

TRACE-IDENTIFICATION

Global information that describes the trace in more detail:

  • NAME

Name of the trace.

  • SS-NAME

Name of the subsystem to which the trace is assigned.

  • SS-VERS

Version number of the subsystem.

STATUS

Current status of the trace. The status description is divided into two parts; any combination may occur.


Part 1 describes the buffer status:

DEF          

No buffer available for trace.

INI

Trace is initialized and buffer data is known to the trace manager.

Part 2 describes the activation status:

ON

Trace is switched on.

OFF          

Trace is switched off.

ON/OFF

Trace is only partially activated.

SCOPE

Scope of a trace:

SYSTEM

Global system trace.

TASK

Task-specific trace.

TYPE

Indicates whether the trace is one that is permanently switched on or one that can be switched on and off:

PERM

Trace is switched on permanently.

TEMP

Trace can be switched on and off.

BUFFER

Information on the trace buffer:

  • SIZE

Size of the trace buffer in bytes.

  • CLASS

Memory class of the trace buffer:

1

Class 1 memory

2

Class 2 memory

3

Class 3 memory

4

Class 4 memory

5

Class 5 memory

Table 168: Output fields of the SHOW-TRACE-STATUS command

Output in S variables

The INFORMATION operand identifies the S variables which are to be created. The following specifications are possible for INFORMATION:

Notation used in command

Abbreviated form used in table

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

Output information

Name of the S variable

T

Contents

Condition

Trace buffer memory class

var(*LIST).BUF-CLASS

I

<integer 1..5>

3,4

Trace buffer size

var(*LIST).BUF-SIZE

I

<integer 0..231>

3,4

Trace buffer status

var(*LIST).BUF-STA

S

*DEFI
*INIT

1,2,3,4

Trace scope

var(*LIST).SCOPE

S

*SYS
*TASK

2,4

Trace switch status

var(*LIST).STA

S

*ON
*OFF
*ON-OFF

1,2,3,4

Name of the subsystem assigned the trace

var(*LIST).SUBSYS-NAME

S

<c-string 1..8>

1,2,3,4

Version of the subsystem

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

Trace switchability

var(*LIST).TYPE

S

*PERM
*TEMP

2,4

Example

/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
VAR#59.TRACE-ID = 'UTLTRACE'
VAR#59.SUBSYS-NAME = '*NONE'
VAR#59.SUBSYS-VERSION = '00.0'
VAR#59.BUF-STA = '*DEFI'
VAR#59.STA = '*ON'
VAR#59.SCOPE = '*SYS '
VAR#59.TYPE = '*PERM'
*END-OF-VAR
VAR#60.TRACE-ID = 'VMMALLOC'
VAR#60.SUBSYS-NAME = 'BS2CP'
VAR#60.SUBSYS-VERSION = '20.0'
VAR#60.BUF-STA = '*INIT'
VAR#60.STA = '*OFF'
VAR#60.SCOPE = '*SYS '
VAR#60.TYPE = '*TEMP'
*END-OF-VAR
Powered by Atlassian Confluence and Scroll Viewport.