The Listener component automatically gathers information about the operating environment of an application. The counters that are gathered are the same, with few exceptions, regardless of the operating system in use.
For more information, see Archiving Manager flags and Opening an archive file.
Archiving Manager syntax
The Archiving Manager uses the following syntax: java –jar archiver.jar [flags] cluster.xml.
Archiving Manager flags
The following parameters can be passed as flags to the Archiving Manager:
| Flag | Definition |
|---|---|
| cluster.xml | Specifies the path and name of the cluster definition. Data from all of the listeners on the hosts that are specified in this file are archived. |
| -d path | Specifies the path of the directory in which the generated archives are saved. Each listener connection results in a separate archive file in this directory. The default value is the current directory. |
| -h | Specifies that the available listener history is included in the generated archive file. |
| -i seconds | Specifies the interval in seconds. If an interval is not defined, the interval remains the same as it was before. |
| -m MaxTries | Specifies the number of times the archiver tries to reconnect to a host in a specified cluster when the connection is lost. The scheduler retries the number of times that are specified, waiting 5 seconds between each try, before it ends the reconnection. The default value for MaxTries is 5. |
| -n timespec | Specifies the amount of time you want the Archiving Manager to log data to a file. After the timespec value is satisfied, a new file is created. The timespec can be in the form of hours:minutes or as a real number, such as 3.5. The archiver can gather historical data, data from the current time and going forward for a designated period, or both, depending on which flags you use. The -n flag specifies that you want to record some data, starting from NOW (whenever you run the command) for some length of time; -n 1:00 means from now until 1 hour from now. The default value for timespec is 0. The default of -n 0 means that the archiver does not wait for further data. If you use the default -n 0, also use the -h flag; otherwise, no data is collected. |
| -t timespec | Specifies the amount of time for which the Archiving Manager collects data, starting at the time of execution. The timespeccan be in the form of hours:minutes or as a real number, such as 3.5. You can also specify -t - to specify you want to continue to collect data until you click Enter. Use this parameter with the -v flag for interactive use. The default value for timespec is 0. |
| -v | Specifies a verbose mode, where you can indicate when an archiver is receiving data. This setting is useful when you use the Archive Manager interactively and identify when an activity occurs. |