Use this command to run the emulation program (EP) line trace function of
the Dynamic Dump utility. You can:
- Activate the EP line trace function
- Start or stop different line traces for different subchannel addresses
- Send the trace data to the TPF system and then write it to a DYN tape
- Stop sending trace data to the TPF system
- Stop the EP line trace function.
Requirements and Restrictions
- The TPF system must be in CRAS state or higher.
- The EP must be loaded on the 3705 control unit that you want to
trace.
- The 3705 load and dump functions cannot be active.
- You must start the EP line trace function before you can start any line
traces. Once you start the EP line trace function, you have 60 seconds
to start a line trace. If you do not start a line trace in 60 seconds,
the EP trace function ends.
- Mount a DYN tape before you start sending trace data to the TPF
system.
- Once you start sending trace data to the TPF system, you cannot start
another line trace until you stop sending the trace data to the TPF
system.
- Once you stop sending trace data to the TPF system, you have 60 seconds to
start another line trace or the EP trace function ends.
- You can trace a maximum of 16 subchannels at one time.
Format
- NSC ccu
- starts the EP line trace function on the 3705 control unit, where
ccu is the 3-digit hexadecimal channel address of the 3705 control
unit.
- OPT
- starts or stops a line trace for the specified subchannel address,
where:
- 10subaddr
- starts a level 2 line trace for the specified 2-digit hexadecimal
subchannel address.
- 11subaddr
- stops the level 2 line trace for the specified 2-digit hexadecimal
subchannel address.
- 20subaddr
- starts a level 3 line trace for the specified 2-digit hexadecimal
subchannel address.
- 21subaddr
- stops the level 3 line trace for the specified 2-digit hexadecimal
subchannel address.
- 30subaddr
- starts a level 2 and level 3 line trace for the specified 2-digit
hexadecimal subchannel address.
- 31subaddr
- stops the level 2 and level 3 line trace for the specified 2-digit
hexadecimal subchannel address.
- 7000
- starts a level 3 line trace for the trace-defined subchannels.
- 7100
- stops the level 3 line trace for the trace-defined subchannels.
- 70FF
- starts a level 3 line trace for all subchannels.
- 71FF
- stops the level 3 line trace for all subchannels.
- DYN
- sends the trace data to the TPF system and then writes the trace data to a
DYN tape.
- Note:
- Mount a DYN tape before you specify this parameter.
- STP
- stops sending trace data to the TPF system.
- END
- ends the EP line trace function and stops sending trace data to the TPF
system.
Additional Information
- Level 2 interrupts are line data interrupts.
- Level 3 interrupts are time-out complete or channel data interrupts (such
as initial selection data) or status.
- Level 1 error log entries are traced continuously after a level 3 trace is
started.
Examples
The trace function is started for the specified control unit in the
following example.
+--------------------------------------------------------------------------------+
|User: Z3705 TRC NSC 01C |
| |
|System: 37050103I 08.32.28 60 SEC.LIMIT ACTIVE |
| 37050098I 08.32.28 ENT NEXT OPT |
+--------------------------------------------------------------------------------+
A level 2 trace is started on subchannel 12 in the following
example.
+--------------------------------------------------------------------------------+
|User: Z3705 TRC OPT 1012 |
| |
|System: 37050098I 08.32.38 ENT NEXT OPT |
+--------------------------------------------------------------------------------+
A level 3 trace is started on all subchannels in the following
example.
+--------------------------------------------------------------------------------+
|User: Z3705 TRC OPT 70FF |
| |
|System: 37050098I 08.42.53 ENT NEXT OPT |
+--------------------------------------------------------------------------------+
The trace data is sent to the TPF system and then written to a DYN tape in
the following example.
+--------------------------------------------------------------------------------+
|User: Z3705 TRC DYN |
| |
|System: 37050101I 08.34.09 TRC BLOCK 0001 WRITTEN |
| 37050101I 08.34.10 TRC BLOCK 0256 WRITTEN |
+--------------------------------------------------------------------------------+
The trace data is no longer sent to the TPF system in the following
example.
+--------------------------------------------------------------------------------+
|User: Z3705 TRC STP |
| |
|System: 37050100I 08.43.41 STOP ACKNOWLEDGED |
| 37050103I 08.43.41 60 SEC.LIMIT ACTIVE |
| 37050098I 08.43.41 ENT NEXT OPT |
+--------------------------------------------------------------------------------+
The trace function is ended in the following example.
+--------------------------------------------------------------------------------+
|User: Z3705 TRC END |
| |
|System: 37050102I 08.47.49 TRC ENDED |
+--------------------------------------------------------------------------------+
Related Information
- See TPF Data Communications Services Reference
for more information about the 3705 communications controller.
- See 3704/3705 Control Program Generation Utilities
Guide for more information about the Dynamic Dump utility.