Sets the state of server process or kernel event sets
Synopsis
dfstrace setset [-set set_name...] [{-active | -inactive | -dormant}]
[-cdsentry server_entry_in_CDS]
[-help]
Options
-set set_name
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.
-active
Sets the state of each specified event set to active. Use this option or the -inactive or -dormant option.
-inactive
Sets the state of each specified event set to inactive. Use this option or the -active or -dormant option.
-dormant
Sets the state of each specified event set to dormant. Use this option or the -active or -inactive option.
-cdsentry server_entry_in_CDS
Specifies the full DCE path name (/.:/hosts/machine/process_name) of a server process whose event set
states you want to set. If this option is used with the -set option, only the states of the specified event sets are set; if this option is used without the -set option, the
state of all non-persistent event sets associated with the specified server process are set. Omit this option to set the state of kernel event sets.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The dfstrace setset command sets the state of the server process or kernel event sets. To set the state of a kernel event set, you must run this command on
the machine that contains that event set. To set the state of a server process event set, you can run the command from any machine; however, you must identify the corresponding server process by
specifying the process with the -cdsentry option.
To set the state of a specific event set, identify the event set with the -set option. Use the -cdsentry option to set the state of a specific server process event set, omit that option to set the state of a specific kernel event set.
To set the state of each kernel event set on a machine, run the dfstrace setset command without the -set option. To set the state of each event set associated with a particular server process, run the command with the -cdsentry option, but without the -set option. Note that you cannot set the state of persistent event sets in this global manner. The persistent attribute prevents accidental resetting of an event set's state. The attribute is assigned to an event set when the kernel or server process is compiled and cannot be changed.
The state of each event set is defined by using the -active, -inactive, or -dormant option. These options correspond to the following event set states:
· active - Tracing is enabled for the event set.
· inactive - Tracing is temporarily disabled for the event set; however, the event set continues to claim space occupied by the logs to which it sends data.
· dormant - Tracing is disabled for the event set; furthermore, the event set releases its claim to space occupied by the logs to which it sends data. When all of the event sets that send data to a particular log are in this state, the space for that log is deallocated.
Privilege Required
To set the state of a kernel event set, the issuer must be logged in as root on the local machine. To set the state of a server process event set,
the issuer must be listed in the admin list associated with that process on the machine specified by the -cdsentry option (for example, admin.fl for the flserver
process and admin.ft for the ftserver process).
Examples
The following command sets the event state of all kernel event sets on the local machine to inactive:
# dfstrace sets -inactive
The following command sets the event state of the event set ubikvote to active for the flserver process on the machine dewitt:
$ dfstrace sets -set ubikvote -active -cdsentry /.:/hosts/dewitt/flserver
Related Information
Commands: dfstrace lsset(8dfs)