Try OpenEdge Now
skip to main content
Administration
WebSpeed Administration : Connecting WebSpeed to a Data Source : Creating an international Web site : Configuring agents
 
Configuring agents
To configure agents to run in an international environment, you must address code-page issues and session options when you specify agent parameters. OpenEdge automatically installs the language you select as the default and configures your machine for this default language; however, you must configure each agent to use the appropriate parameters for the country it accepts requests from. Using a parameter (.pf) file helps you manage agent startup and connection information.
You can use OpenEdge Management or OpenEdge Explorer to configure the agents. You add the Parameter File (-pf) startup parameter and name of your parameter file to the Server startup parameters field for the agent.
On UNIX, use OpenEdge Management/OpenEdge Explorer or manually update the ubroker.properties file to configure the agents. You add the Parameter File (-pf) startup parameter and name of your parameter file to the srvrStartupParam option in the section of the ubroker.properties file where you define the Transaction Server.
Note: The srvrStartupParam property is a dynamic property. Any changes to this property only affects new agents started after the value changes because the change affects how the agent is started. Existing (running) brokers and agents are not updated with the new value.
For each supported international language, OpenEdge provides an example parameter file that you can use as the base for creating your own.
The following examples show the contents of parameter files for the Spanish, Japanese, and U.S. agents, respectively. They are based on the parameter files provided by OpenEdge in the prolang/lang directory, as shown:
-db intldb -cpinternal SHIFT-JIS -cpstream SHIFT-JIS -d ymd
-db intldb -cpinternal iso8859-1 -cpstream iso8859-1 -d dmy -E
-db intldb -cpinternal iso8859-1 -cpstream iso8859-1
These files provide the information that agents need to connect to a local database and to run with session options appropriate to their cultural context. For example, each agent displays dates in a distinct format; in addition, the Spanish agents use the comma as a radix for decimal data. You can add other parameters to the parameter file to further manage how agents connect to the databases.
The following is a sample setting for the srvrStartupParam option in the section of the ubroker.properties file where you define the wsJapan Transaction Server:
srvrStartupParam=-p web/objects/web-disp.p -cpstream iso8859-1 -weblogerror -p web/objects/web-disp.p -weblogerror -pf japan.pf
Note: The srvrStartupParam property is a dynamic property. Any changes to this property only affects new agents started after the value changes because the change affects how the agent is started. Existing (running) brokers and agents are not updated with the new value.
Alternatively, the WebSpeed application can let the language or nationality be selected by the user. From the user's selection, the application can set the CPINTERNAL, CPSTREAM, and DATE-FORMAT attributes of the SESSION handle to the appropriate values.
* Code pages
* Session options