Version 9.5 Fix Pack 2 delivers the following enhancements:

Event rules have never been so easy

A brand new experience that optimizes the creation and editing of event rules.

A modernized user experience that makes the definition of event rules easier, intuitive, and well-organized, thanks to the folder-based structure. Not only the visual usability has been enhanced, but also the whole management of the event rule definitions, their properties and the interactions with them. A lot of news? Don’t worry, the new contextual help can guide you through the new interface and its fields. On the home page, you can find the page-related topics, and if they are not sufficient, you can search for what you need by using the search bar. Furthermore, by clicking on a field, the help automatically updates itself and shows you the information about the selected field.

Dashboard: See the data from more than one engine at the same time

It is now possible to select more than one engine in the dashboard and see the related results in the widgets.

Organize scheduling objects in workflow folders

Gain greater business agility by organizing your scheduling objects in a hierarchy of folders. Organize them by lines of business, departments, geographies, or any custom category that makes sense for your business operations.

With this fix pack, you can now organize the following scheduling objects into workflow folders:

• jobs
• job streams
• workstations
• workstation classes
• calendars
• event rules
• prompts
• resources
• run cycle groups
• variable tables
• workload applications

Folders also simplify security access. Associate access control lists to individual folders to restrict the rights to which folder any single user or group can access. You can also delegate security management of a specific folder and its sub-folders to other users.

Satisfying Requests for Enhancements (RFEs)

RFE 134569: Dynamic Workload Console 9.5 not rendering properly (height) in resolutions over 1100px

The Dynamic Workload Console now supports the customization of every resolution.

RFE 139443 - The Dynamic Workload Console does not accept special characters (#, $ etc. ) in the Application Description name but these characters are allowed in HCL Workload Automation for Z

Special characters are valid for the z/OS job stream name, which corresponds to the application ID.

RFE 137969 - Dynamic Workload Console Explore: ITEMS visible in List View

Workload Designer explore is now available with list view along with data view. By default, data view will be listed in Dynamic Workload Console when explore option is clicked. List view can be traversed from explore view and gives the details Name, type, workstation and object locked by. It is easy to switch between the views from explore and once the view is switched, it retains the last view for easy reference in Dynamic Workload Console.

RFE 133169: Additional query filter criteria has been added for multiple homogeneous engines

When monitoring your workload from the Dynamic Workload Console with a multiple engine selection, only filters in common between distributed and z/OS engines were shown. This behavior is still valid for the selection of non-homogeneous engines. For multiple homogeneous engines, the same filter options for a single engine are now available.

RFE 139843: Possibility to specify the maximum number of objects shown in each graphical view

By changing a property in the setting file it is now possible to edit the maximum number of objects shown in a graphical view. see this section for more information: https://www.ibm.com/support/knowledgecenter/SSGSPN_9.5.0/com.ibm.tivoli.itws.doc_9.5/distr/src_tsweb/General_Help/awsadgraphviews.htm

Updated version of WebSphere Application Server Liberty Base

Fix pack 2 has been formally tested using WebSphere Application Server Liberty Base version 19.0.0.12 and 20.0.0.3. Because of a known issue affecting version 20.0.0.1, APAR PH21281, we strongly recommend you avoid using it.

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.

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.

Broker CLI commands

The resource and jobstore commands have been reactivated.

Note: To make Broker cli and Broker UI work, both Dynamic Workload Console and master domain manager should be updated to the version 9.5, Fix Pack 1.

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

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 enhancements

RFE 127294

Specifying FTP SIte subcommands. See File transfer job plug-in enhancements for more details.

RFE 123295

Delete file on server after download. See File 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 2.

List of APARs fixed:

IJ22284

On DWC 9.5 dwcinst -f dwcinst.properties the 2 bootstrap ports(sec) are not taken into account. but http(s) ports are ok.

IJ22146

dbupgrade prereq check iws 9.5 fp1 docker container issue with azure paas mssql

IJ21092

DWC only shows up to 6 job streams in "submit predefined job streams" screen

IJ20745

DWC editing the workstation field via job stream editor does not save successfully

IJ20907

DWC remove the unused fake credentials from the rest api

IJ20383

Re-submit a jobstream from dwc, the pri hold or earliest start time settings lost and the job stream starts immediately

IJ20382

Submit job into jobstream from dwc > monitor workload > monitor job streams starts immediately even earliest start

IJ20097

Error AWSUI6007E encountered using copy/paste feature in dwc workload designer

IJ17812

dwc 9.5 & 9.5fp1 job stream plan query empty using shared engine

IJ18457

dwc 9.5 performance issues on slow network.

IJ21784

Errors creating JSDLs from DWC 9.5FP1

IJ19852

Dynamic Workload Console custom board does not work when selecting a pie chart or objects

IJ21751

Drill down does not work as expected for critical jobs widget within Dynamic Workload Console default z workload dashboard

IJ21426

Submitting ad hoc job streams sometimes does get jobs from job stream previously submitted

IJ18059

Error while adding a Variable table to a new service in self-service catalog

IJ19802

An engine connection using single sign-on which authenticates with openID will not connect

IJ19800

ERROR 404: SRVE0190E: file not found: / encountered when attempting to authenticate using openID

IJ07891

About Dynamic Workload Console on reply to local prompt : getting error AWSJDB101E AWSJDB817E AWSUI697W but the reply is performed correctly anyway

IJ05782

Help in Japanese language for IBM workload scheduler is not available

IJ17162

Viewing predecessor information in the production plan causes was hang

IJ17690

When you re-open a job with server:port the port is not shown on Dynamic Workload Console

IJ23160

EQQX550 No variable duration or deadline was specified with z/OS engine

IJ19772

Restart\Cleanup from DWC causes OC1 ABEND in IWS SERVER STC

IJ21216

In DWC, when selecting over 100 jobs or job streams to perform it's performing only 100 operations

IJ17387

Workload automation template import replace fails with two schedules having a new object cross referenced

IJ23878

create like function in DWC 9.5 is not working as expected

IJ23879

AWSUI5015E error occurs when trying to edit an er on japanese environment

IJ22858

job in error query on tws-zos engine with operator role displays only ws column with browsers in Italian

IJ22873

Manage multiple event rules in DWC 9.5.0.01 does not work

IJ22458

In DWC, workload application template replace all doesn't work

IJ22759

In 9.5 FP1 DWC, in edit event rule, changing the name creates a new copy rather than renaming the target event rule

IJ22308

Changing job stream definition does not reflect when submit jobstream on DWC

IJ22282

On browser set in french language, on windows french local, DWC 9.5 fp01 monitor job streams there are missing columns

IJ22240

job dependency not working after confirming success on abended job

IJ22225

KNOWN DEFECT WA-80955 Plugins creates too many directories and files in dwcServer directory

IJ21991

The created or modified workstation task content has not been kept after leaving the query or logoff from DWC and logon again

IJ21032

DWC 951 blank page and tab reload when previously opened tabs are close

IJ20058

DWC designer issue with @ in joblib - the value contains incorrect chars

IJ19618

When creating a DWC datasource a filter can not be correctly applied when using a zos engine

IJ19130

Filters does not work for "RestAPI" datasource for zos controller

IJ18841

job properties on jobstream workload designer are english on japanese environment

IJ20175

DWCINST.SH fails with liberty version error if LANG=JA_JP.UTF-8. Same for ENGINE

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

IBM® Workload Scheduler 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 2. 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 2:

A duplicated datasource cannot be edited and saved

A duplicated datasource, belonging to a shared dashboard and that retrieves data from an internal plan query, cannot be edited and saved because -after the engine selection- it lose the information contained in the query field.

Workaround: Save the query before the engine selection and paste the query in the field.

The new SAP option fields in the editor are not available for the Dynamic Workload Console

The following fields: MAX_JOBS_TO_RELEASE_FOR_USER and RELEASE_ALL_INTERCEPTED_JOBS_FOR_REQUEST, added in the latest version of HCL Workload Automation, are not present in the Dynamic Workload Console SAP editor.

Workaround: Open the editor and add the field to the list.

Widgets in dashboard with two or more engines selected, do not display correct data

Selection of more than one engine is fully supported only when two or more engines of 9.5 FP2 version are selected, therefore when two or more engines of different versions are selected, the widgets of job and job streams do not display correct data.

Workaround: Duplicate the dashboard, duplicate the datasources and remove the filter for folders in the query. Use the following query to include different engines to the monitor of the jobs @#@.@ and this query for job streams @#@

Import of Self-Service Dashboards

After the import of the settings from a Self-Service Dashboards, only the definitions are imported.

Query from two or more engines of different versions may be incomplete

When monitoring jobs or job streams from two or more engines of different HCL Workload Automation versions, no results are displayed in the panel.

Workaround: from the monitoring panel enter the following query: @#@

Widgets in the Default Distributed Dashboard does not retrieve data correctly from Critical Jobs datasource

When trying to retrieve data from a critical job datasource, only critical jobs in the root folder will be retrieved.

Workaround: To retrieve critical jobs from all folders path, clone the critical jobs datasource and insert the following filters /*/*

Problems with Critical Jobs in the Monitoring Panel

When trying to retrieve a list of Critical Jobs from the Monitoring Panel without specifying the folders in the query, it will only return the Critical Jobs in the root folder.

Workaround: Always specify the folder in the query.

Dynamic Workload Console erroneously replaces DOCOMMAND WITH SCRIPTNAME

If you modify the jobs in the FINAL and FINALPOSTREPORTS job streams from the Dynamic Workload Console, after saving the changes, the Dynamic Workload Console replaces DOCOMMAND back with SCRIPTNAME.

Workaround: Only use the composer command line to replace SCRIPTNAME with DOCOMMAND in the jobs contained in the FINAL and FINALPOSTREPORTS job streams.

HCL Workload Automation for Z Server ABEND when connecting a Dynamic Workload Console 9.5

To avoid Dynamic Workload Console connection issues and an HCL Workload Automation for Z ABEND when connecting a Dynamic Workload Console v9.5 Fix Pack 1 or later to a v9.2 or v9.3 Controller, install this APAR https://www.ibm.com/support/pages/apar/PH13139

Issue related to the import of a Workload Application Template

The import of a Workload Application Template from V95FP1 to V95FP2 with nested dependencies may not be working as expected, if the folders are not mapped in the V95FP2 environment.

Workaround: Before the import of the Workload Application Template, recreate the folder structure that you are importing from FP1.

Problems when using filters

When you have a backup master domain manager at the V9.5FP2, but the master domain manager is still at a previous product version level, problems can occur when monitoring objects that support the definition in a folder such as, prompts, workstations, and resources, as well as objects that contain the workstation in their object identifier, for example, job streams. More specifically these objects are not displayed in the results of the monitoring query on the plan if you use filters in your query.

Workaround: Upgrade the master to the V9.5FP2 level and then run planman resynch to resolve the issue.

Dynamic Workload Console help panels in other languages

Some of the help panels in the Dynamic Workload Console could not be translated in the following languages: German, French, Italian, Russian, Korean, Chinese, Spanish, Japanese and Portuguese.

Creating a job stream in the same folder from the Workload Designer (AWSUI6007E)

When creating a job stream in the same folder with the same name but different starting date (valid from), the new job stream cannot be saved.

Workaround: Close the first job stream from the list of the Workload Designer and then save the new job streams.

Filters in datasources of critical jobs are not supported in Z Dashboard

Editing of filters in datasources of critical jobs are not supported for Z engine.

A widget in a custom Dashboard is shared even though the engine connected to the related datasource is not. (WA-77928)

When creating an engine connection, that is not shared, but with the check-box "share credentials enabled", a datasource created with that engine retrieves data on the dashboard, although the engine is not visible to the user to which that dashboard is shared.

Folder column does not appear in Monitor Workload and modeling when connected to a engine of previous releases (WA-85339)

When monitoring a object in the Monitor Workload or List workload connected to a engine of the versione 9.5 Fix Pack 1, the column of folders does not appear.

Workaround: Click edit, expand the section Show Filter Criteria section and add the column manually from the section Column Definition.

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 2 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 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 in Planning and Installation Guide.

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.