trace information collection
to start and stop the information collection process
This topic describes how to begin and end the information collecting
Starting the information collection
To start information collection:
- When Transfer CFT starts up,
the user enters the CFTTRACE START parameter (START=CFT).
- During Transfer CFT operations,
the user enters a STARTTRC command.
Information collection is managed by a trace server
task, which makes it possible to resolve trace file access conflict problems.
Serialization is ensured by an internal flag setting mechanism, which
enables message exchanges and synchronization of Transfer CFT tasks.
The collection operation does not pre-empt or significantly
disturb other Transfer CFT mechanisms.
Consequently, if there is a bottleneck in the flag
mechanism (if the volume of traces requested exceeds flagging capabilities
or system resources), messages are purely and simply lost.
Trace mechanisms include the following features:
- You can make traces
started at the same time as Transfer CFT ‘co-exist with other traces,
triggered during Transfer CFT operations, for the same trace file or for
different trace files
- You can create
a trace file with the CFTTRACE command, without having to synchronize
collection with Transfer CFT start-up. To do this, set the START
parameter to DELAYED
- If a STARTTRC
command is entered before the corresponding file has been defined, it
is simply rejected and is without effect
- Whether there are
one or more CFTTRACE commands, a single task ensures that all the
trace files are filled
collection, enter the command: STOPTRC.
The command is transmitted to Transfer CFT, which immediately shuts
down information collection defined for this trace and destroys the corresponding
- The process can
be restarted with STARTTRC; it is possible to use new initialization parameters.
- If the same information
is requested in several different traces and only one of these traces
is shutdown, then the information will still be traced (according to the
definitions of the other traces still active).
Stopping the trace process
To close a trace file, and shutdown the process, enter the SETTRC
Transfer CFT processes the command as follows:
- All traces with output to the
file in question are shutdown immediately.
- The trace file entry is deleted
by the ATM manager.
The ATM component’s server task shutdowns as soon
as there are no more trace files to manage, that is, that there are no
more active trace acquisition processes.
When Transfer CFT shuts down
(SHUT), all the trace files are closed and the server task shuts down.