Terminal Emulation & Transformation Community
  • Home
  • Blogs
  • FORUM
  • About
  • Contact
  • Resources

IBM Host on Demand EHLLAPI Bridge

4/4/2018

0 Comments

 
Picture
Introduction
Emulator High-level Language Application Program Interface (EHLLAPI) standard and API was introduced by IBM for IBM 3270 & 5250 servers, allowing client applications to access information on the host screen. IBM EHLLAPI standard is supported by most of the Terminal Emulator solutions, and forms the basis for many enterprise automation suites and application customization.

Below blogs show different automation capabilities available in IBM Personal Communications.
https://www.tetcommunity.com/blogs/emulator-high-level-language-api-ehllapi-in-ibm-personal-communications
https://www.tetcommunity.com/blogs/personal-communications-session-api-pcsapi-in-ibm-personal-communications
 
IBM Host On-Demand (HOD in short) is another terminal emulator from IBM, which is highly popular for being platform independent, browser based, and having central administration capabilities. HOD supports various automation features, one of which is the capability to interact with EHLLAPI applications.
Following type of EHLLAPI applications can be used via this bridge:
a.       IBM standard interfaces support
  • Industry Standard EHLLAPI 32-bit (&16-bit)
  • IBM Enhanced EHLLAPI 32-bit (&16-bit)
  • Win HLLAPI 32-bit (&16-bit)
  • DOS HLLAPI
b.       Non-Standard IBM interfaces supported
  • IBM Personal Communications PCSAPI Interface
This blog provides more details on this bridge and how to use an EHLLAPI application written for IBM PCOMM on IBM HOD using the EHLLAPI Bridge.

Download Instructions

This tool can be downloaded from IBM Fix Central.
  • Enter “IBM EHLLAPI Library for Host On-Demand”
  • Pick the Installed HOD version details, platform (windows only) & click on Submit
  • On the "Identify Fixes" page, 'Browse for fixes' and then click Continue.
  • Download and install the EHLLAPI bridge.

 
High Level Control Flow
1.       Enable EHLLAPI Bridge in HOD Session profile.
2.       Launch HOD with the modified session profile.
3.       HOD invokes EHLLAPI bridge and establishes a connection with it.
4.       HOD connects with the host specified in the session profile.
5.       Execute the EHLLAPI Application. When run, EHLLAPI functions are executed on the HOD           session rather than PCOMM. Refer to the following design
Picture
Below is a sample on how to configure EHLLAPI and how to use it from IBM Host on Demand
1.       Launch HOD user console.
2.       Select the desired profile and select ‘properties’ from the context menu.
3.       Go to ‘Start Options’ on the left pane and Select the ‘Yes’ radio button of ‘Auto-Start’                    HLLAPI Enable.
4.       Click Ok to apply changes.
Picture
   Note: this invokes EHLLAPI bridge when the selected HOD session is launched.

5.       Launch ‘5250 Display’ session.
          For this example, we have launched Session ‘A’ to a 5250 Host.
6.       Verify that the EHLLAPI bridge is launched correctly by clicking ‘Java Console’ Button on             HOD User console.
7.       Verify that the Java Console displays the following text.
                      “
                       IBM Host Access Class Library
                       Version:  XX.0.1-B20161206
                       Copyright IBM Corporation 1997, 201X. All rights reserved.
 
​                       Using EHLLAPI: XX.00-050116
                       ”
          Where, XX is replaced with the appropriate HOD Version number.
8.       Launch the attached sample program ‘EHLLAPI_Bridge_Sample.xls’ to perform                             appropriate operations. You can observe that the EHLLAPI application can connect,
          read or write data to/from the HOD Terminal Emulator Screen.
Note: More detailed scenarios can be found in the sample EHLLAPI application shipped with PCOMM. It can be found at the following location: <PCOMM_InstallDir>\PCOMM\Samples\VBHLLAPI

If you already have an existing PCOMM EHLLAPI application, it can be executed to communicate with a HOD session using EHLLAPI Bridge (using the procedure above), without needing any modifications.

​Troubleshooting
We have seen some issues when EHLLAPI bridge is installed on the same system as IBM Personal Communications. This is due to existence of multiple versions of the same library being present on the client system.
 
Please refer to the link below to understand how to resolve/workaround these issues
https://www-01.ibm.com/support/docview.wss?uid=ibm10725431

Download the Sample code:
ehllapi_bridge_sample.xls
File Size: 58 kb
File Type: xls
Download File

Contact:
Please email zServices@hcl.com  or HCL-HI-LabServices@hcl.com to get more information on Services offerings.
Avinash Sable
Lead - Lab Services, IBM HACP & HATS
Avinash.sable@hcl.com
0 Comments



Leave a Reply.

    Archives

    May 2020
    October 2019
    July 2019
    June 2019
    May 2019
    March 2019
    November 2018
    October 2018
    September 2018
    August 2018
    July 2018
    June 2018
    May 2018
    April 2018
    March 2018
    February 2018
    January 2018
    December 2017
    October 2017
    September 2017

    Categories

    All
    HACP
    HACPEE
    HATS
    HOD
    PCOMM

    RSS Feed

Proudly powered by Weebly
  • Home
  • Blogs
  • FORUM
  • About
  • Contact
  • Resources