Commands Reference, Volume 5

tracesoff Command

Purpose

Turns off tracing of a subsystem, a group of subsystems, or a subserver.

Syntax

Subsystem

tracesoff [ -h Host] { -g Group | -p SubsystemPID | -s Subsystem}

Subserver

tracesoff [ -h Host] -t Type [ -p SubsystemPID] { -o Object | -P SubserverPID}

The tracesoff command sends the System Resource Controller a subsystem request packet that is forwarded to the subsystem to turn tracing off. Tracing is unsuccessful if the communication method for the subsystems is signals.

Note: Tracing is subsystem dependent.

Flags

-g Group	Specifies a group of subsystems to turn tracing off. The command is unsuccessful if the Group name is not contained in the subsystem object class.
-h Host	Specifies the foreign host on which this trace action is requested. The local user must be running as "root". The remote system must be configured to accept remote System Resource Controller requests. That is, the srcmstr daemon (see /etc/inittab) must be started with the -r flag and the /etc/hosts.equiv or .rhosts file must be configured to allow remote requests.
-o Object	Specifies that a subserver Object name is to be passed to the subsystem as a character string.
-p SubsystemPID	Specifies a particular instance of the subsystem to turn tracing off, or a particular instance of the subsystem to which the trace off subserver request is to be passed.
-P SubserverPID	Specifies that a SubserverPID is to be passed to the subsystem as a character string.
-s Subsystem	Specifies a subsystem to turn tracing off. The Subsystem name can be the actual subsystem name or the synonym name for the subsystem. The command is unsuccessful if the Subsystem name is not contained in the subsystem object class.
-t Type	Specifies a subsystem subserver to turn tracing off. The command is unsuccessful if the Type is not contained in the subserver object class.

Examples

To turn off the tracing of a subsystem, enter:
tracesoff -s tcpip

This turns the tracing off for the tcpip subsystem.

Files

/usr/bin/tracesoff	Contains the tracesoff command.
/etc/objrepos/SRCsubsys	Specifies the SRC Subsystem Configuration Object Class.
/etc/objrepos/SRCsubsvr	Specifies the SRC Subserver Configuration Object Class.
/etc/services	Defines the sockets and protocols used for Internet services.
/dev/SRC	Specifies the AF_UNIX socket file.
/dev/.SRC-unix	Specifies the location for temporary socket files.

Related Information

The traceson command.

The System Resource Controller Overview in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices gives an explanation of subsystems, subserver, and the System Resource Controller.