Controlling the trace function

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

FTADDPTN	Add a remote system to the partner list
FTMODOPT	Modify operating parameters
FTMODPTN	Modify partner properties in the partner list

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

FTSHWOPT	Information about operating parameters
FTSHWPTN	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 FTMODOPT command. You can differentiate by partner type (openFT, FTP), 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 FTMODPTN (or set before with FTADDPTN).

The following table illustrates four typical cases of trace use.

FTMODOPT	FTMODPTN / FTADDPTN	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 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 FTADDPTN is BY-FT-OPTIONS. The global settings are thus taken over from FTMODOPT.

The following table indicates the interrelations between the most important FTMODOPT and FTADDPTN/FTMODPTN trace settings.

FTMODOPT	FTMODPTN / FTADDPTN	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

You will find details on the trace files and the way they are formatted with FTTRACE in the section “Format of the trace files” and in the section “FTTRACE command”.