Microsoft KB Archive/836838

= General configuration options that are available with the Host Integration Server 2000 Web Client =

Article ID: 836838

Article Last Modified on 5/17/2005

-

APPLIES TO


 * Microsoft Host Integration Server 2000 Standard Edition
 * Microsoft Host Integration Server 2000 Service Pack 1

-



SUMMARY
''This article discusses the different general configuration options that are available to the Microsoft Host Integration Server 2000 Web Client. You must have a working knowledge of Host Integration Server 2000 to understand how the different configuration options apply.

The information in this article assumes that the environment to support the installation of the Web Client has been correctly set up. To set up the Web client, you must install the required files on a Web server, and then you must edit the 3270full.HTM and 5250.htm files to support connectivity to the host environment.''



General configuration options and settings in 3270full.htm
The following list explains the basic configuration options and their valid settings in the 3270full.htm file:
 * snactrl.SetSnaDomain &quot;&quot;

For local client operation, set the name of the SNA subdomain in quotation marks. In this example, no subdomain is specified. This means that the client is configured for remote operation and locates Host Integration Server 2000-based computers by using the property that specified by the SetSponsors method.
 * snactrl.SetSponsors &quot;SERVER&quot;

For remote client operation, set the name of the sponsor server to establish a sponsor connection. In this example, the sponsor server is Server (&quot;SERVER&quot;).
 * snactrl.Set3270LU &quot;3270POOL&quot;

Optionally, set the LU or LU pool name. In this example, there is a 3270 display pool that is named 3270POOL.
 * snactrl.Set3270CodePage &quot;United States (037)&quot;

Optionally, set the Host Code Page. For a complete list of values, see the &quot;Code Pages&quot; topic in the Host Integration Server 2000 Online Help.
 * snactrl.Set3270AutoConnect TRUE

Optionally, configure the 3270 Client to connect automatically on startup.
 * snactrl.SetSnabaseTimeout 1

Optionally, set the SnaBase time-out value to 1 second after all clients are shut down.
 * snactrl.SetTcpFirewalls &quot;000.000.000.000 000.000.000.000 000.000.000.000&quot;

Optionally, configure TCP/IP firewall addresses. If the firewall entry is used, this address will be used by the application session instead of the address that is returned in the service table when SnaBase on the client first establishes the sponsor connection with SnaBase on the server.
 * snactrl.SetTransportPortNumber &quot;SnaTcp&quot;, &quot;SnaBasePort&quot;, 2000

Optionally, set the network transport port number to be used by SnaBase. In the example, &quot;SnaTcp&quot; is the transport and &quot;SnaBasePort&quot; with a value of 2000 is the port that SnaBase will use for new client connections (sponsor connections). By default, the port for &quot;SnaBasePort&quot; is 1478.
 * snactrl.DownloadFileFromServer &quot;FTPserver&quot;, &quot;logon.lsc&quot;, &quot;logon.lsc&quot;

Optionally, download the logon script file.
 * snactrl.Set3270ScriptName &quot;logon.lsc&quot;

Optionally, configure the logon script file.
 * snactrl.Set3270AutoLogonScript TRUE

Optionally, set 3270 auto logon scripting.
 * snactrl.Run3270Applet

Run the 3270 Client automatically when the 3270full.htm page is loaded and after the ActiveX controls are loaded and the configuration changes are made to the installed client.
 * window.history.back 1

Return the focus of the browser to the Default.htm page. This action occurs so later users do not inadvertently return to this page after they have visited another page or Web site.

General configuration options and settings in 5250full.htm
The following list explains the basic configuration options and their valid settings in the 5250full.htm file:
 * snactrl.SetSnaDomain &quot;&quot;

For local client operation, set the name of the SNA subdomain in quotation marks. In this example, no subdomain is specified. This means that the client is configured for remote operation and locates Host Integration Server 2000 computers by using the property that is specified by the SetSponsors method.
 * snactrl.SetSponsors &quot;Server&quot;

For remote client operation, set the name of the sponsor server. In this example, the sponsor server is Server (&quot;SERVER&quot;).
 * snactrl.Set5250LocalLU &quot;Local&quot;

Optionally, set the Local LU name.
 * snactrl.Set5250RemoteLU &quot;Remote&quot;

Optionally, set the Remote LU name.
 * snactrl.Set5250DeviceName

Optionally, set the Device name. In this example, this value is not set.
 * snactrl.Set5250DisplaySize 1

Optionally, set the client display model size. By default, the size is 1 for a 24x80 model 2 display. The alternate size is 5 for a 27x132 model 5 display.
 * snactrl.Set5250System36 FALSE

If required, configure for System/36 compatibility.
 * snactrl.Set5250AutoLogon FALSE

Optionally, support the single logon feature.
 * snactrl.Set5250CodePage 0

Optionally, set the Host Code Page. For a complete list of values, see the &quot;Code Pages&quot; topic in the Host Integration Server 2000 Online Help.
 * snactrl.Set5250AutoConnect TRUE

Optionally, configure the 5250 Client to connect automatically on startup.
 * snactrl.SetSnabaseTimeout 1

Optionally, set the SnaBase time-out value to 1 second after all clients are shut down.
 * snactrl.SetTcpFirewalls &quot;000.000.000.000 000.000.000.000 000.000.000.000&quot;

Optionally, configure TCP/IP firewall addresses. If the firewall entry is used, this address will be used by the application session instead of the address that is returned in the service table when SnaBase on the client first establishes the sponsor connection with SnaBase on the server.
 * snactrl.SetTransportPortNumber &quot;SnaTcp&quot;, &quot;SnaBasePort&quot;, 2000

Optionally, set the network transport port number to be used by SnaBase. In the example, &quot;SnaTcp&quot; is the transport and &quot;SnaBasePort&quot; with the value of 2000 is the port that SnaBase uses for new client connections (sponsor connections). By default, the port for &quot;SnaBasePort&quot; is 1478.
 * snactrl.Run5250Applet

Run the 5250 Client automatically when the 5250full.htm page is loaded and after the ActiveX controls are loaded and the configuration changes made to the installed client.
 * window.history.back 1

Return the focus of the browser to the Default.htm page. This action occurs so later users do not inadvertently return to this page after they have visited another page or Web site.

