Agent properties define the configuration of the local agent running for the target database.

Agent properties are found after the [agent] directive in the agent properties file. A properties file can only have one [agent] section. The properties file must be stored in the directory where the target database resides.

Note: Although you may create a source database without an [agent] section, it is recommended that every replication database include an [agent] section to allow the database to become a named target.

Property names and values in the section are separated by an equal sign (for example, name=agent1).

Note: When you add comments to a properties file, place them on a new line that begins with the pound sign (#). Do not specify a comment on the same line as a property value definition.

The following table provides a list of agent properties and their values.

Table 1. Agent properties
Property name Value Description
ai-streaming 0 | 1 Specifies if AI Streaming is enabled.
  • 0 — AI Streaming is disabled.
  • 1 — AI Streaming is enabled. This is the default.

When AI Streaming is enabled, the replication agent utilizes multi-threading to pull the AI blocks from the source, and store and apply the data on the target.

AI Streaming is enabled by default.
connect-timeout seconds Specifies how many seconds the OpenEdge Replication agent will wait for connection from the OpenEdge Replication server before the replication agent shuts itself down.

seconds is an integer greater than or equal to 120 (which is the default) and less than or equal to 86,400.

Using this property means you do not have to perform a forced shutdown on your target database. If the OpenEdge Replication agent does not receive a connection attempt from the OpenEdge Replication server before the number of seconds specified have elapsed, the OpenEdge Replication agent will terminate and allow some limited system-level target database connections.
database db_name Specifies the target database name.
ipver ipv4 | ipv6 Specifies whether to use TCP/IP IPv4 or TCP/IP IPv6 between the Replication server and the Replication agent. If the target database broker is using TCP/IP IPv6, OpenEdge Replication must also use IPv6.
listener-maxport port-number Specifies the maximum TCP port number for the agent.

port-number must be greater than the value of listener-minport+1 and less than the maximum allowable port number on the system.

For UNIX the maximum port number is 65534. For Windows the maximum port number is 32765.
listener-minport port-number Specifies the minimum TCP port number. The agent selects a port in a range between the values specified by listener-minport and listener-maxport.

port-number must be greater than 1024 and less than the value of listener-maxport.
maximum-polling-delay milliseconds Specifies the maximum value, in milliseconds, for a polling delay.

By default, the maximum polling delay is 500 ms.

Set milliseconds to a value between 500 and 1000, inclusive.
minimum-polling-delay milliseconds Specifies the minimum value, in milliseconds, for a polling delay.

By default, the minimum polling delay is 5 ms.

Set milliseconds to a value between 1 and 30, inclusive.

The polling delay starts at the minimum, specified by minimum-polling-delay, and increases by 5 ms increments, during periods of inactivity to the maximum delay, specified by maximum-polling-delay. Once activity occurs during polling, the delay is reset to the minimum-polling-delay value.
name agent_name Specifies the OpenEdge Replication agent name. By convention, the agent-name should match the name specified in the source database properties file.

ALL is not allowed as an agent name. Each agent must have a unique name.
rsb-cache-size cache-size Specifies the size of the Replication Streaming cache in units of an AI block, when AI Streaming is enabled (ai-streaming=1). If AI Streaming is not enabled, this property is ignored.

cache-size is a non-negative integer that determines the size of the cache. The default is 5000.