INF: Avoiding Data Translation in COMTI (329300)


The information in this article applies to:

  • Microsoft COM Transaction Integrator for CICS and IMS 1.0
  • Microsoft Host Integration Server 2000
This article was previously published under Q329300

SUMMARY

In some circumstances, you may want the COM Transaction Integrator (COMTI) runtime to pass untranslated data to or from the mainframe. To do this, set up an array of PIC X Untranslated bytes.

MORE INFORMATION

COMTI supports many data types, however, you may not always want COMTI to translate or interpret the data.

To configure a byte array of PIC X Untranslated bytes, follow these steps:
  1. Open the COMTI Component Builder.
  2. Unlock the COMTI component.
  3. Select the properties for the parameter that you want to change.
  4. On the Automation tab, set the data type to Byte.
  5. On the COBOL Definition tab, set the COBOL Definition to PIC X Untranslated.
  6. On the Arrays tab, set the array to be a Single Dimension Array, and set the maximum size of the array equal to the expected number of bytes.
  7. Lock the component.
After the last step is complete, COMTI will pass the bytes in the array to the calling program as untranslated binary data.

NOTE: Because COMTI passes the bytes as untranslated binary data, the interface program must take into account the newly modified parameter.

You can use this procedure if, for example, the characters coming from or going to the host are outside the range of the translation table. By following the steps earlier in this section, you can implement a custom translation table in code that handles the data.

If a variable-sized array is to be transferred, follow these steps:
  1. Set the array size to the maximum number of characters ever to be exchanged.
  2. On the Advanced tab of the method properties, set the Data buffer options as follows:
    • Final field from host is Bounded.
    • Final field to host is Bounded.

REFERENCES

For more information, see the Host Integration Server 2000 Help documentation.
Modification Type:MajorLast Reviewed:10/24/2002
Keywords:kbinfo KB329300
©2002 Microsoft Corporation. All rights reserved.