Configuring the Siebel ARM Query Tool

This topic is part of Analyzing Siebel ARM Files Using the Siebel ARM Query Tool. It describes how you can configure the Siebel ARM Query Tool. An example of configuring the Siebel ARM Query Tool is modifying the amount of memory that the Siebel ARM query uses, to improve statistical accuracy.

The following table describes the flags that you can use to configure the Siebel ARM Query Tool. All of the listed options must be preceded by the option -config.

Flag	Description
file=macro_file_name	Specifies the file that contains a macro. For more information about using macros, see Using Macros with the Siebel ARM Query Tool.
macro=macro_name(string)	Executes the specified macro and passes the specified string as the first argument to the macro. Before you can use this flag, you must specify the file that contains the macro, by using the file flag: -config file=macro_file_name
gmt=0	Parse all time stamps (on the command line) and displays all time in Greenwich Mean Time (GMT) to the command window. If you do not specify this flag, then the Siebel ARM Query Tool uses local time.
gmt=[+-]HHMM	Parses and reports all times as an offset from GMT. Offsets are specified in the HHMM notation, where HH is the hours (0023) and MM is the minutes (00 to 59). For example, to report Pacific Standard Time (PST), use the gmt flag as follows: –config gmt=-0800
datalimit=limit	Specifies a maximum number of records to return, where limit is the maximum number. When the maximum number is exceeded, an error message (data limit exceeded) appears, and the Siebel ARM Query Tool terminates.
timelimit=seconds	Specifies the maximum number of seconds that the Siebel ARM Query Tool can execute. When the maximum number of seconds elapses, the tool exits. The Siebel ARM Query Tool processes in two phases: File collection phase. The tool identifies all required files. The value that you specify for the timelimit flag does not affect this phase; the time that the Siebel ARM Query Tool takes cannot be constrained. Data processing phase. The value that you specify for the timelimit flag affects the length of this phase.
memlimit=memory	Specifies the amount of memory, in megabytes, that the Siebel ARM Query Tool can allocate to an internal buffer which the tool uses to compute aggregated statistics. The more memory that the internal buffer can use, the more accurate are the statistics returned. The default memory limit is 20 MB. You can allocate a value between 5 MB and 500 MB. The value that you specify does not affect performance; it only applies to the buffer that the Siebel ARM query uses for statistical calculation.