Release Notes
Abstract
This document provides important information about IBM Workload Scheduler Version 10.2.8
Content
IBM Workload Scheduler version 10.2.8 Release Notes
Release date: July 27, 2026
This document provides important information about IBM® Workload Scheduler version 10.2.8.
You can obtain dynamic and up-to-date reports by browsing to Software Product Compatibility Reports and selecting the information you are interested in.
This document is divided into the following main sections:
- Features introduced with version 10.2.8
- APARs fixed in version 10.2.8
- Defects fixed in version 10.2.8
- Resolved Common Vulnerabilities and Exposures (CVEs)
- Interoperability tables
- Known limitations and workarounds
- Package structure
- Software requirements for WebSphere Application Server Liberty Base
- Installing and upgrading to version 10.2.8
- Performing the centralized agent update on a stand-alone fault-tolerant agent
- Documentation updates
- Contacting IBM Workload Scheduler Software Support
- Notices
Documentation Portal Update for IBM Workload Scheduler and IBM Z Workload Scheduler
Effective July 27, 2026, the official documentation for IBM Workload Scheduler and IBM Z Workload Scheduler is returning to the primary IBM Documentation platform: IBM Workload Scheduler V 10.2.8 documentation
Features introduced with version 10.2.8
IBM Workload Scheduler version 10.2.8 contains the following enhancements:
- Advanced capabilities for File Transfer integration
- Nested variables for increased flexibility
- Validation Environment for Readiness Assessment (VERA)
- Effortless control of your job stream status
- Workload management with bulk nop control
- Gain precise control over job reruns with the new deterministic rerun counter
- Optimize your database infrastructure using Amazon RDS for DB2
- Enhanced variable resolution
- New capabilities on the Agent for z/OS
- Customizing and rerunning jobs in the plan
- Exporting job data
- Streamline change control with auditing preferences and justification
- Streamline operations: batch rerun and status confirmation in job stream view
- Changed features, improvements, and RFEs in version 10.2.8
Helpful videos demonstrating new features are available on Workload Automation YouTube channel.
APARs fixed in version 10.2.8
This section lists APARs resolved in version 10.2.8, divided by component.
- Table 1. Engine component - APARs fixed in this release
- Table 2. Installation process – APARs fixed in this release
- Table 3. Command-line component – APARs fixed in this release
- Table 4. Docker – APARs fixed in this release
- Table 5. dynamic domain manager (broker) – APARs fixed in this release
- Table 6. Report CLI– APARs fixed in this release
- Table 7. AIDA CLI– APARs fixed in this release
- Table 8. Documentation – APARs fixed in this release
| Code | Description |
|---|---|
| IJ29440 | Fixed premature execution of jobs dependent on start conditions.Previously, when using condition-based workload automation to monitor a job's output condition (such as waiting for a specific return code like |
| IJ56883 KB0124561 | Fixed unexpected job stream instances when using run cycle groups with repeat cycles.Previously, when a job stream used a run cycle group configured with a repeat cycle (for example, utilizing the |
| IJ58315 | Fixed password encryption failure when using the percent symbol (%) with the pwdcrypt command.Previously, encrypting a password that contained a percent symbol ( |
| IJ58499 | Fixed connection errors when multiple users share the same useropts file for command-line clientsPreviously, when multiple users on the same IBM Workload Scheduler instance attempted to share and use the same custom useropts file (for example, |
| IJ58595 - KB0131268 | Fixed CPU high utilization during Orchestration CLI model extraction of numerous objectsPreviously, when using the Orchestration CLI ( |
| IJ58668 | Fixed password decryption failure when importing user definitionsPreviously, when migrating data from an older environment (such as version 10.1 Fix Pack 5) to a newer environment (such as version 10.2.6), importing user definitions with encrypted passwords failed with the error |
| IJ58678 | Fixed code issue causing JnextPlan to fail on Windows.Previously, when running the JnextPlan script on Windows environments (specifically observed in version 10.2.7) to create or extend a production plan, the command would fail if specific arguments were used. Specifically, when passing arguments like |
| IJ58750 | Fixed an issue where job rerun operations initiated from the Dynamic Workload Console failed to apply the specified priority values.Previously, rerunning a completed job from the Dynamic Workload Console and providing a new priority value resulted in the rerun job being created without the requested priority. This issue has been resolved to ensure that rerun requests consistently apply the newly specified priority value to the rerun job. |
| IJ58886 | Fixed infinite loop issue in AgentCertificateDownloader for Windows dynamic agents.The AgentCertificateDownloader script is used to securely download and deploy certificates in PEM format from the master domain manager to ddynamic agents and fault-tolerant agents. Previously, when running this script to correct mismatched or expired certificates on Windows dynamic agents (specifically observed in IWS 10.2.7), the script would fail to copy the necessary certificate files and instead fall into an infinite loop. This looping behavior caused the |
| KB0103894 - IJ54657 | Fixed batchman process failing to switch TWSMERGE.log files on the first day of the monthPreviously, when the Start of Day (SOD) time was configured to a value other than |
| KB0130577 | Fixed an issue where successors were not displayed during multiple job stream submissionsFixed an issue where the interface failed to display successors when multiple job streams were submitted simultaneously. Previously, in environments configured with an Oracle 19 database, submitting multiple job streams resulted in the successors of those job streams not being displayed. The system has been updated to correctly retrieve and display successors during multiple job stream submissions when using an Oracle 19 database. |
| KB0130752 | Fixed high CPU usage on PostgreSQL and associated job dispatcher errors in messages.logPreviously, environments utilizing a PostgreSQL database server could experience unexpectedly high CPU usage. Accompanying this performance degradation, the WebSphere Application Server Liberty |
| Code | Description |
|---|---|
| IJ53108 | Added missing HTTP security headers to prevent data leakage and phishing attacks.Previously, specific HTTP security headers were missing from the application, which was identified during penetration testing. The missing headers included the |
| IJ58709 | Fixed incorrect prerequisite validation preventing Dynamic Workload Console and master domain manager installation or upgrade on SLES 15.Previously, when attempting to install or upgrade the Dynamic Workload Console or master domain manager to version 10.2.6 on SUSE Linux Enterprise Server (SLES) 15, the prerequisite validation phase could incorrectly fail. This occurred because the installation package's prerequisite definitions did not properly include Dynamic Workload Console and master domain manager in the list of supported components for SLES 15, causing the installer to mistakenly reject valid environments and terminate the deployment. To work around this, users had to manually bypass the system scanner using the |
| IJ58742 | Fixed installation and upgrade failure on AIX systems caused by group ownership syntax.Previously, when installing or upgrading IBM Workload Scheduler components (such as a dynamic agent) to versions 10.2.6 or 10.2.7 on an AIX system, the process could fail during the Java extension installation. This issue occurred because the script attempted to change file ownership using a user-and-group syntax (for example, |
| KB0131669 | Fixed dynamic agent installation failure when using the apikey option.Previously, when installing a dynamic agent on version 10.2.7 and using the apikey parameter to automatically authenticate with the master domain manager and download certificates, the installation failed. Although the AgentCertificateDownloader.sh script executed and successfully generated the |
| Code | Description |
|---|---|
| IJ47501 | Fixed password length validation for the conman altpass commandPreviously, when using the |
| IJ55696 | Fixed password length limitation for the altpass command outside of conman.Previously, when altering a user object's password in the production plan, setting a 31-character password using the altpass command only worked when executed interactively from within the conman utility. Attempting to run the command externally from the command prompt failed for 31-character passwords, although it worked correctly for passwords that were 30 characters or shorter. This issue is now resolved. The altpass command has been updated to correctly process and apply passwords of 31 characters or more regardless of whether the command is executed interactively from inside conman or from an external command prompt. |
| IJ57335 | Fixed certificate validation failure during Windows agent installation caused by trailing backslashes.Previously, installing a Windows dynamic agent might fail during the certificate validation step, generating a |
| IJ57925 | Fixed plain text password exposure in audit logs when using the conman altpass command with a spacePreviously, when using the |
| IJ58057 | Fixed incorrect help output and syntax for the wa_pull_info commandPreviously, querying the help information for the wa_pull_info data collection utility displayed incorrect syntax for the |
| IJ58381 | Fixed daily REPORT8.EXE error events during FINAL job stream run on Windows master domain managers.Previously, executing the daily FINAL job stream on a Windows master domain manager generated |
| IJ58629 | Fixed fault-tolerant agent installation failure caused by the certman command.Previously, installing a fault-tolerant agent (such as version 10.2.6) could unexpectedly fail on certain servers. This issue occurred because the certman command encountered a runtime error ( |
| IJ58725 - KB0131631 | Fixed incorrect default port indicated in Orchestration CLI missing port error messagePreviously, if a user did not specify a port for the Orchestration CLI using its |
| IJ58754 | Fixed incorrect rerun attempt display in job propertiesPreviously, when checking a job properties using the |
| KB0132002 | Fixed OCLI authentication failures for personal API keys in Okta/Keycloak containerized environments.Previously, users attempting to authenticate to the Orchestration CLI using personal API keys in an Okta or Keycloak-based containerized environment would encounter an authentication failure (error |
| Code | Description |
|---|---|
| IJ58327 | Performance degradation in the conman sj command when managing a huge amount of CPUs and folders.Previously, users experienced significantly low performance and slow response times when running the conman sj (showjobs) command in environments configured with a massive number of workstations (referred to as CPUs) and folders. The conman sj command is heavily used by administrators to monitor and display the status of jobs in the production plan. However, when the environment scaled up to include a huge hierarchy of folders used to organize these workstations and scheduling objects, the command's execution speed degraded. This issue is now resolved. The processing of the conman sj command has been optimized to efficiently handle large-scale environments with vast amounts of CPUs and complex folder structures, ensuring that job status queries complete quickly and without performance bottlenecks. |
| KB0132259 | Fixed issue causing manual ACL entries to be lost after an upgrade.Previously, in 10.2.7 environments utilizing a master domain manager and the Dynamic Workload Console, Access Control List (ACL) entries that were manually configured through the Dynamic Workload Console would be lost after performing an upgrade. Specifically, following a WebSphere Application Server Liberty upgrade and subsequent POD restart, administrators would find that all manually configured ACL entries had been removed and were no longer present in the engine security file. This issue is now resolved. The system has been corrected to ensure that ACL configurations remain persistent and are properly retained across standard pod restarts, recycles, and full upgrades. |
| Code | Description |
|---|---|
| IJ57884 | Fixed missing certificate expiration date for dynamic agents connected to a dynamic domain manager.Previously, the certificate expiration date for dynamic agents connected to a dynamic domain manager was not visible. Even after running the Update agent action, the expiration date failed to populate in the Orchestration Monitor screen. This issue is now resolved. The certificate expiration date now correctly populates and displays in the Orchestration Monitor for dynamic agents connected to a dynamic domain manager, allowing you to accurately track when certificates expire and easily verify the success of agent certificate updates. |
| IJ57890 | Fixed suppression of standard error messages in dynamic workload broker scripts.Previously, when running the |
| IJ58187 | Fixed erroneous "404 Not Found" messages in the dynamic domain manager messages.log filePreviously, updating to version 10.2.6 introduced unexpected error conditions into the dynamic domain manager messages.log file. Specifically,IBM Workload Scheduler incorrectly logged a "404 Not Found" error from the |
| IJ58730 - KB0131641 | Fixed database deadlocks and delayed scheduling during massive agent resource scansPreviously, a database deadlock could occur when a large volume of full resource scans arrived simultaneously from multiple agents (such as after long periods of disconnection or following hardware changes). This deadlock involved the |
| Code | Description |
|---|---|
| KB0130879 | Added PostgreSQL configuration section to the reportcli common.properties filePreviously, when setting up command line reporting using the reportcli utility, the common.properties configuration file did not include a dedicated section for PostgreSQL databases. To connect to a PostgreSQL database, users had to manually define the database type ( |
| KB0131193 | Fixed reportcli crashing with out-of-memory errors when processing large reports.Previously, when users attempted to run a large Custom SQL report using the command-line reporting utility (reportcli), the process would frequently fail and crash. Specifically, the Java process running reportcli would exhaust its allocated memory, resulting in a |
| Code | Description |
|---|---|
| KB0129799 | Configurable tolerance values added to AIDA to prevent false anomaly detection.Previously, when the AI Data Advisor (AIDA) component analyzed trends by comparing observed KPI data points with expected values, its algorithms evaluated these metrics using strict decimals without any buffer. Because of this, if the Predictor service calculated a fractional expected value (such as 0.25) but the actual measured value was 0, the system would incorrectly flag the minor discrepancy as a violation. This caused the dashboard to display false anomalies for most KPIs, even when the actual deviation was virtually zero. This issue is now resolved. The AIDA code has been enhanced to include the ability to configure a tolerance value for KPI evaluations. This tolerance is evaluated as the maximum between a fixed and a dynamic value (for example, allowing a 5% deviation of the maximum expected value). With this enhancement, minor decimal variances are safely ignored (for instance, if 1000 jobs are predicted and 1050 are executed, it falls within a 5% tolerance and is not flagged), ensuring the dashboard accurately reports true anomalies without unnecessary alerts. |
| Code | Description |
|---|---|
| IJ57779 | Added missing documentation for dynamic pool optimization policies and sub-fields.Previously, the product documentation lacked detailed information regarding dynamic pool optimization policies and their specific configuration sub-fields. Specifically, essential details and explanations were missing for the following fields:
This issue is now resolved. The documentation has been appropriately updated to include the necessary details for configuring dynamic pool optimization policies and all of their related sub-fields. |
| IJ58167 | Corrected the documented logman command syntax in the recovery procedure.The logman command is used to log job statistics from a production plan log file. Previously, the product documentation for the recovery procedure using logman contained a defect. It incorrectly instructed users to execute the logman -prod command. This documentation issue is now resolved. The recovery procedure guide has been updated to accurately reflect the correct step. Users are now properly instructed to run the command as logman prod <Symphony-file-or-equivalent-schedlog> to ensure the command targets the correct archived Symphony file or scheduling log located in the |
| IJ58269 | Corrected the documented location of the exportserverdata script.Previously, the product documentation for the exportserverdata command incorrectly identified its default location on UNIX systems. It stated that if you did not specify a path for the |
| IJ58309 | Updated documentation for maximum r3password length.Previously, the product documentation for the SAP access method local configuration options incorrectly stated that the |
| IJ58323 | Updated documentation regarding Job Output Condition evaluation limits for RESTful jobs.Previously, the product documentation did not explicitly warn that evaluating Job Output Conditions (such as checking the |
| WA-57867 | Corrected documentation for the enPreventStart global option.Previously, the product documentation incorrectly described the behavior of the enPreventStart global option when it is set to |
Defects fixed in version 10.2.8
This section lists defects resolved in version 10.2.8, divided by component.
- Table 9. Command-line interface – Defects fixed in this release
- Table 10. Documentation – Defects fixed in this release
- Table 11. Dynamic domain manager – Defects fixed in this release
- Table 12. Engine – Defects fixed in this release
- Table 13. Installation – Defects fixed in this release
- Table 14. REST APIs – Defects fixed in this release
| Code | Description |
|---|---|
| WA-163763 | Fixed certman crash caused by directories sharing the control script name.Previously, the certman utility could unexpectedly end in error because it was unable to determine whether it was launched from the product image or from a classic installation. This issue occurred when certman encountered a directory in the path with the exact same name as the control script used to perform the check. By mistakenly identifying the directory as the script file, the path handling logic failed. This issue is now resolved. The certman utility has been updated to correctly differentiate between a directory and a file. This ensures it accurately identifies its launch context without breaking the control logic, crashing, or incorrectly setting the component to an unknown state. |
| Code | Description |
|---|---|
| WA-57867 | Corrected documentation for the enPreventStart global option.Previously, the product documentation incorrectly described the behavior of the enPreventStart global option when it is set to |
| Code | Description |
|---|---|
| WA-161704 | Fixed |
| WA-164313 | Fixed deadlock on Oracle 19 databases during delete operations.Previously, a deadlock could occur in the dynamic domain manager (DWB) when performing delete operations on the |
| Code | Description |
|---|---|
| WA-160877 | Fixed missing job stream information in plan audit files during multiple job stream submissions.Previously, when performing a multiple job stream submission scenario, the plan audit files located in the |
| WA-160878 | Fixed missing plan audit information and justification notes during multiple job stream submissions.Previously, when performing a multiple job stream submission scenario, the plan audit information and justification notes were not correctly saved to the database. As a result, the plan audit files located in the /home/wauser/wadata/audit/plan/ directory were not updated with the relevant job stream submission details. This issue is now resolved. The multiple job stream submission process has been updated to ensure that all plan audit information and user justifications are correctly recorded in the database and logged in the appropriate audit files. |
| WA-161551 | Fixed incomplete multiple job stream submission when using run cycles.Previously, when using the Orchestration Monitor to submit multiple job stream instances generated by a run cycle, an issue prevented all the instances from being successfully submitted. Even if multiple instances were generated and selected for submission, only the first instance was actually added to the production plan. This issue is now resolved. The multiple job stream submission service has been updated to ensure that when multiple instances are generated by a run cycle and submitted, all selected instances are correctly added to the plan. The number of submitted job streams now accurately matches the expected amount on the Orchestration Monitor page. |
| Code | Description |
|---|---|
| WA-165038 | Fixed infinite loop and system freeze caused by AgentCertificateDownloader during upgradePreviously, during an upgrade from version 10.2.6 to 10.2.7, the |
| Code | Description |
|---|---|
| WA-142355 | Fixed folder filtering issues for jobs and job streams in Orchestration CLIand REST APIs v2Previously, when attempting to filter jobs or job streams organized within folders (for example, when querying multiple job streams or sequence rerunning jobs), the filters did not work correctly in the Orchestration CLI and REST APIs v2. Unlike the conman utility, which successfully retrieved information using standard wildcard filters at any folder level (such as |
Resolved Common Vulnerabilities and Exposures (CVEs)
The following CVEs have been resolved:
| CVE ID | Severity |
|---|---|
| CVE-2025-8677 | High |
| CVE-2026-29111 | High |
| CVE-2026-33636 | High |
| CVE-2026-33811 | High |
| CVE-2026-34982 | High |
| CVE-2026-35385 | High |
| CVE-2026-39822 | High |
| CVE-2026-39827 | High |
| CVE-2026-42198 | High |
| CVE-2026-42504 | High |
| CVE-2026-42583 | High |
| CVE-2026-43869 | High |
| CVE-2026-47244 | High |
| CVE-2026-4786 | High |
| CVE-2026-4878 | High |
| CVE-2026-54512 | High |
| CVE-2026-5450 | Medium |
| CVE-2026-45292 | Medium |
| CVE-2026-54515 | Medium |
Interoperability tables
In the tables in this section the following acronyms are used:
| Acronym | Extended form |
|---|---|
| DA | Dynamic agent |
| DDM | dynamic domain manager or backup dynamic domain manager |
| DM | domain manager |
| DWC | Dynamic Workload Console |
| FTA | fault-tolerant agent |
| MDM | master domain manager |
| BKM | backup master domain manager |
| ZWS agent | IBM Z Workload Scheduler Agent (also known as z-centric agent) |
Compatibility is supported on the latest available release level for each IBM Workload Scheduler release listed in the table:
| Component | MDM | DDM | DM | FTA | DA | ZWS agent |
|---|---|---|---|---|---|---|
| MDM 10.2.8 |
|
|
|
|
| |
| DM 10.2.8 | 10.x.x | 10.x.x | ||||
| FTA 10.2.8 | 10.x.x | 10.x.x | 10.x.x | |||
| DA 10.2.8 | 10.x.x | 10.x.x | 10.x.x | |||
| DDM 10.2.8 | 10.x.x | 10.x.x | 10.x.x |
(*) Important information regarding agents at 9.5 version
If you currently have agents at 9.5 version, read the following information:
- Support for 9.5 agents is limited to the upgrade period.
- The required upgrade approach is the top-down approach. For more information, see Choosing how to upgrade your network.
- The recommended upgrade procedure is a parallel upgrade. For more information, see Parallel upgrade from version 9.5.0.x or 10.x.x to version 10.2.8.
| Component | MDM |
|---|---|
| 10.2.8 |
The Orchestration CLI version must be equal to or lower than the master domain manager version. The Orchestration CLI can run at most two versions below the master domain manager. Using an Orchestration CLI that is newer than, or more than two versions older than, the master domain manager is not supported.
| Component | MDM | DDM | DWC |
|---|---|---|---|
| AIDA 10.2.8 | 10.x.x | 10.x.x | 10.x.x |
Compatibility scenarios and limitations
It is highly recommended to keep all IBM Workload Scheduler components updated to the latest version as part of regular maintenance. This not only maintains a consistent environment but also enables you to utilize new features introduced in each release.
Known limitations and workarounds
The following are software limitations and workarounds that affect IBM Workload Scheduler 10.2.8:
Mixed-version environment with a master domain manager at a version earlier than 9.5 FP4
Before you install a component at version 10.2.8 in an environment with a master domain manager at a version earlier than 9.5 FP4, install the fix for IJ47731 on the back-level master domain manager.
- For version 9.4 FP7, the fix is available from IBM Fix Central.
- For other product versions, contact Software Support.
.
Event-driven workload automation (EDWA) proxy does not support HTTPS connections
Event-driven workload automation (EDWA) proxy supports only HTTP connections. As a result, SSL communication is not supported.
The centralized update on a stand-alone fault-tolerant agent V10.2.1 is not supported
The centralized update on a fault-tolerant agent V10.2.1 is not supported, regardless of the operating system. For more information about upgrading from different versions, see Performing the centralized agent update on a stand-alone fault-tolerant agent.
Pool connection issues with CyberArk
If you are using a pool as a gateway to communicate with CyberArk and an agent within the pool loses connection to the CyberArk server, the job assigned to that specific agent fails. For instance, if an agent remains up and running but stops communicating with CyberArk, any jobs assigned to that agent that require a connection to CyberArk fails. This occurs because the pool lacks the ability to verify whether its agents are connected to the CyberArk server.
Folder filtering discrepancy in Command Line Interfaces
Filtering for jobs and job streams within folders with Orchestration CLI or REST APIs V2 using
conmansyntax might not work as expected, returning different results from the ones retrieved usingconman.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.
Unresolved dependency state with shadow jobs and start of day setting
Successor jobs remain permanently in the HOLD state, even after the shadow job predecessors successfully complete. This happens specifically when the job stream execution crosses the customized Start of Day boundary due to the job rerun logic. The product correctly updates the final status of the shadow job to SUCC, but the dependency is not released when the related scheduling event occurs close to or across the
startOfDay. The job is effectively orphaned in the queue, stuck in HOLD despite having met its only prerequisite.ABENDPROMPT Failure to Suppress RERUN on AIX operating systems
On AIX operating systems, the presence of an
ABENDPROMPTsetting fails to correctly block the automatic execution of theRECOVERY RERUNaction when a job terminates in the ABEND state.The job manager fails to prioritize the prompt mechanism, which should transition the job to a waiting state and generate an immediate
ASKEDprompt, thereby overriding or delaying the automaticRERUNdefined in the recovery policy.This failure results in an uncontrolled automatic rerun, bypassing the required human intervention point defined by the
ABENDPROMPTsetting.Database job connection tests to Microsoft SQL Server might fail with an SSL certificate error
A known limitation exists where testing the connection for a Database job to a Microsoft SQL Server database might fail. When this occurs, the system returns an
AWKDBE023Eerror indicating that the database driver could not establish a secure connection using Secure Sockets Layer (SSL) encryption. This issue occurs when theencryptconnection property is set totrueand thetrustServerCertificateproperty is set tofalse, but the driver cannot find a valid certification path to the requested target.Jobs incorrectly display a Cancel Pending status after being unmarked as a No operation (UNNOP) and rerun
A known limitation exists where the Orchestration CLI incorrectly displays a job's internal status as
Cancel Pendingafter the job has had its No operation (NOP) property removed and is rerun. When a user marks a job as a No operation (using the nop command), it is subsequently set to aCancelledstatus. If the user then removes theNOPproperty (using the unnop command) and reruns the job (using the rerun or rr command), the job correctly executes but inaccurately retains aCancel Pendinginternal status instead of updating toSuccess.Error importing users with Orchestration CLI after exporting with composer
When you use the composer extract command with the password argument and a passphrase, user definitions are saved to a file with their passwords in an encrypted format. However, if you attempt to import these definitions back into the database using the ocli model replace command, the process fails. The Orchestration CLI incorrectly evaluates the length of the long, encrypted password string and generates an error stating that the password length exceeds the maximum allowed limit of 31 bytes.
Slow shutdown of the writer process on Windows agents of type
bothA problem might occur when attempting to stop an agent configured as type
bothon a Windows operating system. When launching the shutdown.cmd script to stop the local processes, users may experience a significant delay. While other control processes terminate quickly, thewriterprocess, which is responsible for handling incoming messages and passing them to the localmailman, takes an unusually long time to stop.
Fix availability is as follows:
For more information, see IJ47731: CHECKSYNC JOB FAILED IN IWS 10.1 FP02 - AWSJCL075E ERROR
Package structure
For a detailed list of available packages, see the 10.2.8 Quick Start Guide document available from IBM Fix Central.
Software requirements for WebSphere Application Server Liberty Base
WebSphere Application Server Liberty Base adopts a continuous delivery model where new versions are deployed on a monthly basis.
During formal testing, IBM Workload Scheduler and the Dynamic Workload Console were tested by using WebSphere Application Server Liberty Base 26.0.0.6.
For the Dynamic Workload Console installed in a z/OS environment, the minimum required version is WebSphere Application Server Liberty Base 26.0.0.3.
For more information about which subsequent versions of WebSphere Application Server Liberty Base can be used in the future, see Recommended updates for WebSphere Application Server.
Installing and upgrading to version 10.2.8
This section describes how to install or upgrade to version 10.2.8.
Before installing the release, ensure you have installed the required prerequisite software. To obtain the latest information about system requirements, run the Detailed System Requirements report and browse to the relevant section.
Installation notes
- If you use Oracle AI Database 26ai, you can improve performance by setting the parameters listed in Optimizing performance for Oracle AI Database 26ai.
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"/>
Upgrade notes
Review the following points before upgrading.
MSSQL notes
If you are using MSSQL and are upgrading from a release earlier than 10.2.3, perform the steps listed below after upgrading to version 10.2.8. If you are using MSSQL and are upgrading from release 10.2.3 or a release later than 10.2.3, you can ignore the steps listed below.
- Browse to the datasource.xml template.
- Open the file with a text editor and perform the following changes:
Add the lines listed below after the db.driver.path parameter:
<variable name="db.encrypt" value="false"/> <variable name="db.trustServerCertificate" value="false"/>Append the following strings at the end of the value of the mssql.URL parameter:
;encrypt=${db.encrypt};trustServerCertificate=${db.trustServerCertificate}Add the lines listed below after the integratedSecurity parameter:
encrypt="${db.encrypt}" trustServerCertificate="${db.trustServerCertificate}"The resulting file looks as follows. The modified sections are highlighted in bold:
... <variable name="db.driver.path" value="<db_driver_path>"/> <variable name="db.encrypt" value="false"/> <variable name="db.trustServerCertificate" value="false"/> <variable name="mssql.URL" value="jdbc:sqlserver://${db.serverName}:${db.portNumber};databaseName=${db.databaseName} ;encrypt=${db.encrypt};trustServerCertificate=${db.trustServerCertificate}"/> <jndiEntry value="MSSQL" jndiName="db.type" /> ... integratedSecurity="false" encrypt="${db.encrypt}" trustServerCertificate="${db.trustServerCertificate}"
- Stop and restart WebSphere Application Server Liberty to make the changes effective.
Verify your Single Sign-On settings
When upgrading to Dynamic Workload Console version 10.2.5, if the previous environment is configured for Single Sign-On (SSO) using ltpa.keys, perform the following steps:
- Copy the
ltpa.keysfile either from the master domain manager to the workstation hosting the Dynamic Workload Console, or vice versa, depending on your configuration. - After copying, restart the IBM Workload Scheduler processes on the component where the
ltpa.keysfile was updated to complete the SSO setup.
Check the alias of your custom certificate before upgrading
Before you upgrade the master domain manager or Dynamic Workload Console, verify the alias you use for your custom certificates. Failure to do so might cause the master domain manager and Dynamic Workload Console to fail at start time and return one of the following errors: CWPKI0024E: The server certificate alias is invalid. or CWPKI0024E: The server certificate alias specified by the attribute serverKeyAlias is either not found in KeyStore or it is invalid.
On UNIX operating systems, you can run the following example command to verify the alias:
- Browse to the following paths, depending on the component:
master domain manager
<TWA_DATA_DIR>/usr/servers/engineServer/resources/security
Dynamic Workload Console
<TWA_DATA_DIR>/usr/servers/dwcServer/resources/security
Run the following command:
openssl pkcs12 -in TWSServerKeyFile.p12 -nokeys -info | grep server
On Windows operating systems, you can run the following example command to verify the alias:
- Browse to the following paths, depending on the component:
master domain manager
<TWA_home>\usr\servers\engineServer\resources\security
Dynamic Workload Console
<TWA_home>\usr\servers\dwcServer\resources\security
Run the following command:
certutil -dump keyfile.p12
If a key with the alias server is present, no additional steps are required. The custom certificate with alias server is used by the master domain manager and Dynamic Workload Console.
If your custom certificates use aliases other than server, you can encounter the following situations:
Current status of ssl_config.xml file | Steps to be performed |
|---|---|
You do not have a customized version of the ssl_config.xml file in the overrides folder. | On both master domain manager and Dynamic Workload Console, create a new file named serverkeyalias. xml in the overrides folder with the following content: |
You already have a customized version of the ssl_config.xml file in the overrides folder. | On both master domain manager and Dynamic Workload Console, edit the
|
You can now proceed with the upgrade.
Installation and upgrade procedures
You can install the release using the procedure described in Installing from the CLI.
You can upgrade to the current release using the procedure described in Upgrading from the CLI.
Disk space requirements
To obtain the latest information about permanent disk space requirements when installing on supported operating systems, run the Hardware requirements report and click on the relevant operating system link.
Performing the centralized agent update on a stand-alone fault-tolerant agent
Before performing a centralized update on fix packs or upgrade on releases on a stand-alone fault-tolerant agent to 10.2.8, there are procedures to follow according to the version of the fault-tolerant agent from which you want to upgrade.
The table below shows which procedure you must follow to perform the upgrade, according to the fault-tolerant agent version.
| Stand-alone fault-tolerant agent version | Required steps |
|---|---|
| V9.5 Fix Pack 4 up to V9.5 Fix Pack 6 | If not already enabled, enable the use of the HTTPS protocol to connect to the event processor server. For more information about enabling enEventProcessorHttpsProtocol | eh, see Global options - detailed description |
| V9.5 Fix Pack 7 | No steps required. |
| V10.1 up to V10.1 Fix Pack 3 | If not already enabled, enable the use of the HTTPS protocol to connect to the event processor server. For more information about enabling enEventProcessorHttpsProtocol | eh, see Global options - detailed description. Then, from the same workstation where the fault-tolerant agent is installed, copy the TWSClientKeyStore files from TWA_DATA_DIR/ssl/GSKit to TWA_DATA_DIR/ITA/cpa/ita/cert. Note: The owner of the new TWSClientKeyStore files and the permissions granted must be the same of the existing files. |
| V10.1 Fix Pack 4 | If not already enabled, enable the use of the HTTPS protocol to connect to the event processor server. For more information about enabling enEventProcessorHttpsProtocol | eh, see Global options - detailed description. Then, download the curl file from APAR IJ50967 and save it inside TWS/ITA/cpa/ita. Note: The owner of the new curl file and the permissions granted must be the same of the existing curl file. |
| V10.2 | If not already enabled, enable the use of the HTTPS protocol to connect to the event processor server. For more information about enabling enEventProcessorHttpsProtocol | eh, see Global options - detailed description. Then, download the curl file from APAR IJ50967 and save it inside TWS/ITA/cpa/ita. Note: The owner of the new curl file and the permissions granted must be the same of the existing curl file. |
| V10.2.1 | Not supported. |
| V10.2.2 and later | No additional procedure required. |
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 Workload Scheduler Software Support
Before contacting IBM Software Support with a problem, refer to the IBM Software Support site by accessing the following Web address: https://www.ibm.com/support/home/
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
The guide provides information about how to contact IBM Software Support, depending on the severity of your problem, and the following information:
- Registration and eligibility.
- Telephone numbers, depending on the country in which you are located.
- Information you must have before contacting IBM Software Support.
Notices
This information was developed for products and services offered in the US. This material might be available from IBM Workload Scheduler 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 Workload Scheduler may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM Workload Scheduler representative for information on the products and services currently available in your area. Any reference to an IBM Workload Scheduler product, program, or service is not intended to state or imply that only that IBM Workload Scheduler product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM Workload Scheduler intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM Workload Scheduler product, program, or service.
IBM Workload Scheduler 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 Workload Scheduler 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 Workload Scheduler 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 Workload Scheduler 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 Workload Scheduler product and use of those websites is at your own risk.
IBM Workload Scheduler 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 Workload Scheduler under terms of the IBM Workload Scheduler Customer Agreement, IBM Workload Scheduler 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 Workload Scheduler products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM Workload Scheduler has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM Workload Scheduler products. Questions on the capabilities of non-IBM Workload Scheduler 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 Workload Scheduler, 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 Workload Scheduler, 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 Workload Scheduler shall not be liable for any damages arising out of your use of the sample programs.
© IBM Workload
Scheduler 2006, 2016. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. © Copyright HCL Technologies Limited 2016, 2026.
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.
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.
![]() | Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. |
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 Workload Scheduler 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 Workload Scheduler.
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 Workload Scheduler.
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 Workload Scheduler 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 Workload Scheduler, 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 Workload Scheduler 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.
Was this topic helpful?
Document Information
Modified date:
28 July 2026
UID
ibm17279960
