Microsoft KB Archive/839038

= FIX: New features are available for security credentials and host access in the COM Transaction Integrator for Host Integration Server 2000 =

Article ID: 839038

Article Last Modified on 6/5/2006

-

APPLIES TO


 * Microsoft Host Integration Server 2000 Standard Edition
 * Microsoft Host Integration Server 2000 Service Pack 1

-





SUMMARY
The Microsoft Component Object Model (COM) Transaction Integrator (COMTI) is used to access programs on mainframe systems. This hotfix adds features to the COMTI in Microsoft Host Integration Server 2000 that do the following:
 * The Microsoft Windows client program can now control the security credentials that it sends to the host system and does not have to use the COMTI Explicit Security Callback feature.
 * The Windows client program can select another remote environment (RE) without using the COMTI SelectionHint method call.

These new features have better performance and are compatible with the COMTI that is in Host Integration Server 2004. For more information about how to use these new features, see the &quot;More Information&quot; section.



Service pack information
This feature is available in the latest service pack for Microsoft Host Integration Server 2000. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

328152 How to obtain the latest service pack for Host Integration Server 2000

Hotfix 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 tool in Control Panel.   Date         Time   Version    Size     File name 01-Sep-2004 19:12  5.0.0.998   37,136  Capture.dll 01-Sep-2004 19:12  5.0.0.998  323,856  Cedrmsgs.dll 01-Sep-2004 19:12  5.0.0.998   33,040  Comticontext.dll 01-Sep-2004 19:12  5.0.0.998   28,944  Comtiperf.dll 01-Sep-2004 19:12  5.0.0.998  147,728  Convert.dll 01-Sep-2004 19:12  5.0.0.998   74,000  Convertprim.dll 01-Sep-2004 19:12  5.0.0.998   33,040  Dpl1.dll 01-Sep-2004 19:12  5.0.0.998  823,568  Dtcob390.dll 01-Sep-2004 19:12  5.0.0.998  311,568  Mobase.dll 01-Sep-2004 19:12  5.0.0.998   37,136  Playback.dll 01-Sep-2004 19:12  5.0.0.998   78,096  Readlib.dll 01-Sep-2004 19:12  5.0.0.998  123,152  Tadtlb.dll 01-Sep-2004 19:12  5.0.0.998  119,056  Tagen.dll 01-Sep-2004 19:12  5.0.0.998   82,192  Tranlu62.dll 01-Sep-2004 19:12  5.0.0.998  114,960  Trantcp.dll 01-Sep-2004 19:12  5.0.0.998   49,424  Turnaround.dll 01-Sep-2004 19:12  5.0.0.870  950,272  Componentbuilder.exe 29-Mar-2003 01:15             838,423  Comticb.chm 29-Mar-2003 01:15             812,988  Resnapin.chm

Note Because of file dependencies, the most recent fix that contains these files may also contain additional files.

Information for the security credentials, the remote environment name, or both, is passed to the COMTI runtime by using an optional parameter. This parameter contains an array of data with the following predefined, case-sensitive keywords:
 * REOverride
 * USERID
 * PASSWORD

To enable this new feature, install the hotfix. Then, save the COMTI type library by using the COMTI Component Builder. After you install the COMTI type library into a Microsoft COM+ application package, enable the new features in the client program. For additional information, see the code sample in this section. You can use the following methods to work with the array of data that is passed to the COMTI method:
 * The ClearAllContext method
 * The CountContext method
 * The DeleteContext method
 * The QueryContextInfo method
 * The ReadContext method
 * The WriteContext method

Note This code sample is in Microsoft Visual Basic .NET. The code demonstrates how to use the WriteContext method to provide security credentials and a remote environment name.

In your Visual Basic .NET project, add a COM reference to the COMTI type library and to the following file:

Program Files\Host Integration Server\System\Comticontext.dll

In the Visual Basic .NET project, use the following code sample. 'Create an instance of the COMTI component. Dim objCOMTI As New Context.Test

'Create an instance of the new Context feature. Dim objCntx As New COMTICONTEXTLib.ContextObject

'Create an array to write the Context data to. Dim ContextArray As Object

'Create the variables for the data parameters for the method call. Dim sInfo As String = &quot;Info for host&quot; Dim dBalance As Decimal = 0.0

'Write the context values to the context array. 'In this sample, you must have a remote environment (RE) that is named AltREName. 'This RE is defined in the COMTI Manager and is case sensitive. objCntx.WriteContext(&quot;REOverride&quot;, &quot;AltREName&quot;, ContextArray)

'The following calls will cause UUUUUUUU to be sent as the userid and 'PPPPPPPP to be sent as the password to the host when the method is called. objCntx.WriteContext(&quot;USERID&quot;, &quot;UUUUUUUU&quot;, ContextArray) objCntx.WriteContext(&quot;PASSWORD&quot;, &quot;PPPPPPPP&quot;, ContextArray)

'Make the COMTI method call or calls. '     The last parameter is the Context Array. objCOMTI.MakeCall(sInfo, dBalance, ContextArray)

Additional query words: HIS HIS2000

Keywords: kbhowto kbinfo kbqfe kbhotfixserver KB839038

-

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

© Microsoft Corporation. All rights reserved.