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 (909454)

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:
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.

File name	File version	File size	Date	Time	Platform	SP requirement
Capture.dll	6.0.1993.0	25,600	01-Nov-2005	18:44	x86	SP1
Dcgen.dll	6.0.1993.0	98,816	01-Nov-2005	18:44	x86	SP1
Microsoft.hostintegration.ti.dcgen.interop.dll	6.0.1701.0	4,096	01-Nov-2005	18:44	x86	SP1
Mobase.dll	6.0.1993.0	249,344	01-Nov-2005	18:43	x86	SP1
Playback.dll	6.0.1993.0	24,064	01-Nov-2005	18:44	x86	SP1
Tagen.dll	6.0.1993.0	94,720	01-Nov-2005	18:44	x86	SP1
Tranlu62.dll	6.0.1993.0	53,760	01-Nov-2005	18:44	x86	SP1
Turnaround.dll	6.0.1993.0	34,304	01-Nov-2005	18:44	x86	SP1

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.

1. Verify that the Include Context Parameter property for the TI method is set to True.
2. Install the .NET Framework-based TI WIP object into the TI Manager.
3. In a Microsoft Visual Studio .NET project, follow these steps:
   1. Make a reference to the proxy that is generated when the .NET Framework-based TI WIP object was installed.
   2. Make a reference to System.Runtime.Remoting.
   3. Make a reference to Microsoft.HostIntegration.TI.ClientContext.
   4. 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 = "Input Data";  //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("OverrideSourceTP", "ZZZZ", 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;

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:

1. Verify that the Include Context Parameter property for the TI Method is set to True.
2. Install the TI WIP COM object into the TI Manager.
3. In a Microsoft Visual C# .NET project, follow these steps:
   1. Make a reference to the TI COM type library.
   2. Click the COM tab of the references and make a reference to COMTIContext 1.0 Type Library.
   3. 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 = "input Data"; //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("OverrideSourceTP","ZZZZ", 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;