The following subcommands can be used with the collector command within dbx to define storage options for the experiment. The subcommands are ignored with a warning if an experiment is active.
Set the mode for archiving the experiment. The allowed values for mode are:
on – Normal archiving of load objects
off – No archiving of load objects
copy – Copy load objects into experiment in addition to normal archiving
If you intend to move the experiment to a different machine or read it from another machine, you should enable the copying of load objects. If an experiment is active, the command is ignored with a warning. This command does not copy source files or object files into the experiment.
Limit the amount of profiling data recorded to value megabytes. The limit applies to the sum of the amounts of clock profiling data, hardware counter profiling data, and synchronization wait tracing data, but not to sample points. The limit is only approximate, and can be exceeded.
When the limit is reached, no more profiling data is recorded but the experiment remains open and sample points continue to be recorded.
By default, the amount of data recorded is unlimited.
Governs where the experiment is stored. This command is ignored with a warning if an experiment is active. The allowed values for option are:
directory directory-name – Sets the directory where the experiment and any experiment group is stored. This subcommand is ignored with a warning if the directory does not exist.
experiment experiment-name – Sets the name of the experiment. If the experiment name does not end in .er, the subcommand is ignored with a warning. See Where the Data Is Stored for more information on experiment names and how the Collector handles them.
group group-name – Sets the name of the experiment group. If the group name does not end in .erg, the subcommand is ignored with a warning. If the group already exists, the experiment is added to the group. If the directory name has been set using the store directory subcommand and the group name is not an absolute path, the group name is prefixed with the directory name.