IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

aa1.properties

The following properties are listed in the aa.properties file. If you have more than one instance of the Archive Agent, you will have aa1.properties, aa2.properties, and so on.

serverPortNumber

This value specifies the port where the Archive Agent listens for the socket connections from the other components.

queues.pmi.size

The default value is 1024 Performance Monitoring Infrastructure (PMI) records. This value specifies the size of the PMI queue. This is a circular queue and the Archive Agent wraps the queue (cleans the queue). If the queue reaches this set size, the Publish Server pushes PMI data to this queue.

queues.pmijmxengine.size

The default value is 1024 PMI records. This value specifies the number of slots in the PMI Java Management Extensions (JMX) engine queue used to process data going from the Publish Server to the Archive Agent. If you are seeing items being dropped from the queue, you can increase the size, but that would also require an increase in the maximum heap size.

queues.pmi.priority

Request help from IBM support before attempting to modify this parameter. The default value is 5. This value specifies the priority of the PMI dequeuing thread (also known as the PMI Reader Thread). The default values range from 1 to 10.

queues.method.size

The default value is 5120 request records. This value specifies the size of the method or request queue. This is a circular queue and the Archive Agent wraps the queue (cleans the queue). If the queue reaches this set size, the Publish Server pushes request or method data to this queue.

queues.method.priority

Request help from IBM support before attempting to modify this parameter. The default value is 5 method availability records. This value specifies the priority of the method or request dequeuing thread (also known as the Request Reader Thread).

queues.availability.size

The default value is 3072 availability records. This value specifies the size of the availability queue. This is a circular queue and the Archive Agent wraps the queue (cleans the queue). If the queue reaches this set size, the Publish Server and Kernel push availability data to this queue.

queues.availability.priority

Request help from IBM support before attempting to modify this parameter. The default value is 5. This value specifies the priority of the availability dequeuing thread (also known as the Availability Reader Thread).

queues.memory.size

The default value is 1024 memory records. This value specifies the size of the memory queue. This is a circular queue and the Archive Agent wraps the queue (cleans the queue). If the queue reaches this set size, the Publish Server pushes memory related data (Garbage Collection data and Heap Dump data) to this queue.

queues.memory.priority

Request help from IBM support before attempting to modify this parameter. The default value is 5. This value specifies the priority of the memory dequeuing thread (also known as the Memory Reader Thread).

queues.trap_actionHistory.size

The default value is 1024 PMI records. This value specifies the number of slots in the trap action history queue used to process data going from the Publish Server to the Archive Agent. If you are seeing items being dropped from the queue, you can increase the size, but that would also require an increase in the maximum heap size.

queues.polling.size

The default value is 1024 PMI records. This value specifies the number of slots in the polling queue used to process data going from the Publish Server to the Archive Agent. If you are seeing items being dropped from the queue, you can increase the size, but that would also require an increase in the maximum heap size.

TEXTSTRING_SEQ_BLOCK

The default value is 1000. This value specifies how many keys the primary key generator should cache in memory for the table TEXTSTRING. A higher number increases efficiency by reducing the number of calls to the database to fetch the next block of keys. However this might cause large gaps in the primary key sequence, because when the Archive Agent is stopped, all unused keys in memory are discarded.

TEXTSTRING_LENGTH

The default value is 60. This value specifies the length of the URL string and method or class name string stored in the database. The maximum length is 256.

PROBES_SEQ_BLOCK

The default value is 10. This value specifies how many keys the primary key generator should cache in memory for the table PROBES. A higher number increases efficiency by reducing the number of calls to the database to fetch the next block of keys. However, this might cause large gaps in the primary key sequence, because when the Archive Agent is stopped, all unused keys in memory are discarded.

REQUEST_SEQ_BLOCK

The default value is 200. This value specifies how many keys the primary key generator should cache in memory for the table REQUEST. A higher number increases efficiency by reducing the number of calls to the database to fetch the next block of keys. However, this might cause large gaps in the primary key sequence, because when the Archive Agent is stopped, all unused keys in memory are discarded.

REQUESTDATA_READER_SLEEPTIME

The default value is 2000 milliseconds. This value specifies the time for which the Request reader thread sleeps if no data is available in the request or method queue for dequeuing (queue is empty). After this time elapses, the thread wakes up and re-checks the queue to see if data is available in the queue. The request data reader reads data from the request or method queue and processes the data and puts it in a temporary request buffer. A different thread (Request Data writer thread) reads data from this buffer and inserts it into the database.

REQUESTDATA_WRITER_SLEEPTIME

The default value is 180000 milliseconds. This value specifies the time interval at which the Request writer thread will be inserting data into the database. Request writer thread reads data from the request buffer and inserts it into the database.

REQUESTDATA_BUFFER_THRESHOLD

The default value is 20. If the number of requests in the request buffer exceeds this size, the writer thread wakes up and inserts requests into the database irrespective of the REQUESTDATA_WRITER_SLEEPTIME property.

BATCH_THRESHOLD

The default threshold is 10000 inserts in a batch. This value specifies the maximum number of database inserts that can be executed in a batch. When this number is exceeded, the database insert buffer is flushed to avoid running out of memory space.

AVAILABILITY_READER_SLEEPTIME

The default value is 2000 milliseconds. This value specifies the time that the Availability reader thread sleeps if no data is available in the availability queue for dequeuing (queue is empty). After this time elapses, the thread wakes up and re-checks the queue to see if data is available in the queue.

PMI_READER_SLEEPTIME

The default value is 2000 milliseconds. This value specifies the time that the PMI reader thread sleeps if no data is available in the PMI queue for dequeuing (queue is empty). After this time elapses, the thread wakes up and re-checks the queue to see if data is available in the queue.

MEMORY_READER_SLEEPTIME

The default value is 2000 milliseconds. This value specifies the time that the memory reader thread sleeps if no data is available in the memory queue for dequeuing (queue is empty). After this time elapses, the thread wakes up and re-checks the queue to see if data is available in the queue.

TRAP_SEQ_BLOCK

The default value is 100. This value specifies how many keys the primary key generator should cache in memory for the tables TRAP_HISTORY, TRAP_THREAD_DUMP, TRAP_METHOD_DETAIL, and TRAP_STACK_TRACE. A higher number increases efficiency by reducing the number of calls to the database to fetch the next block of keys. However, this might cause large gaps in the primary key sequence, because when the Archive Agent is stopped, all unused keys in memory are discarded.

CLOB_BLOCK_SIZE

Default 4000. This is the Character Large Object (CLOB) default reading size.

ENABLE_DATATRIMMER

The default value is true. When set to true, the Archive Agent cleans records that are more than two days old in some tables every two hours. If set to false, you need to manually run aa_deletedata.sh to clean tables. The aa_deletedata.properties contains a list of tables and frequency to delete data.

MEMORY_DATA_DELETE_TIME

The default value is 2940 minutes. This is the amount of time to keep data in the MEMORY_DATA table before it is deleted.

GC_DATA_DELETE_TIME

The default value is 2940 minutes. This is the amount of time to keep data in the GC_DATA table before it is deleted.

SR_OVERVIEW_DATA_DELETE_TIME

The default value is 70 minutes. This is the amount of time to keep data in the SR_OVERVIEW_DATA table before it is deleted.

IMS_THREAD_DATA_DELETE_TIME

The default value is 60 minutes. This is the amount of time to keep data in the IMS_THREAD_DATA table before it is deleted.


Parent topic:

Managing Server properties files

+

Search Tips   |   Advanced Search