HCL Workload Automation version 10.2.1 Readme File

Features introduced with version 10.2.1

APARs and defects fixed in version 10.2.1

This section lists APARs resolved in version 10.2.1.

Resolved Common Vulnerabilities and Exposures (CVE)

Known limitations and workarounds

Package structure

This section describes the structure of the images contained in this release.

Installation files available for HCL Workload Automation by using HCL License Portal

Following is the structure of the release on Flexnet:

• Readme file and WebSphere Liberty package
• AIX components
• IBMi components
• Linux components
• Linux components on Docker
• Windows components
• z/OS Components
• Mac components
• DB2 components

Table 2. Readme file and WebSphere Liberty package

Name	Description
HWA_10.2.1_ReadmeFirst	Readme file with download instructions
WEBSPHERE_LIBERTY_BASE 23.0.0.03	WebSphere Liberty application server

Table 3. AIX components

Name	Description
HWA_10.2.1_AIX_AGENT_2023.12	HCL Workload Automation Agent V10.2.1 for AIX

Table 4. IBM i components

Name	Description
HWA_10.2.1_IBM_I_AGENT_2023.12	HCL Workload Automation Agent V10.2.1 for IBM i

Table 5. Linux components

Name	Description
HCL Workload Automation 10.2.1 LINUX	LINUX distribution
HWA_10.2.1_MDM_LINUX_X86_64_2023.12	Workload Automation V10.2.1 FOR LINUX
HWA_10.2.1_OCLI_LINUX_X86_64_2023.12	Orchestration CLI (OCLI) V10.2.1 for Linux X86-64-2023.12
HWA_10.2.1_LNX_PPC64LE_AGENT _2023.12	HCL Workload Automation Agent V10.2.1 for Linux PPC-2023.12
HWA_10.2.1_LINUX_X86_64_BatchReportCli_2023.12	Batch Report CLI V10.2.1 for Linux X86-64
HWA_10.2.1_LNX_S390_AGENT_PPC-2023.12	HCL Workload Automation Agent V10.2.1 for IBM Z
HWA_10.2.1_LNX_X86_64_AGENT_2023.12	Workload Automation Agent V10.2.1 for Linux on x86-64
HWA_10.2.1_FILE_PROXY_LINUX_X86_64_2023.12	File Proxy V10.2.1 for Linux X86-64-2023.12
HWA_10.2.1_FILE_PROXY_LINUX_S390_2023.12	File Proxy for Linux S390-2023.12

Table 6. Linux components on Docker

Name	Description
HCL Workload Automation 10.2.1 LINUX	LINUX distribution
HWA_10.2.1_DOCKER_MDM_LINUX_X86_64_2023.12	Workload Automation V10.2.1 for LINUX on Docker
HWA_10.2.1_DOCKER_Agent_LINUX_X86_64_2023.12	Agent for Linux on x86-64 on Docker
HWA_10.2.1_DOCKER_Agent_LINUX_S390_2023.12	Agent for Linux on IBM Z on Docker
HWA_10.2.1_DOCKER_FILE_PROXY_LINUX_S390_2023.12	File Proxy for Linux on IBM Z on Docker
HWA_10.2.1_DOCKER_FILE_PROXY_LINUX_X86_64_2023.12	File Proxy for Linux X86-64 on Docker
HWA_10.2.1_DOCKER_AIDA_LINUX_S390_2023.12	AIDA for Linux on IBM Z on Docker
HWA_10.2.1_DOCKER_AIDA_LINUX_X86_64_2023.12	AIDA for Linux X86-64 on Docker

Table 7. Windows™ components

Name	Description
HCL Workload Automation 10.2.1 WINDOWS	WINDOWS distribution
HWA_10.2.1_MDM_WINDOWS_X86_64_2023.12	Workload Automation V10.2.1 for WINDOWS 2023.12
HWA_10.2.1_WINDOWS_X86_64_BatchReportCli_2023.12	HCL Workload Automation V10.2.1 Batch Reports Command Lines
HWA_10.2.1_WIN_X86_64_AGENT_2023.12	HCL Workload Automation Agent V10.2.1 for Windows x64 2023.12
HWA_10.2.1_OCLI_WINDOWS_X86_64_2023.12	Orchestration CLI (OCLI) V10.2.1 for Windows X86-64-2023.12
HWA_10.2.1_FILE_PROXY_WINDOWS_X86_64_2023.12	File Proxy V10.2.1 for Windows X86-64

Table 8. ™z/OS Components

Name	Description
HCL Workload Automation V10.2.1 z/OS	z/OS distribution
HWA_10.2.1_ZSYSTEM_BatchReportCli_2023.12	Batch Report CLI V10.2.1 for Z System 2023.12

Table 9. Mac components

Name	Description
HWA_10.2.1_OCLI_MAC_2023.12	Orchestration CLI (OCLI) V10.2.1 for MAC
HWA_10.2.1_OCLI_MAC_X86_64_2023.12	Orchestration CLI (OCLI) V10.2.1 for MAC ARM 2023.12
HWA_10.2.1_OCLI_MAC_ARM_64_2023.12	Orchestration CLI (OCLI) V10.2.1 for MAC x86 2023.12

Table 10. DB2 components

Name	Description
IBM_DB2_StandardEd_11.5.8_LNX	IBM® DB2® Standard Edition - Restricted Use for Linux® 11.5 on AMD64 and Intel® EM64T systems (x64)
IBM_DB2_Activation_11.5.8	IBM® DB2® Standard Edition 11.5 - Restricted Use - Activation
IBM_DB2_StandardEd_11.5.8_WIN	IBM® DB2® Standard Edition - Restricted Use 11.5 for Windows® on AMD64 and Intel® EM64T systems (x64)

Installing version 10.2.1

This section describes how to apply version 10.2.1 to HCL Workload Automation.

Installation notes

• Before installing the release, ensure you have installed the required prerequisite software. To obtain the latest information about software requirements, see Product Requirements.
• The minimum required WebSphere Liberty version to successfully install the release is 22.0.0.3 or later.
• Before installing this release on AIX® V7.1 operating systems, apply the patch for APAR IZ99634. For more information, see: APAR IZ99634.
• Before you install on UNIX™ operating systems, ensure that umask is set to 022. To verify that umask is set to the correct value, from a command prompt, run the umask command. If the value is different from 022, modify it by running the following command:

  umask 022

• On UNIX™ operating systems, the database administrator must have read and run privileges for the HCL Workload Automation installation path. If this is not the case, the installation fails. (54367)

After the installation completes, verify the following information:

• This release installs a new version of the file tws_env.sh (tws_env.cmd) and also creates a backup file named, tws_env.sh.bk (tws_env.cmd.bk), which are both saved to the TWA_HOME/TWS directory, where TWA_HOME is the HCL Workload Automation installation directory. After completing the installation, if you have modified the original version, merge the content of the new version with the content of the customized version to carry your customized content into the new version.
• Only on Windows™ operating systems, to correctly display double-byte character set (DBCS) characters, perform the following actions:
  • Set the LANG environment variable to the DBCS language code you want to use, for example, set LANG=zh_CN.
  • Set the TWS_TISDIR environment variable to the HCL Workload Automation home directory, for example, set TWS_TISDIR=C:\FTA\TWS.
  • Open the Control Panel window and click Clock, Language, and Region.
  • Click Region and Language.
  • In the Format tab, choose from the Format drop-down list the language you want to use.
  • In the Keyboards and Languages tab, under Display Language, click install and follow the steps to install the DBCS language pack you want to use.
  • In the Administrative tab, click Change system locale and, from the drop-down list, choose the language (system locale) you want to use.
  Note that all the settings must be consistent, that is they must refer to the same DBCS language setting. After you have completed these changes, reboot your workstation to have the changes take effect.
• When installing a dynamic agent or a fault-tolerant agent, ensure that the agent name does not start with a number. If the name of the dynamic agent starts with a number, use the -displayname parameter at installation time to specify a different name. If the name of the fault-tolerant agent starts with a number, use the --thiscpu parameter at installation time to specify a different name.

Interoperability notes

HCL Workload Automation version 10.2.1 supports all product versions indicated in HCL Workload Automation Version 10.2.0 Release Notes.

Installation methods

You can install the release using one of the following methods:

For master domain manager or its backup:

see Updating the master domain manager and its backup.

For dynamic domain manager or its backup:

see Updating the dynamic domain manager.

For fault-tolerant agent, dynamic agent or domain manager:

see Updating agents.

Disk space requirements

For the most up-to-date information about disk space and memory requirements, see the Supported Hardware document in Product Requirements.

Before starting the installation, ensure you have the necessary disk space available on the file system. Consider that the disk space check calculated by the installation considers the entire space occupied by the TWA_HOME directory. The space required by the backup is the sum of the following directories:

TWA_HOME/TWS + TWA_HOME/TDWB + TWA_HOME/wastools + TWA_HOME/properties

If the installation fails because of lack of free disk space, stop the installation, free space on your disk, and start the installation again.

In addition to the disk space in the following table, the installation requires an additional 600 MB available on the file system where the IMShared directory is located.

Table 11. Disk space requirements for installing a master domain manager or a backup master

Operating System	Installation directory	Temporary directory
AIX®	2,5 GB	1,5 GB
Microsoft® Windows®	2 GB	1 GB
Linux®	1,5 GB	800 MB

Table 12. Disk space requirements for installing the fault-tolerant agents

Operating System	Installation directory	Temporary directory
AIX®	900 MB	400 MB
Microsoft® Windows®	700 MB	350 MB
Linux®	720 MB	350 MB

Table 13. Disk space requirements for installing dynamic agents and z/OS agents

Operating System	Installation directory	Temporary directory
AIX®	600 MB	250 MB
Microsoft® Windows®	800 MB	400 MB
Linux®	600 MB	250 MB

Documentation updates

Any additions or changes to the documentation as a result of this release have been integrated into the online product documentation available in HCL Workload Automation product information.

Contacting HCL Workload Automation Software Support

Refer to the HCL Workload Automation Support page: Software Support

Notices

This information was developed for products and services offered in the US. This material might be available from HCL Workload Automation in other languages. However, you may be required to own a copy of the product or product version in that language in order to access it.

HCL Workload Automation may not offer the products, services, or features discussed in this document in other countries. Consult your local HCL Workload Automation representative for information on the products and services currently available in your area. Any reference to an HCL Workload Automation product, program, or service is not intended to state or imply that only that HCL Workload Automation product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any HCL Workload Automation intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-HCL Workload Automation product, program, or service.

HCL Workload Automation may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

For license inquiries regarding double-byte character set (DBCS) information, contact the HCL Workload Automation Intellectual Property Department in your country or send inquiries, in writing, to:

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

HCL TECHNOLOGIES LTD. PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. HCL Workload Automation may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-HCL Workload Automation websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this HCL Workload Automation product and use of those websites is at your own risk.

HCL Workload Automation may use or distribute any of the information you provide in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by HCL Workload Automation under terms of the HCL Workload Automation Customer Agreement, HCL Workload Automation International Program License Agreement or any equivalent agreement between us.

The performance data discussed herein is presented as derived under specific operating conditions. Actual results may vary.

Information concerning non-HCL Workload Automation products was obtained from the suppliers of those products, their published announcements or other publicly available sources. HCL Workload Automation has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-HCL Workload Automation products. Questions on the capabilities of non-HCL Workload Automation products should be addressed to the suppliers of those products.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to actual people or business enterprises is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to HCL Workload Automation, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. HCL Workload Automation, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. HCL Workload Automation shall not be liable for any damages arising out of your use of the sample programs.

© (HCL Workload Automation) (2022).
Portions of this code are derived from HCL Workload Automation Sample Programs.
© Copyright HCL Workload Automation _2022_.

Trademarks

HCL, and other HCL graphics, logos, and service names including "hcltech.com" are trademarks of HCL. Except as specifically permitted herein, these Trademarks may not be used without the prior written permission from HCL. All other trademarks not owned by HCL that appear on this website are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by HCL.

Adobe™, the Adobe™ logo, PostScript™, and the PostScript™ logo are either registered trademarks or trademarks of Adobe™ Systems Incorporated in the United States, and/or other countries.

IT Infrastructure Library™ is a Registered Trade Mark of AXELOS Limited.

Linear Tape-Open™, LTO™, the LTO™ Logo, Ultrium™, and the Ultrium™ logo are trademarks of HP, IBM® Corp. and Quantum in the U.S. and other countries.

Intel™, Intel™ logo, Intel Inside™, Intel Inside™ logo, Intel Centrino™, Intel Centrino™ logo, Celeron™, Intel Xeon™, Intel SpeedStep™, Itanium™, and Pentium™ are trademarks or registered trademarks of Intel™ Corporation or its subsidiaries in the United States and other countries.

Linux™ is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft™, Windows™, Windows NT™, and the Windows™ logo are trademarks of Microsoft™ Corporation in the United States, other countries, or both.

Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Cell Broadband Engine™ is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

ITIL™ is a Registered Trade Mark of AXELOS Limited.

UNIX™ is a registered trademark of The Open Group in the United States and other countries.

Terms and conditions for product documentation

Permissions for the use of these publications are granted subject to the following terms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the HCL Workload Automation website.

Personal use

You may reproduce these publications for your personal, noncommercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative work of these publications, or any portion thereof, without the express consent of HCL Workload Automation.

Commercial use

You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of HCL Workload Automation.

Rights

Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein.

HCL Workload Automation reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by HCL Workload Automation, the above instructions are not being properly followed.

You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations.

HCL Workload Automation MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.