Commands Reference, Volume 5

traceson Command

Purpose

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

Syntax

Subsystem

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

Subserver

traceson [ -h Host] [ -l] -t Type [ -o Object] [ -p SubsystemPID] [ -P SubserverPID]

Description

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

Note: Tracing is subsystem dependent.

Tracing may occur in either short or long form. When the -l flag is absent, the trace request is assumed to be a short trace.

Flags

-g Group	Specifies a group of subsystems to turn tracing on. 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.
-l	Specifies that a long trace is requested.
-o Object	Specifies that a subserver object is to be passed to the subsystem as a character string.
-p SubsystemPID	Specifies a particular instance of the subsystem to turn tracing on, or a particular instance of the subsystem to which the trace subserver request is to be passed.
-P SubserverPID	Specifies that a subserver PID is to be passed to the subsystem as a character string.
-s Subsystem	Specifies the subsystem to turn tracing on. The Subsystem name can be either 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 subserver to turn tracing on. The command is unsuccessful if the Type is not contained in the subserver object class.

Examples

To turn on tracing of the tcpip subsystem on a foreign host, enter:

traceson -h odin -s tcpip

This turns on the tracing for the tcpip subsystem on the odin foreign host.

Files

/usr/bin/traceson	Contains the traceson 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 tracesoff command.

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