InitialAgents

The InitialAgents parameter defines the number of agents that the High-speed Apply Engine must start at the beginning of an apply request. The number of agents that you specify depends on the resources which are available on the system where the target database resides. 

Related topics

Agent-parameters

Considerations

Attributes

This parameter has the following attributes:

Attribute

Value

Section

[Agent]

Abbreviation

None

Required?

No

Valid values

An integer greater than or equal to 1 and less than or equal to the value of MaxAgents (MaxAgents)

Default value

Depends on the value of MaxAgents

In general, the default for InitialAgents is one half the value of MaxAgents (rounded down), except when MaxAgents is less than four. For example:

  • MaxAgents=1, InitialAgents=1
  • MaxAgents=2 to 5, InitialAgents=2
  • MaxAgents=6, InitialAgents=3
  • MaxAgents=7, InitialAgents=3

Usage

Specify a value representing a number of agents. Consider the following points about the InitialAgents parameter:

  • Each started agent requires a connection to the target database.
  • This parameter defines the minimum number of agents that High-speed Apply Engine requires to start processing. If sufficient connections are not available to start this number of agents, the apply request terminates.
  • If you do not have information about the number of database connections available in your environment, we recommend consulting your database administration personnel before changing the default value of this parameter.
  • By setting this parameter higher, you can reduce the small delay that occurs when High-speed Apply Engine starts additional agents during the apply request.
  • If you set this parameter too high, you can:
    • Limit the flexibility of High-speed Apply Engine
    • Use more database resources than you need

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*