traceson Command

Edit online

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

Item	Description
-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.

Security

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

To turn on tracing of the tcpip group on a foreign host, enter the following command:
```
traceson -h odin  -g tcpip
```
This turns on the tracing for the tcpip group on the odin foreign host.
To turn on tracing of the sendmail subsystem on a foreign host, enter the following command:
```
traceson -h odin  -s sendmail
```
This turns on the tracing for the sendmail subsystem on the odin foreign host.

Files

Item	Description
/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.