WebSpeed
Installation and
Configuration Guide
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. Progress 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.On Windows, use the Progress Explorer to configure the Agents. You add the Parameter File (-pf) startup parameter and name of your parameter file to the Startup Parameters field for the Agent Executable File.
On UNIX, use the Progress Explorer from a remote Windows machine 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 theubroker.properties
file where you define the Transaction Server.For each supported international language, Progress 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 Progress in the
prolang/lang
directory:
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.
Here is a sample setting for the srvrStartupParam option in the section of the
ubroker.properties
file where you define the wsJapan Transaction Server:
Alternatively, the WebSpeed application can let the language or nationality be selected by the user. From the selection, the application can set the CPINTERNAL, CPSTREAM, and DATE-FORMAT attributes of the SESSION handle to the appropriate values.
Code Pages
The Agent’s CPINTERNAL code page (that is, the code page used by the Agent for its internal processing) must be compatible with the code page of the database it connects to. This is easy to accomplish if the databases’s code page is UTF-8. This is the approach recommended by Progress Software Corporation.
The Agent’s CPSTEAM code page (which the Stream Code Page (-cpstream) parameter specifies must be the same as the Agent’s CPSTREAM code page (assuming dynamic code-page support is not used).
Session Options
Supporting an international Web site means more than just supporting several languages. You must also support the cultural difference in date formats and numeric notations. WebSpeed allows you to control how Agents display and process date information and numeric conventions. The Date (-d) parameter lets you specify the format that an Agent uses to process dates. By default, an Agent processes dates as month, day, year. To display a date as day, month, year, specify -d dmy in the Agent’s parameter (
.pf)
file. The European Numeric Format (-E) parameter specifies that a comma (,) represents the decimal point instead of a period (.).On Windows systems, another aspect of an Agent’s session environment that you control through startup parameters is which initialization (
.ini
) file an Agent uses. If you want an Agent to display error messages in a language other than the default language you chose for your WebSpeed installation, you must use an initialization file to set the PROMSGS option to the appropriate version of the PROMSGS file. The WebSpeed Agent can use the [WinChar Startup] section of the initialization file, so you must set PROMSGS there. Specify the Initialization File (-ininame) parameter to specify the name of the initialization file you customized for the Agent.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |