You can set the OSAGENT_CLIENT_HANDLER_PORT in the configuration.xml for the partition by following the steps listed in page 467 of the Borland Application Server 6.7 Developer Guide.

Or

You can set the OSAGENT_CLIENT_HANDLER_PORT from the BES console.

1) Right click on Smart Agent to go the Smart Agent properties page.

2) Go to the Agent Process Setting tab

3) Click on the Advanced Process Setting button.

4) Add a property OSAGENT_CLIENT_HANDLER_PORT, the port number in my example is 18000.

A brief write up on the ports that Application Server will use to communicate with clients.

Please note the OSAGENT is another term for Smart Agent. I will use the 2 terms interchangeably. OSAGENT_PORT (UDP type)

The VisiBroker-ORB requires the OSAGENT_PORT environment variable to be set to register and query CORBA objects using the Smart Agent. What it means is that the server will do a UDP broadcast to locate an osagent. When it finds an osagent, your CORBA objects (from the BES server) use the OSAGENT_PORT to register themselves to the Smart Agent. This port is not used by the clients.

OSAGENT_CLIENT_HANDLER_PORT (UDP type)

The Smart Agent uses an IPv4 UDP broadcast message to advertise itself. If the Smart Agent needs to be accessible from an external network, the specific port must be open on the firewall.
The client will do an UDP broadcast to locate an osagent. The client will use the first osagent that replies.

OSAGENT_CLIENT_HANDLER_PORT (TCP type)

The TCP port (OSAGENT_CLIENT_HANDLER_PORT) used by the Smart Agent is for Location Service, an extension to the CORBA specification, that enables you to access the information from multiple Smart Agents. The Location Service can see all the available instances of an object to which a client can bind. It is useful for load balancing.

Note that Smart Agent is used primary for the server to register their services and the clients to discover the services.

Once the client has located the object reference from the Smart Agent, the client will uses the IIOP port to communicate with the server.