RTS_ERROR_DUPLICATE_HOSTNAME error messages

The RTS_ERROR_DUPLICATE_HOSTNAME error message is displayed in logs when two agents from the same agent machine try to connect to the Topic Service, and the second agent gets rejected.

An example of such a message is shown below, in qpea.log (QPEA's SYSOUT DD).

Mon Mar 2 09:55:23.666 2015:/shrd/bmm/prod/B_Hotfix_7_0_00_150/eadev/qpea/rtsp.c(3696)[1]:logLevel:0-11530760:Connection to topic server failed with RTS_ERROR_DUPLICATE_HOSTNAME (3), will try again in 500 seconds.

There are three ways in which this issue can be resolved:

Reconfigure the second agent so it will be seen by the Topic Service as a separate agent host

In this method, leave one agent as it is and reconfigure the other agent so it will be seen by the Topic Service as a separate agent host.

To reconfigure the other agent, add a Local_HostName preference to the "Agent" stanza in EAAXML, as shown below.

<Agent>
 <Preferences>
  <PreferenceAttribute>
  (...)
  <PreferenceAttribute>
   <PreferenceName>Local_HostName</PreferenceName>
   <PreferenceValue>AlternateHostNameHere</PreferenceValue>
  </PreferenceAttribute>
 </Preferences>
</Agent>

where AlternateHostNameHere is the alternate hostname under which this agent is supposed to appear in the Management Console.

Have the agent use a different (non-default) port number

To do this, add the "agent_listen_port" stanza to the eaapi.ini file (distributed systems), as shown below.

[networksettings]
agent_listen_port=1234

or to EAAPIINI DD (z/OS)

(networksettings)
agent_listen_port=1234

where 1234 is the alternate port number that should be used by the Extensible Agent (qpea).

Change the port numbers for the WebSphere MQ Monitor and the WebSphere MQ Configuration extensions 

To do this, modify the "ServicePort" preferences in EAAXML, as shown below.

<PreferenceAttribute>
 <PreferenceName>ServicePort</PreferenceName>
 <PreferenceValue>AlternatePortNumberHere</PreferenceValue>
</PreferenceAttribute>

where AlternatePortNumberHere is the alternate port number that should be used by the extension.