IBM Support

Dynamic Workload Console Version 10.2.6 Release Notes

Release Notes


Abstract

Dynamic Workload Console Version 10.2.6 Release Notes

Content

Dynamic Workload Console version 10.2.6 Release Notes

Release date: 2025, December 15

This document provides important information about Dynamic Workload Console version 10.2.6.

Features introduced with version 10.2.6

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

Important information for version 10.2.6

Starting with IBM® Workload Scheduler version 10.2.6, the Workload Definitions section for version 9.x connected engines will be removed from the Dynamic Workload Console. Therefore, the following pages will no longer be available:

  • Manage Workload Definitions
  • List Workload Definitions
  • Import Workload Application
  • Manage Event Rules
  • Create Workstations
  • List Workstations

APARs and defects fixed in version 10.2.6

This section lists APARs resolved in version 10.2.6

Table 1. APARs addressed in version 10.2.6
CodeDescription
IJ33630
Environment variable value disappears if the value is enclosed within double quotes (").

If an environment variable within an executable job is defined with a value containing double quotes ("), the variable is not visible from the Workload Designer.

IJ39811
Sorting jobs fails while monitoring resources from the Monitor Workload page.

While monitoring resources from the Monitor Workload page, attempting to sort the jobs list by clicking on column headers either returns an error or an empty list of results.

IJ41121
dwcrest.war does not use custom schema name.

If a custom database schema name is specified during Dynamic Workload Console installation, the dwcrest.war fails to use this custom schema, instead attempting to use the default TDWC schema, resulting in errors during REST API operations.

IJ43952
Job priority change not retained from the Properties panels of Workload Submission pages.

Changing the job priority value within the job properties panel of the Workload Submission pages does not retain the newly selected value after closing the panel. The value is reverted to the previous priority setting.

IJ44945
Dynamic Workload Console fails to display all predecessors when more than four dependencies exist.

When a job in the plan has more than four predecessor dependencies, the DWC "Dependencies" view (in both Monitor Workload and the beta Monitor) fails to display the complete list. This issue is reproducible when the job's predecessors include JOIN or conditional dependencies. A java.lang.ClassCastException related to ExternalConditionalDependencyInPlan is logged in the messages.log file when this occurs.

IJ44945
Issue when displaying job predecessor within theDynamic Workload Console.

The Dynamic Workload Console does not display all the predecessors of a job when there are more than four dependencies.

IJ46506
wappman -replace fails after modifying an imported Workload Application job.

If a job definition within a Workload Application template imported with wappman -importis modified using the Dynamic Workload Console, subsequent attempts to update the Workload Application using the wappman -replace command fail.

IJ46601
Unrun dependency incorrectly shown as ABEND in Dynamic Workload Console.

A job dependency that has not yet met its conditions and therefore has not run is sometimes incorrectly displayed as ABEND in the Dynamic Workload Console, while conman correctly displays the correct status, that is HOLD.

IJ46786
Job name limited to 40 characters in event rule definitions.

The job name field within the event rule definition from the Workload Designer incorrectly limits input to 40 characters.

IJ47036
Conditional dependencies not shown in the Graphical View of the Workload Designer.

Conditional job stream dependencies are not visually represented with connecting arrows in the Graphical View of the Workload Designer.

IJ47302
Column filters returning inaccurate results in Monitor Workload.

While monitoring workstations from the Monitor Workload page, filtering a specific column using the Filter drop-down menu does not work, returning every workstation regardless the specified column.

IJ47650
Variables not visible from the Workload Designer.

In Dynamic Workload Console V10.1, variables defined with a value that contains a backslash (\) are not displayed on the Workload Designer.

IJ47870
Dynamic Workload Console displays duplication or overlap issues.

Occasionally, during operation, the Dynamic Workload Console displays glitches where different screen elements or views overlap or appear duplicated simultaneously, hindering usability.

IJ48321
Error modifying r3batch options file in Dynamic Workload Console V10.1.

Attempting to edit the r3batch options file associated with an SAP workstation definition through the Dynamic Workload Console V10.1 results in an error, and the changes cannot be saved.

IJ48333
No results when searching objects defined within folders on archived plans using lowercase.

In Dynamic Workload Console V10.1, searching for objects within a folder on archived plan does not retrieve results when the folder in the search bar is written in lowercase.

IJ48455
Saving large Job Stream View visuals as PNG file fails.

In Dynamic Workload Console V10.1 for z/OS, when viewing a graphical map with hundred of objects in the Job Stream View, exporting the visual as a PNG file fails.

IJ48774
Impossibility to select all jobs or job streams in the Workspace area when Manage Roles page is open or pinned.

If the Manage Roles page is open or pinned, the Name button does not select all the jobs or job streams that are open in edit mode in the Workspace area.

IJ48880
Inconsistent resolution dependency offsets between the graphical interfaces of the Dynamic Workload Console.

Defining a resolution dependency with From and To time offsets yields different results depending on whether it is configured via the Workload Designer or the Manage Workload Definitions page in Dynamic Workload Console V10.1.

IJ49531
Output conditions disappear from view in the Workload Designer

In the Dynamic Workload Console V10.1, output conditions defined for a job are not visible in the Workload Designer after the job definition has been saved and reopened.

IJ49531
Output conditions not visible in the Workload Designer.

In the Dynamic Workload Console V10.1, after a job definition has been saved and reopened, the output conditions defined for a job are not visible in the Workload Designer.

IJ49677
DOCOMMAND overwritten by SCRIPTNAME after editing a job definition in the Dynamic Workload Console.

In the Dynamic Workload Console, editing a job definition that contains both SCRIPTNAME and DOCOMMAND keywords can lead to the DOCOMMAND value being incorrectly overwritten by the SCRIPTNAME value upon saving the definition.

IJ50456
Workstation access restriction fails in Monitor Workload.

Security domain rules intended to restrict user access to specific workstations are not enforced in the Monitor Workload. Jobs on the excluded workstation remain visible.

IJ51005
Dependency link removal fails in Graphical View for z/OS.

In the Workload Designer, attempting to remove a dependency link between jobs within a z/OS job stream using the Remove link function of the Graphical View fails to remove the dependency.

IJ51005
Dependency link removal fails in the Graphical View of the Workload Designer for z/os job streams.

In the Workload Designer, when editing a z/OS job stream in the Graphical View, the Remove Link action fails to remove the dependency.

IJ51132
Too many error messages in trace.log

The Dynamic Workload Console trace.log file is excessively populated with CWWKS4001I error message during normal operations, such as listing jobs, workstations, and job streams in the Monitor Workload page.

IJ51615
Duplicate entries in Monitor Workload with security domains.

When a user's access is limited by a custom security domain and an Access Control List (ACL), the Monitor Workload incorrectly displays duplicated entries for jobs and job streams.

IJ52152
Shared engine connection authentication fails in Dynamic Workload Console V10.2.x.

When attempting to connect to an engine via a shared engine connection configured by an administrator in Dynamic Workload Console V10.2.x., authentication failures or errors prevent the access.

IJ52517
Incorrect start date after job stream duplication.

In the Workload Designer, when duplicating a job stream and saving without any change, in the Run Cycle preview the job stream with the older "Valid from" value appears to have a schedule that continues after the "Valid to" date.

IJ52537
OK button hidden in Manage Roles page when viewing entities at 100% zoom.

In Dynamic Workload Console V10.1 Fix Pack 4, within the Entities configuration window within Manage Roles page, the OK button is not visible when the browser zoom level is set to 100%, resulting in the user to zoom out to access the button.

IJ52591
Open Definition button expands unrelated job dependencies.

Opening a job stream in the Workload Designer, clicking Open Definition for a specific job that has internal FOLLOWS dependencies incorrectly causes the dependency sections of all jobs in the stream to expand, not just the selected job.

IJ52815
Incorrect ${TWS.JOB.IA} resolution with modified submit date.

When submitting a predefined job stream ad hoc from the Dynamic Workload Console and modifying the Specified Date for the run, the ${TWS.JOB.IA} variable resolves to the original plan date instead of the user-specified submission date.

IJ52941
Specify date and time check box fails for manually entered predefined jobs.

When submitting a predefined job in Dynamic Workload Console, if the user manually types the job stream name instead of selecting it from the pick list, the Specify date and time check box cannot be activated.

IJ53045
Custom database schema name not applied to dwcrest.war.

If a custom database schema name is specified in configureDb.properties during the Dynamic Workload Console installation, this custom schema name is not correctly configured within the dwcrest.war application, leading to REST API failures.

IJ53116
Editing dependencies within the Graphical View creates spurious links.

When editing job dependencies within a job stream using the Graphical View, if saving, closing the Graphical View, and reopening it results in the unexpected creation of multiple, incorrect dependency lines between unrelated jobs.

IJ53128
Job stream positions not retained in Plan View.

Within the Plan View, manually repositioning job stream graphical elements by dragging them does not persist. The layout resets to the default arrangement upon refreshing or reopening the view.

IJ53598
Estimated times missing for critical path jobs in Monitor Workload.

In the Monitor Workload page, jobs on the critical path are not displaying their Estimated Start Time and Estimated End Time values.

IJ53761
edit_add_jobstream z/OS API fails to recognize required variables.

In Dynamic Workload Console V10.2.3, using the edit_add_jobstream API Z connector to add a job stream that uses a variable table with required fields, fails. The API returns error AWSJOM936E, stating that a required variable is not defined, even if it is present in the variable table.

IJ53986
Unsupported character error after saving Report title with parentheses.

When editing a predefined report in the Dynamic Workload Console, using parentheses () in the Report Title field of a Predefined Report is initially accepted. However, upon reopening the report for further editing, the Dynamic Workload Console incorrectly flags the HTML-encoded parentheses as unsupported characters and prevents saving.

IJ54479
Engine deletion using the Dynamic Workload Console API fails.

Attempting to delete an engine connection using the Dynamic Workload Console REST API endpoint DELETE /v1/engine/{engine_id} fails. The Dynamic Workload Console server logs show an EntityManager query exception related to an unknown abstract schema TdwcSapConnection and unresolved state field paths for tdwcPreferenceable.

IJ54553
Calendar name incorrectly limited to 8 characters in folders.

The Workload Designer incorrectly enforces an 8-character limit on calendar names, even when the calendar is being created within a non-root folder, where the limit should be 16 characters according to documentation.

IJ54822
undefined word appears appended to job names with hyphens.

In the Dynamic Workload Console, job names containing hyphens are sometimes displayed with the word undefined appended to the actual job name.

IJ55080
Job Dependency Picker Shows Base Name Instead of Alias.

When adding a job dependency in the Workload Designer, the dialog incorrectly displays the base job definition names instead of the job aliases specified using the AS keyword in the job stream definition.

IJ55090
Search bar ignores folder context in the Workload Designer.

In the Workload Designer, the search bar consistently searches across all objects in the database, even when a specific folder is selected. The expected behavior is for the search to be scoped to the currently selected folder.

IJ55091
Clearing search bar shows all objects instead of folder contents.

In the Workload Designer, if a search is performed while within a specific folder and the search term is subsequently cleared, the view incorrectly displays all objects from all folders instead of reverting to show only the contents of the currently selected folder.

IJ55098
Variable search limited to 250 results in Workload Designer.

The variable search function within the Workload Designer is limited to displaying a maximum of 250 results, without indicating if more variables match the search criteria.

IJ55129
Double quotes around wildcards cause argument display issue.

In the Workload Designer, defining a job task command with an argument containing a wildcard enclosed in double quotes, for example "/path/"*", causes the argument to become invisible in the Dynamic Workload Console after saving and reopening the job definition. The argument remains correctly stored, as verified by composer.

IJ55257
Column sorting fails in Advanced filter results of the Workload Designer.

In the Workload Designer, when using the Advanced filter to list objects, clicking on column headers to sort the results does not function and the order of the items remains unchanged.

IJ55366
Recovery job path incorrectly modified in Dynamic Workload Console Properties view.

In Dynamic Workload Console V10.2.2, opening the properties window for a job that includes a recovery job definition incorrectly removes the folder path separators ("/") from the recovery job's workstation and job name fields. This causes subsequent job submission attempts to fail with authorization error AWSJCO026E.

IJ55421
Pagination issue in the Workload Designer.

In the Workload Designer, when viewing objects within a specific folder that span multiple pages, navigating to any page beyond the first incorrectly displays all objects from the database, ignoring the selected folder context.

IJ55431
Items per page setting ineffective above 10 in Workload Designer.

In the Workload Designer, setting the Items per page display option to a value greater than 10 does not take effect, and the view continues to display only 10 items per page.

IJ55520
Filter reset issue after clicking the Refresh button in the Advanced filter results page.

In the Workload Designer, after performing a search using Advanced filter panel, and then clicking the Refresh button, the filter criteria are incorrectly reset.

IJ55725
Job frequency setting lost when changing Priority in Monitor Workload.

Modifying the priority of a job using the Properties action within the Monitor Workload page incorrectly removes the defined Repeat Every setting of the job.

IJ55751
Dynamic Workload Console screen goes blank after login.

After having modified a dashboard, the Dynamic Workload Console screen becomes blank immediately after user login.

IJ55862
Dynamic Workload Console upgrade failure due to password decode error.

Upgrading Dynamic Workload Console from V10.2.3 to V10.2.5 fails with a password decode error. This occurs during the Liberty server configuration phase.

IJ55867
SSL settings lost when using legacy V9.5 Workload Designer with V10.1 engine.

Modifying object definitions for a V10.1 engine using the legacy 9.5 Workload Designer within Dynamic Workload Console V10.1 can cause the loss of SSL configuration settings, such as SECURE ADDR and SECURITYLEVEL.

IJ55869
Engine connection option missing with German browser language.

In Dynamic Workload Console V10.2.4 and V10.2.5, selecting "Deutsch" (German) as the browser language causes the Engine Connection option to be absent from the Monitor Workload page. The issue does not occur when the browser language is set to English.

IJ56043
Folder path length incorrectly limited in Dynamic Workload Console.

When using the Workload Designer to create a job stream within a nested folder structure as /folder/subfolder/, the Dynamic Workload Console incorrectly enforces a 40-character limit on the total folder path length, preventing the creation or saving of the object.

IJ56156
Dynamic Workload Console focus jumps when using shared connections.

In the Workload Designer, when a user is logged in via a shared engine connection, selecting a job stream that contains cross-folder dependencies causes the Dynamic Workload Console focus to jump to the top of the screen. This behavior prevents the user from successfully selecting and viewing or editing job stream properties.

IJ56157
Bookmark option missing with sole z/OS engine connection.

The Bookmark functionality is unavailable in the Dynamic Workload Console V10.1.x and V10.2.x when the only connected engine is a z/OS engine.

IJ56161
Cleartext credentials returned in HTTP responses.

The Dynamic Workload Console returns unnecessary user information in HTTP responses.

IJ56361
planman deploy crash after removing all values from multi-select field.

Editing an event rule in Dynamic Workload Console V10.1.x and removing all selected values from a multi-select field (for example Status, Internal Status) causes the planman deploy -scratch command to fail. The Dynamic Workload Console incorrectly saves the field with no values instead of removing the field attribute entirely.

IJ56394
The Dynamic Workload Console crashes when adding dependencies in the Graphical View of the Workload Designer

The Dynamic Workload Console crashes when using the Graphical View of the Workload Designer. The crash often occurs when attempting to create an internal dependency, particularly when adding a dependency to a newly created job that has not yet been saved.

IJ56444
REST API call to add JCL operation fails with null parameter exception.

In Dynamic Workload Console V10.2.2, running a POST request to the REST API endpoint /v1/<engine>/model/jcl to add a JCL operation fails. The API returns an internal error, which reports the message "obj parameter must not be null".

IJ56458
Incorrect dependency display for migrated job streams in Dynamic Workload Console V10.2.4.

In Dynamic Workload Console V10.2.4, selecting job dependencies within job stream definitions migrated from V10.2.2 incorrectly displays job stream properties instead of the dependency details. This issue occurs in both view and edit modes, although the underlying object definition remains correct when checked via conman.

IJ56461
Password field lacks warning for character limit.

The Dynamic Workload Console password field truncates any typed or pasted input to 31 characters, without providing an error or warning message to inform the user that the password has exceeded the maximum allowed length.

IJ56462
Filters selected on workstation queries saved as datasources are not persisted.

In Dynamic Workload Console V10.1 and V10.2, filters applied to a workstation query saved as datasource are not retained. After saving and reopening the datasource, the settings revert to their previous state.

IJ56465
Sorting filtered jobs or files yields empty display and an error message.

In the Dynamic Workload Console, sorting columns after filtering jobs or files results in an empty display and the error message AWSUI0833E, indicating a communication failure. This occurs specifically when using certain dependency filters or viewing jobs dependent on a file.

KB0110550
REST API V2 swagger documentation lacks examples for ad hoc job submission task body.

The Swagger documentation for the REST API V2 endpoint

POST /twsd/api/v2/plan/job/submit-ad-hoc-job

provides an empty JSON object ({}) as the example value for the mandatory task field, but the task body requires different, complex JSON structures depending on the job type.

KB0118763
Cannot view or edit shadow jobs in Workload Designer.

An error occurs in the Workload Designer when attempting to view or edit newly created shadow jobs (both z/OS and distributed types). This issue occurs whether the job is defined using composer or directly from the Dynamic Workload Console.

KB0123237
[Perf] messages within the message.log file of the Dynamic Workload Console.

In the message.log file of the Dynamic Workload Console, many [Perf] messages appear.

KB0123694
SAP jobs fail on extended agent after V10.2.4 encryption update.

In IBM Workload Scheduler V10.2.4, SAP jobs on an extended agent fail with error EEWO0012E "The extended agent could not be initialized".

KB0124683
Run Cycle Preview calendar header displays incorrect date.

In the Workload Designer, when previewing a run cycle calendar , the date displayed in the header of the preview header is incorrect.

KB0124970
Broker fails to update agent resource deletion.

When a resource is deleted from an agent, the broker fails to update its records and continues to retain the old resource information. This outdated information causes the broker to incorrectly assign jobs to the wrong agent if a dynamic pool is configured to use the deleted resource.


Defects

The following defect has been resolved in IBM Workload Scheduler version 10.2.6:

 WA-151215: In Dynamic Workload Console versions 10.2.4 and 10.2.5, the Delete button for actions and events within an event rule does not appear. 

 

Resolved Common Vulnerabilities and Exposures (CVE)

The following CVEs have been resolved:

  1. WS-2019-0379

Interoperability tables

In the tables in this section the following acronyms are used:

Table 2. Acronym table
AcronymExtended form
DDMdynamic domain manager or backup dynamic domain manager
DWCDynamic Workload Console
MDMmaster domain manager

 

Dynamic Workload Console compatibility is supported on each release version listed in the table:

 MDMDDM
DWC 10.2.610.2.x, 10.1.x, 9.5.x10.2.x, 10.1.x, 9.5.x
Note: Version 9.5 is no longer supported. It appears in this table with a recommendation to upgrade to a currently supported version.
 

The following table shows which Dynamic Workload Console pages are compatible with previous master domain manager versions:

Engine versionManage Workload DefinitionsWorkload DesignerGraphical DesignerMonitor WorkloadOrchestration Monitor
IBM Workload Scheduler v10.2.3 onward
IBM Workload Scheduler v10.x ✔ from v10.2.x
IBM Workload Scheduler v9.5.x   
IBM Workload Scheduler z/OS v10.2 
IBM Workload Scheduler z/OS v10.1  
IBM Workload Scheduler z/OS v9.x.x   

 Note: Version 9.5 is no longer supported. It appears in this table with a recommendation to upgrade to a currently supported version.

Compatibility scenarios and limitations

You are strongly recommended to maintain all IBM Workload Scheduler components at the latest version level as regular maintenance activity. Keeping your environment consistent also ensures you can implement the new features available with each release.

Known limitations and workarounds

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

Issue while rerunning a job from the Orchestration Monitor

When connected to a V10.2.x engine, rerunning a job from the Orchestration Monitor results in a blank page.

Workaround
To workaround the issue, 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.
  3. Browse to the jobRerun section:

    {
    "jobRerun":true,
    "justification":true,
    "breadcrumbTitleId":"MW_RERUN_JOB",
    "helpId":"rerunjobnew",
    "query":"/@/@#/@/@",
    "key":"RERUN_JOB",
    "subkey":"RERUN_FROM",
    "type":"job",
    "labelId":"MW_RERUN",
    "show":["RERUN_TYPE_ROW"],
    "cleanUpTemplatePolicy": ["jobDefinitionDbIdentifier","jobDefinitionDbKey","priority","rerunJobOnSameWorkstation","startTime","stepName"],
    "order":4

  4. Under the "labelId" field, add the following parameter:

    "actualWorkstationField" : "jobruns.?lastInRerunChain==true.actualWorkstation"

  5. Delete the cache folder located in the following path:

    /opt/wa/TWA/usr/servers/engineServer/apps/TWSEngineModel.ear/WD.war/WEB-INF

  6. Delete the monitorWorkloadCache folder located in the following path:

    /opt/wa/DWC/usr/servers/dwcServer/dwc_workarea

Removed the prefilled value for the Job stream field in Submit Predefined Job

To resolve APAR IJ52941 in version 10.2.6, the prefilled value /JOBS was removed from the Job stream field of Submit Predefined Job.

Workaround

Since the job stream field is no longer automatically populated, you must manually enter the value.

Issue while opening Alter User Password in Plan page.

When selecting the Alter User Password in Plan page, the User Object Credentials Management page opens instead.

Workaround
To workaround the issue, perform the following steps:

  1. Browse to /opt/wa/DWC/usr/servers/dwcServer/apps/DWC-10.2.6.00-SNAPSHOT.ear/TWSWebUI.war/html.
  2. Open the scaffold_page_definition.json file.
  3. In the "alter-user-pwd" section, replace "widgetType": "alterUserPasswordChangePage" with the following parameter:
    "link": "/html/changepassword/ChangePassword.jsp"
     

Blank lines in Design menu after update

After updating the Dynamic Workload Console to version 10.2.6, blank lines can appear between items in the Design menu, corresponding to the pages of the Workload Definitions section that were removed in V10.2.6 release. This issue occurs if custom roles created in a previous version reference menu items that are now removed.

Workaround

From the Manage Roles page, open any custom role, then save without making any change. After saving, the blank lines corresponding to the removed Workload Definitions pages disappear.

Issues on the Job Stream view when using Firefox browser

On Firefox browser, some functions of the Multiple selection option on the Job stream view might not work.

Restart action fails with wildcards

When monitoring a File Transfer job from the Dynamic Workload Console, the Workflow Details panel displays information about the transfer of individual files. If you use wildcards instead of a specific file name and the job step fails, you cannot restart the step.

Workaround

You can rerun the entire job using the Rerun button in the Monitor jobs panel.

Workload Security reconfiguration required for User Object Credential Management page

To use the User Object Credential Management page, users require at least one of the following security permissions:

  • Design and monitor workload: User Objects - Modify (userobj access=modify)
  • Modify plan: Alter user password (userobj - altpass)

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.

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

 

Impossibility to generate reports on Dynamic Workload Console installed on z/OS systems

The generation of reports in the Dynamic Workload Console fails when the Dynamic Workload Console is installed on z/OS systems.

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.

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.

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.

Package structure

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

Installing and upgrading to version 10.2.6

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

Before getting started, verify that the following requirements are met:

  • The Dynamic Workload Console is active.
  • No user is connected to the Dynamic Workload Console to prevent the data related to their working session from being lost.

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 using WebSphere Application Server Liberty Base version 25.0.0.11. The minimum required version to successfully install the product is 25.0.0.9

For the Dynamic Workload Console installed in a z/OS environment, testing was conducted using WebSphere Application Server Liberty Base version 25.0.0.9, which is also the minimum required version for that configuration.

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.

Installation notes

  • If you plan to perform a fresh installation with WebSphere Application Server Liberty 26.0.0.3 or later, set the SECUREWRAP_PASSPHRASE environment variable to a custom passphrase of your choice before you run the installation command. If you are upgrading IBM Workload Scheduler or WebSphere Application Server Liberty, no action is required. For more information, see IWS 10.2.x earlier than 10.2.7 returns installation failure with Liberty 26.0.0.3.
  • Ensure you have installed the required prerequisite software. To obtain the latest information about software requirements for IBM Workload Scheduler, run the Detailed System Requirements report and browse to the relevant section.
  • 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

Upgrade 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.6. 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.

  1. Browse to the datasource.xml template.
  2. Open the file with a text editor and perform the following changes:
    1. Add the lines listed below after the db.driver.path parameter:

      <variable name="db.encrypt" value="false"/>
      <variable name="db.trustServerCertificate" value="false"/>
    2. Append the following strings at the end of the value of the mssql.URL parameter:

      ;encrypt=${db.encrypt};trustServerCertificate=${db.trustServerCertificate}
    3. 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}"
  3. Stop and restart WebSphere Application Server Liberty to make the changes effective.

When upgrading to Dynamic Workload Console version 1025, if the previous environment is configured for Single Sign-On (SSO) using ltpa.keys, perform the following steps:

  1. copy the ltpa.keys file either from the master domain manager to the workstation hosting the Dynamic Workload Console, or vice versa, depending on your configuration.
  2. After copying, restart the IBM Workload Scheduler processes on the component where the ltpa.keys file was updated to complete the SSO setup.

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.

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

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 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) (2025). 
Portions of this code are derived from IBM Sample Programs. 
© Copyright IBM Corp. _2025_.

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 Logo
 
Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Cell Broadband Engine™ is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

ITIL™ is a Registered Trade Mark of AXELOS Limited.

UNIX™ is a registered trademark of The Open Group in the United States and other countries.

Terms and conditions for product documentation

Permissions for the use of these publications are granted subject to the following terms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the 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.

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSGSPN","label":"IBM Workload Scheduler"},"ARM Category":[{"code":"a8m50000000KzAMAA0","label":"Components-\u003EDWC"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"10.2.6"}]

Document Information

Modified date:
10 April 2026

UID

ibm17250175