Note

Before using this information and the product it supports, read the information in Notices.

This edition applies to Fix Pack 2 for version 9, release 5, modification level 0 of HCL Workload Automation (program number 5698-WSH) and to all subsequent releases and modifications until otherwise indicated in new editions.

HCL Workload Automation version 9.5.0 Readme File for Fix Pack 2

Date
April 24, 2020
Fix Pack
9.5.0-HCL-IWS-FP0002
Product
HCL Workload Automation version 9.5.0
General Description
HCL Workload Automation Fix Pack 2 for version 9.5.0

This readme file provides important information about Fix Pack 2 for HCL Workload Automation version 9.5.0.

The most up-to-date version of this readme can be accessed at the following URL: Fix Pack readmes

It is divided into the following sections:

HCL version 9.5.0 Fix Pack 2 supports all product versions indicated in the HCL Workload Scheduler version 9.5 Release Notes which can be accessed at the following link: https://workloadautomation.hcldoc.com/help/topic/com.hcl.wa.doc_9.5/Release_Notes_for_HCL_Workload_Scheduler.htm

For the most up-to-date information about supported operating systems, software and hardware requirements, see the Detailed system requirements document at the following URL: Detailed System Requirements for HCL Workload Automation, version 9.5.

Review this section thoroughly before installing or using this Fix Pack.

About this Fix Pack

This section contains information specific for this Fix Pack including what has been modified or introduced, what has been fixed, product versions or components to which the Fix Pack applies, and compatibility issues, if any.

Product versions and components to which the Fix Pack applies
This Fix Pack can be applied only on top of HCL Workload Automation V9.5.0, and subsequent Fix Packs.

This section includes the following subsections:

Features introduced with Fix Pack 2

Automation Hub: the future of automation

For more information about the new automation command center, see Automation Hub: the future of automation

Workload Automation Lutist Development Kit: do-it-yourself!

For more information about the new tool that enables you to create and publish your own integrations, see Workload Automation, Lutist Development Kit: do-it-yourself!

Continuous operation with automatic failover

For more information about the automatic switchover, see Continuous operation with automatic failover

Organize scheduling objects in workflow folders

For more information about folders, see Organize scheduling objects in workflow folders

Enhance security with encrypted passwords

For more information about password encrypting, see Enhance security with encrypted passwords

Enable support for long object names in the security file

For more information about scheduling object names, see Enable support for long object names in the security file

Deploying HCLWorkload Automation components on Red Hat OpenShift v. 4.x

For further details about the deployment on OpenShift refer to Deploying HCL Workload Automation components on Red Hat OpenShift

Changed features and feature capabilities
A new home for Workload Automation plug-ins
Automation Hub is a new concept for automating business workflows.

In previous versions, all job plug-ins were provided with the product and obtaining new plug-ins meant you were bound to the product releases.

With Fix Pack 2, you can still access the usual plug-ins from the product, but going forward, any updates, and the related documentation, can be found on Automation Hub. Furthermore, the continuous delivery of new plug-ins - now called integrations - enables you to download and use new integrations in the product, at any time.

A new way to automate your business workflows and a more flexible solution to having only the integrations of your interest integrated in the product.

But that is not all, if you do not find the integration that you are looking for, you can make a request for it or, you can create it yourself. To create a new integration, you can use the Workload Automation, Lutist Development Kit, and then share your integration with the community.

Let's automate more and automate better.

Identifying workstations, resources, and prompts
Fix pack 2 adds the support for defining scheduling objects in folders. As a consequence, workstations, resources, and prompts are no longer identified in the plan solely by their names, but also by the folder in which they are defined. The name and folder association is mapped to a unique identifier. In the localopts file, the this_cpu option is the unique identifier of the workstation. You can verify the unique identifier for workstations, resources, and prompts by submitting the composer list command, together with the ;showid filter, or by submitting the conman commands: showcpus, showresources, and showprompts, together with the ;showid filter.

Identifying workstations and resources by their unique identifier avoids the problem that occurred in previous versions when objects were renamed in the plan. For example, if an object was renamed and then carried forward to a new production plan, references to the old object name were lost. With the implementation of the unique identifier, this will no longer occur and dependencies will be correctly resolved. However, if a workstation or resource is renamed, its new name is visible to all V9.5FP2 instances (or later), but earlier instances continue to see the old name of the object.

For examples, see the conman showcpus command and the composer list command in the User's Guide and Reference.
Modification of the use of wildcards in workstation classes
With the introduction of folders in which to define workstation classes, a change has taken place with respect to the use of wildcards in specifying members of a workstation class. While in the previous releases, wildcards included all workstations, starting from version 9.5, Fix Pack 2, wildcards include all the workstations defined in the same folder (including sub-folders, if any) as the workstation class definition.

For more information about the use of wildcards in workstation classes, see the topic about workstation class definition in User's Guide and Reference.

Extended agent installed with a master domain manager
With a fresh installation of a master domain manager on Linux and UNIX, a new extended agent is installed on the master domain manager workstation which is used to communicate where to run the FINAL job stream. With an extended agent, the $MASTER keyword can be used to indicate that the agent's host workstation is the master domain manager. If the role of the master domain manager is switched to another workstation, then the $MASTER keyword automatically detects the new master domain manager. This change is to facilitate the automatic failover feature. See automatic failover in the Administration Guide.
Scheduling objects defined using REST APIs
Starting from product version 9.5, Fix Pack 2, the composer command line to create object definitions uses REST APIs. This means that when you create a definition using composer, new APIs are used, which are not compatible with the APIs installed on master domain managers with previous product versions. As a result, you cannot use a composer at version 9.5, Fix Pack 2 level, to create a definitions on a master domain manager where a previous version of the product is installed. This change applies to the following object definitions:
  • calendar
  • domain
  • prompt
  • resource
  • variable table
  • variable and parameter
  • Windows user
  • workstation
  • workstation class
The default value for the mm resolve master local options has changed
With this fix pack, the default value for the mm resolve master local option in the localopts file has changed from no to yes.
Create a JSDL job definition
To create a JSDL job definition in HCL Workload Automation using the Job Brokering Definition Console refer to the previous documentation releases.
Remove deleted folders, prompts, workstations, and resources from the database
When deleting a workstation, if the workstation is still in the plan, then another workstation cannot be renamed with the name of the deleted workstation for the number of days specified by the global option folderDays. However, a brand new workstation can be created with the name of the deleted workstation. This behavior applies only to dynamic agents, pools, and dynamic pools. The default value is 10 days.

When deleting a folder, a prompt, or resource, if there are still objects in the plan that reference these objects, then another folder, prompt, or resource cannot be renamed with the name of the deleted folder, prompt or resource for the number of days specified by “folderDays”. However, a brand new folder, prompt, or resource can be created with the name of the deleted object. .

Satisfying Requests for Enhancements (RFEs)

Requests for Enhancements (RFEs) give customers the opportunity to collaborate directly with the product development team and other users. The team prioritizes and develops new product features based on proposals made by customers.

HCL Workload Automation V9.5 Fix Pack 2 delivers the following RFEs:
RFE 138951: Support for an existing Oracle user
When creating and populating the Oracle database schema during a fresh installation of the server or Dynamic Workload Console component, by default a check is performed to detect if the Workload Automation Oracle user already exists. If the Oracle user is found, but it does not contain the Workload Automation schema, the database schema is not created for this user. If no user is found, the installation creates the Oracle user and the Workload Automation schema. This behavior can be configured using the -skipdbcheck parameter in the installation scripts. By default this parameter is set to false. If this parameter is set to true, the installation creates the Workload Automation schema even if the existing Oracle user does not contain the Workload Automation schema.
RFE 132029: Add run number check within MakePlan before locking the database

The MakePlan process was modified to perform a check on the previous day run number and comparing it with the new run number ensuring it has increased by 1. If the new run number is not reflected in the database, MakePlan should abend. This check must be done prior to the locking of the database by Planner.

RFE 136191: JS EVERY DONOTSTART is not using untilDays. Allow configuration of the value for the global option untilDays for job streams
The untilDays option removes obsolete job and job stream instances from the plan. In previous versions, a hardcoded value of 2 days was set for job streams that did not have an until time set, resulting in cancellation of the job stream after two days. In the case of a job stream with the EVERY ONOVERLAP DONOTSTART keywords, if one or more jobs defined in the job stream abend, and are not resolved within the 2-day period specified by UntilDays, then the abended jobs are not carried forward and the job stream is canceled. This global option can now be configured for the number of days most appropriate for your scheduling environment. If you require maintaining a job stream longer than the number of days specified by untilDays, you can explicitly set an until time for that specific job stream.

For jobs, either you set an until time at the job level, or it assumes the until time of its job stream. If no until time is set for either job or job stream, then the until time is calculated by adding the setting for untilDays to the time the job enters the production plan.

With the release of this fix pack, the global option untilDays is now configurable. The default value is 0. If the default value is used, then for jobs, no default time is set for the until time (latest start time). For job streams, if the default is used, then the default until time is 2 days. See the Administration Guide for more information about the untilDays global option
RFE 120948: Intercept SAP jobs by SAP users, and limit executions on TWS by "n" jobs per user
Control and limit the number of jobs submitted by each user. When the established number of jobs for the specific user is exceeded, the jobs are queued and submitted at a later time. To implement this feature, two new options have been added in the options file:
MAX_JOBS_TO_RELEASE_FOR_USER
Defines the maximum number of jobs released for each user each time the release job is submitted. If this option is less than or equal to 0, the option is ignored and all jobs are released when the release job is submitted.
RELEASE_ALL_INTERCEPTED_JOBS_FOR_REQUEST
Releases jobs for each user on a cyclic basis, based on the number of jobs specified in the max_jobs_to_release_for_user option. The default value is ON, which means that all jobs are submitted for each user:
  • If the max_jobs_to_release_for_user option is less than or equal to 0, all jobs are released for each user.
  • If the max_jobs_to_release_for_user option is higher than 0, the specified number of jobs is submitted for each user on a cyclic basis. For example, if max_jobs_to_release_for_user=5, the first 5 jobs are submitted for each user, then the following 5 jobs for each user, and so on, until all jobs for all users are submitted.
If this option is set to OFF, it releases for each user only the number of jobs specified in the max_jobs_to_release_for_user option. The remaining jobs are submitted only when a new release job is submitted:
  • If the max_jobs_to_release_for_user option is less than or equal to 0, all jobs are released for each user.
  • If the max_jobs_to_release_for_user option is higher than 0, only the specified number of jobs is submitted, then no other job is submitted until the new release job. If max_jobs_to_release_for_user=5, the first 5 jobs are submitted for each user, then no other job is submitted until the new release job.

For more information, see the section about defining configuration options in Scheduling Applications with HCL Workload Automation.

RFE 140942: Ability to remove/control rerun option for broker jobs
By default, when a broker job fails because of a missing resource, the product attempts to find an available resource every 600 seconds, rerunning the job each time. With this enhancement, after the first failed attempt to find an available resource, the job FAILS. To enable this new behavior, add the hidden property, Broker.Workstation.Enable.RerunOnAllocFailure, to the BrokerWorkstation.properties file and set the property to "false". By default, the value of this property is "true".
RFE 137732: Wappman functionality does not support the replacing or modifying of an existing job stream
In HCL Workload Automation 9.3 Fix Pack 3, wappman import/export and replace is used for continuous deployment across environments. After the upgrade to V94FP5, wappman cannot be used to modify the existing job stream definitions and its related objects like resources and jobs. With HCL Workload Automation 9.5 Fix Pack 2, the import, export and replace with wappman has been reintroduced.
RFE 140989: Add an SSH client in the DOCKER image of the HCL Workload Automation Agent (z-centric)
An SSH client has been added to the HCL Workload Automation Agent DOCKER image which allows secure and encrypted remote connections.
RFE 128243: Job run numbers are not unique on a single agent in the plan when you have a very high number of rerun jobs
When you have a very high number of rerun jobs, accessing information about a specific job instance, specifying the CPUNAME and the job number, does not provide the expected result. With this fix pack, the job number is not considered an identifying factor when running conman commands. When submitting a conman command, you are prompted to confirm a selection of results that correspond to the filters specified with the exception of conman show commands (for example, conman showjob),where you are not prompted for confirmation but, instead, all results corresponding to the filters specified are displayed.
Updated version of WebSphere Application Server Liberty Base
HCL Workload Automation version 9.5 fix pack 2 was formally tested using WebSphere Application Server Liberty Base version 19.0.0.12, 20.0.0.2 and 20.0.03. Because of a known issue affecting version 20.0.0.1, APAR PH21281, we strongly recommend you avoid using it.

For more information about new features introduced with this fix pack, see Summary of enhancements.

Helpful videos demonstrating new features for HCL Workload Automation is available on Workload Automation YouTube channel.

Features introduced with Fix Pack 1

Renaming and moving jobs and job streams into folders

You might have used simple to complex naming conventions when creating job and job stream names to easily identify and manage them. With character length restrictions for these names, creative abbreviations are required to stay within the limits. This can often lead to unreadable names.

You can now migrate multiple jobs and job streams, in batch mode, whose names contain common pattern matching into specified folders and sub-folders, where the folder names are extracted from the job and job stream names themselves. Naming folders by using tokens from the job and job stream names frees up characters so that you can rename jobs and job streams with more meaningful names, in addition to the folder names.

To rename and move jobs and job streams into folders, the composer rename command has been extended to support wildcard characters. The wildcard characters are used to replace pattern matching tokens in the job and job stream names and enable you to migrate the jobs and job streams in bulk, rather than one at a time. A ;preview option is provided to test the command before actually running it to ensure you obtain the expected result.

For more information see Organizing jobs and job streams into folders

File transfer job plug-in enhancements
Version 9.5 Fix Pack 1 delivers the following enhancements to the File transfer job plug-in:
RFE 124923: Appending text to an existing file
The file transfer job plug-in now includes an option to append the data contained in the transferred file to the existing file on the destination system. This avoids overwriting the existing file and preserves any changes that were made to the file prior to the transfer. The option applies to file transfers of type download and for files encoded as text.
Deleting a source file after an upload transfer
An option has been added to specify if you want to delete the source files after a file transfer of type "upload".
RFE 127294: Specifying FTP SIte subcommands
An option has been added for file transfers originating from a distributed environment to a z/OS target workstation, using the FTP protocol, to specify SIte subcommands. For example, you can specify a subcommand to define primary and secondary space allocations.
Deploying HCL Workload Automation Agent on Red Hat OpenShift v. 3.x

The HCL Workload Automation agent container can be deployed onto OpenShift, a container application platform based on Kubernetes and useful to orchestrate containers.

For further details about the deployment on OpenShift refer to Deploying HCL Workload Automation Agent on Red Hat OpenShift

Delegating administrator privileges on folders to other users

The HCL Workload Automation administrator can grant permissions to a user on a folder so that the user can freely create new access control lists or modify existing access control lists on the folder or any sub-folders to which the user has been delegated administrator permissions. The user can in turn give access to the folder or sub-folder to other users by specifying an existing role to which the user wants to grant the access, as well as the folder. In this way, the HCL Workload Automation administrator can delegate the security to various organizations in the business to other users who can act independently as administrators for that organization.

A new access type "acl" has been added for folder objects. With this type of access, users can create access control lists for the folder assigned to them by assigning predefined roles to users and groups on the entire folder hierarchy or on specific sub-folders.

For more information about delegating permissions on folders, see Granting administrator permissions to a user on a folder

Satisfying Requests for Enhancements (RFEs)

Requests for Enhancements (RFEs) give customers the opportunity to collaborate directly with the product development team and other users. The team prioritizes and develops new product features based on proposals made by customers.

HCL Workload Automation V9.5 Fix Pack 1 delivers the following RFEs:
RFE 124923
Appending text to an existing file. For details, see File transfer job plug-in ehnancements
RFE 127294
Specifying FTP SIte subcommands. See for more details. File transfer job plug-in enhancements for more details.
RFE 123295
Delete file on server after download. See File transfer job plug-in enhancements for more details.

To view a complete list of RFEs, new, planned, and delivered, see: RFE online community.

Broker CLI commands
The resource and jobstore commands have been reactivated.
Note: To make Broker cli and Broker UI work, both Dynamic Workload Console and master domain manager should be updated to the version 9.5, Fix Pack 1.
Updated version of WebSphere Application Server Liberty Base
HCL Workload Automation version 9.5 fix pack 1 has been tested using WebSphere Application Server Liberty Base version 19.0.0.4 and 19.0.0.5
Updated version of Informatica
Fix Pack 1 has been tested using Informatica 10.1.1. The scenarios already certified with Informatica 9.x have ran successfully

For more information about new features introduced with this fix pack, see Summary of enhancements.

Helpful videos demonstrating new features for HCL Workload Automation is available on Workload Automation YouTube channel.

Problems fixed in HCL Workload Automation Fix Pack 2 for version 9.5.0

This section lists APARs and internal defects solved by Fix Pack 2.

Table 1. APARs addressed in Fix Pack 2
APAR ABSTRACT
IJ08195 cmdLauncher program in TWS/BIN can allow a not root user to launch commands as root
IJ11908 IWS dependencies are removed when upgrading a runcycle in a job stream before the final run
IJ09112 Canceling jobs and job streams, CTRL-c is considered as yes answer to the cancel confirmation question
IJ12793 On DDM, the schedule timezone specification for UNTIL is not enforced, and it uses the underlying timezone of the processes
IJ13551 Mirroring defect on IWS/DWC 9.4.0 FP05. For job transitions fence to ready, the status is not properly reflected in the DWC
IJ16123 APAR IV98210 correction causes significant plan mirroring delays when a spike of mirroring generated events occur
IJ17247 File transfer jobs to z/OS with ssh protocol truncate files with lrecl greater than 128
IJ17325 Planman checksync can fail if OPENS dependencies from previous days are incorrect in the database
IJ17348 Composer validate with syntax flag fails on dependencies
IJ17407 HTWGT0009E file does not exist error when running jobs on Peoplesoft agents
IJ17670 SENDEVENT event rule fails in 9.5 at encrypting password
IJ17722 POST /{ENGINE}/PLAN/{PLANID}/JOBSTREAM/ACTION/ADD_JOBSTREAM? Rest API gets an error using VARIABLESTOBESUBSTITUTED
IJ17723 Rest API "GET" ON A RESOURCE returns a blank value in defaultAvailability f
IJ17795 The swagger codegen tool returns an error on EVENTRULEFILTER
IJ17791 EJB job status is incorrect in 9.4.0.06 plug-in ported from 9.5.0.00
IJ18008 Join condition compiler.c case TS002519455
IJ18045 The broker on DDM gets unlinked (and the agents will not be linked too) after the start up
IJ18226 Return code 127 for all actions called through GENERICEVENTPLUGIN
IJ18247 "REPTR" command looks for SYMNEW/SYMPHONY in old directory <TWAHOME>/TWS
IJ18285 Importing Workload Application, schedule version is not created
IJ18312 Conman SJ/SS returns elapse time as 00:60 instead of 01:00, if actual elapse time is between 00:59:01 and 00:59:59
IJ18334 Vaerbose message every job
IJ18424 TWS cumulative doc APAR 9.5
IJ18804 MAILBOX.MSG corruption causes MAILMAN failure
IJ18837 Salesforce job succeeds on SF side, but it is in ABEND on IWS side
IJ19134 In a remote engine, the shadow job status is not updated
IJ19621 Conman submit commands fail with AWSBHU710E when into argument uses a job stram ID
IJ19633 Job stream repeat is not working when EVERY is defined directly at run cycle group level in job stream definition
IJ19649 TSAMP on TWS 9.5 FP1 scripts are not present into TWS 9.5 FP1 installation
IJ19654 Runcycle group within a job stream is not picking up the default holidays calendar
IJ19944 WORKSTATIONINPLANAVAILABILITYINTERVALS is missing in the PLAN/CURRENT/WORKSTATION/QUERY call
IJ20064 Upgrade of DB2 failed upon executing configureDB.sh for IWS 9.5 upgrade
IJ20065 ITM integration does not work in IWS v. 9.5
IJ20119 WLB jobs run twice in MS-Prod
IJ20175 DWCINST.SH fails with liberty version error if LANG=JA_JP.UTF-8. Same for ENGINE
IJ20351 Date format on Rest APIs has changed since 9.3 and is currently formally incorrect
IJ20446 9.5 installation: home variable not resolving properly on windows agents
IJ20538 File transfer jobs does not run remotely if wildchars are used
IJ20586 twsinst cannot be used with new msvc versions
IJ20834 Issue in submitting job streams from event rules
IJ21081 Composer replace does not return expected syntax error
IJ21082 Event rule action to trigger sbs for event sent through a gateway fails with UNAUTHENTICATED error
IJ21156 Setting the trace mode for TWSProfile to tws_broker_all showsthat the same member of a POOL workstation is selected for a file check test defined for the POOL.
IJ21301 Installing v. 9.5 it is necessary to have the installation directory empty, while it was not required in past IWS/TWS versions
IJ21346 Mirroring improvement for file dependencies management after the resync operation
IJ21348 Mirroring improvement on the cancel operation management
IJ21480 On SAP jobs, the mail address field is nullified when using RERUNSTEP for a job
IJ21519 Tables in PLN schema are carrying over too many rows
IJ21775 IWS processes do not start automatically using the START_TWS.SH script after a failover
IJ22079 9.5 documentation on Docker run/Docker compose is insufficient to have a zcentric container restarting correctly
IJ22223 FILE_STARTCOND did not work with FOLDER
IJ22431 Check prereq fails on CentOS Linux release 7.4.1708 (Core)
IJ22534 Adding a job stream definition as dependency that matches a job or job stream that does not exist, the 'The object "js=MDM95#RN_TEST_EXT_DEP2" already exists' error is returned.
IJ22635 JOBMAN core dump during OPENS file check
IJ22828 ORA-00955 error when upgrading to IWS 9.5.0.01 using an Oracle database
IJ23003 When a variable is used within a job, it is not possible to add an application by using Rest API
IJ23561 Processes hold the files, not of the current day, in the stdlist/logs directory
IJ24196 Event rule of type "update event" doesn't work.

Problems fixed in HCL Workload Automation Fix Pack 1 for version 9.5.0

This section lists APARs and internal defects solved by Fix Pack 1.

This Fix Pack includes a number of fixes for internal defects found by the verification team that mainly cover the following product capabilities: installation, auditing, and mirroring.

APAR ABSTRACT
IJ16502 Symphony corruption causes a batchman crashing.
IJ13958 CHECKPREREQ command fails on CentOS Linux 7.4.1708
IJ16233 Extra backward slashes "\" are added each time a customer edits the event rule.
IJ16230 Wildcards on DSNAME causes a FTP job failure.
IJ15085 A local user without root privileges can write files in the file system as root.
WA-80434 TaskLauncher continues to monitor a windows job, even if the job completed.
IJ12956 In case of Japanese engine name, performing a job definition search on rerun job, no result is returned. The issue occurs only on IE11 browser.
IJ15789 Running the CURL command from an Unix machine causes a "CURL: FAILED INITIALIZATION" error.
IJ14140 In case of SSL connection issues, the domain manager mailman process continues to try to establish a connection.
IJ14282 Jobs are randomly killed with exit code 143.
IJ14630 Event rules occasionally submit the wrong job stream.
IJ14147 Upgrading to version 9.4.0.3, the operating unit is no longer getting populated in OLFM.
IJ11203 Remote command job containing the "£" char stays in EXEC hang due to RXA issue.
IV93833 Remove meaningless messages from systemout.log.
IJ11152 "HOW-MANY=0" returns blank result on the plan object query rest API.
IJ11230 The FTA centralized upgrade fails when upgrading from version 9.4 fix pack 3 to later versions.
IJ07067 Job stream, with scheduled time before DST time change, starts before the scheduled time.
IJ08161 Improve the jobmanager.ini.bak file creation mechanism.
IJ07385 Multiple vulnerabilities have been found in OpenSSL.
IJ07377 Zcentric agent does note reconnect after rebooting an Unix system where the agent is installed.
IJ06229 Installing a 9.4 master domain manager, a MASTERAGENTS workstation is automatically created. Deleting the MASTERAGENTS CPU and installing a dynamic domain manager, a new MASTERAGENTS workstation is automatically created but it is linked to the wrong host ID and causes an error.
IJ04537 Sometimes the twsinst.sh script check fails even if there are no problems.
IJ04230 Cancelling pending job streams takes more time if batchman is not performing activities.
IV83963 After a file transfer job has run on a windows environment, the deletion of the source file fails.

Backward compatibility

This fix pack delivers support for scheduling objects in folders, including workstations. When monitoring workstations from a back-level agent workstation, the output displays the workstation unique identifier and not the workstation name for those workstations that were defined in folders different from the root folder. To identify the corresponding workstation name, run the conman command using the showid filter, showcpu ;showid, from an updated agent workstation.

Known limitations and workarounds

The following are software limitations and workarounds that affect HCL Workload Automation version 9.5.0 Fix Pack 2 and previous versions. For a list of known problems and limitations documented for the V9.5 General Availability release, see the product Release Notes at https://workloadautomation.hcldoc.com/help/topic/com.hcl.wa.doc_9.5/distrDDguides.html.

9.5 Fix Pack 2:

datacalc utility does not support calendars defined in a folder different from the root
The datecalc utility command only supports calendars that are defined in the root (/) folder.
The HCL Workload Automation agent for z/OS cannot be defined in a folder other than the root (/) folder
The definition of a HCL Workload Automation agent for z/OS workstation is not supported in a folder other than the root (/) folder. You can, however, schedule jobs and job streams defined in folders on an HCL Workload Automation agent for z/OS workstation.
Problems when using filters during the upgrade phase
During the upgrade phase where you have a backup master domain manager at the V9.5FP2, but the master domain manager is still at a previous product version level, problems can occur when monitoring objects that support the definition in a folder such as, prompts, workstations, and resources, as well as objects that contain the workstation in their object identifier, for example, job streams. More specifically these objects are not displayed in the results of the monitoring query on the plan if you use filters in your query.

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

Following a temporary switch manager operation to the backup master domain manager, MakePlan fails after the next plan generation
In an environment where the automatic failover feature is enabled, if you perform a temporary switch from the master to the backup, and do not make it a permanent switch before the next JnextPlan, then when the XA (extended agent) runs the FINAL job stream, the MakePlan script ends in ABEND and a new plan is not generated. This occurs because the automatic failover feature runs the FINAL from an XA defined on $MASTER and the XA does not recognize that a switch has occurred and continues to refer to the original master.

Workaround: Modify the XA workstation definition in the database to set the new master as the current and make the switch permanent. The old master should be set as FTA and the new one as MANAGER.

Dependencies cannot be resolved when a workstation is set to IGNORE
If a workstation is set to IGNORE, the dependency resolution does not work since it cannot be evaluated by the batchman process. Furthermore, conman ads/adj considers the workstation not present in the plan and prevents you to add dependencies on IGNORED workstations. The deletion and release can be performed on dependencies defined on IGNORED workstations.
The EEW0107E error occurs and the option editor does not work
Using the option editor the following error could occur:
EEW0107E the password cannot be longer than forty characters error new file can not be correctly saved, old option files can not be opened
This occurs because the option editor does not work with the following option file types:
  • PeopleSoft (psagent)
  • SAP R/3 (r3batch)
  • z/OS® (mvsjes and mvsopc)

Workaround: For both SAP and PeopleSoft option files, you can create or edit files by using the option editor available in the XA task tab of the Access Method job type. For z/OS®, you can create or edit files by using a file editor instead of the option editor.

Job streams with resources that are not yet into the production plan cannot be submitted
You cannot submit a job stream defined on a workstation class if the job stream contains resources defined on the workstation class and the resources have not yet entered into the production plan.

Workaround: Define the job stream in the database and wait until the production plan is generated. After the plan is generated, submit the job stream as usual.

Collecting intercepted SAP jobs periodically is supported only for XA workstations on root
You can retrieve intercepted SAP jobs and relaunches them only for XA workstations defined on the root folder.
9.5 Fix Pack 1:
An incorrect run number is sent to Flexera and causes the engine functionality to stop
If you have migrated a master domain manager from product version 9.5 Fix Pack 1 to the latest fix pack level and encounter the error message AWKFLX002E One or more job run numbers are missing in the job count, then an error has occurred in calculating the job run number. The updateStats script of the first FINALPOSTREPORTS could end after the switchPlan script of the FINAL job stream, thus the job run number changes before the end of the updateStats script. Flexera server finds that the run number is not the expected one and stops the engine functionality.

This problem does not apply if you perform a fresh installation of the master domain manager at 9.5, Fix Pack 2 level. The problem applies only if you have migrated a master domain manager from product version 9.5 Fix Pack 1 to the latest fix pack level.

Workaround: to make the job run number reliable, the FINAL and FINALPOSTREPORTS should be modified as follows:
  • The FINAL's FOLLOWS dependency must be changed from WKS#FINAL.SWITCHPLAN PREVIOUS to FOLLOWS WKS#FINALPOSTREPORTS.UPDATESTATS FROM 2359 - 1 DAYS TO 2358 job.
    Following an example of the complete FINAL definition:
    SCHEDULE WKS#FINAL
            DESCRIPTION "Added by composer."
            ON RUNCYCLE RC1 "FREQ=DAILY;"
            AT 2359
            CARRYFORWARD
            FOLLOWS WKS#FINALPOSTREPORTS.UPDATESTATS FROM 2359 - 1 DAYS TO 2358
            :
            WKS#STARTAPPSERVER
     
            WKS#MAKEPLAN
            FOLLOWS STARTAPPSERVER
     
            WKS#SWITCHPLAN
            FOLLOWS MAKEPLAN
  • The FINALPOSTREPORTS.UPDATESTATS job must be set to have a RECOVERY STOP option instead of the RECOVERY CONTINUE one.
    Following an example of the complete UPDATESTATS definition:
    WKS#UPDATESTATS
            SCRIPTNAME "/opt/HCL/WA95/TWS/UpdateStats"
            STREAMLOGON wauser
            DESCRIPTION "Added by composer."
            TASKTYPE UNIX
            RECOVERY STOP
            FOLLOWS CHECKSYNC

Jobs are not able to run on a domain manager after a repeat rerun

If the recovery job workstation is a dynamic agent, to make jobs run on a domain manager after a repeat rerun, the dynamic agent must belong to the same domain as the parent job workstation.

SendMail action is not performed due to a missing WebSphere Application Server Liberty Base third-party library

When an event rule includes sending a user an email as the triggered action in response to the occurrence of the event, the email is not sent due to the absence of a WebSphere Application Server Liberty Base third-party library.
Workaround: to load the missing third-party library available in Liberty, you must define the API type visibility in the section of the server.xml file that is related to the TWSEngineModel.ear deployment. Set the apiTypeVisibility attribute of the classloader element to third-party as follows:
<enterpriseApplication id="TWSEngineModel" location="TWSEngineModel.ear" name="TWSEngineModel"> <classloader apiTypeVisibility="+third-party" commonLibraryRef="DBDriverLibs, libs.native" delegation="parentFirst"  privateLibraryRef="libs.sdo, libs.plugin, libs.jackson, twa-properties, libs.ccmdb, libs.emf, libs.jlog, libs.act">
</classloader>

Once the change has been performed, restart the WebSphere Application Server Liberty Base

A communication failure could occur when removing an ACL defined on a deleted folder

Removing an ACL defined on a deleted folder from the DWC, you could receive the following error message:
"AWSUI0833E The operation could not be completed. There has been a communication failure. The internal message is: AWSJDB201E The object "acl=/FOLDER1_1/+F" cannot be locked, updated, or deleted because it is locked by user "null"."
Workaround: to remove the ACL and avoid communication issues, perform the following steps:
  1. Recreate the deleted folder.
  2. Delete the ACL defined on the folder you just recreated.
  3. Delete the folder.

A fully qualified path length of a folder cannot be longer than 254 chars

The folder path cannot be longer than 254 chars, otherwise a security file corruption occurs.

The CWWKS4001I information message is logged several times in the messages.log file

In case of Dynamic Workload Console concurrent users generating more than 15 pages/second traffic, the CWWKS4001I information message is logged several times in the WebSphere Application Server Liberty Base messages.log of the master domain manager. This behaviour makes the log file difficult to read and might cause potential performance impacts on Dynamic Workload Console response time.

Fix pack structure

This section describes the structure of the images contained in this Fix Pack.

Fix Pack files available for HCL Workload Automation using Flexnet

This is the structure of the Fix Pack for the engine on Flexnet:
Table 2. Readme file and WebSphere Liberty package
Name Description
HWA_9502_ReadmeFirst Readme file with download instructions
HWA_9502_WEBSPHERE_LIBERTY WebSphere Liberty application server
Table 3. AIX components
Name Description
HWA_9502_AIX_BatchReportCli HCL Workload Automation 9.5.0.2 Batch Reports Command Lines
HWA_9502_AIX_AGENT HCL Workload Automation Agent 9.5.0.2, Remote CLI and Workload Automation for Applications for AIX
Table 4. IBM i components
Name Description
HWA_9502_IBM_I_AGENT HCL Workload Automation Agent 9.5.0.2 for IBM i
Table 5. Linux components
Name Description
HCL Workload Automation 9.5 LINUX LINUX distribution
HWA_9502_MDM_LINUX_X86_64 Workload Automation 9.5.0.2 FOR LINUX
HWA_9502_LINUX390_BatchReportCli HCL Workload Automation 9.5.0.2 Batch Reports Command Lines
HWA_9502_LINUX_X86_64_BatchReportCli HCL Workload Automation 9.5.0.2 Batch Reports Command Lines
HWA_9502_LNX_PPC64LE_AGENT HCL Workload Automation Agent 9.5.0.2, Remote CLI and Workload Automation for Applications for Linux on POWER (little endian)
HWA_9502_LNX_S390_AGENT HCL Workload Automation Agent 9.5.0.2, Remote CLI and Workload Automation for Applications for Linux on System z9 and System z
HWA_9502_LNX_X86_64_AGENT Workload Automation Agent 9.5.0.2, Remote CLI and Workload Automation for Applications for Linux on x86-64
Table 6. Linux components on Docker
Name Description
HCL Workload Automation 9.5 LINUX LINUX distribution
HWA_9502_DOCKER_MDM_LINUX_X86_64 Workload Automation 9.5.0.2 FOR LINUX on Docker
HWA_9502_DOCKER_LNX_X86_64_AGENT Workload Automation Agent 9.5.0.2, Remote CLI and Workload Automation for Applications for Linux on x86-64 on Docker
Table 7. Windows components
Name Description
HCL Workload Automation 9.5 WINDOWS WINDOWS distribution
HWA_9502_MDM_WINDOWS_X86_64 Workload Automation 9.5.0.2 FOR WINDOWS
HWA_9502_WINDOWS_X86_64_BatchReportCli HCL Workload Automation 9.5.0.2 Batch Reports Command Lines
HWA_9502_WIN_X86_64_AGENT HCL Workload Automation Agent 9.5.0.2, Remote CLI and Workload Automation for Applications for Windows x64
Table 8. zOS components
Name Description
HWA_9502_Zsystem_BatchReportCli HCL Workload Automation 9.5.0.2 Batch Reports Command Lines
Table 9. OpenShift components
Name Description
HWA_9502_OpenShift_Agent.zip Workload Automation for Openshift 9.5.0.2 - agent only
HWA_9502_OpenShift_Server_UI_Agent.zip Workload Automation for Openshift 9.5.0.2 - Server, UI and agent

Installing the Fix Pack

This section describes how to apply Fix Pack 2 to HCL Workload Automation.

The section is divided into the following subsections:

Installation notes

When installing the HCL Workload Automation Fix Pack, follow these recommendations:
  • Before installing the Fix Pack, ensure you have installed the required prerequisite software. To obtain the latest information about software requirements for HCL Workload Automation, see https://workloadautomation.hcldoc.com/help/topic/com.hcl.wa.doc_9.5/distrDDguides.html.
  • This Fix Pack supports DB2 Advanced Enterprise Server Edition, Version 10.5 on HP-UX and Sun Solaris operating systems only. It is available for download from Flexnet. After the installation of DB2 Advanced Enterprise Server Edition, Version 10.5, you must manually apply the license activation key (.lic file). The license key must be downloaded separately from the Passport Advantage web site. The part number related to the license activation key is CNED3ML. The key must be registered using the db2licm command. See Applying DB2 licenses licenses for the procedure to register the key.

    If you already have installed DB2 Advanced Workgroup Server Edition, you can switch this license with a DB2 Advanced Enterprise Server Edition license, by following the procedure in Updating licenses. Note that when the procedure references the product-identifier as in step 3:db2licm -a product-identifier, replace the product-identifier with the file representing the license activation key (.lic).

  • Before installing this Fix Pack on AIX® V7.1 operating systems, you must apply the patch for APAR IZ99634. For more information, see: APAR IZ99634.
  • On UNIX operating systems, before installing the HCL Workload Automation Fix Pack, ensure that your umask is set to 022. To verify that umask is set to the correct value, from a command prompt, run the umask command. If the value is different from 022, modify it by running the command:
    umask 022
  • On UNIX operating systems, the database administrator must have read and run privileges for the HCL Workload Automation installation path; otherwise the installation fails. (54367)
After the Fix Pack installation completes, verify the following information:
  • This Fix Pack installs a new version of the file tws_env.sh (tws_env.cmd) and also creates a backup file named, tws_env.sh.bk (tws_env.cmd.bk), which are both saved to the <TWA_HOME>/TWS directory, where <TWA_HOME> is the HCL Workload Automation installation directory. After installing the Fix Pack, if you have modified the original version, merge the content of the new version with the content of the original version to carry your customized content into the new version.
  • On IBM i operating systems, if you want to install the Fix Pack on the agent for z/OS and HCL Workload Automation Dynamic Agent, verify that the user profile used as TWSUser is not a member of a group profile. Set the group profile associated with the TWSUser to *NONE. If the TWSUser is a member of a group, the Fix Pack installation fails.
  • Only on Windows operating systems, to correctly display double-byte character set (DBCS) characters, you must perform the following actions:
    • Set the LANG environment variable to the DBCS language code you want to use, for example, set LANG=zh_CN.
    • Set the TWS_TISDIR environment variable to the HCL Workload Automation home directory, for example, set TWS_TISDIR=C:\FTA\TWS.
    • Open the Control Panel window and click Clock, Language, and Region.
    • Click Region and Language.
    • In the Format tab, choose from the Format drop-down list the language you want to use.
    • In the Keyboards and Languages tab, under Display Language, click install and follow the steps to install the DBCS language pack you want to use.
    • In the Administrative tab, click Change system locale and, from the drop-down list, choose the language (system locale) you want to use.
    Note that all the settings must be coherent, that is they must refer to the same DBCS language setting. After you have completed these changes, reboot your workstation to have the changes take effect.
  • When installing a dynamic agent or a fault-tolerant agent, ensure that the agent name does not start with a number. If the name of the dynamic agent starts with a number, use the -displayname parameter at installation time to specify a different name. If the name of the fault-tolerant agent starts with a number, use the --thiscpu parameter at installation time to specify a different name.

Interoperability notes

HCL Workload Automation version 9.5.0 Fix Pack 2 supports all product versions indicated in the HCL Workload Automation version 9.5 Release Notes which can be accessed at the following link: https://workloadautomation.hcldoc.com/help/topic/com.hcl.wa.doc_9.5/Release_Notes_for_HCL_Workload_Scheduler.htm.

Disk space requirements

For the most up-to-date information about disk space and memory requirements, see the hardware requirements at the following URL: https://workloadautomation.hcldoc.com/help/topic/com.hcl.wa.doc_9.5/HCL_Workload_Automation_Supported_Hardware.pdf

Before starting the Fix Pack installation, ensure that you have the necessary disk space available on the file system. Consider that the disk space check calculated by the installation considers the entire space occupied by the <TWA_HOME> directory. The space required by the backup is the sum of the following directories:
<TWA_HOME>/TWS + <TWA_HOME>/TDWB + <TWA_HOME>/wastools + <TWA_HOME>/properties
In addition to the disk space in the following table, the installation requires an additional 600 MB on the file system where the IMShared directory is located.
Table 10. Disk space requirements for installing a master domain manager or a backup master Fix Pack
Operating System Installation directory Temporary directory
AIX 2,5 GB 1,5 GB
Microsoft Windows 2 GB 1 GB
Linux 1,5 GB 800 MB
Table 11. Disk space requirements for installing the Fix Pack for HCL Workload Automation fault-tolerant agents
Operating System Installation directory Temporary directory
AIX 900 MB 400 MB
HP-UX 1.3 GB 400 MB
Solaris 920 MB 400 MB
Microsoft Windows 700 MB 350 MB
Linux 720 MB 350 MB
Table 12. Disk space requirements for installing the Fix Pack for HCL Workload Automation dynamic agents and z/OS agents
Operating System Installation directory Temporary directory
AIX 600 MB 250 MB
HP-UX 920 MB 400 MB
Solaris 580 MB 120 MB
Microsoft Windows 800 MB 400 MB
Linux 600 MB 250 MB
Note: Only on HP and Solaris operating systems, the Fix Pack installation requires also 300 MB free disk space in the temporary directory /var/tmp.

Installation methods

You can install the Fix Pack using one of the following methods:
For master domain manager or its backup:
see Updating the master domain manager and its backup
For dynamic domain manager or its backup:
see Updating the dynamic domain manager
For fault-tolerant agent, dynamic agent or domain manager:
see Updating agents

Before Installing

Before installing the Fix Pack using any of the methods described in the following sections, perform the following actions:
  1. If you have jobs scheduled to run on the instance you are upgrading, make sure that they have completed otherwise some processes, such as jobmon or joblnch, might still be active.
  2. Download the appropriate ZIP files for the operating system from HCL License Portal Flexnet.
  3. Extract the content of the ZIP files into a directory, using one of the extraction tools available on your system or downloadable from the Internet. The tool you use must be able to keep the file permissions on the extracted files, for example, infozip.
    Note:
    • If you want to install the Fix Pack on IBM i, to untar the eImages, see Extract the eImages for the HCL Workload Automation for Z Agent and Dynamic Agent on IBM i operating systems.
    • To extract the .zip file onto a Windows 64-bit system, ensure that the eImage is not located on the desktop because the Windows operating system extract tool has a problem. Choose another directory into which to extract the Fix Pack eImage.

Creating or updating the HCL Workload Automation database schema

Before launching any of the installation methods, create or update the database schema.

Before applying the Fix Pack, create the database schema by following the procedure described in the Creating and updating the database tables chapter in the Planning and Installation guide.

If the database already exists, update the database by running the following command:
On Windows operating systems
cscript configureDb.vbs --rdbmstype <db_type> --dbhostname <db_hostname> --dbport <db_port> --dbname <db_name> --dbuser <db_user> --dbpassword <db_password> --dbadminuser <db_administrator> --dbadminuserpw <db_administrator_password>
On UNIX operating systems
./configureDb.sh --rdbmstype <db_type> --dbhostname <db_hostname> --dbport <db_port> --dbname <db_name> --dbuser <db_user> --dbpassword <db_password> --dbadminuser <db_administrator> --dbadminuserpw <db_administrator_password>

If a new version of the database is available, update to it by following the procedure described in the Upgrading the database schema chapter in the Planning and Installation guide.

Extract the eImages for the HCL Workload Automation for Z Agent and Dynamic Agent on IBM i operating systems

The following package is available with this Fix Pack:
  • HWA95_FP2IBM_I_AGENT.zip: The dynamic agent on IBM i image. This package also contains an extraction tool executable that can be copied to the IBM i workstation.

To untar or unzip the Fix Pack eImages, you can use the PASE shell or the AIXterm.

Using PASE shell:
  1. Open the PASE shell.
  2. Run the command:
    "CALL QP2TERM"
  3. Locate the folder where you downloaded the Fix Pack eImage and run the command:
    Dynamic agent
    "unzip HWA95_FP2_IBM_I_AGENT.zip"
  4. Exit from the PASE shell.
Using AIXterm:
  1. Start the Xserver on your desktop.
  2. On the iSeries machine, open a QSH shell and export the display.
  3. In QSH shell, go to the directory /QopenSys and run the command:
    "aixterm -sb"
  4. A pop-up window is displayed on your desktop. Using this pop-up window, unzip the HWA95_FP2_IBM_I_AGENT.zip file, or untar the HWA95_FP2_IBM_I_AGENT.zip.

Rolling back an applied fix pack

This topic describes how to roll back an applied fix pack to a previous version.

About this task

You can revert back to an earlier version of an installed Fix Pack or release by using one of the following methods:
For master domain manager or its backup:
see Rolling back the master domain manager and its backup
For dynamic domain manager or its backup:
see Rolling back the dynamic domain manager

Documentation updates for HCL Workload Automation Fix Pack 2 for version 9.5.0

Any additions or changes to the documentation as a result of this Fix Pack have been integrated into the online product documentation available in HCL Workload Automation documentation.

Contacting HCL Software Support

Refer to the HCL Workload Automation Support page: Support

Notices

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

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

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

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

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

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

HCL TECHNOLOGIES LTD. 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. HCL 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-HCL 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 HCL product and use of those websites is at your own risk.

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

HCL
330 Potrero Ave.
Sunnyvale, CA 94085
USA
Attention: Office of the General Counsel

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

© (HCL Ltd.) (2020).
Portions of this code are derived from HCL Ltd. Sample Programs.
© Copyright HCL Ltd. _2020_.

Trademarks

HCL, and other HCL graphics, logos, and service names including "hcltech.com" are trademarks of HCL. Except as specifically permitted herein, these Trademarks may not be used without the prior written permission from HCL. All other trademarks not owned by HCL that appear on this website are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by HCL.

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

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

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.

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

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

Trademarks

HCL, the HCL logo, and ibm.com are trademarks or registered trademarks of HCL Technologies Ltd. in the United States, other countries, or both. If these and other HCL trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by HCL at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries.

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.

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.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

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