Note

Before using this information and the product it supports, read the information in Notices.

This edition applies to Fix Pack 1 for version 9, release 5, modification level 0 of HCL Dynamic Workload Console.

HCL Dynamic Workload Console Readme File Fix Pack 1 for Version 9.5.0

Date
8 July 2019
Fix Pack Name
9.5.0-HCL-DWC-FP0001
Product
HCL Dynamic Workload Console version 9.5.0
General Description
HCL Dynamic Workload Console 9.5.0 Fix Pack 1

This readme file provides important information about Fix Pack 1 for HCL Dynamic Workload Console version 9.5.0.

This readme file is the most current information for the fix pack and takes precedence over all other documentation for Dynamic Workload Console version 9.5.0.

The most up-to-date version of this readme can be accessed at the following URL: Fix Pack readmes

HCL Dynamic Workload Console version 9.5.0 Fix Pack 1 supports all product versions indicated in the HCL Workload Scheduler version 9.5 Release Notes which can be accessed at the following link: Dynamic Workload Console Version 9.5 Release Notes.

For the most up-to-date information about supported operating systems, software and hardware requirements, see the Detailed system requirements document at the following URL: Detailed System Requirements for Dynamic Workload Console.

Review the following sections thoroughly before installing or using this fix pack.

About this Fix Pack

This section contains information specific for this Fix Pack including what has been modified or introduced, what has been fixed, product versions or components to which the Fix Pack applies, and compatibility issues, if any.

This section includes the following subsections:

Features introduced with Fix Pack 1

File transfer job plug-in enhancements
Version 9.5 Fix Pack 1 delivers the following enhancements to the File transfer job plug-in:
RFE 124923: Appending text to an existing file
The file transfer job plug-in now includes an option to append the data contained in the transferred file to the existing file on the destination system. This avoids overwriting the existing file and preserves any changes that were made to the file prior to the transfer. The option applies to file transfers of type download and for files encoded as text.
RFE 127294: Specifying FTP SIte subcommands
An option has been added for file transfers originating from a distributed environment to a z/OS target workstation, using the FTP protocol, to specify SIte subcommands. For example, you can specify a subcommand to define primary and secondary space allocations.
RFE 123295: Deleting a source file after an upload transfer
An option has been added to specify if you want to delete the source files after a file transfer of type "upload".
Delegating administrator privileges on folders to other users

The HCL Workload Automation administrator can grant permissions to a user on a folder so that the user can freely create new access control lists or modify existing access control lists on the folder or any sub-folders to which the user has been delegated administrator permissions. The user can in turn give access to the folder or sub-folder to other users by specifying an existing role to which the user wants to grant the access, as well as the folder. In this way, the HCL Workload Automation administrator can delegate the security to various organizations in the business to other users who can act independently as administrators for that organization.

A new access type "acl" has been added for folder objects. With this type of access, users can create access control lists for the folder assigned to them by assigning predefined roles to users and groups on the entire folder hierarchy or on specific sub-folders.

For more information about delegating permissions on folders, see Managing folders.

OpenID Connect Provider as an identity provider
Enable web single sign-on and use the OpenID Connect Provider as an identity provider.

Client applications, for example, the Dynamic Workload Console, can verify the identity of a user by relying on authentication from an OpenID Connect Provider. You can configure the WebSphere Application Server Liberty Base server to function as an OpenID Connect Client to take advantage of web single sign-on and to use the OpenID Connect Provider as an identity provider.

To simplify the configuration of the WebSphere Application Server Liberty Base server, a sample configuration file in XML format is provided.

For more information about configuring WebSphere Application Server Liberty Base server to function as an OpenID Connect Client, see Configuring an OpenID Connect Client.

Workload dashboard improvements
With the latest release, new enhancements have been added to the workload dashboard.
  • Simplification of the use of the Table widget combined with Engine list datasource: By selecting the Engine list and the Table widget, the related fields are automatically displayed in the list without the need to add them manually.
  • Light redesign of KPI and Bar chart widgets, with different colors and a smoother style.
  • Additional widgets: Bubble chart and Free text. The Bubble chart represents data with a series of bubbles in descending order and size. The bubbles might change in dimension and position according to the variation of data. The Free text gives the possibility to have useful notes at your fingertips.
Updated version of WebSphere Application Server Liberty Base
Fix pack 1 has been tested using WebSphere Application Server Liberty Base version 19.0.0.4 and 19.0.0.5
Added support for Windows 2019 Server
Fix pack 1 delivers support for Windows 2019. The Dynamic Workload Console version 9.5 Fix Pack 1 was tested using Windows 2019 Server with Oracle 18c as the RDBMS.
Enhancements in the Reports feature
  • Folders in reports are now fully supported.
  • Reports are now supported on MSSQL and Oracle databases
  • Two new columns are now available in reports which use a z/OS engine:
    • SUBSYSTEM NAME
    • WORKSTATON TYPE
Satisfying Requests for Enhancements (RFEs)

Requests for Enhancements (RFEs) give customers the opportunity to collaborate directly with the product development team and other users. The team prioritizes and develops new product features based on proposals made by customers.

HCL Workload Automation V9.5 Fix Pack 1 delivers the following RFEs:
RFE 124923
Appending text to an existing file. For details, see File transfer job plug-in enhancementsFile transfer job plug-in enhancements
RFE 127294
Specifying FTP SIte subcommands. See File transfer job plug-in enhancementsFile transfer job plug-in enhancements for more details.
RFE 123295
Delete file on server after download. See File transfer job plug-in enhancementsFile transfer job plug-in enhancements for more details.

To view a complete list of RFEs, new, planned, and delivered, see: RFE online community.

For more information about new features introduced with this fix pack, see Summary of enhancements.

Helpful videos demonstrating new features for HCL Workload Automation is available on Workload Automation YouTube channel.

APARs and defects fixed in HCL Dynamic Workload Console Fix Pack 1 for version 9.5.0

This Fix Pack includes a number of fixes for internal defects found by the verification team.

This section lists APARs solved by Fix Pack 1.

List of APARs fixed:
IJ16431
With Dynamic Workload Console 9.4 FP05, in the submit predefined josbtream panel, the selected variable from the vartab table is overridden by the default main_table variable.
IJ16233
Extra backward slash "\" symbols are added each time the customer edits the event rule.
IJ16230
FTP jobs containing wildcards in the destination name fail with error message AWKFTE037E.
IJ12138
The yearly layout in run cycles is displayed in collapsed mode with Internet Explorer, v. 11.
IJ12956
The search function does not return any job definitions when searching for rerun job definitions in Internet Explorer, v. 11, if a Japanese engine name is used.
IJ11905
With Dynamic Workload Console 9.4.x, if the timezone of the Dynamic Workload Console and the engine are different, job time in job history report is incorrect.
IJ13912
Cannot import Self-Service catalogs when there is no associate.
IJ11908
HCL Workload Automation dependencies are removed when updating a run cycle in a job stream before the final run time occurs.
IJ11482
Cannot load predecessor jobs from a backup master domain manager in Dynamic Workload Console 9.4.04. The following error message is returned: AWSUI0796E: the specified action cannot be performed.

Known limitations and workarounds

The following are software limitations and workarounds that affect Dynamic Workload Console version 9.5.0 Fix Pack 1. For a list of known problems and limitations documented for the V9.5 General Availability release, refer to the https://workloadautomation.hcldoc.com/help/topic/com.hcl.wa.doc_9.5/distrDDguides.html.

9.5 Fix Pack 1:

The actual report is not displayed in the archived plan list if a high number of archived plans is present (WA-80653)

You cannot specify folders with folder names longer than 254 in the security file (WA-80894)

A communication failure could occur when removing an ACL defined on a deleted folder (WA-80991)

Removing an ACL defined on a deleted folder from the Dynamic Workload Console, you could receive an error message similar to the following:

"AWSUI0833E The operation could not be completed. There has been a communication failure. The internal message is: AWSJDB201E The object "acl=/FOLDER1_1/+F" cannot be locked, updated, or deleted because it is locked by user "null"."

Workaround: to remove the ACL and avoid communication issues, perform the following steps:
  • Recreate the deleted folder.
  • Delete the ACL defined on the folder you just recreated.
  • Delete the folder.
Actual Production Details Report output in .csv format is incomplete (WA-81024)

In Actual and Planned Production Plan reports the maximum length for job stream name in the Filter Criteria tab is 16 characters (WA-81039)

Dynamic Workload Console reports in a z/OS environment: Workstation Workload Summary returns the following errors when exported in .csv format:(WA-80992)
  • The Subsystem Name and Workstation Type filters are missing.
  • The filter is not applied to the report contents.
Dynamic Workload Console reports in a z/OS environment: limitations for customized report Analysis Job Duration Standard Deviation (WA-80996)
The maximum job name length is 8 characters and wildcards in the job name are not supported.
Dynamic Workload Console reports in a z/OS environment: Job Run Statistics filter on workstation type does not work (WA-81052)
The filter is not applied to the report contents.

Fix Pack structure

This section describes the structure of the images contained in this Fix Pack.

Fix Pack files available for HCL Workload Automation using HCL License Portal

This is the structure of the Fix Pack on Flexnet:
Table 1. Readme file and WebSphere Liberty package
Name Description
HWA_9501_ReadmeFirst Readme file with download instructions
HWA_9501_WEBSPHERE_LIBERTY WebSphere Liberty application server
Table 2. AIX components
Name Description
HWA_9501_AIX_BatchReportCli HCL Workload Automation 9.5.0.1 Batch Reports Command Lines
HWA_9501_AIX_AGENT HCL Workload Automation Agent 9.5.0.1, Remote CLI and Workload Automation for Applications for AIX
Table 3. HP-UX components
Name Description
HWA_9501_HPIA64_BatchReportCli HCL Workload Automation 9.5.0.1 Batch Reports Command Lines
Table 4. IBM i components
Name Description
HWA_9501_IBM_I_AGENT HCL Workload Automation Agent 9.5.0.1 for IBM i
Table 5. Linux components
Name Description
HCL Workload Automation 9.5 LINUX LINUX distribution
HWA_9501_MDM_LINUX_X86_64 Workload Automation 9.5.0.1 FOR LINUX
HWA_9501_DWC_LINUX_X86_64 Workload Automation Dynamic Workload Console 9.5.0.1 FOR LINUX
HWA_9501_LINUX390_BatchReportCli HCL Workload Automation 9.5.0.1 Batch Reports Command Lines
HWA_9501_LINUXPPC_BatchReportCli HCL Workload Automation 9.5.0.1 Batch Reports Command Lines
HWA_9501_LINUX_X86_64_BatchReportCli HCL Workload Automation 9.5.0.1 Batch Reports Command Lines
HWA_9501_LNX_PPC64LE_AGENT HCL Workload Automation Agent 9.5.0.1, Remote CLI and Workload Automation for Applications for Linux on POWER (little endian)
HWA_9501_LNX_S390_AGENT HCL Workload Automation Agent 9.5.0.1, Remote CLI and Workload Automation for Applications for Linux on System z9 and System z
HWA_9501_LNX_X86_64_AGENT Workload Automation Agent 9.5.0.1, Remote CLI and Workload Automation for Applications for Linux on x86-64
Table 6. Linux components on Docker
Name Description
HCL Workload Automation 9.5 LINUX LINUX distribution
HWA_9501_DOCKER_MDM_LINUX_X86_64 Workload Automation 9.5.0.1 FOR LINUX on Docker
HWA_9501_DOCKER_DWC_LINUX_X86_64 Dynamic Workload Console 9.5.0.1 FOR LINUX on Docker
HWA_9501_DOCKER_LNX_X86_64_AGENT Workload Automation Agent 9.5.0.1, Remote CLI and Workload Automation for Applications for Linux on x86-64 on Docker
Table 7. Windows components
Name Description
HCL Workload Automation 9.5 WINDOWS WINDOWS distribution
ReadmeFirst file Readme file with download instructions
HWA_9501_MDM_WINDOWS_X86_64 Workload Automation 9.5.0.1 FOR WINDOWS
HWA_9501_DWC_WINDOWS_X86_64 Dynamic Workload Console 9.5.0.1 FOR WINDOWS
HWA_9501_WINDOWS_X86_64_BatchReportCli HCL Workload Automation 9.5.0.1 Batch Reports Command Lines
HWA_9501_WIN_X86_64_AGENT HCL Workload Automation Agent 9.5.0.1, Remote CLI and Workload Automation for Applications for Windows x64

Installing the Fix Pack

This section describes how to apply Fix Pack 1 to Dynamic Workload Console.

Before starting the installation, verify that:
  • The Dynamic Workload Console is active.
  • No user is connected to the Dynamic Workload Console to prevent the data related to their working session from being lost.
This section is divided into the following subsections:

Installation notes

Read this section thoroughly before installing this Fix Pack.

  • Before installing the Fix Pack, ensure you have installed the required prerequisite software. To obtain the latest information about software requirements for HCL Workload Automation , see https://workloadautomation.hcldoc.com/help/topic/com.hcl.wa.doc_9.5/distrDDguides.html.
  • On UNIX systems only: Before installing either the Dynamic Workload Console version 9.5 or this Fix Pack, make sure 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 command:
    umask 022
  • If you plan to connect the Dynamic Workload Console version 9.5 Fix Pack 1 to a z/OS engine, ensure the following APAR for the z/OS platform is installed if you plan to use the two new columns in the DB2 reports (SUBSYSTEM NAME and WORKSTATON TYPE):
    PH12689
    Support for multiple controller for DB2 reporting and new keywords added to JOBREC statement.

Interoperability notes

Dynamic Workload Console version 9.5.0 Fix Pack 1 supports all product versions indicated in the Dynamic Workload Console version 9.5 Release Notes which can be accessed at the following link: Dynamic Workload Console Release NotesDynamic Workload Console Version 9.5 Release Notes.

Installation methods

When you install the Fix Pack, the installation path varies depending on the version level you have currently installed:

If necessary, you can also return to a previous product version level, as described in Returning the Dynamic Workload Console to a previous product version level.

Disk space requirements

Before starting the Fix Pack installation, ensure that you have the following space available in the file system. The values indicated in the table show the disk space required by the Dynamic Workload Console alone. For the disk space required by other components, see the relevant documentation.

For the most up-to-date information about disk space and memory requirements, see the hardware requirements at the following URL: see https://workloadautomation.hcldoc.com/help/topic/com.hcl.wa.doc_9.5/distrDDguides.html.

Table 8. Disk space requirements for installing a Dynamic Workload Console Fix Pack
Operating System Installation directory Temporary directory
AIX® 2 GB 800 MB
Linux s390x 2 GB 800 MB
Linux x86-64 2 GB 800 MB
Windows 64 2,5 GB 1 GB
Note: In addition to the above disk space, the installation requires further 579 MB on /usr file system.

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

Documentation updates for HCL Dynamic Workload Console Fix Pack 1, version 9.5.0

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

Contacting HCL Software Support

Refer to the HCL Workload Automation Support page: https://www.hcltech.com/products-and-platforms#support

Notices

This information was developed for products and services offered in the US. This material might be available from HCL 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 may not offer the products, services, or features discussed in this document in other countries. Consult your local HCL representative for information on the products and services currently available in your area. Any reference to an HCL product, program, or service is not intended to state or imply that only that HCL product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any HCL intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-HCL product, program, or service.

HCL 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 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 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 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 product and use of those websites is at your own risk.

HCL 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 under terms of the HCL Customer Agreement, HCL 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 products was obtained from the suppliers of those products, their published announcements or other publicly available sources. HCL has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-HCL products. Questions on the capabilities of non-HCL 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, 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, 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 shall not be liable for any damages arising out of your use of the sample programs.

© (your company name) (year).
Portions of this code are derived from HCL Ltd. Sample Programs.
© Copyright HCL Ltd. _enter the year or years_.

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

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.

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