Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

Host-Initiated Processing is updated to support multiple sends to a client app that's running on an IBM mainframe


View products that this article applies to.

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.


↑ Back to the top


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.

↑ Back to the top


Status

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

↑ Back to the top


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.
Third-party information disclaimer
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.

↑ Back to the top


Keywords: kbqfe, kbfix, kbexpertiseinter, kbbug, kbsurveynew, kbnotautohotfix, kb

↑ Back to the top

Article Info
Article ID : 2995330
Revision : 1
Created on : 1/7/2017
Published on : 12/3/2014
Exists online : False
Views : 301