Symptoms
When you have Microsoft Host Integration Server 2009 clients that are running on systems that use network adapters with MAC (physical) addresses that begin with values of X’80’ or larger, these clients cannot access resources (for example, 3270 logical units) that are assigned to Workstation definitions based on the clients' MAC (physical) addresses.
The error that you receive varies, depending on the 3270 Emulator or the application that is being used. When you use the 3270 application that is included with SNA Server, you receive the following error message:
ERROR - There are no configured sessions for your user record.
Note This issue can also occur when you use earlier versions of Host Integration Server.
Cause
The Host Integration Server client calls the UuidCreateSequential function because the function returns the MAC (physical) address of the network adapter as part of the UUID that this API creates. The UuidCreateSequential function does not return the MAC address of the network adapter if the address begins with a value of X’80’ or larger.
This issue occurs because the MAC address of the client’s network adapter cannot be obtained. Therefore, the Host Integration Server client cannot obtain the list of Host Integration Server resources that are assigned to the client’s physical address.
Resolution
A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing the problem described in this article. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.
If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.
Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft website:
http://support.microsoft.com/contactus/?ws=supportNote The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.
Prerequisites
There are no prerequisites for installing this hotfix package.
Restart requirement
You do not have to restart the computer after you apply this hotfix.
Hotfix replacement information
This hotfix package does not replace a previously released hotfix package.
File Information
The global version of this hotfix uses a Microsoft Windows Installer package to install the hotfix. The dates and the times for these files are listed in Coordinated Universal Time (UTC) in the following table. When you view the file information, the date is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.
For Microsoft Host Integration Server 2009, 32-bit edition:
|
File name |
File version |
File size |
Date |
Time |
Platform |
|---|---|---|---|---|---|
|
Snaadsi.dll |
8.0.3764.2 |
170,832 |
09-Jul-2010 |
22:03 |
x86 |
|
Snadmod.dll |
8.0.3764.2 |
812,880 |
09-Jul-2010 |
22:03 |
x86 |
For Microsoft Host Integration Server 2009, 64-bit edition:
|
File name |
File version |
File size |
Date |
Time |
Platform |
|---|---|---|---|---|---|
|
Snaadsi.dll |
8.0.3764.2 |
416,592 |
09-Jul-2010 |
22:05 |
x64 |
|
Snadmod.dll |
8.0.3764.2 |
1,018,704 |
09-Jul-2010 |
22:05 |
x64 |
Workaround
Frequently, network adapters allow for the hard-coded MAC (physical) address to be changed in the network adapter properties dialog box. The following list of steps shows how to do this on a Windows 7 system:
-
In Control Panel, open the Network and Sharing Center.
-
Click Change Adapter Settings.
-
Right-click the network adapter, and then click Properties.
-
Click Configure.
-
Click the Advancedtab.
-
The Property list may include a property that is named Network Address or Locally Administered Address. In this list, you can specify a specific MAC address for the adapter.
Note Not all network adapters expose a property to set a custom MAC address as described here. You also want to make sure that you use unique addresses if you override the hard-coded address that is provided by the network adapter vendor.
If you enter a customer MAC address that begins with a value less than X’80’, the problem described in this article does not occur.
Status
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.
More Information
After you apply the update that is described here, the Host Integration Server client will use the IPHelper API to retrieve the client’s MAC address. If the Host Integration Server client system has multiple network adapters installed, the Host Integration Server client will obtain the MAC address of the first adapter that is returned in the list of adapters that the IPHelper API returns. If this address is not the network adapter or MAC address that you want to use in the Host Integration Server configuration for the workstation definition to assign resources to, you will have to change the binding order of the network adapters so that the correct network adapter is returned first in the list.
References
For more information about how to use MAC addresses, click the following article numbers to view the articles in the Microsoft Knowledge Base:
191610 Assigning LUs/Pools to workstation MAC addresses not supported
275280 Workstation definitions that use MAC addresses fail on Windows 2000For more information about the IPHelper API and about how to use the UuidCreateSequential function, visit the following MSDN websites:
