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.

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.

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.

Read this section thoroughly before installing this Fix Pack.

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.

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.

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.

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.