IBM Support

IBM HACP Extended Edition

Product Documentation


IBM HACP Extended Edition is a plugin free, web-based terminal emulator. Unlike IBM Host On-Demand, HACP EE does not download any binaries that run on the client machine.

HACP EE reads the existing session definitions from Host On-Demand server and allows users to connect to their System z and System i hosts through an HTML5 compatible browser.


How does it work?

HACP EE runs on an application server and provides the end users with a web-based interface to access the pre-configured HOD sessions and connect to the host systems.

It can fetch 3270/5250 display session configurations from both HTML-based model, combined-based model, and configuration server-based model pages of Host On-Demand.

The following figure shows how a typical HACP EE setup works:

  • User opens a HTML5 compatible web browser and navigates to HACP EE application
       Typically http(s)://<appserver_address:port>/hex/<hod_page_name>
  • HACP EE dashboard appears based on the html page requested by the user.
    • In case of HTML-based and combined-based model pages, session configurations are retrieved from HOD publish directory and listed.
    • If it’s a configuration-based model page, a login screen is presented using which an HOD user can login to fetch the session configurations.
  • User clicks on a session icon to connect to the host system.
  • HACP EE processes the request and renders the terminal screen on the web browser.
  • User interacts with the host using the terminal screen.

Why use IBM HACP EE?

  • Zero Foot Print - Nothing gets downloaded to end users' systems
  • No dependency on Java or any other browser plugins
  • Secure access to host systems using HTTPS and TLS connectivity
  • HTML5 compatible
  • Intuitive and user centric design

How to deploy and configure IBM HACP EE?

IBM HACP EE package is available on IBM fix central.


  • IBM Host On-Demand server
  • WebSphere Application Server (WAS) or TOMCAT or Liberty or HOD (Host On-Demand) embedded Server.

Deployment steps:

  • Extract the contents of IBM HACP EE package (.zip) file
  • Deploy the EAR (Enterprise Application aRchive) file on WAS using WAS admin console.
  • Configure the initial parameters of HACP EE application on WAS with Host On-Demand service manager and web server details

System Requirements

  • Web browsers:
    • Google Chrome v59.0.3071.115 or above
    • Firefox v51.0.1 or above
    • IE 11 or above
    • Edge 41 or above
  • Application servers:
    • IBM WebSphere Application Server v9.0.0.4 and above
    • IBM WebSphere Application Server v8.5.5.11 and above *
    • TOMCAT
    • Liberty Server
    • HOD (Host On-Demand) embedded Server
  • Client Operating Systems:
    • Windows 10 and above
    • RHEL 7.2 and above
    • Mac OS 10.11 and above #

*JRE 1.7 or above is required.

# Only Firefox browser is supported.


Table of Contents:

IBM HACP EE features:

Version: 1.0

  •   Terminal Screen on the browser  
    • New UI using HTML5 canvas for emulator screen
    • Field-based rendering of host data
  •   Operator Information Area (OIA)
    • OIA using HTML5 canvas
    • Updates to cursor position and keyboard lock/unlock status
  •   Productivity features
    • Context menu for Copy/Paste and disconnect operations
    • Host keypad
  •   HOD integration
    • Interface for HOD client login to access session configurations from HOD configuration server
    • Access to both HTML-based and configuration server-based pages created using HOD deployment wizard
  •   Security
    • TLS connectivity to host systems
Version: 1.1
  •   Session Manager API 
    • HACP EE also supports specialized APIs, called Session Manager APIs. These JavaScript-based APIs help application developers manage host sessions and text-based interactions with host sessions.
    • Refer to Session Manager API for configuration details and list of API's supported.
  •   License tracking
    • HACP EE clients can be tracked using the Host Integration License Manager (LM) deployed on an application server. For configuration steps, refer to HACP License Manager.

Version: 1.2

  •   Play Macros
    • All existing macros associated and configured with HOD sessions can be played using HACP EE client. The macro is played on the HACP EE application server, so users will not be able to see intermediate screens. The users will be able to play macros from the following locations:
      • Current session
      • Local macro
      • Server macro library (web only)
  •   Touchpad support
    • Support for touch-enabled devices for HACP EE clients, so that the users can work with system touch keypad or use tap events on green screen.
  •   Edit session properties
    • Configuration model-based users can edit session parameters from HACP EE clients, if they are not locked by an administrator.

Version: 1.3

  • Selectable Font
    • Support to select fonts for both 3270 and 5250 display sessions. HACP EE supports the following list of fonts, for the terminal screen.
    • Consolas
    • Courier
    • Courier New
    • Monaco
    • Monospace
    • Ubuntu Mono
    • Anonymous Pro
    • Cousine
    • Space Mono
    • Terminal

            If any of the above fonts are available on the client system, the application will automatically detect and list them.

            If none of them are present, the application uses monospaced fonts.

  •   Keyboard Remap
    • Host On-demand users can map a single key or a key combined with Shift, Ctrl, or Alt to some action in session configuration. The action can be to display a character, to execute a host function and so on.

      The above mapping can now be used by HACP EE clients. If user types the sequence of mapped keystrokes, it performs the mapped action.

    • Key remap supports Macros Functions, and is also editable. HACP EE users can use the Key Remap editor capability to assign or unassign a key to a function or reset the key to its default assignment.

  • Print Screen
    • Support for printing contents of the terminal screen for both 3270 and 5250 display sessions. HACP EE supports two types of printing.
      There are two ways to print the terminal screen
      1. Print in color - Yes (Color printing)
      2. Print in color - No (Blank and white printing)
      3. Partially selected area of the screen
      4. Entire data available on screen

Version: 1.4

Color Remap:

  • An administrator can map default color of 3270 attribute or 5250 elements or OIA color.
  • Default screen gets repainted with the colors mapped in HOD.
  • HACP EE users can also edit the color of different attributes and save their changes.

Status Bar:

  • Status bar can be viewed on both 3270 and 5250 display sessions.
  • Connection details are shown in status bar. 
  • OIA (Operator Information Area) status are displayed as text in status bar.

Download as Image:

  • Users can download both 3270 and 5250 display sessions as an image.
  • Entire screen or a part of the screen can be downloaded.

Version: 1.5

  •   Hotspot 
    • Support to enable users to create Hotspots on any area of the session window, in order to execute a command or a function by pressing the left-hand button of a mouse.
    • Hotspots can be used to perform the following tasks :  
      1. Simulating Function keys.
      2. Executing a Macro that has the same name as the word that is selected on the screen.
      3. Simulating the Enter Key at the current Cursor location.
      4. Connecting to a website by clicking on a URL that appears on the screen.
  •   Start Sessions Automatically
    • Support to launch a Session automatically (if the Start Automatically option is set to Yes) when a HACP EE user accesses the page, on which the session is defined.
    • The Start Automatically property is available under the session property window, and can be enabled by choosing the Radio button for 'Yes' against the field, 'Start Automatically'.

Version: 1.6

  •   Auto-Start macros
    • Support to automatically play an already existing macro when the session connects.
  •   Support for end-to-end security - For instructions to setup the end to end security, see here
Version: 1.7
  • Asynchronous submission of host data and automatic refresh of the terminal screen    
    • Host data is sent to the server asynchronously and updated on the client without refreshing the terminal screen. The Host screen changes are queried at regular intervals and the terminal screen is updated accordingly without any user intervention.
  •   Keystroke buffering/Type-ahead 
    • Enables the user to enter keystrokes in an emulator session while input is inhibited; keystrokes are buffered and processed later when the input-inhibited condition is removed.
  • Save User configuration (for HTML-based model pages)
    • User changes to the session configurations (like session properties, key remap, color remap and so on) are saved in the browser’s cache.

Version: 1.8

  • Custom function KeyRemap 
    • HACP Extended Edition v1.8 comes with a new functionality to add, update, and delete a custom function for keyremap, where a user can map any key to that user-defined custom function. The custom data can be a combination of mnemonic keyword along with a string (for example, logout[enter]). User can also give Unicode encoding, for example, unicode: \u0028 for the special character ‘(‘. 


§  The user can define name and data for the custom function and then map a key to that function.

§  The data is processed when the mapped key is pressed.


§  Click the row of a specific custom function to view and update the name and data in their appropriate input fields for that function.

§  The user is not allowed to give duplicate name and data for a custom function.


§  The user can delete a custom function by selecting that specific function.

Unicode Encoding:

For Unicode encoding in custom function, only the following are supported:

  •         Alphabets: A-Z, a-z
  •         Numbers: 0-9
  •         Special characters: !, ', (,), *, ?, @, ^, ;, <, >, ~

All the unsupported Unicode is displayed as ”?” in the HACP EE green screen.

  • Extended ColorRemap Attributes: 
      -  Using the Extended color remap property, the HACP EE user can change the color of the extended attributes present in the host screen. 
      -   The Extended color remap attributes are specific to 3270-session type.  

Select the foreground and background colors from the color picker for a specific-extended attribute. 

The extended attributes include: 

  • Blue 
  • Green 
  • Pink 
  • Red 
  • Turquoise 
  • White 
  • Yellow 

NOTE: Default intensified, and default attributes are excluded. 

  • Cut/Copy/Paste:
  • HACP Extended Edition allows users to select different options that are available to edit functions (cut/copy/paste). 

Cut/copy Tab:

Cut/Copy only if a trim rectangle is marked

If this checkbox is selected, the user must draw a trim rectangle in order to use the cut or copy function.

If this checkbox is cleared, the user can do one of the following:

  •         If no trim rectangle is drawn, the user can cut or copy the entire screen.
  •         If a trim rectangle is drawn, the user can cut or copy the contents of that trim rectangle.                       

Trim Rectangle remains after edit function

If this checkbox is selected, the trim rectangle remains on the screen after the completion of cut/copy function.

If the checkbox is cleared, the trim rectangle disappears when the cut/copy function is completed.                                                                                                            

Copy As table       

This function can be used in 3270 and 5250 field-formatted display sessions. It allows you to copy fields from the screen in a tabular form.

 Copy As Fields

This function can be used in 3270 and 5250 field-formatted display sessions. The user can copy fields from the screen in a tabular form. Data inside every new field that is copied, is considered as a separate column in the table. By default, the Copy as Fields function is disabled. This menu option acts as a toggle switch. When it is enabled or disabled, the option is applicable only to the current session.

Protected fields

To copy data from the protected or non-editable fields.

Unprotected fields

To copy data from the unprotected or editable fields.

Trim spaces in fields

To trim leading and trailing spaces in the data field contents that were copied.

Paste Tab

Paste option is enabled if the user copies text from the emulator session.      

Field Wrap: Allows the data that falls in a protected field is pushed to the next nearest unprotected field. The Field Wrap function does not break words in the middle, except when the first word encounters a protected field.

Line Wrap: Enables recognition of end-of-line and end-of-screen indicators and continues to paste your data.

Paste to marked area: Determines if you use a trim rectangle to designate exactly where to paste your data.

Stop pasting when protected field encountered: Allows your data to be pasted until a protected field is encountered unless Field Wrap, Line Wrap, or Paste to marked area is enabled.

Tab character processing.
These paste preferences indicate how tab characters must be processed while pasting.

  1. Advance to next tab stop: Enables you to align tabulated text at specified tab stops.
  2. Replace with: Allows you to replace tab stops with a specified number of spaces.
  3. Paste data to fields: Determines whether your tabulated text is placed in subsequent unprotected fields. When a tab character is encountered, the succeeding text data is pasted into the next unprotected field on the same line of the emulator session.
  • Add Workstation ID and LU Name: 
    • LUName or pool name is the session property that connects the session to the specified pool name, which is defined at the telnet server. The first character must be from A through Z, $ (dollar sign), @ (at symbol). The remaining characters can be from A through Z, 0 through 9, $, and @.
    • Workstation ID is the session property that defines the name of the workstation, If this field is left blank, the host automatically defines the unique ID. The first character must be from A through Z, $ (dollar sign), @ (commercial at sign), or # (number sign). The remaining nine characters can be from A through Z, 0 through 9, $, @ or _ (underscore). The first character can be % (percent symbol) that gets replaced by ‘S’ for display sessions, and when the next character is * (asterisk) it gets replaced by the session short name as in OIA. For example, %M52* replaced by SM52A, SM52B.

Version: 1.9

  • Combined-Based Model Support:
    • Combined-based model pages work as a combination of HTML-model pages and Config-based model pages.
    • Session created under the groups in the configuration server is listed in the HACP EE html page created in the Deployment Wizard.
    • As in the HTML-based model, there is no login prompt.
    • User updates are stored into the browser cache. 
  • Set Refresh Interval globally:

In the HACP EE v1.8 design, the refresh interval was set to 5 seconds by default and using the refresh interval dropdown the user was able to modify the interval from 2 through 5 seconds at the client side. In HACP EE v1.9, the admin can set the refresh interval as a global value for all the clients in “” by using the parameter clientRefreshInterval. Any numeric value can be given to this parameter without any upper limit.

  • Path for file is the HOD publish directory. 
  • For example, clientRefreshInterval = 10.
  • If the parameter is set by the admin, then the refresh interval dropdown is disabled with the assigned value and the user cannot modify the refresh interval at the client side. 
  • If the parameter is not set by the admin, then a default value of 5 is set and the user can change the interval from 2 through 5 seconds.
  • Swedish Host Code Page Beta Support:

HACP EE v1.8 design supported United States (037) Host Code page only. In HACP EE v1.9, Sweden (278) and Sweden Euro (1143) Host Code pages are also supported.

  • As a prerequisite, the user must have Swedish Host Code page supported host.
  • The user can see the green screen with the default Host Code page (United States) if an unsupported host is connected.
  • The user can modify the Host Code page as per their requirements if this property is unlocked by the admin in the property panel.
  • The Host Code page defined by the admin is displayed if this property is locked by the admin.
  • The Host Code page is set to default (United states) if admin defines the Host Code page that is not supported in HACP EE.
  • After setting up the Host Code page, the green screen reflects the changes.
  • HOD integration 
    • Access to combined-based server-based pages created using HOD deployment wizard.
  • Edit session properties 
    • Combined and HTML-based model users can edit session parameters from HACP EE clients, if they are not locked by an administrator.
  • Save User configuration (for combined-based model pages)
    • User changes to the session configurations (like session properties, key remap, color remap and so on) are saved in the browser’s cache.

Version: 1.10

  • 1. Connection parameters support:

    §  From version 1.10, more connection-related properties are supported by HACP EE, such as the following:

    o   TN3270E, Contention Resolution under General.

    o   Keep-alive, Inactivity Timeout, Connection Timeout under Advanced.

    o   Backup Server1 and Backup Server2, Timeout if no data received at initialization, Connect to last host without timeout under Backup Servers. LU or Pool Name is included under Backup Server1 and Backup Server2 for 3270 session alone

    §  End users can enable/disable the properties (from the Connection tab in Property Panel) by locking/unlocking while creating a session.

  • For Config-based model, changes made at client side will be updated on server side.
  • For HTML-based model and Combined-based model, the modified properties will be stored into the browser cache.   

  • 2. Search on Canvas:


    The Search on Canvas feature allows Users to search for specific keywords/text in the green screen and will appear at the top of the presentation screen on the client side. The search results for a successful search is highlighted with a rectangular box.

    The below basic options are available for the Search feature:

    ·       case-sensitive search.

    ·       find number of occurrences.

    ·       navigate to next/previous occurrence of search.

    ·       navigate to first occurrence of search.

    This feature is available under Settings --> Preferences tab.

  • If the parameter is locked by the Admin, the option will be disabled and cannot be modified by Users at the client side. 
  • If the parameter is unlocked by the Admin, the option will be enabled and can be modified by Users at the client side. 

3. Cursor style set update:


From version 1.10, HACP EE supports Block, Underline, Crosshair and Blinking cursors.

·       The Cursor styles can be enabled/disabled directly by Users in the Client side, if the option is unlocked at the Server side.

·       Users can be restricted from modifying the cursor style in the client page, by disabling the check-box corresponding to this feature at the Server side.

·       The corresponding cursor style will be displayed on the green screen, when a User selects this feature from the Cursor tab in the Settings panel.

·       Changes will be saved to the config server for configuration-based model and to the browser cache for HTML and Combined-based models.

4. Confirm on exit:

  • The Confirm On Exit prompt window can be enabled or disabled by Users from the client page, when this feature is unlocked at the Server side. Users can be restricted from modifying this feature in the client page, by disabling the check-box corresponding to this feature at the Server side.
  • When a session on the client page is closed, the Confirm on Exit prompt window appears only if the check-box is enabled on the Preferences tab in the Settings panel.
  • In the pop-up window that appears, click on 'OK' to terminate the session, or on 'Cancel' to remain on the presentation window. 
  • If the check-box is disabled (or unchecked) on the Preferences tab in the Settings panel, the Confirm on Exit prompt window will not appear.

5. Admin control parameters:


The file must be created in the HOD publish directory by an Administrator with the following parameters :






Sample path to HOD Publish directory:

             C:\Program Files\IBM\HostOnDemand\HOD\


(i) ClientRefreshInterval parameter for Set Refresh Interval Globally:

This parameter was part of the file in version 1.9, and need to be defined in the file from version 1.10 onwards.


(ii) QuickConnectByAdmin parameter for Quick-Connect feature:

Users without credentials and configured page, can connect to sessions and use the product as a trial version, by using the Quick-Connect feature in HACP EE.

·       For Config-based model, Users can navigate to Quick-Connect, by clicking on ‘Continue as Guest’ option in the Login Page.

·       For HTML and Combined-based models, the Quick-Connect page will be displayed if a User enters an invalid page name or attempts to launch an unconfigured page.  

·       Administrators can enable/disable the quick-connect option by setting the QuickConnectByAdmin parameter in the file to True or False respectively.

·       If the QuickConnectByAdmin parameter is set to True, Users will be able to see the quick-connect option to launch a session.

·       If the QuickConnectByAdmin parameter is set to False, the quick-connect option will not be shown. Instead, a message will be displayed on the page as You do not have permission to use Quick-connect to launch sessions. Contact the System Administrator to enable this feature.


Following are the parameters to be filled in the Quick-Connect page,

·       Session Type, Destination Port

·       Protocol (Telnet), Destination Address

·       Screen Size, Workstation ID for 5250

·       TN3270E

·       LU Name for 3270

·       Host code page to establish plain host connection.


Limitations of the Quick-Connect feature:

·       Only a Boolean value of true or false can be set by the Administrators for quick-connect.

·       Secure connections are not supported.


(iii) enableStatusBarForAll and isStatusBarEditableByAdmin parameters for Control Status Bar:

Unlike previous versions of HACP EE, where the Status Bar was editable for all Users by default, from version 1.10 onwards, the Administrator can control the Status Bar for clients by setting a global value for the Control Status Bar. The Admin can use isStatusBarEditableByAdmin and enableStatusBarForAll parameters in the file to set the global value. Valid values for these parameters are True/False.

§  For Example: 

isStatusBarEditableByAdmin = true

enableStatusBarForAll = false

§  If the parameter isStatusBarEditableByAdmin is set to True by the Admin and if enableStatusBarForAll is also True, then the Status Bar gets enabled for all Users and this option under Settings panel à  Preferences will be inactive. The Users will not be able to modify the parameter at the Client side.


§  If the parameter isStatusBarEditableByAdmin is set to False by the Admin, then the option under Settings panel à  Preferences will be active, and the value assigned to enableStatusBarForAll parameter in the file is enabled. Users will be able to modify the parameter at the Client side.


o   For Config-based model, the modified values will be saved in the config file.

o   For HTML-based and Combined-based models, the changes are saved to the browser cache.

o   Modified values will remain only until the browser history gets cleared for all the users.


§  If the parameter is not set by the Admin, by default, the Status Bar will be editable for all Users.

6. Mouse wheel support:


This feature allows Users to map the key functions with mouse wheel rotation (up/down).

§  Users can enable/disable the mouse wheel feature from the Settings panel, and can specify the function key which is to be triggered, when the mouse wheel is rotated up or down.

§  This Setting options include the following:


o   Page Up - The choices of key functions available for page up depend on the type of the session, user is running and include the following:

Ø  3270 Session: PF1-PF24, PA1-PA3, Attention and Enter.

Ø  5250 Session: Page Up, Page Down, PF1-PF24, PA1-PA3, and Enter.


o   Page Down – The choices of key functions available for page down depend on the type of the session user is running and include the following:

Ø  3270 Session: PF1-PF24, PA1-PA3, Attention and Enter.

Ø  5250 Session: Page Up, Page Down, PF1-PF24, PA1-PA3, and Enter.


§  Changes will be saved to the config server for configuration-based model and to the browser cache for HTML and Combined-based models.

7. Tomcat and Liberty Support:


Unlike previous versions of HACP EE which supported only IBM WebSphere Application server (WAS) as the runtime environment, from HACP EE version 1.10 onwards, the following application servers are also supported as runtime environments:

1. IBM WebSphere Liberty, which is a highly composable, fast to start, dynamic application server at runtime environment.

2. Tomcat, which is used as application server for web-based application.

These servers were based on Java 2 platform and Enterprise Edition (J2EE) which adopted a multitier distributed model, and also support multiple applications running simultaneously.


8. One Server:


In addition to other supported servers, from version 1.10, an embedded server (part of Host On-Demand) is also included in HACP EE, as part of the deployable application. The advantage of the embedded One Server is that it is not necessary to pre-install a web server in the deployment environment. Embedded servers are scalable and can host applications that support millions of users.

By default, the parameters defined in the code are picked up by the Service Manager when it starts, but Administrators can override the default values by defining parameters of the existing (in the HOD publish directory).

Below are the parameters which can be defined to override configurations.

publishDirContextPath = hod






 Note: The HACP EE WAR file resides under the lib folder of HOD publish directory (HostOnDemand). The modified values from the file will be picked, after the Service Manager is restarted.

9. Auto-update of files:


With the Auto Update feature added in HACP EE 1.10, Users need not manually change the context root or clear the browser history after every build deployment, in order to run the application.

§  Once the User deploys a new build, application automatically updated the client-side java script files and CSS files.

§  Users get the new build changes with new features

§  No need to clear the browser cache

10. Improved Performance and client refresh interval:


Reduced download content size & screen traversal time, thereby, also resulting in improved performance while traversing across screens.

11. UX Design Improvements:


To enhance the User experience, several UI changes have been included in HACP Extended Edition (HACP EE) v1.10 that makes it more responsive and user-friendly.

Below are some of the UX updates:

  • For config-based model, the Login page includes a 'Remember me' option and displays appropriate error message for invalid login attempts.
  • The Dashboard shows a list of available and active sessions.
  • A Search bar has been added to the Settings panel.
  • A ribbon bar is available in the Full screen mode.
  • §  The Property panel includes a Search bar and Help link.

    §  The Color Remap feature is updated with a Reset button that can be used to reset to the default color.

    The Color Remap feature is updated with a Hex code field that shows the Hex value of a color.

List of APARs fixed in HACP Extended Edition

The APARs fixed in HACP Extended Edition and their details can be seen in : Fix list for IBM HACP Extended Edition

Known Issues and Limitations

UI Considerations:

  • For optimal user experience, minimum screen resolution must be 1366x768 or more.
  • Ribbon bar buttons are not accessible using keyboard shortcuts.
  • All the UI elements and strings are available in English only.
  • Back/Forward buttons on the browser are disabled.
  • All the active sessions are lost when the page is refreshed.

Home tab:

  • The Context menu item, ‘Properties’ can be used to view and edit the connection properties, if an administrator has enabled or unlocked properties.

Active sessions tab:

  • Navigation to other tabs, sessions, and ribbon bar buttons are disabled while establishing connection with the host.
  • When a screen is closed, the first entry in the active session list will be selected.

Terminal screen:

  • Only English (037), Sweden (278), and Sweden Euro (1143) code pages are supported. Even if the HOD session definition is set to a different code page, it would be changed to 037 while establishing the connection with the host.
  • Monospaced font is used by default and the text appearance may vary depending on the combination of the browser and OS.
  • Screen does not refresh automatically, without any user action. For example, progress updates of any background actions will not be shown on the screen unless user refreshes the screen using Ctrl+Shift+R key combination.
  • Paste option from context menu or the ribbon bar works only if the text is copied from terminal screens of the same applications. To paste the text that has been copied from other applications (for example notepad), user can use the keyboard shortcut Ctrl+V.
  • Text present in the clipboard will not be processed to identify the control characters (like enter, tab), if any before paste operation.
  • When session data is being encrypted, a + symbol appears in the 4th column of the OIA. There is no option to find more information about the encryption strength or the algorithm used.
  • ENPTUI (5250) and Host graphics (3270) are not supported.
  • For HTML-based pages, users need to clear the browser cache, to get the latest session definition changes from the server.
  • For HTML, Config, and Combined-based models, the following special characters are not allowed in a Session name :

    #   =   “   ‘   /   \   [   {   }

  • Set Refresh Interval globally

    ·       Valid values for file (under HOD publish directory), are only numeric characters.

    ·       If Internet Explorer (IE) is used as the browser, a page refresh must be done for the HACP EE client to pick the updated values of clientRefreshInterval parameter, defined in the file while opening in alternate tab.

Secured connections:

  • HOD’s certificate store files are used for secured connections. For sessions configured with JSSE, CustomizedCAs.jks file will be used, else CustomizedCAs.p12 file will be used.
  • TLS Client authentication is not supported.

Session Manager API (like [pf4]Some text):

  • Cross Browser Communication is not possible through Session Manager API.
  • callCustomerFunction is not supported.
  • WorkAround with iframe is not supported.

Touch support:

  • Host keypad is not optimized for smaller screen devices.
  • On devices with smaller touch screen, the device system keypad might reduce the terminal screen to an unusable level.
  • Context menu for a session icon on HACP EE Home page is unavailable on iOS.

Play macros:

  • Users cannot see intermediate macro screens when the macro is played.
  • Following screen actions are not supported
    • Message
    • File transfer
    • Copy/paste
    • Box select
    • File upload action
    • Xfer action
    • SQL query
    • Run program
    • Perform action
    • Print start, Print extract and Print end
    • Interacting between two sessions using a macro
  • In case of local macros, the following macro actions are not supported
    • Chained macro action
    • Play macro action
  • Since the macros are executed on the HACP EE application server, they cannot open or run any native application.
  • If an active session is closed when a macro is playing, it may result in improper session termination. 

Edit session properties:

  • Users can modify only those properties that are displayed on the properties panel on the HACP EE client.

Keyboard Remap:

  • Character, Macros, and Host Functions categories are supported.
  • If numpad is off, numpad keys are not supported.
  • On android device, key remap feature is not supported.

Custom function Key Remap:

  • Combination of Unicode encoding is not supported.
  • Carat encoding is not supported in the custom function.
  • For adding data or name in custom function, symbols ‘%’ and ‘#’ are not supported. If we add data or name as ‘#’ in custom function, it gets replaced with ‘=’ (equal sign). If we add data or name as ‘%’ in custom function, an error occurs while parsing the JSON data. As a result, the key remap tab is not clickable.
  • For Unicode encoding of custom functions if \u007B,\u007D-{ } is given; while returning data from HOD, due to JSON parsing those braces are not accepted when the Enter key is pressed in the Config model. 


  •  After the trim rectangle is drawn on the screen, screen co-ordinates reflect the co-ordinates of the rectangle only after the cut/copy function is performed.
  • Co-ordinates gets updated when the cursor position is changed on screen. 

Add Workstation ID and LU Name: 

  • Configuring Workstation ID with special characters does not support collision avoidance ID (=).
  • Wildcard entry combinations for Workstation ID is not supported (for example, : N=A=).

Print Screen:

  • Print Screen without graphics is not supported on Internet Explorer.
  • Print Screen without graphics is a blur on Chrome Browser.
  • Crop Printing is not supported in Internet Explorer & Edge.
  • Print screen functionality is not supported on iPad.
  • Print Screen not supported in Firefox browser in Android.

Selectable Font:

  • Selectable font feature is not supported on Android device in Firefox browser.

Quick-Connect feature: 

  • Only a Boolean value of True or False can be set by the Administrators for quick-connect.
  • Secure connections are not supported.

[{"Line of Business":{"code":"LOB17","label":"Mainframe TPS"},"Business Unit":{"code":"","label":""},"Product":{"code":"SSS9FA","label":"IBM Host On-Demand"},"ARM Category":[{"code":"a8m0z0000000CCjAAM","label":"HOD->HACPEE"}],"Platform":[{"code":"PF002","label":"AIX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z/OS"}],"Version":"12.0.0;12.0.1;12.0.2;12.0.3;12.0.4;12.0.5;12.0.6;13.0.0;13.0.1;13.0.2;13.0.3;13.0.4;14.0.0;14.0.1;14.0.2"}]

Document Information

Modified date:
10 October 2020