Microsoft KB Archive/931246

= FIX: The Host Access Management Agent may import the READY prompt as a member of an IBM RACF group in MIIS 2003 =

Article ID: 931246

Article Last Modified on 11/15/2007

-

APPLIES TO


 * Microsoft Identity Integration Server 2003 Host Access Management Agent Feature Pack 2

-



SYMPTOMS
The Host Access Management Agent may import the READY prompt as a member of an IBM Resource Access Control Facility (IBM RACF) group in Microsoft Identity Integration Server (MIIS) 2003. This problem occurs when you use the Host Access Management Agent to run an import operation from an IBM system that includes a limited number of RACF groups.

Additionally, you may receive an error message that resembles the following:

Microsoft.MetadirectoryServices.EntryExportException: Failure attempting to add READY to group RACF Group Name. Please verify that the READY object exists. at Microsoft.MetadirectoryServices.Host.RACF.RACFMA.CheckForExportGroupsError(Hashtable scriptReturnValues, String parentId, String objectId) at Microsoft.MetadirectoryServices.Host.RACF.RACFMA.ExportGroupMembers(ModificationType modificationType, String[] changedAttributes, CSEntry csentry) at Microsoft.MetadirectoryServices.Host.RACF.RACFMA.ExportGroupEntries(ModificationType modificationType, String[] changedAttributes, CSEntry csentry) at Microsoft.MetadirectoryServices.Host.RACF.RACFMA.ExportEntry(ModificationType modificationType, String[] changedAttributes, CSEntry csentry)



CAUSE
The Host Access Management Agent uses a screen scraping API to read the data that is displayed in an IBM Time Sharing Option (TSO) session. When you run IBM RACF commands, such as the LISTUSER command or the LISTGRP command, the IBM TSO session includes a READY prompt at the end of each screen of data. The READY prompt is included in the data that is read from the IBM TSO session, and it is returned to the Host Access Management Agent. This problem occurs when the READY prompt appears on the last line of the IBM TSO screen immediately following the last user in the RACF group that is listed by the LISTGRP command. The script that is used by the Host Access Management Agent to process the returned data incorrectly includes the READY prompt as a member of a RACF group.



Hotfix information
A supported hotfix is now 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 this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next service pack that contains this hotfix.

To resolve this problem, submit a request to Microsoft Online Customer Services to obtain the hotfix. To submit an online request to obtain the hotfix, visit the following Microsoft Web site:

http://go.microsoft.com/?linkid=6294451

Note If additional issues occur or 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. To create a separate service request, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

Post-installation instructions
After you apply this hotfix, you must update the Hostconfig.xml file in the Host Access Management Agent. To update the Hostconfig.xml file, follow these steps:
 * 1) Click Start, click Run, type cmd, and then click OK.
 * 2) Move to the directory that contains the MIIS 2003 extensions. By default, this is the &quot;C:\Program Files\Microsoft Identity Integration Server\Extensions&quot; directory.
 * 3) To upgrade the Hostconfig.xml file, type hostconfig –upgrade, and then press ENTER.

File information
The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it 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.



STATUS
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the &quot;Applies to&quot; section.



MORE INFORMATION
This hotfix also includes fixes for the following problems that may occur when you import and export RACF users and RACF groups.  The READY prompt may be listed as the last RACF user who was imported when you process the IBM RACF LISTUSER command. The RACF management agent tries to remove the READY user from a RACF group during an export operation. Additionally, the following error message is returned by RACF:

0x80230722 Failure attempting to add READY to Group Name. Please verify that the READY object exists.



For more information, click the following article number to view the article in the Microsoft Knowledge Base:

824684 Description of the standard terminology that is used to describe Microsoft software updates

The third-party products that this article discusses are manufactured by companies that are independent of Microsoft. Microsoft makes no warranty, implied or otherwise, about the performance or reliability of these products.

Keywords: kbfix kbbug kbhotfixserver kbqfe kbpubtypekc KB931246

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.