3270 Client Unable to Open Configuration File If Path Has Spaces (311256)



The information in this article applies to:

  • Microsoft SNA Server 3.0
  • Microsoft SNA Server 4.0
  • Microsoft Host Integration Server 2000

This article was previously published under Q311256

SYMPTOMS

The 3270 client (Win3270.exe) fails to open its configuration file if the path to the configuration file contains any spaces. The 3270 client may fail to connect to a host session when this occurs because the 3270 client configuration file may contain specific information necessary to connect to a host session.

CAUSE

The 3270 client incorrectly truncates command line parameter strings that contain spaces.

RESOLUTION

To resolve this problem, obtain the latest service pack for Host Integration Server 2000. For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

328152 How to Obtain the Latest Host Integration Server 2000 Service Pack

WORKAROUND

Place the 3270 client's configuration file in a path that doesn't contain any spaces.

STATUS

Host Integration Server 2000

Microsoft has confirmed that this is a problem in Microsoft Host Integration Server 2000. This problem was first corrected in Host Integration Server 2000 Service Pack 1.

SNA Server 3.0 and 4.0

Microsoft has confirmed that this is a problem in SNA Server versions 3.0 and 4.0.

MORE INFORMATION

Once the 3270 client is configured to connect to a host session, its configuration can be saved in a configuration file. The 3270 client can then open the saved configuration file to restore the session information.

The problem described in this article can occur if the 3270 client is configured to automatically open a configuration file when the 3270 client is initialized and the path to the configuration file contains a space. The following steps describe a typical scenario in which this might occur:
  1. Install the Host Integration Server (HIS) 2000 End User Client on a Windows 2000 Professional-based system.
  2. Create a desktop shortcut to the 3270 client (Win3270.exe).
  3. Configure the desktop shortcut for the 3270 client so that it includes the path and name of a 3270 client configuration file. The following is an example of how the desktop shortcut's Target parameter would look in a case where the configuration file is also saved on the user's (for this example, TestUser's) desktop:

    "C:\Program Files\Host Integration Server\System\win3270.exe" C:\Documents and Settings\TestUser\Desktop\3270.cfg

  4. Open the 3270 client by executing the shortcut. This results in the 3270 client window opening with the following title bar:

    Host Integration Server 3270 Client - "C:\Documents

    If the 3270 configuration file had opened successfully, the 3270 client window would have the complete path and file name of the configuration file in the title bar.

Modification Type:MinorLast Reviewed:3/23/2005
Keywords:kbBug kbfix kbHostIntegServ2000preSP1fix kbHostIntegServ2000SP1fix KB311256