Setting an Event Set's State

An event set's state determines whether information on the events in that event set is logged to the event set's trace logs. To set an event set's state, do the following:

1. Verify that you have the necessary privilege. To set the state of a kernel event set, you must be logged in as root on the local machine. To set the state of a server process event set, you must be listed in the administrative list associated with that process on the corresponding machine; if necessary, issue the bos lsadmin command to check.

2. Issue the dfstrace setset command to set the state of each specified event set:

$ dfstrace setset [-set set_name...] [{-active | -inactive | -dormant}]
[-cdsentry server_entry_in_CDS]

The -set set_name option specifies the name of each event set whose state you want to set. Omit this option to set the state for all non-persistent kernel event sets on the local machine or all non-persistent server process event sets for the server process specified with the -cdsentry option.

The -active option sets the state of each specified event set to active. This option enables tracing for each specified event set. Use this option or the -inactive or -dormant option.

The -inactive option sets the state of each specified event set to inactive. This option disables tracing for each specified event set; however, each event set continues to claim space occupied by each log to which it sends data. Use this option or the -active or -dormant option.

The -dormant option sets the state of each specified event set to dormant. This option disables tracing for each event set; furthermore, each event set releases its claim to space occupied by each log to which it sends data. Use this option or the -active or -inactive option.

The following command sets the event state of all non-persistent kernel event sets on the local machine to inactive:

# dfstrace sets -inactive