Trace Handling

In this section:

Trace Panel Commands

Trace Detail Lines

The Trace Index

MSORGN1  JOB07626-------  CONSOLE TRACE panel - Line:001(013)
COMMAND ===>
 
TR S TY ALL NAME * SERV * USER * TCB * LEV *
C TRACE SERVICE USERID TCBADR TRACEDD_ DDNAME TYP COND LEVEL
FSTRACE5 FOCUS MSOUSR 7CA680 TR000013 FSTRACE5 ACT 4
STDOUTFX FOCUS MSOUSR 7CA680 TR000004 STDOUTFX ACT 0
HFTRACE FOCUS MSOUSR 7CA680 TR000001 STDOUT ACT 2048
DYNTRACE FOCUS MSOUSR 7CA680 TR000003 STDOUTDY ACT 0
FSTRACE FOCUS MSOUSR 7CA680 TR000002 FSTRACE ACT 0
STDOUTFX FOCUS MSOUSR2 7CC628 TR000008 STDOUTFX ACT 0
HFTRACE FOCUS MSOUSR2 7CC628 TR000005 STDOUT ACT 2048
DYNTRACE FOCUS MSOUSR2 7CC628 TR000007 STDOUTDY ACT 0
FSTRACE FOCUS MSOUSR2 7CC628 TR000006 FSTRACE ACT 0
STDOUTFX FOCUS MSOUSR3 7CC310 TR000012 STDOUTFX ACT 0
HFTRACE FOCUS MSOUSR3 7CC310 TR000009 STDOUT ACT 2048
DYNTRACE FOCUS MSOUSR3 7CC310 TR000011 STDOUTDY ACT 0
FSTRACE FOCUS MSOUSR3 7CC310 TR000010 FSTRACE ACT 0

The TRACE panel is displayed when the TRACE command is entered on the command line. The TRACE panel allows activating and managing of the various traces which IBI products and options may generate. Specific information on traces to be generated is provided by Information Builders support personnel. Operator authority is required in order to use the trace facility.


Top of page

Trace Panel Commands

The INDEX command may be entered in the COMMAND field to display the trace index.


Top of page

Trace Panel Control Fields

Use the trace panel control fields to control the format of the trace display and to select that traces are to be displayed.

TR

TR can be set to S or F. S selects the short, single-line format display. On a 3270 Model 5, this display extends past 80 columns. F selects the full, multi-line format display.

TY

Use TY to restrict the trace types displayed. ACT displays active traces while DEF displays deferred traces. Specifying * causes all trace types to be displayed.

NAME

Use NAME to restrict the display to traces with the specified trace name. Wildcards using * may be used.

SERV

Use SERV to restrict the display to traces in tasks running under the specified service. Wildcards using * may be used.

USER

Use USER to restrict the display to traces in tasks running under the specified userid. Wildcards using * may be used.

TCB

Use TCB to restrict the display to traces in the specified TCB. Wildcards using * may be used.

LEV

Use LEV to restrict the display to traces running with the specified level. Specify * to get all levels.


Top of page

Trace Detail Lines

The following columns are displayed for each trace:

C

May be used to specify a command to be issued for the specified trace. The commands which are valid are:

  • S - Start Trace

  • This command starts the specified trace.

  • P - Stop Trace

  • This command stops the specified trace.

TRACE

Contains the name of the trace.

SERVICE

Contains the name of the service under which the task is running.

USERID

Contains the userid associated with the task.

TCBADDR

Contains the address of the task's TCB.

TRACEDD

Contains the real (translated) ddname to which trace records are written.

DDNAME

Contains the untranslated ddname that is used for writing trace records.

TYP

Contains one of the following values:

  • ACT - Active

  • An Active trace is currently running, although it only produces output if it is set to an appropriate level.

  • DEF - Deferred

  • A Deferred trace is not currently running; rather, it is waiting for a trace matching its selection criteria to be started.

COND

This field contains the value COND if the trace is a conditional trace.

LEVEL

This field contains the current level for the trace.


Top of page

The Trace Index

The trace index provides a list of all traces that have been activated for the life of the MSO address space. Active traces are highlighted.

MSORGN1  JOB07550------- .CONSOLE DATA SET BROWSER. ----------Line 000001
COMMAND ===>
 
..Date.. ..Time..JobName TracName Server User TCBADR DDname RealNam
11/17/94 10.43.17MSORGN1 DYNTRACE FOCUS MSOUSR 7BEE88 STDOUTDY TR000003
11/17/94 10.44.23MSORGN1 DYNTRACE FOCUS MSOUSR2 7BF3F0 STDOUTDY TR000007

If traces are being recorded in a PDSE or in sequential data sets, the trace index allows use of the data set browser to display traces. The data set browser may not be used for active traces, only for closed ones, and it may not be used if traces are being recorded in SYSOUT files.

The trace index contains the following columns:

(unlabeled command field)

You may enter S to the left of the trace information to select the trace for browsing. This field is only available if the trace is eligible for browsing.

Date

Date the trace was activated.

Time

Time the trace was activated.

JobName

Name of the MSO address space.

TracName

Name of the trace.

Server

Service under which the task is running.

User

Contains the userid associated with the task.

TCBADR

Contains the address of the task's TCB.

Ddname

ddname that FOCUS is using to write the trace.

RealNam

Real (translated) ddname that MSO is using for the trace.


Information Builders