Article ID: 810956 - View products that this article applies to.
This article has been archived. It is offered "as is" and will no longer be updated.
Using the Microsoft Component Object Model (COM) Transaction Integrator (COMTI) to access Customer Information Control System (CICS) programs on the mainframe over TCP/IP involves first sending a Transaction Request Message (TRM) and then receiving a TRM reply from the mainframe before exchanging the program data. Previously, the COMTI runtime automatically formatted the TRM request and then processed the TRM reply. This meant that the client program had no control over the TRM request and could not receive the contents of the TRM reply. COMTI now includes a new feature that gives the client program full control of the TRM request and lets the client program process the TRM reply. For more information about how to use this new feature, see the "More Information" section.
Service pack informationThis 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:
(http://support.microsoft.com/kb/328152/ )How to obtain the latest service pack for Host Integration Server 2000
Hotfix informationThe 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 ------------------------------------------------------------ 04-Jun-2003 14:01 22.214.171.1245 37,136 Capture.dll 04-Jun-2003 14:01 126.96.36.1995 323,856 Cedrmsgs.dll 04-Jun-2003 14:01 188.8.131.525 33,040 Comticontext.dll 04-Jun-2003 14:01 184.108.40.2065 147,728 Convert.dll 04-Jun-2003 14:01 220.127.116.115 74,000 Convertprim.dll 04-Jun-2003 14:01 18.104.22.1685 33,040 Dpl1.dll 04-Jun-2003 14:01 22.214.171.1245 823,568 Dtcob390.dll 04-Jun-2003 14:01 126.96.36.1995 37,136 Playback.dll 04-Jun-2003 14:01 188.8.131.525 78,096 Readlib.dll 04-Jun-2003 14:01 184.108.40.2065 123,152 Tadtlb.dll 04-Jun-2003 14:01 220.127.116.115 114,960 Tagen.dll 04-Jun-2003 14:01 18.104.22.1685 82,192 Tranlu62.dll 04-Jun-2003 14:01 22.214.171.1245 110,864 Trantcp.dll 04-Jun-2003 14:01 126.96.36.1995 49,424 Turnaround.dll 04-Jun-2003 14:01 188.8.131.520 950,272 Componentbuilder.exe 28-Mar-2003 06:15 838,423 Comticb.chm 28-Mar-2003 06: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 TRM request or the TRM reply, or both, is passed to the COMTI runtime through an optional parameter that contains an array of data. Formatting for the TRM request and the TRM reply is defined within the user-defined type definitions in the COMTI type library. The name of the user-defined type must start with the characters TRMIN for the TRM request and TRMOUT for the TRM reply. This prefix is case sensitive. TRM requests and TRM replies may have multiple user-defined type definitions. For example, you may have the following user-defined type definitions:
COMTI includes sample Concurrent Server programs that use the default format that the COMTI runtime will process automatically. You can use the Mscmtics.cbl program with the TCP/IP Link model. You can modify the Tcpcdrbk.cbl sample, the Tcpcgtac.cbl, and the Cicscs.cbl sample for use with the Concurrent Server (non-Link) model. The example in this section uses the TRM request format that is programmed in the Mscmtics.cbl sample and calls the sample cedrbank method that is used in the CedarBank tutorial that is included with COMTI.
When sending the TRM request, the IBM listener expects a four-byte string with the CICS Transaction Name for the Concurrent Server program and then a one-byte FILLER that typically contains a comma. Then, in the Mscmtics.cbl sample, the format of the TRM request after the fifth byte is the following:
To give the client program full control over the data that is sent in the TRM request, you must add the following user-defined type to the COMTI type library:
As soon as the COMTI type library is saved and installed into a COM+ application package, you must enable the TRM reply feature in the client program. To do this, follow these steps:
Note This code sample is in Microsoft Visual Basic .NET.
To view the TRM reply, a user-defined type must be defined in the COMTI type library with a user-defined type name that begins with TRMOUT. You must define a variable within the Visual Basic project for that user-defined type and you must call the WriteContext method with the following three parameters:
Article ID: 810956 - Last Review: October 26, 2013 - Revision: 2.1