Updated : 09/10/2018
Usually vendors tell their customers that their transformation tool can run on any operating systems such as Windows and various UNIX platforms; however they cannot tell them that their tool can run in any application. While HCL Integration Platform (HIP) can run in Windows, all different flavours of UNIX and even the mainframe (zOS), it can also run from any application and it doesn’t have to be Java
AlthoughHCL Integration Platform (HIP) has its own runtime environment called Launcher and Command Server, it’s also embedded in IBM Integration Bus (IIB), IBM Sterling B2B Integrator (B2Bi) and IBM Business Process Server (BPM). With IIB, a message flow can invoke an HCL Integration Platform (HIP) map via a Node. With B2Bi, a business process can invoke an HCL Integration Platform (HIP) map via a Service. With BPM, a business process can invoke an HCL Integration Platform (HIP) map via a Mediation Primitive. As a Unit of Works, when the map fails, the message flow or business process also fails.
The technology behind it is a set of rich APIs that can be invoked from a C/C++, Java and CSharp program. In the embedded solution, the code to invoke the API is encapsulated in the HCL Integration Platform (HIP) configurator. However, you don’t have to stop there. If you have a C/C++, Java or CSharp application, you can write your own code to invoke the API. Examples of the code is shown at the end of this article for Java and CSharp.
So what does the APIs provide. They allow you to
1. Change any map setting from your program. Things like turning on and off the Audit Log, turning on and off the Map Trace, location of those files, specify Workspace to be in File or Memory in addition to PageSize and PageCount.
2. Passing input data and output data via Memory (streaming).
3. Pass input and output file names with location.
4. Change the input or output adapter (for example from File to MQ)
5. Obtain return code and description when the map fails.
The map itself remains the same whether you are running it in Launcher, Command Server, IIB, B2Bi or BPM. To use this module, you would need HCL Integration Platform (HIP) for Application Programming installed on your runtime environment. HCL Integration Platform (HIP) makes itself available via the PATH. For Java application, you also need to set up a ClassPath. As of HCL Integration Platform (HIP) 9.0, a customer who owns Launcher or Command Server also owns Application Programming. The HCL Integration Platform (HIP) runtime license include all those 3 components. However if you are running it in a different server, you do need to get license for that server. You can also find the sample code in the Design Studio installation folder under examples/dk subfolder.
Sample code for Java:
Sample Code for CShar
World Wide tech sales
HCL Integration Platform (HIP) is a trademark of IBM Corporation in at least one jurisdiction and is used under license.