This article describes a software update that adds support for some additional configuration properties, an XML assembler and XML disassembler, and new data types for the BizTalk Pipeline Component for Host Data Conversion feature. This feature is included in Microsoft Host Integration Server 2010.
The BizTalk Pipeline Component for Host Data Conversion enables you to add message or record conversion to existing BizTalk adapters that do not offer built-in transformation or formatting. Such adapters include the adapters for WebSphere MQ and for FTP. Host data conversion is based on existing Host Integration Server technologies and offers an intuitive Designer plug-in for Microsoft Visual Studio and includes COBOL, RPG, and XSD import and export. The host data conversion runtime engine converts numeric, datetime, and string data types for a range of platforms and locales. This enables BizTalk developers to produce BizTalk message pipeline-level solutions that scale and perform well.
The update adds support for the following features to the BizTalk Pipeline Component for Host Data Conversion:
An XML assembler and an XML disassembler for BizTalk Server Send and Receive Pipelines.
Additional Host Code Page support: Before this update, the BizTalk Pipeline Component for Host Data Conversion only supported the EBCDIC - U.S./Canada (37) host code page for data conversions.
CICS User Data Programming Model: Before this update, the BizTalk Pipeline Component for Host Data Conversion only supported the CICS Link programming model. The addition of the CICS User Data programming model is useful for scenarios where more than 32 kilobytes (KB) of data must be sent at a time.
SendCompleteCOMMAREA property: If you are using the CICS Link programming model, the BizTalk Send Pipeline will send the whole 32 KB buffer when SendCompleteCOMMAREA is set to a value of True. If SendCompleteCOMMAREA is set to False, only the actual data in the buffer is sent. The CICS Link programming model was the only programming model available before this update.
InitialBufferValue property: This property enables you to control how the data buffer being used is initialized. By default, the BizTalk Pipeline Component initializes the data buffer to binary zeros. You can use the InitialBufferValue property to specify how the data buffer is initialized.
Short and Integer Host data types: The following host data types for Short and Integer data are added:
PIC SX(n) Numeric String
PIX X(n) Numeric String
S (Numeric String) RPG Type
It was found that, even after additional host code page support was added, the BizTalk Pipeline Component converted numeric host data types by using host code page 37 (EBCDIC - U.S./Canada) even if another code page was specified. These new host data types for Short and Integer data types allow for string representations of the data, and this provides more flexibility across different kinds of systems.
A supported update is available from Microsoft. However, this update is intended to add the support that is described in the "More Information" section only to the systems that require this support. This update might receive additional testing. Therefore, if your system is not severely affected by the lack of this update, we recommend that you wait for the next Host Integration Server 2010 service pack.
To obtain this update immediately, contact Microsoft Customer Support Services. The usual support costs will apply to additional support questions and issues that do not qualify for this specific update. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft website:
You must have Microsoft Host Integration Server 2010 installed to apply this update.
You do not have to restart the computer after you apply this update.
This update does not replace a previously released update.
The English version of this update 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 item in Control Panel.
For Microsoft Host Integration Server 2010, 32-bit Edition