Known Issues and Limitations

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.

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=).

Admin Console:

  • The Web Application Server and Preferences feature is applicable only from HOD version 14.0.3

  • HACP EE HTML Page names should not contain the strings ‘admin’ or ‘adminconsole’.

    For Example: ‘http://<IP Address>:<port>/<contextroot>/admin.html’ is not valid.

Application Server:

  • When we deploy WAR file, while Playback the Error macro, session gets disconnected when continue is pressed in the intermediate screen.

Autosuggestion Text on Presentation Space:

  • The user input limit field accepts only numbers from the range 1-50, which is 50 by default.
  • Only the Aid keys [Enter] are used to add dynamic text in the presentation space.

  • Do not use any of these common illegal characters or symbols in the user text:

    # = @ “ ‘ % / < > and blank spaces

Connection Parameter:

The Status bar shows primary connection details even if it is connected with the backup server.

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.

Cut/Copy/Paste:

  • 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.

Data Masking:

  • In HOD Hex Client, the data masking feature has some limitations when using DOM View, and print screen functionalities.
  • The data masking feature has limitations when using the color remap functionality.

Debug Module

  • Key Remap Logs get generated after the user navigates to Key Remap under the Settings panel.

Deployment Wizard

  • Some of the properties of Tables, logon, and Driver tabs under the Data Transfer section are not functionally implemented for Display session properties under the HOD Hex Client Admin console.

DOM View-Transformation:

  • Most of the core features will work in transformed pages for all SBCS codepages except ENPTUI, Cut/Copy/Paste (rectangle selection), Host Keypad, Print screen, Cursor under Settings panel, and Ctrl+X, Ctrl+A key functions do not work.
  • Transformation mode will not support the DBCS Code Page.

  • Context Menu will not appear.

  • Color remap – There will be no reflection of the input field background color
  • Prompt and Extract macro - The user must manually give row column values.
  • Execute macro using hotspot will not work.
  • Menu options UI are not in format in the intermediate screens, and additional Font styles are unavailable.
  • HOD Hex Client performance will be slightly low when the transformation is enabled.
  • In the DOM View, users may be unable to navigate to input fields using keyboard keys such as Tab.

EHLLAPI:

  • The WebSocket connection is not working for HTTPS URLs.

ENPTUI:

  • Window8 –DDS window is not appearing.

  • Other –1,4 pull down, and other4 vertical scrollbar is appearing.

    (This issue highlighted in green color is there in HATS also)

  • For the split text cursor, the left movement has issues (text with underlining).
  • Selection field 10- The scrollbar appears slightly above.
  • The arrow mark for the scroll bar has issues in a small device.
  • Selection field 12,22-->As of now cursor will move normally.
  • Others9 field will have multiple radio buttons as some parameters are missing.

Feature Walkthrough:

  • Feature Walkthrough may not function properly on touch devices, server-based recording, customized attributes, auto-start macros, automatic start, file transfer, and the Green Screen context menu.
  • Feature Walkthrough supports only 3270 Display and 5250 Display sessions. For all other session types, the Feature Walkthrough icon will be disabled.
  • The Restart option on the disconnect page may not be recorded.
  • To ensure compatibility, avoid using special characters in the recording title input field when recording in the navigator.

File Transfer:

  • The ‘File transfer type’ should be chosen as ‘Host File Transfer’ by admin since ‘FTP’ is not supported.
  • The zSeries host must be running MVS/TSO, VM/CMS, or MVS/CICS. File transfer must use IND$FILE (SBCS) and the host must be in ready state.
  • The iSeries host must be running the Integrated File System (IFS) on OS/400 V3R7 or later.
  • Only “.txt,.text,.pdf,.doc,.docx,.xlsx” are the supported file formats for transferring files.
  • The maximum file upload size is 100MB, but for 5250 in Embedded Server, the limit is upto 100KB.
  • Host File Transfer feature does not work with WLP desktop users.
  • During file transfer, selection of multiple files frequently from Host location, will result in an unexpected behaviour.
  • Host File Transfer is not supported in macOS(ipad).
  • If the host file already has data (i.e, while sending local file data to existing host file), it appends to the existing data instead of replacing the contents.
  • Host file names should have 1 to 8 characters, the first of which must be alphabetic (A to Z) or national (# @ $). The remaining seven characters are either alphabetic, numeric (0 - 9), national or a hyphen (-). Name segments are separated by a period (.).
  • For 5250 host file name, only IFS naming convention is supported and QSYS naming convention is not supported. Only limited transfer option as mentioned in help.

For example:

/QSYS.LIB/QGPL.LIB/Sample.FILE/Sample.MBR

FTP and VT Session:

  • If HOD Hex Client is deployed in RHEL OS then the FTP and VT service may not work properly using the HOD Hex Client admin console.

    Note: FTP Backend service needs to start externally. For more information refer to FTP Backend service.

  • VT service must be stopped using the HOD Hex Client admin console to restart the NC service manager.
  • HTML page name and Application Server context root should not start with admin','ftp','vt'(case-insensitive).
  • In PPC LE – FTP and VT Session may not work properly.
  • In AIX and zLinux - VT SSH, FTP SSH doesn’t work.
  • FTP Session doesn’t work if the user refreshes the browser.
  • For FTP connection, the “No.of users exceeds” and “transfer in progress” strings will be shown in English.
  • The FTP Login button is recommended to be clicked only once.

Globalization:

  • The dropdown values available in HOD Hex Client client page are not globalized.

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.

Host Code Page:

  • If the HOD session definition is set to unsupported Code Pages, it would be changed to 037 while establishing the host connection.
  • Host graphics (3270) are not supported.

Host Codepage Addition – DBCS Support:

  • Admin console will not support a few properties of DBCS when a session starts.
  • In the DBCS session, operations like overwrite, backspace, and delete will be handled on the server. Hence copy and pasting the DBCS characters are working partially, but pasting the DBCS characters continuously is not working as expected.

Host File Transfer:

  • Host File Transfer and Host File Printing do not work in DBCS Session. The user will not see the expected characters post the file transfer and file printing.
  • File transfer fails in zOS for 5250 host in WAS Liberty and Embedded server.
  • Host File Transfer doesn’t work when HOD Hex Client is deployed on zOS.
  • Send files to the host functionality will not work with Tomcat (Jakarta) Application Server.
  • A " bad gateway" error will appear when the user tries to perform any host file transfer action for cross-platform environments. The host file transfer functionality does not work as expected if the MBR file contains special characters. Sending such files to the host fails; receiving the file from the host will show a 0KB file.

Hotspots:

  • Hotspot macro execution fails while double-clicking.
  • If the user enables a URL hotspot via settings in HOD Hex Client, the page gets loaded in the presentation space.

Intelli Typing Assistant:

  • Intelli Typing Assistant is supported only with the HOD HEX client. It will not be supported in Admin Console sessions.
  • On non-Windows machines such as AIX,zLinux, AS400, and z/OS, the Node server must be deployed on Windows, Linux, or macOS, as these machines do not support the TensorFlow.js library.
  • Model training is limited to words with a maximum length of 12 characters. Words exceeding this limit cannot be trained.

Illegal Filename Characters for Customize Attributes/Macro Export:

Do not use any of these common illegal characters or symbols in your filenames or folders:

  • # % & { } \ < > * ? / $ ! ‘ “ : @ + ` | = blank spaces
  • DOM View changes are not imported.
Associated Printer session changes are not imported when AutoStart macro is enabled.

Jakarta:

  • Migration Utility Export /Import and features will not work when HOD Hex Client is deployed in Tomcat (Jakarta supported).

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.
  • Importing key remapping (.kmp) files from HOD to HOD Hex Client may not work as expected.

License Manager for HOD Hex Client:

  • LM is not supported in the Tomcat HTTPS setup.
  • The active license count is not decreased when the user disconnects the session instead of closing it in supported app servers with client authentication enabled.
  • WAS app server with client authentication enabled, the LM goes down after a few minutes, in this case deploy LM in other supported servers.
  • License Manager doesn't work if it is deployed on WAS Application Server (with Client authentication enabled)
  • License count will not work properly when License Manager is deployed on Tomcat Application Server (all OS) and Embedded Sever (only zOS).

Macro:

While recording a macro if a key mapped to a macro in the key remap panel is pressed, the macro will not get executed. Instead of executing the macro, that key will appear in the presentation space. Macro record will work as usual.

  • Macro record feature does not work in Android as users cannot enter the macro name due to flickering of the keyboard.
  • Session gets disconnected upon playback of the Prompt or Extract macro action (only with Tomcat application server).
  • If a user repeatedly attempts to edit various macros, the deleted macros may still appear.

Migration Utility:

  • HOD Hex Client and the HOD server must be installed on the same machine.
  • The source and targeted HOD versions are independent.
  • The supported HOD versions are HOD 13, HOD 14, HOD 15, and its refresh packs.
  • Do not delete or tamper with these files ‘.rollback, .rollbackSuccess, .importsuccess, .checksumtemp, ImportDirectory.txt’, created after the import/rollback process under the lib directory.
  • HOD Hex Client admin console Migration Utility is not supported for zOS.
  • In configuration parameter import, all ‘Terminal’ properties are supported except the Codepage key.
  • In PPC LE, the user must create a ‘migration’ folder in the target HOD installation directory for config parameter import.
  • Only deltas are available in imported HOD Data (in AS400) and groups (in Windows) after rollback.
  • zOS users cannot migrate HOD data from a lower version to a higher version of the HOD server using Migration Utility.
  • If HOD Hex Client is deployed in PPC LE OS, then users cannot modify the session property for the Config-based model in the migration utility.
  • FTP and VT sessions will not work if Migration Utility is used.
  • Export may not work properly when the user tries to export the package with a custom path.
Note:
After the Import and Rollback operations are completed, the HOD Hex Client deployed application server, and HOD server must be restarted.

Modifying Session Parameters Dynamically:

  • The session manager API (Application Programming Interfaces) does not work with auto-start sessions.
  • With custom JSP, JSON array created by admin will not work.

Office365-Integration:

  • The office365 icon in the ribbon bar will be disabled while executing the macro.
  • Only the green screen data can be integrated with office 365, except the user input values.
  • Microsoft API's doesn't resolve different addresses, as they will be provided during APP configuration (azure). So, Redirector URI and HOD Hex Client URL should be the same.
  • The Green screen content will not send to office 365 when DBCS HCP is Enabled.
  • When DOM View - Transformation is enabled, full-screen content will be sent to the office 365 integrated application. The user will not be able to send part of the green screen to the office 365 integrated application.

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 HOD Hex Client 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.

Print Screen:

  • 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.

Printer Session:

The printed files will not be saved in a customized directory (on using Shared/Network location) in the following:

  • RHEL - Tomcat, WLP, IBM WAS, and Embedded Application Server.

Instead of that, it will be saved in Application Server location.

Quick-Connect Feature:

  • Secure connections are not supported.

Screen Timers:

  • Only numerical values are allowed, for “Minimum time to wait for initial host screen” and “Maximum time to wait for the screen to settle”.
  • HOD Hex Client application must be restarted to reflect the changes, for “Minimum time to wait for initial host screen” and “Maximum time to wait for the screen to settle”.

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.

Selectable Font:

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

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

  • callCustomerFunction is not supported.
  • WorkAround with iframe is not supported.

SSO with MS Authentication:

  • If the end user deletes the HOD User from the HOD/HOD Hex Client admin page, Microsoft authentication will not allow the creation of a new user with the same HOD Username again.

Terminal Screen:

  • Monospaced font is used by default and the text appearance may vary depending on the combination of the browser and OS.
  • 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.
  • For HTML-based pages, users need to clear the browser cache, to get the latest session definition changes from the server.
  • The Display terminal will not be displayed in HOD Hex Client.
  • 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 config.properties 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 HOD Hex Client client to pick the updated values of clientRefreshInterval parameter, defined in the config.properties file while opening in alternate tab.

TLS Client Authentication:

  • JSSE: This feature is implemented for JSSE ‘Yes’.
  • A secure host connection with Client Authentication enabled does not connect with the Tomcat (Jakarta) Application Server.
Note:
Sessions with non-TLS CA will work fine irrespective of the number of sessions.

Touch Devices:

  • Limited support of Web-based Deployment Wizard feature in touch devices.
  • FTP and VT sessions do not work with touch devices.
  • Limited support for functionalities such as macros, host file transfers, and DOM View on touch-enabled devices.

  • Intelli Typing Assistant, Admin Console, Virtual Macro Editor, and Feature Walkthrough are not supported on touch devices.

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 HOD Hex Client Home page is unavailable on iOS.

UI Considerations:

  • For optimal user experience, the minimum screen resolution must be 1366x768 or more.

Virtual Macro Editor:

  • Virtual Macro Editor with menu command key remapping and DOM View may not function properly.
  • Marquee actions are not supported for scrolling or zooming in/out of the canvas.
  • Negative values are not allowed in any input fields.
  • Zero and negative values should not be used in extract actions.
  • Only .mac files are supported when importing a local macro.
  • In Virtual Macro Editor, node and new screen properties, as well as fetching the number of fields and input fields, may sometimes provide inaccurate information.

Web.properties:

While adding a path for printedFileLocation in Printer Session or templateURL in Custom UI in web.properties at the private directory, use double backslash instead of single backslash.

Example:the D:\\FolderName\\FileName.jsp instead of D:\Foldername\FileName.jsp

WEL & SSO Macro:

  • DB jars (eg:DB2 jars) for JDBC Vault must be placed in the server/ application lib folder before starting the server.
Note:
In case of WAR file deployment, we need to mention deployed Jar names in MANIFEST.INF File.
  • “SSO Macro Alternative start screen” option is not supported. (Will be used in the future for different sessions).
  • Auto Start Macro Option will not appear after the SSO Macro record.
  • Config Based Web Express Logon is not implemented.
  • When Web Express Logon Macro is recorded/ Playback, the OIA layer will not appear.
  • Custom SSO does not work in the following scenarios:
    • When the Application Server is Tomcat.
    • When the HOD Server installed on z/OS Operating System.

TLS Client Authentication

TLS Client Authentication and File Transfer (send operations) may not work as expected in the following environments:
  • WebSphere Liberty (WLP)
    • WLP 25.0.0.11 (Web Profile 8)
    • WLP Jakarta 25.0.0.11 (Web Profile 10)
  • Apache Tomcat
    • Tomcat 9.0.111
    • Tomcat Jakarta 11.0.2, 11.0.14
  • Embedded (java 17)
    • Embedded Jakarta 16.0.1