Controlling the trace function

The FT administrator uses the following commands to control the trace function:

ADD-FT-PARTNER	Add a remote system to the partner list
MODIFY-FT-OPTIONS	Modify operating parameters
MODIFY-FT-PARTNER	Modify partner properties in the partner list

The FT administrator uses the following commands to get information on the current settings:

SHOW-FT-OPTIONS	Information about operating parameters
SHOW-FT-PARTNERS	Information about partner systems

The FT trace function can be switched on and off irrespective of whether the FT system is active or inactive.

You can set the scope of openFT traces globally using the MODIFY-FT-OPTIONS
command. You can differentiate by partner type (openFT, FTP, FTAM), request type (local/remote and synchronous/asynchronous) and trace scope (with/without file contents). The global setting can be modified on a partner-specific basis using MODIFY-FT-PARTNER (or set before with ADD-FT-PARTNER).

The following table illustrates four typical cases of trace use.

MODIFY-FT-OPTIONS	ADD-FT-PARTNER/ MODIFY-FT-PARTNER	Task	Effect
TRACE=*ON	TRACE= *BY-FT-OPTIONS	General tracing of FT operations.	FT operation is fully traced.
TRACE=(SWITCH=ON, OPTIONS= NO-BULK-DATA)	TRACE= *BY-FT-OPTIONS	Connect tracing for all openFT partners.	Mass data transfers are not recorded. Recommended for long-lived traces.
TRACE=(SWITCH=ON ,PART-SELECTION= *FTP)	TRACE= *BY-FT-OPTIONS	Tracing of a certain type of partner over an extended period. (here, ftp partners)	All events relating to a selected partner type are logged. Despite the extended period, the trace volume does not become excessive.
TRACE=(SWITCH=ON ,REQ-SELECTION= *REM)	TRACE= *BY-FT-OPTIONS	Tracing of a specific type of request (here, requests submitted by a remote system)	All events relating to certain request types are logged. Despite the extended period, the trace volume does not become excessive.

The default value for ADD-FT-PARTNER is BY-FT-OPTIONS. The global settings are thus taken over from MODIFY-FT-OPTIONS.

The following table indicates the interrelations between the most important MODIFY-FT-OPTIONS and ADD-/MODIFY-FT-PARTNER trace settings.

MODIFY-FT-OPTIONS	ADD-FT-PARTNER/ MODIFY-FT-PARTNER	Effect
TRACE=*OFF	equals	*OFF
TRACE=*ON	TRACE=*BY-FT-OPTIONS	*ON
	TRACE=*UNCHANGED	Setting retained
	TRACE=*ON	*ON
	TRACE=*OFF	*OFF
TRACE=(SWITCH=ON, PARTNER-SELECTION= partner type)	TRACE=*BY-FT-OPTIONS	*ON if suitable partner type *OFF if unsuitable partner type
	TRACE=*UNCHANGED	Setting retained
	TRACE=*ON	*ON
	TRACE=*OFF	*OFF
TRACE=(SWITCH=ON, REQUEST-SELECTION= request type)	TRACE=*BY-FT-OPTIONS	*ON if suitable request type *OFF if unsuitable request type
	TRACE=*UNCHANGED	Setting retained
	TRACE=*ON	as *BY-FT-OPTIONS
	TRACE=*OFF	*OFF