Managing trace information collection

How to start and stop the information collection process

This topic describes how to begin and end the information collecting process.

Starting the information collection

To start information collection:

  1. When Transfer CFT starts up, the user enters the CFTTRACE START parameter (START=CFT).
  2. 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:

  1. 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
  2. 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
  3. If a STARTTRC command is entered before the corresponding file has been defined, it is simply rejected and is without effect
  4. Whether there are one or more CFTTRACE commands, a single task ensures that all the trace files are filled

Stopping the collection process

To stop 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 vector.

Note that:

  • 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 MODE=DELETE command.

Transfer CFT processes the command as follows:

  1. All traces with output to the file in question are shutdown immediately.
  2. 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.

Related Links