General configuration options that are available with the Host Integration Server 2000 Web Client (836838)


The information in this article applies to:

  • Microsoft Host Integration Server 2000
  • Microsoft Host Integration Server 2000 SP1

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.

MORE INFORMATION

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 ""
    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 "SERVER"
    For remote client operation, set the name of the sponsor server to establish a sponsor connection. In this example, the sponsor server is Server ("SERVER").
  • snactrl.Set3270LU "3270POOL"
    Optionally, set the LU or LU pool name. In this example, there is a 3270 display pool that is named 3270POOL.
  • snactrl.Set3270CodePage "United States (037)"
    Optionally, set the Host Code Page. For a complete list of values, see the "Code Pages" 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 "000.000.000.000 000.000.000.000 000.000.000.000"
    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 "SnaTcp", "SnaBasePort", 2000
    Optionally, set the network transport port number to be used by SnaBase. In the example, "SnaTcp" is the transport and "SnaBasePort" with a value of 2000 is the port that SnaBase will use for new client connections (sponsor connections). By default, the port for "SnaBasePort" is 1478.
  • snactrl.DownloadFileFromServer "FTPserver", "logon.lsc", "logon.lsc"
    Optionally, download the logon script file.
  • snactrl.Set3270ScriptName "logon.lsc"
    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 ""
    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 "Server"
    For remote client operation, set the name of the sponsor server. In this example, the sponsor server is Server ("SERVER").
  • snactrl.Set5250LocalLU "Local"
    Optionally, set the Local LU name.
  • snactrl.Set5250RemoteLU "Remote"
    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 "Code Pages" 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 "000.000.000.000 000.000.000.000 000.000.000.000"
    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 "SnaTcp", "SnaBasePort", 2000
    Optionally, set the network transport port number to be used by SnaBase. In the example, "SnaTcp" is the transport and "SnaBasePort" with the value of 2000 is the port that SnaBase uses for new client connections (sponsor connections). By default, the port for "SnaBasePort" 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.

REFERENCES

For additional information about the Web client installation and initial setup and about the new configuration options that are added, click the following article numbers to view the articles in the Microsoft Knowledge Base:

279003 Understanding and configuring the SNA Server/HIS 2000 Web Client

833798 The Host Integration Server 2000 Web Client is updated to include additional configuration options

Modification Type:MinorLast Reviewed:5/17/2005
Keywords:kbinfo KB836838 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.