How to Install and Configure Host Integration Server 2016 whitepaper

How to Install and Configure Host Integration Server 2016 whitepaper

At their core, mainframes are high-performance computers with large amounts of memory and processors that process billions of simple calculations and transactions in real-time. The mainframe is critical to commercial databases, transaction servers, and applications that require high resiliency, security, and agility

Microsoft Host Integration Server (HIS) technologies and tools enable enterprise organizations to integrate existing IBM host systems, programs, messages, and data with new Microsoft server applications.

HIS allows IT administrators to securely and efficiently connect new systems to existing systems using industry-standard High-Performance Routing (HPR) and Transmission Control Protocol (TCP) over Internet Protocol (IP). This reduces operating expenses and total cost of ownership while supporting existing and new computing workload.

HIS 2016 is available in one technology package licensed as additional software to the core editions of Microsoft BizTalk Server 2016.

This whitepaper will discuss a step-by-step guideline – how to install and configure Host Integration Server 2016 on a BizTalk Server standalone environment running Windows Server 2016.

What’s in store for you?

This whitepaper will give you a detailed understanding of the following:

  • Install Host Integration Server 2016
  • Configure Host Integration Server 2016
  • Install Host Integration Server 2016 Cumulative Updates

Where I can download it

You can download the whitepaper here:

I hope you enjoy reading this paper and any comments or suggestions are welcome.

You can also find, download and enjoy several other free whitepapers of my own here:

The post How to Install and Configure Host Integration Server 2016 whitepaper appeared first on SANDRO PEREIRA BIZTALK BLOG.

Host Integration Server 2016: Invalid Assembly. Assembly does not contain any TI Objects that inherit from interface

Host Integration Server 2016: Invalid Assembly. Assembly does not contain any TI Objects that inherit from interface

While going through my adventure on a BizTalk Server + Host Integration Server (HIS) project and mainframe connectivity, I’m trying to migrate an old HIS2006 solution to BTS2016 + HIS2016. Just ten years of evolution, I notice that:

  • Many things on HIS2006 are not compatible with HIS2016.
    • You may found some new limitations and new features.
    • Luckily Microsoft provides tools to migrate several components, especially the TI resources.
  • HIS Tools have changed:
    • SNA Manager is quite the same. Maybe some screens and options are a bit different.
    • TI Manager is no longer available. Now we have a different tool called TI Configuration Tool with the same goals as the previous one. However, the way we configure Host-Initiated Processing (HIP) and Windows-Initiated Processing (WIP) is different nowadays.
  • The HIS documentation is quite limited, and you will not find much information about it.

I have to say I’m lucky to have good friends, and because of that, I have been learning a lot with my dear friend Steve Melan, that is the best expert I know regarding HIS.

The last strange (all of them are strange) issue I encountered while trying to Add Host-Initiated Processing (HIP) Object on my HIP configuration by using the Transaction Integration (TI) Configuration Tool was:

Add TI HIP Implementing Assembly

Invalid Assembly. Assembly does not contain any TI Objects that inherit from interface: namespace.interface

Or in other cases:

Invalid Assembly. Unable to load one or more of the requested types. Retrieve the LoaderExceptions property for more information.

Cause

As I told you before, many things changed from HIS2006 to HIS2016, and migrate the Host Application projects is not direct – Visual Studio does not migrate the project as it does for a C# project or BizTalk Server project. Instead, you need to migrate the resources using the TIConversionTool and then import them to your Visual Studio Host Application project.

And you need to make sure that you are not breaking anything like methods and interface names. And then, you need to reference these new resources (DLL containing the .Net Server Definition) on your interface implementation project. This interface implementation is a C#, or VB, class library project. Then, inside that project, you need to create a class that implements the inherited .Net Server Definition interface and provides the implementation of all the members defined within the interface – in this case, all the operations or COBOL programs in that Host Application .Net Server Definition.

My problem was that this interface implementation was also a very old project, compiled in .NET 2.0. For some reason, I yet not completely understood, and despite successfully migrating them to .NET4.6.1, I couldn’t make it fully compatible with the HIP, and I always got these two issues above.

Solution

The resolution was, in fact, quite simple. Basically, I create a new C# class library project from scratch and copy-paste all the existing code to the new one, recreating the old one manually.

Surprise… everything work perfectly! And then, I could create the HIP object.

An example of a Host Application .Net Server Definition interface implementation is something like this:

using RemoteOrder;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;
using System.Text;
using System.Threading.Tasks;
using IHIPServices;

namespace TestOrders
{
    public class OrderImplementation : IHIPServices
    {
        void IHIPServices.GetOrders(ref string value)
        {
            /*
             * Implement the logic
             * 
            */
        }
    }
}

What you need to be aware of are:

  • It should reference these two HIS assemblies:
    • Microsoft.HostIntegration.TI.ClientContext
    • Microsoft.HostIntegration.TI.ServerContext
  • It should reference the Host Application .Net Server Definition assembly
    • In this case, represented by IHIPServices
  • Implement the interface members
    • In this case, represented by IHIPServices.GetOrders(ref string value)

The post Host Integration Server 2016: Invalid Assembly. Assembly does not contain any TI Objects that inherit from interface appeared first on SANDRO PEREIRA BIZTALK BLOG.

Host Integration Server: String was not recognized as a valid DateTime while open HIS Configuration Console

Host Integration Server: String was not recognized as a valid DateTime while open HIS Configuration Console

This week I installed on a BizTalk Server 2016 environment Host Integration Server 2016 (HIS), and to my surprise, I was receiving this quite unusual and annoying error: String was not recognized as a valid DateTime.

Host Integration Server (HIS) Configuration Console: String was not recognized as a valid DateTime

Each time I try to open the HIS Configuration Console.

Nevertheless, this error did not occur the first time I ran the configuration console, in other words, after I install the HIS, the first time I executed the Configuration console everything worked ok. Even, if I close and open again, everything was still working fine. The problem only occurred once I actually configure something.

This error only occurred If:

  • I configure let’s say all the HIS features;
  • Close the HIS Configuration console
  • And then try to open the Configuration console again

Cause

As far as I know, there is no other reason, this is a bug!

Solution

The solution is very simple:

  • Install Host Integration Server Cumulative Update 1

But in fact, there is already Host Integration Server Cumulative Update 2 available so I will recommend you installing this one instead:

After installing HIS CU2, everything worked as expected.

Author: Sandro Pereira

Sandro Pereira lives in Portugal and works as a consultant at DevScope. In the past years, he has been working on implementing Integration scenarios both on-premises and cloud for various clients, each with different scenarios from a technical point of view, size, and criticality, using Microsoft Azure, Microsoft BizTalk Server and different technologies like AS2, EDI, RosettaNet, SAP, TIBCO etc. He is a regular blogger, international speaker, and technical reviewer of several BizTalk books all focused on Integration. He is also the author of the book “BizTalk Mapping Patterns & Best Practices”. He has been awarded MVP since 2011 for his contributions to the integration community. View all posts by Sandro Pereira

Host Integration Server 2016 RTM is avaiable

Host Integration Server 2016 RTM is avaiable

Host Integration Server 2016 RTM is avaiable

The Host Integration Server Product Team finally released the great new Release 2016.
This release confirms the commitment to Microsoft enterprise customers and partners, by delivering a set of new technologies, tools, and improvements.
  • New Microsoft Client for MQ connecting .NET Framework and BizTalk Server applications to IBM MQ message processing systems, providing simplified administration and improved performance.
  • Expanded platform support for latest Microsoft operating systems and development tools, plus support for most popular IBM systems versions, permitting the broadest application support lifecycle for upgraded and new solutions.
  • Improved installation and configuration assisting IT administrators to efficiently deploy new clients and servers, reducing operating expenses and total cost of ownership.
  • New telemetry for improving technologies and tools, by monitoring and reporting connections, operations, and exceptions.
  • New Microsoft Client for DRDA connecting .NET Framework and BizTalk Server applications to IBM DB2 and Informix relational database systems, delivering increased functionality, with improved performance and scalability.
To get started, visit the Microsoft Developer Network to read more about what’s new and improved in Host Integration Server 2016.
Advertisements

BizTalk & Host Integration Server 2016 CTP1

BizTalk & Host Integration Server 2016 CTP1

BizTalk & Host Integration Server 2016 CTP1

Those who thought that BizTalk is dead are completely wrong. Every 2 to 3 years, Microsoft is releasing a fresh new release of BizTalk and Host Integration Server (HIS). Last year at the Integrate Event 2015 in London, the new releases have been announced and now you have the possibility to test out an early preview of both products. HIS (Host Integration Server) is part of BizTalk Server, which are “THE” Microsoft Integration Stack. At this stage, YOU have the possibility to test out the preview and give feedback to the Microsoft Product Team.

BizTalk Server 2016 – What’s new: https://msdn.microsoft.com/en-us/library/mt670742

Host Integration Server 2016 – What’s new: https://msdn.microsoft.com/en-us/library/mt670807

Some of the great new features :

  • Microsoft & Third Party Platform Alignment
  • SQL Server Always On Support of BizTalk
  • Native .NET IBM MQ Client
  • and much more

In addition, there will be a great Integration Event in London this year : http://www.biztalk360.com/integrate-2016/

Advertisements