Summary
This article describes a software update that enables a Host-Initiated Processing (HIP) server program to issue multiple sends to a client application that is running on an IBM mainframe.
Resolution
Cumulative update information
A supported feature that changes Host Integration Servers default behavior is now available from Microsoft Support. However, this feature is intended to change only the behavior that this article describes. Apply it only to systems that specifically require it.
The fix that resolves this problem is included in Cumulative Update 2 for Host Integration Server 2013.
Status
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.
More Information
The Transaction Integrator Host-Initiated Processing feature enables a client application that's running on an IBM mainframe to call a .NET Framework object that's defined in a Windows-based application. This feature also lets the client app pass parameters to the object and receive parameters (data) from the object. In the original design, the HIP server program sends the receive parameters to the calling IBM host application in a single send operation.
After you apply this update, the HIP server program can send parameters (data) to the client application on an IBM mainframe in multiple send operations. This new functionality applies only when HIP is connecting to the IBM mainframe by using an SNA Endpoint to communicate in order to use APPC (LU 6.2) sessions.
To support the sending of multiple parameters (data) back to the calling IBM host application, the Host-Initiated Processing server context is updated to include a new SendDataDelegate property. The SendDataDelegate server context property accepts an object that is either a .NET String or an object that is defined as a Structure in a Host Integrator Definition XML (HIDX) file that uses the HIS Designer in Visual Studio. The SendDataDelegate property uses the defined .NET String or Structure to determine what data to send to the client application on the IBM mainframe. The HIP Server program uses the following format to call the SendDataDelegate keyword:
serverContext.SendDataDelegate(myDataStructure);
For example:
string myString = “My String Data”;
serverContext.SendDataDelegate(myString);
Note The myDataStructure property represents the structure that is defined in the HIDX file that, in turn, describes the data that will be sent to the client application.
The third-party products that this article discusses are manufactured by companies that are independent of Microsoft. Microsoft makes no warranty, implied or otherwise, about the performance or reliability of these products.
