Back in 2009, I did a short BizTalk project that used Host Initiated Processing (aka “HIP”).  This is one of the five features of Host Integration Server (HIS).  Starting with the BizTalk 2009 release, HIS is no longer sold separately, and can only be obtained along with a BizTalk license.

  1. HIP – Host Initiated Processing – CICS transactions send a request to BizTalk for a response, example, a CICS program calls a COBOL subroutine, which in turns talks to BizTalk, which could run an orchestration and call an external web service.
  2. WIP – Windows Initiated Processing – Windows sends a request to CICS and waits for a response.
  3. DB2 – Ability to read/update DB2 database tables.
  4. Host Files – Ability to read/write VSAM files
  5. TI – Transaction Integration – Remote control of CICS screens.

 

When using HIP (CICS Host-Initiated-Processing) [part of Host Integration Services – or HIS] – you might get the error “Select Error Occurred”. This seemed to happen to me when I was trying to pass a null value back to the HIP (and therefore CICS). It seems to want to have all the fields set to some value other than null. Unfortunately, it doesn’t tell you the field that is causing the problem.

With other errors, sometimes you will get an Event Log message that is more helpful. For example, if CICS tries to send a number that is too large for the .NET type, you will get a message like this:

Event Type: Error
Event Source: HIP Service
Event Category: (7)
Event ID: 815
Date: 2/2/2010
Time: 1:00:29 PM
User: BUILTINAdministrators
Computer: NXWTest08BT1.dev.txfb-ins.com
Description:
(815) A Transaction Integrator flow control module is reporting a failure when converting client user data.
HIP Application: RCTGetReplacementCost

Error Description: (1507) The magnitude of a sending field exceeds that allowed for a receiving field in RqstEstimateNumber in GetReplacementCost.
The size of the number is too large to be placed into the resulting data type. Check for a client application error and correct. If the client application is correct consider modifying the data conversion mapping so that the parameter is converted to a data type capable of accepting the numeric value.

HRESULT: 80020009

EXPLANATION
An error has occurred when converting input user data.
ACTION
Verify that the client program is sending the correct data and that the correct HIP mappings have been administered. Make sure that the Transaction Integrator service has been properly deployed and administered and that the HIP runtime environment has been installed on the system on which the failure occurred. If the problem persists contact Microsoft support.

This can happen if COBOL has for example PIC S9(10), and .NET has an integer. Entering 1111111111 in the number “fits”, but entering 2222222222 does not.