Modifying your connection file

The connection file contains XML tags that define the settings you select when you configure your HATS LE connection. You can perform advanced configuration by editing the connection file. To edit the file, start the HATS LE Administrative Console and click Advanced. This section describes the tags used in the connection file.

<hodconnection> tag

The <hodconnection> tag specifies the connection characteristics for the application.

The attributes of the <hodconnection> tag are:

codePage
Specifies the numeric code page number for the code page used in the application. The default value is 037. You select the codePage value when you configure the application. A code page number might be used for more than one location or usage. See the description of the codePageKey attribute for the code page numbers.
codePageKey
Specifies the usage key that corresponds to the numeric codepage. The default value is KEY_US. Valid values for codePage and the location or usage key are:
Table 3. Code pages and usage keys
Code page Usage key
037
KEY_BELGIUM
KEY_BRAZIL
KEY_CANADA
KEY_NETHERLANDS
KEY_PORTUGAL
KEY_US
273
KEY_AUSTRIA
KEY_GERMANY
274
KEY_BELGIUM_OLD
275
KEY_BRAZIL_OLD
277
KEY_DENMARK
KEY_NORWAY
278
KEY_FINLAND
KEY_SWEDEN
280
KEY_ITALY
284
KEY_SPAIN
KEY_LATIN_AMERICA
285
KEY_UNITED_KINGDOM
290
KEY_JAPAN_KATAKANA_EX
297 KEY_FRANCE
420
KEY_ARABIC
424
KEY_HEBREW
500
KEY_MULTILINGUAL
803
KEY_HEBREW_OLD
838
KEY_THAI
870
KEY_BOSNIA_HERZEGOVINA
KEY_CROATIA KEY_CZECH
KEY_HUNGARY
KEY_POLAND
KEY_ROMANIA
KEY_SLOVAKIA
KEY_SLOVENIA
871
KEY_ICELAND
875
KEY_GREECE
924
KEY_MULTILINGUAL_ISO_EURO
930
KEY_JAPAN_KATAKANA
933
KEY_KOREA_EX
937
KEY_ROC_EX
939
KEY_JAPAN_ENGLISH_EX
1025
KEY_BELARUS
KEY_BULGARIA
KEY_MACEDONIA
KEY_RUSSIA
KEY_SERBIA_MONTEGRO
1026
KEY_TURKEY
1047
KEY_OPEN_EDITION
1112
KEY_LATVIA
KEY_LITHUANIA
1122
KEY_ESTONIA
1123
KEY_UKRAINE
1137
KEY_HINDI
1140
KEY_BELGIUM_EURO
KEY_BRAZIL_EURO
KEY_CANADA_EURO
KEY_NETHERLANDS_EURO
KEY_PORTUGAL_EURO
KEY_US_EURO
1141
KEY_AUSTRIA_EURO
KEY_GERMANY_EURO
1142
KEY_DENMARK_EURO
KEY_NORWAY_EURO
1143
KEY_FINLAND_EURO
KEY_SWEDEN_EURO
1144
KEY_ITALY_EURO
1145
KEY_LATIN_AMERICA_EURO
KEY_SPAIN_EURO
1146
KEY_UNITED_KINGDOM_EURO
1147
KEY_FRANCE_EURO
1148
KEY_MULTILINGUAL_EURO
1149
KEY_ICELAND_EURO
1153
KEY_BOSNIA_HERZEGOVINA_EURO
KEY_CROATIA_EURO
KEY_CZECH_EURO
KEY_HUNGARY_EURO
KEY_POLAND_EURO
KEY_ROMANIA_EURO
KEY_SLOVAKIA_EURO
KEY_SLOVENIA_EURO
1154
KEY_BELARUS_EURO
KEY_BULGARIA_EURO
KEY_MACEDONIA_EURO
KEY_RUSSIA_EURO
KEY_SERBIA_MONTEGRO_EURO
1155
KEY_TURKEY_EURO
1156
KEY_LATVIA_EURO
KEY_LITHUANIA_EURO
1157
KEY_ESTONIA_EURO
1158
KEY_UKRAINE_EURO
1160
KEY_THAI_EURO
1364
KEY_KOREA_EURO
1371
KEY_ROC_EURO
1388
KEY_PRC_EX_GBK
1390
KEY_JAPAN_KATAKANA_EX_EURO
1399
KEY_JAPAN_ENGLISH_EX_EURO
delayInterval
Specifies the time (in milliseconds) that the server waits until a full host screen that is not the first host screen has arrived. The initial default value is 1200 milliseconds.
delayStart
Specifies the time (in milliseconds) that the server waits until the first full host screen has arrived. The initial default value is 2000 milliseconds.
description
Specifies a description for the connection configured for the application. This value is always empty.
SSL
Specifies whether SSL is enabled. Valid values are:
true
SSL is enabled for the application.
false
SSL is not enabled for the application.
host
Specifies the name of the host to which the application connects.
name
Specifies the connection configured for the application. This value should always be main, and main is the initial default.
port
Specifies the number of the port through which the connection to the host is made. The initial default is 23.
screenSize
Specifies the number of rows and columns that the host terminal displays. Valid values for screenSize are: The initial default screen size is 24 x 80.
workstationID
Sets the workstationID property, which is used during enhanced negotiation for 5250. Values are in string format. If the value of workstationIDSource is "automatic" or "prompt", this value is ignored. If the value of workstationIDSource is "value", this value is used as the workstation ID. If the value of workstationIDSource is "session", this value specifies the name of the HTTP session variable from which the workstation ID is derived.
Note:
If you select the Use a specified value option, you supply a string from which the workstation ID is created. You can also use wildcard characters in the specified string. The wildcard character is an asterisk (*). Include at least one wildcard character or only the first user will gain access to the application. Using the wildcard character increments the workstation ID using numbers, for example, WorkstationID1, WorkstationID2, and so on.
workstationIDSource
Specifies how the workstation ID value is set. Valid values are "automatic", "value", "prompt", and "session". The options are described in the help for the connection settings panel of the Configuration wizard.

<otherParameters> tag

The <otherParameters> tag specifies additional Host On-Demand session parameters.

Host On-Demand session parameters supported by HATS include:

Lamalef
Sets the LamAlef property, which determines whether LamAlef should be expanded or compressed. This property applies to Arabic sessions only. Values are in string format. Valid values are: The default value is LAMALEF_OFF.
numeralShape
Sets the numeralShape property. This property applies to bidirectional sessions only. Values are in string format. The default value is NOMINAL.
numericSwapEnabled
Sets the Numeric swapping property. This property applies to Arabic 3270 sessions only. Valid values are true and false. The default value is true.
roundTrip
Sets the roundTrip property. This property applies to bidirectional sessions only. Values are in string format. Valid values are: The default value is ROUNDTRIP_ON.
SecurityProtocol
Sets the SecurityProtocol property, which indicates whether to use the TLS v1.0 protocol or the SSL protocol for providing security. Values are in string format. The default value is TLS.
SSLServerAuthentication
Sets the SSLServerAuthentication property, which indicates whether SSL server authentication is enabled. Valid values are true and false. The default value is false.
symmetricSwapEnabled
Sets the Symetric swapping property. This property applies to Arabic 3270 sessions only. Valid values are true and false. The default value is true.
textOrientation
Sets the textOrientation property. This property applies to bidirectional sessions only. Values are in string format. Valid values are: The default value is LEFT_TO_RIGHT.
ThaiDisplayMode
Sets the Thai display mode property. This property applies to Thai sessions only. Values are in string format. The default value is THAI_MODE_5.
workstationID
Sets the workstationID property, which is used during enhanced negotiation for 5250. Values are in string format. All lowercase characters are converted to uppercase. There is no default value.