Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

FIX: Host Integration Server 2009 clients cannot access resources that are assigned to Workstation definitions by using MAC addresses that begin with values of X’80’ or larger


View products that this article applies to.

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.

↑ Back to the top


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.

↑ Back to the top


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: Note 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 nameFile versionFile sizeDateTimePlatform
Snaadsi.dll8.0.3764.2170,83209-Jul-201022:03x86
Snadmod.dll8.0.3764.2812,88009-Jul-201022:03x86
For Microsoft Host Integration Server 2009, 64-bit edition:
File nameFile versionFile sizeDateTimePlatform
Snaadsi.dll8.0.3764.2416,59209-Jul-201022:05x64
Snadmod.dll8.0.3764.21,018,70409-Jul-201022:05x64

↑ Back to the top


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:
  1. In Control Panel, open the Network and Sharing Center.
  2. Click Change Adapter Settings.
  3. Right-click the network adapter, and then click Properties.
  4. Click Configure.
  5. Click the Advancedtab.
  6. 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.

↑ Back to the top


Status

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

↑ Back to the top


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.

↑ Back to the top


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 2000
For more information about the IPHelper API and about how to use the UuidCreateSequential function, visit the following MSDN websites:

↑ Back to the top


Keywords: kbpubtypekc, kbsurveynew, kbexpertiseadvanced, kbautohotfix, kbhotfixserver, kbqfe, kb, kbfix

↑ Back to the top

Article Info
Article ID : 2272231
Revision : 2
Created on : 9/25/2018
Published on : 9/25/2018
Exists online : False
Views : 312