Microsoft KB Archive/909454

= FIX: A new feature is available in the TI to override the Source TP Name property for a TI method in Host Integration Server 2004 =

Article ID: 909454

Article Last Modified on 12/4/2007

-

APPLIES TO


 * Microsoft Host Integration Server 2004 Standard Edition

-





SUMMARY
The Microsoft Host Integration Server 2004 Transaction Integrator (TI) now includes a new feature that lets you override the Source TP Name property for a TI method by using the new OverrideSourceTP context keyword.

For more information about this new feature, see the &quot;More Information&quot; section.



MORE INFORMATION
A supported feature that modifies the product's default behavior is now available from Microsoft, but it is only intended to modify the behavior that this article describes. Apply it only to systems that specifically require it. This feature may receive additional testing. Therefore, if the system is not severely affected by the lack of this feature, we recommend that you wait for the next Host Integration Server 2004 service pack that contains this feature.

To obtain this feature immediately, contact Microsoft Product Support Services. For a complete list of Microsoft Product Support Services telephone numbers and information about support costs, visit the following Microsoft Web site:

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

The English version of this fix 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.

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





When you are working with a TI Windows-initiated processing (WIP) component that is configured to use a LU6.2 Customer Information Control System (CICS) Link component, there are three different Host Definition properties:
 * Link-to-Program Name
 * Mirror Transaction ID
 * Source TP Name

You can modify the Link-to-Program Name property and the Mirror Transaction ID property by using the ProgNameOverride context keyword and the TPNameOverride context keyword.

With the software update that is described in this article, the OverrideSourceTP context keyword has been added in order to let you modify the Source TP Name property.

Note The Source TP Name property is the CICS Transaction ID for the Source Transaction Program and is limited to four characters. Additional characters that are passed to the Component Object Model (COM) Transaction Integrator (COMTI) Context Array will be truncated.

How to use the new OverrideSourceTP context keyword with a Microsoft .NET Framework-based TI WIP object
To use the new OverrideSourceTP context keyword with a Microsoft .NET Framework-based TI WIP object, follow these steps.

Note These steps assume that you understand how to install and use .NET Framework-based TI WIP objects.  Verify that the Include Context Parameter property for the TI method is set to True. Install the .NET Framework-based TI WIP object into the TI Manager. In a Microsoft Visual Studio .NET project, follow these steps:  Make a reference to the proxy that is generated when the .NET Framework-based TI WIP object was installed. Make a reference to System.Runtime.Remoting. Make a reference to Microsoft.HostIntegration.TI.ClientContext.</li>  The following code sample is for a .NET Framework-based TI WIP object that is named NetTI.Test and that contains a method named MyMethod: NetTI.Test objTI = new NetTI.Test; //Create an instance of the TI object string sIn = &quot;Input Data&quot;; //Input data for MyMethod decimal dBal; //Output data from MyMethod object[] ctxAry = null; //Set up the context array

//Set up an object that enables us to write data to the context array Microsoft.HostIntegration.TI.ClientContext objCtx = new Microsoft.HostIntegration.TI.ClientContext;

//Write the new Source TP Name to the context array – the new name is ZZZZ objCtx.WriteContext(&quot;OverrideSourceTP&quot;, &quot;ZZZZ&quot;, ref ctxAry);

//Call MyMethod and pass it the context array objTI.MyMethod(ref sIn, out dBal, ref ctxAry);

textBox1.Text = dBal.ToString; objTI = null; objCtx = null; ctxAry = null; </li></ol> </li></ol>

How to use the new OverrideSourceTP context keyword with a TI WIP Component Object Model (COM) object
To use the new OverrideSourceTP context keyword with a TI WIP COM object, follow these steps.

Note These steps assume that you understand how to install and use TI WIP COM objects. For more information about TI WIP COM objects, click the following article number to view the article in the Microsoft Knowledge Base:

899810 FIX: A Component Services application package may stop responding in Host Integration Server 2004 on Windows Server 2003

<ol> Verify that the Include Context Parameter property for the TI Method is set to True.</li> Install the TI WIP COM object into the TI Manager.</li> In a Microsoft Visual C# .NET project, follow these steps: <ol style="list-style-type: lower-alpha;"> Make a reference to the TI COM type library.</li> Click the COM tab of the references and make a reference to COMTIContext 1.0 Type Library.</li>  The following code sample is for a TI WIP COM object that is named COMTI.Test and that contains a method that is named MyMethod: // Create an instance of the TI object COMTI.TestClass objTI = new COMTI.TestClass;

string sIn = &quot;input Data&quot;; //Set up input data for MyMethod decimal dBal; //This is the output data from MyMethod

object ctxAry = null; //Set up the context variable System.Array sysAry = null; //Set up a System Array

//Set up the object that will write data to the System Array COMTICONTEXTLib.ContextObjectClass objCtx = new COMTICONTEXTLib.ContextObjectClass;

//Write the new Source TP Name (ZZZZ) to the System Array objCtx.WriteContext(&quot;OverrideSourceTP&quot;,&quot;ZZZZ&quot;, ref sysAry);

//For TI COM the Context array must be an object type //The next statement copies the System Array to the object ctxAry = sysAry;

//Call MyMethod and pass it the context object objTI.MyMethod(ref sIn, out dBal, ref ctxAry);

textBox1.Text = dBal.ToString; objTI = null; objCtx = null; ctxAry = null; sysAry = null; </li></ol> </li></ol>

Additional query words: HIS KB909454

Keywords: kbinfo kbqfe kbpubtypekc kbhotfixserver kbhis2004 KB909454

-

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

© Microsoft Corporation. All rights reserved.