Transaction Request Messages
When you use TCP/IP to communicate with CICS, the client sends the host a transaction request message (TRM) request containing the Transaction Program ID, User ID, Password, and other administrative data to be used by the host. CICS sends the client a TRM reply containing additional administrative data. The data in the TRM is independent from the actual program data to be exchanged with the Transaction Program (TP) on the host.
You can find templates for various TRMs at \installation directory\Microsoft Host Integration Server\system\TIM\MicrosoftTRMDefs.tim. Use Microsoft Visual Studio .NET 2003 to open the file, and then expand the User-Defined Types node. The following TRMs are defined as UDTs:
- TRMIN_MSLink
- TRMOUT_MSLink
- TRMIN_MSCCS
- TRMIN_IBMCCS
- TRMOUT_CCS
You can also find templates for various enhanced listener messages (ELMs) at \installation directory\Microsoft Host Integration Server\system\TIM\MicrosoftELMDefs.tim. Use Microsoft Visual Studio .NET 2003 to open the file, and then expand the User-Defined Types node. The following ELMs are defined as UDTs:
- ELMIN_MSLink
- ELMOUT_MSLink
- ELMIN_MSCCS
- ELMIN_IBMCCS
- ELMOUT_CCS
You can create a TRM or ELM template in COBOL to assist with your programming by exporting the TRM or ELM definition.
To create a TRM template in COBOL
- Open Microsoft Visual Studio .NET 2003.
- On the File menu, point to Open, and then click File.
- In the Open File dialog box, navigate to <drive>:\Program Files\Microsoft Host Integration Server\System\TIM\, and then click either MicrosoftTRMDefs.tim or MicrosoftELMDefs.tim.
- On the File menu, click Export Host Definition.
- In the Export Host Definition dialog box, type or select the file name, and then click Save.
You can substitute a custom TRM (or ELM) for the default TRM (or ELM) created by the TI runtime. Use the COMTIContext parameter to pass custom context data.
See Also
Using Custom TRMs and ELMs with COMTIContext
Sample Client Application That Passes a Custom TRM
To download updated Host Integration Server 2004 Help from www.microsoft.com, go to http://go.microsoft.com/fwlink/?linkid=29507. Copyright © 2004 Microsoft Corporation.All rights reserved.