Features introduced with version 10.2.4

IBM Workload Scheduler version 10.2.4 contains the following enhancements:

• Maximize workflow efficiency with advanced job stream submission and management
• Filtering with Orchestration Query Language in the Orchestration Monitor
• Operator instructions within the Orchestration Monitor
• Discover the new and improved integration with password vaults
• Improved security for password encryption
• Unlocking the enhanced capabilities of Certman
• Workstation management within the Graphical Designer
• Run cycle groups available as triggers in the Graphical Designer
• Resources available in the Graphical Designer
• Workflow details available in the Orchestration Monitor
• Enhanced job control post-submission
• Performance enhancements
• Changed features, improvements, and RFEs in version 10.2.4

Dynamic Workload Console and master domain manager are not supported on AIX operating systems in version 10.2.4. However, support will be reinstated in version 10.2.5.

Performance optimization

Helpful videos demonstrating new features are available on Workload Automation YouTube channel.

APARs and defects fixed in version 10.2.4

This section lists APARs resolved in version 10.2.4

Fixed defects

Resolved Common Vulnerabilities and Exposures (CVE)

Known limitations and workarounds

The following are software limitations and workarounds that affect Dynamic Workload Console 10.2.4:

Unexpected duplicate entries in database indexes when upgrading and using a PostgreSQL database

Duplicate entries may unexpectedly appear in database indexes when performing an upgrade and using a PostgreSQL database.

Jobs and dependencies in job streams might not be displayed when using composer display or extract commands with a PostgreSQL database

While job and dependency information exists in the database, it might not be visible when using the composer display or extract commands with a PostgreSQL database. This issue is purely visual and does not affect job scheduling: job streams and their respective jobs continue to run as expected when loaded into the plan. The defect solely impacts how job stream details are displayed.

SAP jobs and Shadow jobs cannot be created nor edited from the Graphical Designer

 

SAP and Shadow job definitions cannot be created nor edited from the Graphical Designer.

 

Job streams dragged into the Graphical Designer workspace keep loading

 

Job streams might remain in a loading state when they are dragged from the Assets panel into the workspace.

Workaround

The issue is fixed by dragging the same job stream into the workspace again.

Error screen appears while monitoring jobs on the Orchestration Monitor

During the monitoring of jobs from the Orchestration Monitor on distributed engines, selecting Dependencies or Rerun options might result in the display of an error screen.

 

 

Workaround

 

If the issue occurs, perform the following steps:

1. Browse to the following path: /opt/wa/TWA/usr/servers/engineServer/apps/TWSEngineModel.ear/WD.war/monitor/common

2. Open the jobInPlan.json file, and edit the id value under fieldPaths as follows:

   "fieldPaths": {
       "id": "id",

3. Delete the cache folder located in the following path: /opt/wa/TWA/usr/servers/engineServer/apps/TWSEngineModel.ear/WD.war/WEB-INF
4. Delete the monitorWorkloadCache folder located in the following path: /opt/wa/DWC/usr/servers/dwcServer/dwc_workarea

Federator does not always perform the automatic clean up of archived records

Archived records that are stored by the Federator into the database used, if any, are not always auto deleted according to the cleanup policy set in the fed_variables.xml file.

Workaround
To delete those records, you must run the extend command, or perform a plan refresh.

The Federator does not clean up database from old engines

 

Old engines that are stored by the Federator into the database used, if any, are not deleted.

Workaround

To delete those records, you must manually run a query on the database.

The Federator does not support Db2 for z/OS

 

You can use the Federator with all databases supported by the Dynamic Workload Console, with the exception of Db2 for z/OS.

Database load failure with special characters

When using non-American codepages on a z/OS engine, special characters in job stream, workstation, and job names cause database loading failures, resulting in items not being visible in the Orchestration Monitor.

 

Discovered z/OS engines are only usable in the Orchestration Monitor

 

After you have registered a z/OS engine to the Federator, it is added to the list of discovered engines, which are only usable in the Orchestration Monitor. To make all the other Dynamic Workload Console functions available to z/OS engines, you must define them manually on the Dynamic Workload Console.

 

Hyphens not supported in configuredb script when using a PostgreSQL database

 

When specifying names containing hyphens in the configuredb script for a PostgreSQL database, enclose the name within backslashes and double quotes, as follows: \”user_name\”

 

Japanese characters might display incorrectly in job logs on Windows for Dynamic Workload Console and fault-tolerant agents

Job logs containing Japanese characters might appear garbled when viewed in the Dynamic Workload Console or when using the command line on fault-tolerant agents running on Windows operating systems.

Workaround

To resolve this issue, set a Windows environment variable that points to the IBM Workload Scheduler home directory, for example:

TWS_TISDIR=C:\FTA\TWS

Interoperability tables

Package structure

For a detailed list of available packages, see the 10.2.4 Quick Start Guide document available from IBM Fix Central.

Installing and upgrading to version 10.2.4

This section describes how to install and upgrade the Dynamic Workload Console to version 10.2.4.

Installation notes

• Ensure you have installed the required prerequisite software. To obtain the latest information about software requirements for IBM Workload Scheduler, run the Detailed Software Requirements report and browse to the relevant section.
• The formal test phase was performed using WebSphere Application Server Liberty Base 25.0.0.3. The minimum required version of WebSphere Application Server Liberty Base is 24.0.0.9.
• The formal test phase of the Dynamic Workload Console installed in a z/OS environment was performed using WebSphere Application Server Liberty Base 24.0.0.9. The minimum required version of WebSphere Application Server Liberty Base is 24.0.0.9.

• Before performing an upgrade, check whether the ssl_config.xml file is present in the overrides folder. If the file is present, check the verifyHostname option in the twaSSLSettings section. The  verifyHostname must be set to false, as shown in the following example:

  <ssl id="twaSSLSettings" keyStoreRef="twaKeyStore" trustStoreRef="twaTrustStore" sslProtocol="TLSv1.2" 
  clientAuthenticationSupported="true" verifyHostname="false"/>

• Depending on the WebSphere Application Server Liberty version you are using, you might encounter the problems described in the following technotes:

Versions equal to or higher than 24.0.0.8

See Possible IWS compatibility issues with Liberty 24.0.0.8 or higher

Versions ranging from 24.0.0.3 to 24.0.0.8

See Dynamic Workload Console is not able to open "Monitor Event Rules" nor "Manage workload security" with OpenID authentication

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 IBM Workload Scheduler product information.

Contacting IBM Software Support

Before contacting IBM Software Support with a problem, refer to the IBM Software Support site by accessing the following Web address: http://www.ibm.com/software/support

To access IBM support, click the IBM support link at the bottom right of the page.

If you want to contact IBM Software Support, see the IBM Software Support Handbook at the following Web site: http://techsupport.services.ibm.com/guides/handbook.html

Notices

This information was developed for products and services offered in the US. This material might be available from IBM 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.

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

IBM 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:

IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

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

Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

INTERNATIONAL BUSINESS MACHINES CORPORATION 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. IBM 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-IBM 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 IBM product and use of those websites is at your own risk.

IBM 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:

IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

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 IBM under terms of the IBM Customer Agreement, IBM 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-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM 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 IBM, 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. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

© (IBM) (2024).
Portions of this code are derived from IBM Sample Programs.
© Copyright IBM Corp. _2024_.

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

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

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

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.

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

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