Tivoli Workload Scheduler

Version 8.4

Dynamic Workload Console Installation and Troubleshooting Guide

SC32-1572-01

Tivoli Workload Scheduler

Version 8.4

Dynamic Workload Console Installation and Troubleshooting Guide

SC32-1572-01

Note Before using this information and the product it supports, read the information in Notices on page 193.

This edition applies to IBM Tivoli Dynamic Workload Console which is a component of Tivoli Workload Scheduler Version 8, Release 4 Modification Level 0 (program number 5698-WSH) and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces SC32-1572-00. Copyright International Business Machines Corporation 2007. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents
About this publication . . . . . . . . v
Intended audience for this publication . . . . . . v What this publication contains . . . . . . . . v Publications . . . . . . . . . . . . . . v Tivoli Workload Scheduler library . . . . . . vi Prerequisite publications . . . . . . . . . ix Related publications . . . . . . . . . . . x Accessing terminology online . . . . . . . xii Accessing publications online . . . . . . . xii Ordering publications. . . . . . . . . . . xiv Accessibility . . . . . . . . . . . . . . xiv Tivoli technical training . . . . . . . . . . xv Support information . . . . . . . . . . . xv Conventions used in this publication . . . . . . xv Typeface conventions . . . . . . . . . . xv Operating system-dependent variables and paths . . . . . . . . . . . . . . . xvi Command syntax . . . . . . . . . . . xvi

| | | | | | | | | |

Exporting the LTPA token_keys from the Tivoli Workload Scheduler z/OS connector version 8.3 Fix Pack 3 . . . . . . . . . . . . . . Sample Web console configurations using user registry and Single Sign-On . . . . . . . . . Updating the Secure Socket Layer protocol certificates on the Web console . . . . . . . . Disabling Tivoli Workload Scheduler Version 8.3 Fix Pack 3 workstations from being connected to Web console . . . . . . . . . . . . . . . .

42 43 45

46

Chapter 3. Uninstalling . . . . . . . . 49
Uninstalling using the graphical wizard . . . . Uninstalling in silent mode . . . . . . . . Sample response file for uninstall . . . . . Uninstalling the Tivoli Workload Scheduler z/OS connector . . . . . . . . . . . . . . . 49 . 50 . 50 . 50

Chapter 1. Installing . . . . . . . . . 1
|
Overview . . . . . . . . . . . . . . . 1 Getting started with the installation. . . . . . . 2 Installation prerequisites . . . . . . . . . . 3 Supported Operating Systems . . . . . . . 3 Additional prerequisites for using the launchpad 8 Runtime requirements . . . . . . . . . . . 8 System runtime requirements . . . . . . . . 8 Supported client browsers . . . . . . . . . 8 Tivoli Workload Scheduler supported engines . . 9 Tivoli Dynamic Workload Broker supported servers . . . . . . . . . . . . . . . 12 Before installing . . . . . . . . . . . . . 12 Supported installation scenarios . . . . . . 12 Available installation methods . . . . . . . 14 Installation media . . . . . . . . . . . 14 Installing . . . . . . . . . . . . . . . 15 Starting the installation using the launchpad . . 16 Installing using the graphical wizard . . . . . 17 Installing in silent mode . . . . . . . . . 23 Post-installation steps to connect to Tivoli Workload Scheduler Version 8.3 Fix Pack 3 . . . . . . . 31 Accessing the Web console . . . . . . . . . 32 Quick steps to define a Tivoli Workload Scheduler engine connection . . . . . . . . 34 Quick steps to define a Tivoli Dynamic Workload Broker engine connection . . . . . . . . . 35 Starting and stopping an application server instance 36

Chapter 4. Troubleshooting . . . . . . 53
| | | | | | | | | | | |
Log and trace files . . . . . . . . . . . . Activating traces. . . . . . . . . . . . . Removing manually the Web console and the embedded version of WebSphere Application Server. Backing up the WebSphere Application Server configuration files . . . . . . . . . . . . Restoring the WebSphere Application Server configuration files . . . . . . . . . . . . Showing the security properties . . . . . . . Changing the security properties . . . . . . . Setting security properties in the template file for LDAP configuration . . . . . . . . . . Backing up the Web console data . . . . . . . Creating a core dump of the application server . . Troubleshooting scenarios . . . . . . . . . Troubleshooting installation scenarios . . . . Troubleshooting runtime scenarios . . . . . . 53 54 55 55 56 57 58 58 60 60 61 61 64

| | | |

Appendix A. Web console messages

IBM Tivoli message format . Message code . . . . . Message text . . . . . Message help . . . . . List of Web console messages Installation messages . . Interface messages . . . Server Messages . . . R3Batch Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

77
. 77 . 77 . 78 . 78 . 79 . 79 . 86 . 149 . 151

| | | | | | | | | | | | |

Chapter 2. Configuring . . . . . . . . 37
Managing users and roles . . Enabling the Web console to use Enabling the Web console to use method with engines . . . . . . . . . . . 37 a user registry . . 39 the Single Sign-On . . . . . . . 39

Appendix B. Accessibility . . . . . . 183

Navigating the interface using the keyboard . Magnifying what is displayed on the screen . . . . 183 . 183

Appendix C. Support information . . . 185

Using IBM Support Assistant . . . . . . . . 185

Copyright IBM Corp. 2007

iii

Tivoli Workload Scheduler IBM Support Assistant plug-in version and upgrade issues . . Searching knowledge bases . . . . . . . . . Searching the local information center . . . . Searching the Internet . . . . . . . . . Obtaining fixes . . . . . . . . . . . . . Receiving weekly support updates . . . . . . Contacting IBM Software Support . . . . . . Determining the business impact . . . . . . Describing problems and gathering information Submitting problems . . . . . . . . . .

185 186 186 186 187 187 189 190 190 190

Notices . . . . . . . . . . . . . . 193
For the code entitled BIRT . . . . . . . . For the code entitled Commons-IO 1.3 . . . . TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION . . For the code entitled Commons File Upload 1.1.1 For the code entitled Dojo 0.4.2 . . . . . . For INSTALLSHIELD MULTI-PLATFORM 11.5 Code . . . . . . . . . . . . . . . APACHE CODE . . . . . . . . . . . 194 . 194 . 195 198 . 198 . 198 . 199

JXML CODE. . . . . . . . . . . . InfoZip CODE . . . . . . . . . . . HSQL CODE . . . . . . . . . . . BROWSERLAUNCHER CODE . . . . . JTOPEN CODE . . . . . . . . . . . For the code entitled embedded version of IBM WebSphere Application Server (embedded WebSphere Application Server) V6.1 . . . . APACHE CODE . . . . . . . . . . . CUP PARSER GENERATOR FOR JAVA . . . EPL CODE . . . . . . . . . . . . . JYTHON . . . . . . . . . . . . . . XML SCHEMAS . . . . . . . . . . . International Components for Unicode (ICU) . . OAISIS XML SCHEMAS. . . . . . . . . Trademarks . . . . . . . . . . . . .

. . . . .

200 201 202 203 203

. . . . . . . . .

204 204 207 208 208 209 210 210 211

Glossary . . . . . . . . . . . . . 213 Index . . . . . . . . . . . . . . . 219

iv

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

About this publication

IBM Tivoli Dynamic Workload Console Installation and Troubleshooting Guide describes how to install, configure, uninstall, and troubleshoot the Tivoli Dynamic Workload Console component.

Intended audience for this publication

This publication is for system architects, system administrators, and technical specialists who are responsible for the planning and installing of Tivoli Dynamic Workload Console. Readers need to be familiar with the following topic: v PC and UNIX operating systems

What this publication contains

This publication contains the following chapters: | | v Chapter 1, Installing, on page 1 It provides the information about installation prerequisites, supported configurations, different mechanisms to install the Web console. v Chapter 2, Configuring, on page 37 It describes how to configure the Web console v Chapter 3, Uninstalling, on page 49 It provides the information about different mechanisms to uninstall he Web console. v Chapter 4, Troubleshooting, on page 53 It provides information on how to use log and trace files, and contains troubleshooting scenarios. v Appendix A, Web console messages, on page 77 It provides the description of the format and the list of application messages. v Appendix B, Accessibility, on page 183 It provides the information about the accessibility features in this product. v Appendix C, Support information, on page 185 It provides information on how to obtain support for IBM products.

| |

Publications
The IBM Tivoli Dynamic Workload Console Installation and Troubleshooting guide is part of the IBM Tivoli Workload Scheduler distributed library. This section lists the other publications contained in the IBM Tivoli Workload Scheduler distributed library and related documents. It also describes how to access Tivoli publications online, and how to order Tivoli publications. This section lists publications in the Tivoli Workload Scheduler library and any other related publications. It also describes how to access Tivoli publications online and how to order Tivoli publications.

Copyright IBM Corp. 2007

Publications

Tivoli Workload Scheduler library

Tivoli Workload Scheduler comprises several separate products available for a variety of operating systems. The library is divided into: IBM Tivoli Workload Scheduling suite library This library contains all cross-platform and cross-product publications for Tivoli Workload Scheduler. IBM Tivoli Workload Scheduler distributed library This library contains all of the publications that refer to the use of Tivoli Workload Scheduler on operating systems other than z/OS. IBM Tivoli Workload Scheduler for z/OS library This library contains all publications that apply only to IBM Tivoli Workload Scheduler for z/OS. IBM Tivoli Workload Scheduler for Applications library This library contains all publications that apply only to IBM Tivoli Workload Scheduler for Applications. IBM Tivoli Workload Scheduler for Virtualized Data Centers library This library contains all publications that apply only to IBM Tivoli Workload Scheduler for Virtualized Data Centers.

IBM Tivoli Workload Scheduling suite library

The following publications are available in the IBM Tivoli Workload Scheduling suite library. This library includes publications that are common to all products, operating systems, and components. v Tivoli Workload Scheduling Suite: Overview, SC32-1256 Provides an overview of all Tivoli Workload Scheduler products, and the way they can be used together to provide workload management solutions for your whole enterprise. Note: This manual used to be called "General Information". v Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide, SC32-1572 Describes how to work with Tivoli Workload Scheduler, regardless of operating system, using a common Web-based GUI called the Dynamic Workload Console. v Tivoli Dynamic Workload Console Download Document at http:// www.ibm.com/support/docview.wss?rs=672&uid=swg24016672 This provides full information about downloading the product CD images. It also indicates the APARs that have been fixed in this release. v Tivoli Dynamic Workload Console System Requirements Document at http://www.ibm.com/support/docview.wss?rs=672&uid=swg27010503 This provides full information about the hardware and software prerequisites of the product. v Tivoli Workload Scheduler: Job Scheduling Console Users Guide, SC32-1257 Describes how to work with Tivoli Workload Scheduler, regardless of operating system, using a common GUI called the Job Scheduling Console. v Tivoli Workload Scheduler, version 8.3: Warehouse Enablement Pack version 1.1.1 Implementation Guide for Tivoli Data Warehouse, versions 1.2 and 1.3 Provides information about enabling Tivoli Workload Scheduler for Tivoli Data Warehouse. This publication is only available on the Tivoli Workload Scheduler Engine Installation CD "TWS84_OTHER", in the following path: TDW_enablement_pack/tdw_weps/aws/v8300/doc/itws_for_TDW.doc

vi

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Publications
You cannot access it online, in the same way that you can the other books (see Accessing publications online on page xii).

IBM Tivoli Workload Scheduler distributed library

The following publications are available in the IBM Tivoli Workload Scheduler distributed library. This library contains publications that refer to using the product on distributed operating systems (all operating systems except z/OS). v Tivoli Workload Scheduler: Quick Start Guide, GC23-6141 Provides information on how to get started with an installation of Tivoli Workload Scheduler on distributed operating systems. v Tivoli Workload Scheduler Download Document at http://www.ibm.com/ support/docview.wss?rs=672&uid=swg24016672 This provides full information about downloading the product CD images. It also indicates the APARs that have been fixed in this release. v Tivoli Workload Scheduler System Requirements Document at http://www.ibm.com/support/docview.wss?rs=672&uid=swg27010396 This provides full information about the hardware and software prerequisites of the product. v Tivoli Workload Scheduler: Planning and Installation Guide, SC32-1273 Describes how to plan for and install IBM Tivoli Workload Scheduler on distributed operating systems, and how to integrate Tivoli Workload Scheduler with NetView, Tivoli Data Warehouse, Tivoli Monitoring, and Tivoli Enterprise Console. v Tivoli Workload Scheduler: Reference Guide, SC32-1274 Provides an explanation of the concepts of Tivoli Workload Scheduler and describes how the product is used. Also describes the Tivoli Workload Scheduler command line used on distributed operating systems, and how extended and network agents work. v Tivoli Workload Scheduler: Administration and Troubleshooting, SC32-1275 Provides information about how to administer Tivoli Workload Scheduler on distributed operating systems, and what to do if things go wrong. It includes help on many messages generated by the main components of Tivoli Workload Scheduler. v Tivoli Workload Scheduler: Database Views, SC32-2261 Provides information about the views of the IBM Tivoli Workload Scheduler database. v Tivoli Workload Scheduler: Using Microsoft Cluster Service on Windows Server 2003, SC23-6119 Describes how to use Tivoli Workload Scheduler with the Microsoft Cluster service on Windows Server 2003 to achieve high availability. v Tivoli Workload Scheduler: Limited Fault-tolerant Agent for i5/OS, SC32-1280 Describes how to install, configure, and use Tivoli Workload Scheduler limited fault-tolerant agents on i5/OS. v Java API documentation. Provides information about using the Java Application Programming Interface (API). This is a set of available classes and methods running in a JAVA environment that you use to create a custom interface to manage scheduling objects in the database and in the plan. They cannot be used to manage the plan or to set global options.

About this publication

vii

Publications
Documentation for the API is provided on all distributed product CDs. Mount the CD for your platform and open the following file with your Internet browser: <CD_drive>/API/doc/index.html. See http://www.ibm.com/software/tivoli/products/scheduler/ for an introduction to the product.

IBM Tivoli Workload Scheduler for z/OS library

The following publications are available in the Tivoli Workload Scheduler for z/OS library: v Tivoli Workload Scheduler for z/OS: Getting Started, SC32-1262 Discusses how to define your installation data for Tivoli Workload Scheduler for z/OS and how to create and modify plans. v Tivoli Workload Scheduler for z/OS: Installation Guide, SC32-1264 Describes how to install Tivoli Workload Scheduler for z/OS. v Tivoli Workload Scheduler for z/OS: Customization and Tuning, SC32-1265 Describes how to customize Tivoli Workload Scheduler for z/OS. v Tivoli Workload Scheduler for z/OS: Managing the Workload, SC32-1263 Explains how to plan and schedule the workload and how to control and monitor the current plan. v Tivoli Workload Scheduler for z/OS: Quick Reference, SC32-1268 Provides a quick and easy consultation reference to operate Tivoli Workload Scheduler for z/OS. v Tivoli Workload Scheduler for z/OS: Diagnosis Guide and Reference, SC32-1261 Provides information to help diagnose and correct possible problems when using Tivoli Workload Scheduler for z/OS. v Tivoli Workload Scheduler for z/OS: Messages and Codes, SC32-1267 Explains messages and codes in Tivoli Workload Scheduler for z/OS. v Tivoli Workload Scheduler for z/OS: Programming Interfaces, SC32-1266 Provides information to write application programs for Tivoli Workload Scheduler for z/OS. v Tivoli Workload Scheduler for z/OS: Scheduling End-to-end, SC32-1732 Provides information on how to integrate Tivoli Workload Scheduler for z/OS with Tivoli Workload Scheduler, controlling workload in a distributed environment from a z/OS master domain manager. v Tivoli Workload Scheduler for z/OS: Memo to Users, GI11-4209 Provides a summary of changes for the current release of the product. v Tivoli Workload Scheduler for z/OS: Program Directory, GI11-4248 Provided with the installation tape for Tivoli Workload Scheduler for z/OS, describes all of the installation materials and gives installation instructions specific to the product release level or feature number. See http://www.ibm.com/software/tivoli/products/scheduler-zos/ for an introduction to the product.

viii

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Publications

IBM Tivoli Workload Scheduler for Applications library

The following publications are available in the IBM Tivoli Workload Scheduler for Applications library: v Tivoli Workload Scheduler for Applications: Users Guide, SC32-1278 Provides information on how to install, set up, and use the IBM Tivoli Workload Scheduler access methods that run and control jobs of the following applications: Oracle PeopleSoft R/3 z/OS v Tivoli Workload Scheduler for Applications: Quick Start Guide, GC32-1538 Gives an overview on how to get started with Tivoli Workload Scheduler for Applications. v Tivoli Workload Scheduler for Applications Download Document at http://www.ibm.com/support/docview.wss?rs=673&uid=swg24013044 This provides full information about downloading the product CD images. It also indicates the APARs that have been fixed in this release. v Tivoli Workload Scheduler for Applications System Requirements Document at http://www.ibm.com/support/docview.wss?rs=673&uid=swg27007885 This provides full information about the hardware and software prerequisites of the product. See http://www.ibm.com/software/tivoli/products/scheduler-apps/ for an introduction to the product.

IBM Tivoli Workload Scheduler for Virtualized Data Centers library

The following publications are available in the IBM Tivoli Workload Scheduler for Virtualized Data Centers library: v Tivoli Workload Scheduler for Virtualized Data Centers: Users Guide, SC32-1454 Describes how to extend the scheduling capabilities of Tivoli Workload Scheduler to workload optimization and grid computing by enabling the control of IBM LoadLeveler and IBM Grid Toolbox jobs. v Tivoli Workload Scheduler for Virtualized Data Centers: Release Notes, SC32-1453 Provides late-breaking information about Tivoli Workload Scheduler for Virtualized Data Centers. See http://www.ibm.com/software/info/ecatalog/en_US/ products/ Y614224T20392S50.html for an introduction to the product.

Prerequisite publications
To use the information in this book effectively, you must have some prerequisite knowledge, which you can obtain from the following publications: In the IBM Tivoli Dynamic Workload Broker publication: v IBM Tivoli Dynamic Workload Broker: User's Guide, SC32-2281 It explains how to use Tivoli Dynamic Workload Broker to manage your scheduling environment. In the IBM Tivoli Workload Scheduler for z/OS publications: v Tivoli Workload Scheduler for z/OS: Managing the Workload, SC32-1263

About this publication

ix

Prerequisite publications
It explains how to plan and schedule the workload in a z/OS environment and how to control and monitor the current plan. v IBM Redbooks: IBM Tivoli Workload Scheduler for z/OS: Best Practices, SG24-7156 This IBM Redbook describes best practices for installing and using Tivoli Workload Scheduler for z/OS. You can find this Redbook in the Redbooks Web site at http://www.redbooks.ibm.com/abstracts/ sg247156.html In the IBM WebSphere Application Server publications: For all types of information about the WebSphere Application Server, go to the WebSphere Application Server Information Center: http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp

Related publications
The following publications also provide useful information: In the IBM Tivoli Workload Scheduler distributed publications: v IBM Redbooks: Getting Started with IBM Tivoli Workload Scheduler V8.3: Best Practices and Performance Improvements, SG24-7237 Abstract: IBM Tivoli Workload Scheduler is an IBM strategic scheduling product that runs on different platforms including the mainframe. The new version of the product, IBM Tivoli Workload Scheduler V8.3, comes with some important enhancements, such as relational database management system support, new advanced planning system, which allows the definition of plans that span more that 24 hours, removal of framework requirements, new application programming interface (API), Job Scheduling Console enhancements, and so on. This IBM Redbook documents the architecture, deployment, best practices, and migration scenarios for IBM Tivoli Workload Scheduler V8.3 in a distributed environment. In addition, it covers IBM Tivoli Workload Scheduler V8.3 security, IBM DB2 and IBM WebSphere considerations, troubleshooting, tuning for performance, application programming interface, and JnextPlan, which has replaced the JnextDay process in this release. Clients and Tivoli professionals who are responsible for installing, administering, maintaining, or using IBM Tivoli Workload Scheduler V8.3 will find this book a major reference. This Redbook can be found on the Redbooks Web site at http://www.redbooks.ibm.com/abstracts/sg247237.html v IBM Redbooks: Customizing IBM Tivoli Workload Scheduler for z/OS V8.2 to Improve Performance, SG24-6352 Abstract: This IBM Redbook covers the techniques that can be used to improve the performance of Tivoli Workload Scheduler for z/OS (including end-to-end scheduling). This Redbook can be found on the Redbooks Web site at http://www.redbooks.ibm.com/abstracts/sg246352.html v IBM Redbooks: IBM Tivoli Workload Scheduler for z/OS: Best Practices, SG24-7156 Abstract: This IBM Redbook describes best practices for using Tivoli Workload Scheduler for z/OS. Topics covered include: Installation best practices Installation verification

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Related publications
Started tasks Communication Initialization statements and parameters Security Exits Restart and cleanup Dataset triggering and event trigger tracking

Variables Audit report facility This Redbook can be found on the Redbooks Web site at http://www.redbooks.ibm.com/abstracts/sg247156.html v IBM Redbooks: Integrating IBM Tivoli Workload Scheduler with Tivoli Products, SG24-6648 Abstract: This IBM Redbook explains the benefits and technical merits of integrating IBM Tivoli Workload Scheduler Distributed and IBM Tivoli Workload Scheduler for z/OS with other IBM products. Scheduling is a mission critical process for any company. However, when you talk about scheduling, you are really talking about an ecosystem. In this ecosystem, each solution is a building block that adds value to the overall solution. With IBM Tivoli Workload Scheduler, you can collect and add data to and from each component. In addition, expanding the scheduling ecosystem to include monitoring, management, help desk, storage, and business systems management provides greater value. This book discusses all these integration points and provides detailed scenarios on how to integrate IBM Tivoli Workload Scheduler with these types of applications. Because workload management is widely considered the nucleus of the data center, there are numerous opportunities for you to integrate IBM Tivoli Workload Scheduler with other products. This book addresses just some of these many opportunities. In terms of integration with IBM Tivoli Workload Scheduler, do not limit yourself to the products that this book discusses. Integration points discussed in this book should give you an idea of the potential value that IBM Tivoli Workload Scheduler integration can provide for your company. This Redbook can be found on the Redbooks Web site at http://www.redbooks.ibm.com/abstracts/sg246648.html v IBM Redbooks: WebSphere Application Server V6 System Management & Configuration Handbook, SG24-6451 Abstract: This IBM Redbook provides system administrators, developers, and architects with the knowledge to configure a WebSphere Application Server V6 runtime environment, to package and deploy Web applications, and to perform ongoing management of the WebSphere environment. One in a series of handbooks, the entire series is designed to give you in-depth information about the entire range of WebSphere Application Server products. In this book, we provide a detailed exploration of the WebSphere Application Server V6 runtime environments and administration process. This Redbook can be found on the Redbooks Web site at http://www.redbooks.ibm.com/abstracts/sg246451.html v Java API documentation.
About this publication

xi

Related publications
It explains how to use the Java Application Programming Interface (API). This is a set of available classes and methods running in a JAVA environment that you might want to use to create a custom interface to manage scheduling objects in the database and in the plan. They cannot be used to manage the plan or to set global options. Documentation for the API is provided on all distributed product CDs. Mount the CD for your platform and open the following file with your Internet browser: <CD_drive>/API/doc/index.html. In the IBM Tivoli Workload Scheduler for z/OS publications: v Tivoli Workload Scheduler for z/OS: Customization and Tuning, SC32-1265 It explains how to customize Tivoli Workload Scheduler for z/OS. v Tivoli Workload Scheduler for z/OS: Diagnosis Guide and Reference, SC32-1261 It helps diagnose and correct possible problems when using Tivoli Workload Scheduler for z/OS. v Tivoli Workload Scheduler for z/OS: Messages and Codes, SC32-1267 It explains messages and codes in Tivoli Workload Scheduler for z/OS. In the IBM WebSphere Application Server publications: IBM Redbooks: WebSphere Application Server V6 System Management & Configuration Handbook, SG24-6451 This IBM Redbook provides system administrators, developers, and architects with the knowledge to configure a WebSphere Application Server V6 runtime environment, to package and deploy Web applications, and to perform ongoing management of the WebSphere environment. This Redbook can be found on the Redbooks Web site at http:// www.redbooks.ibm.com/abstracts/sg246451.html

Accessing terminology online

The Tivoli Software Glossary includes definitions for many of the technical terms related to Tivoli software. The Tivoli Software Glossary is available at the following Tivoli software library Web site: http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm The IBM Terminology Web site consolidates the terminology from IBM product libraries in one convenient location. You can access the Terminology Web site at the following Web address: http://www.ibm.com/software/globalization/terminology

Accessing publications online

The Tivoli Workload Scheduler documentation CD contains the publications that are in the product library. The format of the publications is PDF, HTML, or both. The publications are found within a Tivoli Information Center. Place the CD in the CD drive of a Windows computer and the Information Center automatically opens. If the Information Center does not open automatically, or you require more information, consult the readme.txt file in the root of the CD. IBM posts publications for this and all other Tivoli products, as they become available and whenever they are updated, to the Tivoli software information center Web site. There are two ways of accessing the Tivoli software information center:

xii

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Related publications
Directly access the IBM Tivoli Workload Scheduler Information Center Go directly to the Information Center at the following Web address: http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp?toc=/ com.ibm.tivoli.itws.doc/toc.xml Access the IBM Tivoli Workload Scheduler Information Center from the Tivoli Technical Product Documents Web site Access the Tivoli software information center by following these steps: 1. Go to the Tivoli library at the following Web address: http://www.ibm.com/software/tivoli/library/ 2. Click Tivoli product manuals 3. In the Tivoli Technical Product Documents Alphabetical Listing window, click W (for Workload Scheduler) or scroll down to the W section of the product list 4. Click the appropriate Tivoli Workload Scheduler product link to access your product libraries at the Tivoli software information center. All publications in the Tivoli Workload Scheduler suite library, distributed library, and z/OS library can be found under the entry Tivoli Workload Scheduler. The Tivoli software information center page for Tivoli Workload Scheduler is displayed. It gives you access to the publications relating to the latest version of the product. Links are provided to the documentation of prior versions. 5. Click to access the Tivoli Workload Scheduler Information Center. The Information Center is Eclipse-based, and contains full instructions on how to use it to obtain information and search the publications for specific terms.

Note: If you print PDF publications on other than letter-sized paper, set the option in the File Print window that enables Adobe Reader to print letter-sized pages on your local paper. For all types of information about DB2, go to the DB2 Information Center: http://publib.boulder.ibm.com/infocenter/db2luw/v8//index.jsp For all types of information about the Embedded Version of the WebSphere Application Server version 6.1, go to the WebSphere Application Server Information Center: http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/ index.jsp. Note: The Embedded Version of the WebSphere Application Server version 6.1 is not the same as WebSphere Application Server - Express. It is a runtime version of WebSphere Application Server, version 6.1 which is bundled in and managed by Tivoli Workload Scheduler. For all types of information about the Oracle database, consult the documentation of Oracle Corporation. When this manual was published, the relevant documentation could be found on http://www.oracle.com/technology/ documentation/index.html. Note: This information has been included as a courtesy, and IBM cannot guarantee that this URL will continue to be correct.

About this publication

xiii

Related publications

Tivoli Workload Scheduler online books

All the books in the Tivoli Workload Scheduler for z/OS library are available in displayable softcopy form on CD in the IBM Online Library: z/OS Software Products Collection Kit, SK3T-4270. You can read the softcopy books on CD using these IBM licensed programs: v BookManager READ/2 (program number 5601-454) v BookManager READ/DOS (program number 5601-453) v BookManager READ/6000 (program number 5765-086) All the BookManager programs need a personal computer equipped with a CD drive (capable of reading disks formatted in the ISO 9660 standard) and a matching adapter and cable. For additional hardware and software information, refer to the publications for the specific BookManager product you are using. Updates to books between releases are provided in softcopy only.

Ordering publications
You can order many Tivoli publications online at the following Web site: http://www.elink.ibmlink.ibm.com/public/applications/ publications/cgibin/ pbi.cgi You can also order by telephone by calling one of these numbers: v In the United States: 800-879-2755 v In Canada: 800-426-4968 v In other countries, contact your software account representative to order Tivoli publications. To locate the telephone number of your local representative perform the following steps: 1. Go to the following Web site: http://www.elink.ibmlink.ibm.com/public/applications/ publications/cgibin/pbi.cgi 2. Select your country from the list and click . The IBM Publications Center page is displayed. 3. Click About this site in the main panel to see an information page which includes the telephone number of your local representative.

Accessibility
Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. With this product, you can use assistive technologies to hear and navigate the interface. You can also use the keyboard instead of the mouse to operate all features of the graphical user interface.

xiv

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Training

Tivoli technical training

For Tivoli technical training information, refer to the following IBM Tivoli Education Web site: http://www.ibm.com/software/tivoli/education

Support information
If you have a problem with your IBM software, you want to resolve it quickly. IBM provides the following ways for you to obtain the support you need: v Searching knowledge bases: You can search across a large collection of known problems and workarounds, Technotes, and other information. v Obtaining fixes: You can locate the latest fixes that are already available for your product. v Contacting IBM Software Support: If you still cannot solve your problem, and you need to work with someone from IBM, you can use a variety of ways to contact IBM Software Support. For more information about these three ways of resolving problems, see Appendix C, Support information, on page 185.

Conventions used in this publication

This publication uses several conventions for special terms and actions, operating system-dependent commands and paths, command syntax, and margin graphics.

Typeface conventions
This publication uses the following typeface conventions: Bold v Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text v Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) v Keywords and parameters in text Italic v v v v Words defined in text Emphasis of words (words as words) New terms in text (except in a definition list) Variables and values you must provide

Monospace v Examples and code examples v File names, programming keywords, and other elements that are difficult to distinguish from surrounding text

About this publication

xv

Conventions
v Message text and prompts addressed to the user v Text that the user must type v Values for arguments or command options

Operating system-dependent variables and paths

This publication uses the UNIX convention for specifying environment variables and for directory notation, except where the context or the example path is specifically Windows. When using the Windows command line, replace $variable with % variable% for environment variables and replace each forward slash (/) with a backslash (\) in directory paths. The names of environment variables are not always the same in Windows and UNIX environments. For example, %TEMP% in Windows is equivalent to $tmp in UNIX environments. Note: If you are using the bash shell on a Windows system, you can use the UNIX conventions.

Command syntax
This publication uses the following syntax wherever it describes commands:
Table 1. Command syntax Syntax Description convention Name of command Brackets ([ ]) The first word or set of consecutive characters. The information enclosed in brackets ([ ]) is optional. Anything not enclosed in brackets must be specified. Example conman [-file definition_file]

Braces ({ }) Braces ({ }) identify a set of mutually exclusive options, when one option is required. Underscore An underscore (_) connects multiple (_) words in a variable. Vertical bar Mutually exclusive options are (|) separated by a vertical bar ( | ). You can enter one of the options separated by the vertical bar, but you cannot enter multiple options in a single use of the command. Bold Bold text designates literal information that must be entered on the command line exactly as shown. This applies to command names and non-variable options. Italic text is variable and must be replaced by whatever it represents. In the example to the right, the user would replace file_name with the name of the specific file.

{-prompts | -prompt prompt_name }

prompt_name {-prompts | -prompt prompt_name }

composer add file_name

Italic

file_name

xvi

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Conventions
Table 1. Command syntax (continued) Syntax Description convention Example

Ellipsis (...) An ellipsis (...) indicates that the [x file_name]... previous option can be repeated multiple times with different values. It An ellipsis outside the brackets indicates that x file_name is optional can be used inside or outside of and may be repeated as follows: x brackets. file_name1 x file_name2x file_name3 [x file_name...] An ellipsis inside the brackets indicates that x file_name is optional, and the file variable can be repeated as follows: x file_name1 file_name2 file_name3 x file_name [x file_name]... An ellipsis used with this syntax indicates that you must specify x file_name at least once.

About this publication

xvii

Conventions

xviii

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Chapter 1. Installing
| | | | | | | | | | | | This chapter describes how to install Tivoli Dynamic Workload Console and is divided into the following sections: v Overview v Getting started with the installation on page 2 v Installation prerequisites on page 3 v Runtime requirements on page 8 v Before installing on page 12 v Installing on page 15 v Post-installation steps to connect to Tivoli Workload Scheduler Version 8.3 Fix Pack 3 on page 31 v Accessing the Web console on page 32 v Starting and stopping an application server instance on page 36

Overview
| | | | | | | | | | | The Tivoli Dynamic Workload Console, from now on referred to as Web console, is a Web-based user interface for the following set of products: v Tivoli Workload Scheduler v Tivoli Workload Scheduler for z/OS v Tivoli Workload Scheduler for Applications v Tivoli Dynamic Workload Broker Starting from Version 8.4 the Web console installs also Tivoli Dynamic Workload Broker web user interface. The Tivoli Dynamic Workload Broker is an on-demand scheduling infrastructure providing dynamic management of your environment. It optimizes the use of the IT infrastructure by constantly analyzing your environment to maintain an up-to-date view of the resources available. You can access Tivoli Workload Scheduler and Tivoli Dynamic Workload Broker environments from any location in your network using one of the supported browsers connected to the Web console. The Web console must reside on a system that can reach either the Tivoli Workload Scheduler or the Tivoli Dynamic Workload Broker nodes using network connections. These are the activities that you can perform from the Web console user interface in your production environments: Tivoli Workload Scheduler v Browse and manage scheduling objects involved in current plan activities. v Create and control connections to Tivoli Workload Scheduler engines. v Submit jobs and job streams in production. v Create trial and forecast plans. v Generate workload and statistics reports from historical data stored in the database.

Copyright IBM Corp. 2007

v Perform event correlation and trigger action in response to stated event conditions Tivoli Workload Scheduler for z/OS v Browse and manage scheduling objects involved in current plan activities. v Create and control connections to Tivoli Workload Scheduler engines. v Submit jobs and job streams in production. v Generate workload and statistics reports from historical data stored in the database. Tivoli Workload Scheduler for Applications v Submit SAP jobs and job streams in production. Tivoli Dynamic Workload Broker v Define logical resources. v Edit job definitions. v Submitting and monitoring jobs. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Getting started with the installation

Follow these steps to install, configure, and prepare your Web console for use: 1. Check the installation prerequisites to verify that your system satisfies the installation requirements. For more information, see Installation prerequisites on page 3. 2. Collect the information necessary to fill in the required fields during the installation, as described in Before installing on page 12 3. Choose the installation method that best suits your needs as described in Available installation methods on page 14. 4. Install following the instructions provided in Installing on page 15. 5. Perform the post-installation steps described in Post-installation steps to connect to Tivoli Workload Scheduler Version 8.3 Fix Pack 3 on page 31 if you plan to communicate with the Tivoli Workload Scheduler or Tivoli Workload Scheduler for z/OS connector Version 8.3 Fix Pack3. 6. Log in to the Web console as described in Accessing the Web console on page 32. 7. In the navigation tree on the left, click on Tivoli Workload Scheduler to access the Tivoli Workload Scheduler available functionality, click on Tivoli Dynamic Workload Broker to access the Tivoli Dynamic Workload Broker available functionality. Navigate the tree down these entries, and, if you need help, click on ? on the top right corner of the panel, or Help in the menu of the Integrated Solutions Console panel to access to the online help. The online help that is displayed explains the functionality available in the web condole panel. In the online help panel, if you click on More Information, you get more detailed information. To effectively manage the functions available on the Web console, create engine connections to the Tivoli Workload Scheduler and Tivoli Dynamic Workload Broker environments that you want to manage. Without defining engine connections you can use only a limited set of functions, for more information refer to Managing users and roles on page 37.

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Installation prerequisites

Installation prerequisites
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | You can install the Web console: On the following existing WebSphere Application Server instances: v WebSphere Application Server version 6.1.0.9 v WebSphere Application Server Network Deployment version 6.1.0.9 in the stand-alone application server profile mode. with the following interim fixes installed: v PK53569 v PK47675 v PK48621 v PK46953 only for HP platforms, both for PA-RISC and Intel Itanium v PK51495 v PK50659 The Web console inherits the WebSphere Application Server installation path. To download the packages containing the required APARs, follow these steps: 1. Access the IBM Support and Download link at http://www.ibm.com/ software/support . 2. In the Search within all of IBM Software support pane insert as search term the APAR number, for example PK48621, and click Go. 3. Click Go. The Search result page opens. 4. In the Search results panel click the entry related to the selected APAR, for example
PK48621: ADMINISTRATIVE CONSOLE CAN HANG ON USER LOGOUT IF INVALID SESSION call is made.

The page containing the APAR description opens. 5. In the Problem conclusion section verify which fix pack contains the fix for the APAR, and click on the highlighted link to download it. On its embedded version of WebSphere Application Server version 6.1.0.9 The embedded version of WebSphere Application Server version 6.1.0.9, is available in the Web console installation CD, and it is installed during the Web console installation. During the installation you can choose in which path to install, from now on referred to as tdwc_install_dir, by default the path is: On UNIX: %Program Files%\IBM\TDWC On Windows: /opt/IBM/TDWC Note: You cannot install the Web console on top of an existing embedded version of WebSphere Application Server version 6.1.0.9.

Supported Operating Systems

Table 2 on page 4 lists the supported operating systems, with their hardware and software requirements.
Chapter 1. Installing

Installation prerequisites
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Linux x86

Table 2. Hardware and software requirements for installing the Web console Platform IBM AIX

Asset Processor Memory Operating System

Requirement Power 4 minimum 1.5 GB or more available per processor. Swap space should be double the physical memory. AIX 5L 5.2 with Recommended Maintenance package 5200-07 AIX 5L 5.3 with Service Pack 5300-04-01

Install authority Disk space

Log in as root The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB

Processor Memory Operating System

Intel Pentium processor at 1.0 GHz minimum 1.5 GB or more available per processor. Swap space should be double the physical memory. Red Hat Enterprise Linux AS, Version 4 with Update 2 Red Hat Enterprise Linux ES, Version 4 with Update 2 Red Hat Enterprise Linux, Version 5 with: compat-libstdc++-33-3.2.3-61.i386.rpm to install using the graphical wizard: libXp-1.0.0-8.i386.rpm SUSE Linux Enterprise Server, Version 9 with SP 2 or 3 SUSE Linux Enterprise Server, Version 10

Install authority Disk space

Log in as root The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Installation prerequisites
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Linux on POWER Table 2. Hardware and software requirements for installing the Web console (continued) Platform Asset Requirement AMD Opteron and Intel EM64T 1.5 GB or more available per processor. Swap space should be double the physical memory. Red Hat Enterprise Linux AS, Version 4 with Update 2 with: compat-libstdc++-33-3.2.3-47.3.x86_64.rpm Red Hat Enterprise Linux ES, Version 4 with Update 2 with: compat-libstdc++-33-3.2.3-47.3.x86_64.rpm Red Hat Enterprise Linux, Version 5 with: compat-libstdc++-33-3.2.3-61.i386.rpm to install using the graphical wizard: libXp-1.0.0-8.i386.rpm libXmu-1.0.2-5.i386.rpm Use the image contained in the CD: IBM Tivoli Dynamic Workload Console 8.4 for Linux on x86 SUSE Linux Enterprise Server, Version 9 with SP 2 or 3 SUSE Linux Enterprise Server, Version 10 Install authority Disk space Log in as root The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB Processor System i models that support logical partitioning (LPAR) with minimum of 450 commercial processing workload (CPW) in the Linux partition. 1.5 GB or more available per processor. Swap space should be double the physical memory. Red Hat Enterprise Linux AS, Version 4 with Update 2 with: compat-libstdc++-33-3.2.3-47.3.ppc.rpm Red Hat Enterprise Linux AS, Version 5 with: compat-libstdc++-33-3.2.3-61.ppc.rpm to install using the graphical wizard: libXp-1.0.0-8.ppc.rpm SUSE Linux Enterprise Server, Version 9 with SP 2 or 3 SUSE Linux Enterprise Server, Version 10 Install authority Disk space Log in as root The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB

Linux x86-64 Processor Memory Operating System

Memory Operating System

Chapter 1. Installing

Installation prerequisites
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Microsoft Windows (64-bit) Microsoft Windows (32-bit) Table 2. Hardware and software requirements for installing the Web console (continued) Platform Linux on IBM System z Asset Processor Memory Operating System Requirement System z 1.5 GB available recommended. Swap space should be double the physical memory. Red Hat Enterprise Linux AS, Version 4 with Update 2 (64 bit kernel support only) with: compat-libstdc++-33-3.2.3-47.3.s390.rpm Red Hat Enterprise Linux AS, Version 5 (64 bit kernel support only) with: compat-libstdc++-33-3.2.3-61.s390.rpm to install using the graphical wizard: libXp-1.0.0-8.s390.rpm SUSE Linux Enterprise Server, Version 9 with SP 2 or 3 (64 bit kernel support only) SUSE Linux Enterprise Server, Version 10 (64 bit kernel support only) Install authority Disk space Log in as root The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB Processor Memory Operating System Intel Pentium processor at 1.0 GHz minimum 1.5 GB or more available per processor. Microsoft Windows Server 2003, Standard with SP1 Microsoft Windows Server 2003, Enterprise with SP1 Microsoft Windows Server 2003, DataCenter with SP1 Install authority Disk space Log in as Administrator The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB Processor Memory Operating System Install authority Disk space AMD Opteron or Intel EM64T 1.5 GB or more available per processor. Microsoft Windows Server 2003 x64 Editions Log in as Administrator The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Installation prerequisites
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
HP-UX Intel Itanium HP-UX PA-RISC Solaris x64 Table 2. Hardware and software requirements for installing the Web console (continued) Platform Solaris SPARC Asset Processor Memory Operating System Requirement Power 4 minimum 1.5 GB or more available per processor. Swap space should be double the physical memory. Sun Solaris operating environment, Version 9 with the latest Patch Cluster Sun Solaris operating environment, Version 10 with the latest Patch Cluster Install authority Disk space Log in as root The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB Processor Memory Operating System Install authority Disk space AMD Opteron 1.5 GB or more available per processor. Swap space should be double the physical memory. Sun Solaris operating environment, Version 10 with the latest Patch Cluster Log in as root The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB Processor Memory Operating System PA_RISC 1.5 GB or more available per processor. Swap space should be double the physical memory. HP-UX 11iv2 (11.23) with Standard Patch Bundles of March 2006 and Sep 2004 Bundle 11i HP-UX 11iv3 (11.31) Install authority Disk space Log in as root The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB Processor Memory Operating System Intel Itanium 2 1.5 GB or more available per processor. Swap space should be double the physical memory. HP-UX 11iv2 (11.23) with Standard Patch Bundles of March 2006 and Sep 2004 Bundle 11i + Java patches PHCO_30476 and PHSS_34201 HP-UX 11iv3 (11.31) Install authority Disk space Log in as root The following disk space must be available before proceeding with the installation: v tdwc_install_dir: 900 MB v temporary directory: 350 MB
Chapter 1. Installing

Installation prerequisites
| | | | Notes: 1. The WebSphere Application Server installation uses, as temporary directory, the directory specified in the environment variables (%TEMP% for Windows, $TEMP for UNIX). If not specified, the default setting for that operating system is used. 2. For the latest information about required hardware platforms and operating systems refer to the download document available at the following link: http:/www.ibm.com/support/docview.wss?rs=672&uid=swg24013916

Additional prerequisites for using the launchpad

If you plan to run the installation using the launchpad, you need to have one of the following browsers installed: v Mozilla Version 1.7, or later v FireFox Version 1.0, or later v Microsoft Internet Explorer (only for Microsoft Windows operating systems) Version 5.5, or later Notes: 1. On UNIX and Linux operating systems make sure you export the browser location to the BROWSER environment variable. 2. Multiple concurrent accesses from the same system using FireFox are not supported.

| | | | |

Runtime requirements
This section contains the information about what is required to have a supported working environment. It is divided in the following topics: v System runtime requirements v Supported client browsers v Tivoli Workload Scheduler supported engines on page 9 v Tivoli Dynamic Workload Broker supported servers on page 12 | | | | | | | | | | | |

System runtime requirements

When performing capacity planning on the system where Web console is installed, consider also that additional disk space is used at run time to manage the data displayed in the browse task result table. This additional space depends on: v The number of objects to be displayed. v The number of queries to be run concurrently. v The number of users logged in to the Web console. As an average, one object displayed as the result of one query run by one user, requires 5 KB disk space available in the tdwc_install_dir/AppServer profile directory. This disk space is then released when the panel showing the browse task result is closed.

Supported client browsers

| You must use one of the following client browsers to access from the systems across your network, the machine where you installed the Web console: v Microsoft Internet Explorer Version 6.0 SP2 or higher.

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Supported client browsers

v Microsoft Internet Explorer Version 7.0 v FireFox Version 2.0

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Tivoli Workload Scheduler supported engines

The Web console supports any of these Tivoli Workload Scheduler distributed configurations: Tivoli Workload Scheduler, Version 8.4 All new functions available on the Web console are accessible. Tivoli Workload Scheduler, Version 8.3 Fix Pack 3 All Tivoli Workload Scheduler, Version 8.3 Fix Pack 3 functions available on the Web console are accessible. Reporting and event management capabilities are not available in this configuration. Note: If you plan to communicate from the Web console version 8.4 to Tivoli Workload Scheduler, Version 8.3 Fix Pack 3 through a firewall, you must install an interim fix on top of Tivoli Workload Scheduler, Version 8.3 Fix Pack 3. For more information, contact IBM Software Support as described in Appendix C, Support information, on page 185. These configurations require that the Tivoli Workload Scheduler connector installed on the engine where you want to connect from the Web console. By default it is installed on the master domain manager. Optionally you can install it on another workstation in the scheduling environments. For information about installing Tivoli Workload Scheduler connector, refer to IBM Tivoli Workload Scheduler Planning and Installation Guide. The Web console supports any of these Tivoli Workload Scheduler for z/OS controller configurations: Tivoli Workload Scheduler for z/OS, Version 8.3 with APAR PK46302 (Virtual Workstations), and PK41519 (Reporting) All new Tivoli Workload Scheduler for z/OS functions available on the Web console are accessible. Tivoli Workload Scheduler for z/OS Version 8.3 and PK41611 cumulative APAR All Tivoli Workload Scheduler for z/OS Version 8.3 functions available on the Web console are accessible. Reporting capabilities and virtual workstations support are not available in this configuration. Tivoli Workload Scheduler for z/OS, Version 8.2 and PK33565 cumulative APAR All Tivoli Workload Scheduler for z/OS Version 8.2 functions available on the Web console are accessible. Reporting capabilities and virtual workstations support are not available in this configuration. These configurations require Tivoli Workload Scheduler z/OS connector Version 8.3 Fix Pack 3 installed on a distributed system in your Tivoli Workload Scheduler distributed environment. Installing Tivoli Workload Scheduler z/OS connector on page 10 explains how to install the Tivoli Workload Scheduler z/OS connector. Note: You must restart the Web console immediately after installation before connecting to either Tivoli Workload Scheduler Version 8.3 Fix Pack 3, or Tivoli Workload Scheduler z/OS connector Version 8.3 Fix Pack 3 engines.

Chapter 1. Installing

Tivoli Workload Scheduler supported engines

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Installing Tivoli Workload Scheduler z/OS connector

Tivoli Workload Scheduler z/OS connector Version 8.3 Fix Pack 3 must be installed as an upgrade on top of Tivoli Workload Scheduler z/OS connector Version 8.3 Fix Pack 2. Follow this procedure to install and make operational the Tivoli Workload Scheduler z/OS connector in your environment: 1. Before installing the Tivoli Workload Scheduler z/OS connector, set up your environment as follows: a. Set up and start the Tivoli Workload Scheduler for z/OS server, which is the server address space that runs on z/OS and communicates with the Tivoli Workload Scheduler z/OS connector installed on the distributed system. b. Modify the SERVER member in the TWS.INSTPARM data set. For example:
SYS1.COMPLEX.TWS.INSTPARM(SERVER) SERVOPTS SUBSYS PROTOCOL ARM USERMAP PORTNUMBER ( ( ( ( ( TWS ) JSC ) YES ) USERMAP ) 445 )

2. Download the Tivoli Workload Scheduler z/OS connector Version 8.3 Fix Pack 2 and Fix Pack 3 from the IBM Software Support Web site at the following link http://www.ibm.com/software/support. Follow the steps listed in Receiving weekly support updates on page 187 to download the software packages. 3. Install the Tivoli Workload Scheduler z/OS connector Version 8.3 Fix Pack 2 as follows: a. Navigate to the operating system directory. b. Run the setup according to the operating system where you are installing: On Windows: setup.exe On UNIX setup.bin Select the language for the installation wizard, and click OK. In the welcome panel click Next to proceed. The procedure checks that you have the necessary rights to perform the installation, and that no previous installations of embedded version of WebSphere Application Server and connectors exist. Accept the license agreement and click Next, or click Cancel to exit. Specify the user name and password of the TWS_user for which you are installing the connector. Click Next. Specify the installation directory for Tivoli Workload Scheduler z/OS connector. Specify the following port numbers: HTTP Transport It is the HTTP port used by the Tivoli Workload Scheduler composer command line. The default value is 31125. HTTPS Transport It is the HTTPS port used by the Tivoli Workload Scheduler composer command line. The default value is 31126.

c. d.

e. f. g. h.

10

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Tivoli Workload Scheduler supported engines

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Bootstrap/RMI It is the port used when bootstrap or RMI protocol is selected. The default value is 31127. SOAP Connector It is the SOAP port used by the Web console to communicate. The default value is 31128. Use the defaults unless you are sure those port numbers are already in use. Click Next. i. Configure the Tivoli Workload Scheduler z/OS connector connection setting by specifying: Tivoli Workload Scheduler for z/OS Engine Name Use the name of the controller agent as the new instance name. Tivoli Workload Scheduler for z/OS Remote Host The IP address or host name of the remote z/OS system where the controller is installed. Tivoli Workload Scheduler for z/OS Remote TCP/IP Port The TCP/IP port number of the remote z/OS system. Click Next. j. Review the installation settings and click Next to start the installation. When the installation completes, a panel displays a successful installation message or contains a list of the items that failed to install and the location of the log file. k. Click Finish. You might decide to install Tivoli Workload Scheduler z/OS Connector in background using a silent installation. If so, follow these steps to perform the silent installation: a. Make a backup copy of the response file provided for the platform where you are going to install. b. Customize the response file, if needed, to fit with your environment. The following options are available in the response file: v Embedded Version of WebSphere Application Server installation location v Connector instance creation c. Navigate to the directory where the installation setup file is stored and run the installation command as follows: On Windows:
setup.exe -silent -options filename

On UNIX:
./setup.bin -silent -options filename

specifying as filename the fully qualified path to the customized response file. Note: The silent installation parameters are described in detail as comments in the response file. 4. After installing the Tivoli Workload Scheduler z/OS connector Version 8.3 Fix Pack 2, edit the user-mapping used by the Tivoli Workload Scheduler for z/OS server stored in member USERMAP. For example:

Chapter 1. Installing

11

Tivoli Workload Scheduler supported engines

| | | | | | | | | | | | | | | | | | | | | | | | | |
SYS1.COMPLEX.TWS.INSTPARM(USERMAP) USER [email protected] RACFUSER(zosuser)

where: userid Is the user ID specified during the Tivoli Workload Scheduler z/OS connector installation. Hostname.domain Is the value specified in the file named TWSConfig.properties stored in the following directory [connector_home]/[userid]/appserver/ profiles/twszconnprofile/properties. zosuser Is an existing z/OS user defined in RACF. 5. On the system where the Tivoli Workload Scheduler z/OS connector is installed, under the installation path in the wastools directory, run the following command:
webui -operation enable -user userid -password password -port port [-server ServerName]

where port is the SOAP port of the WebSphere Application Server. This is a mandatory setting when using the enable flag. Its default values are 31118 for distributed environments and 31128 for z/OS environments. 6. Stop and then start the WebSphere Application Server. 7. Upgrade the Tivoli Workload Scheduler z/OS connector Version 8.3. to Fix Pack 3.

Tivoli Dynamic Workload Broker supported servers

The Web console works with Tivoli Dynamic Workload Broker Version 1.2 servers.

Before installing
This section helps you to quickly choose how to install the Web console in your environment. It is divided into the following topics: v Supported installation scenarios v Available installation methods on page 14 v Installation media on page 14

Supported installation scenarios

The installation procedure and the components installed for the Web console might differ according to whether or not you plan to install on an existing WebSphere Application Server version 6.1.0.9 instance. | | | | | | Table 3 lists these different scenarios:
Table 3. Components installed during the Web console installation If you select to ... Install on a system where the Integrated Solutions Console Advanced Edition version 7.1 is installed. The following components are installed... Tivoli Dynamic Workload Console version 8.4

12

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Supported installation scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Install on a system where either WebSphere Application Server version 6.1.0.9 or WebSphere Application Server Network Deployment version 6.1.0.9 is already installed. Install on a system where WebSphere Application Server version 6.1.0.9 is already installed , but you do not want to integrate the two environments. Table 3. Components installed during the Web console installation (continued) If you select to ... The following components are installed...

Install on a system where no instance of Integrated Solutions Console Advanced WebSphere Application Server version 6.1.0.9 Edition version 7.1 is installed. Embedded Version of the WebSphere Application Server version 6.1.0.9 Tivoli Dynamic Workload Console version 8.4 Integrated Solutions Console Advanced Edition version 7.1 Embedded Version of the WebSphere Application Server version 6.1.0.9 Tivoli Dynamic Workload Console version 8.4 Integrated Solutions Console Advanced Edition version 7.1 Tivoli Dynamic Workload Console version 8.4

Notes: 1. If you plan to install the Integrated Solutions Console Advanced Edition version 7.1 on an external WebSphere Application Server, before starting the installation, make sure that all servers are stopped except for the server associated to the profile where you plan to install, which must be active. 2. If you plan to install the Web console on an external WebSphere Application Server where the Integrated Solutions Console Advanced Edition version 7.1 is already installed, make sure that the server associated to the profile where you plan to install is active before starting the installation. You can install Tivoli Dynamic Workload Console version 8.4 on a system where a Tivoli Dynamic Workload Console version 8.3 instance is installed. This is because instances of Tivoli Dynamic Workload Console with different versions have different sets of configuration files. You cannot install more than one instance of Tivoli Dynamic Workload Console version 8.4 on the same system. By default the Tivoli Workload Scheduler installed on its embedded version of WebSphere Application Server using the server name server1. If you plan to install on an external WebSphere Application Server on a system where Tivoli Workload Scheduler is installed, before installing the Web console, create a new profile with a server name different from server1, and use this profile during the installation, as explained in Installing on an existing WebSphere Application Server instance on page 21. This is a sample command to create a new profile referring to a new server name on WebSphere Application Server:
installation_directory/AppServer/bin/manageprofiles.sh -create -profileName "new_profile" -hostName "hostname" -nodeName "node_name" -cellName "cell_name" -serverName new_server_name -adminUserName administrator
Chapter 1. Installing

13

Supported installation scenarios

| | | | |
-adminPassword administrator_password -enableAdminSecurity true -templatePath "installation_directory/AppServer/profileTemplates/default"

Note: You must restart the Web console immediately after the installation if you plan to connect to Internet Protocol version 6 (IPv6) enabled engines. For more information about installation options refer to Installing on page 15.

Available installation methods

You can install the Web console using one of the following methods: Graphical wizard You access the graphical user interface of the InstallShield for Multiplatforms (ISMP) wizard by invoking a setup command and entering the configuration settings to install and configure your installation. Using this method you can synchronously monitor the installation processing and results. For more information, see Installing using the graphical wizard on page 17. | | | | | | Silent mode You customize a response file by adding all configuration settings to be used during installation, and then invoke from the command line the setup command using the -silent keyword. Using this method you can run the installation unattended and in the background. For more information, see Installing in silent mode on page 23. Launchpad You run the launchpad which, in turn, invokes the setup command to perform the installation in interactive mode. Using this method, the launchpad guides you through a set of panels where you become familiar with the product documentation and with the information you need to provide during the installation itself. The use of the launchpad adds some prerequisites as described in Additional prerequisites for using the launchpad on page 8. For more information about how to install using the launchpad, see Starting the installation using the launchpad on page 16. | | | | | | | | | | | | |

Installation media
The Web console is packaged into 11 CDs, one for each of the supported platforms. Each CD contains, for that platform, the: v Installable image v Setup file v Sample response files v Launchpad Table 4 lists, for each supported platform, the label of the CD containing the installable image, and the path on the CD to the setup file:
Table 4. Labels of the CDs containing the Web console installable images Supported Platform IBM AIX CD Label Setup file path

IBM Tivoli Dynamic Workload WEBUI/AIX/setup.bin Console 8.4 for AIX (LCD7-1398-00)

14

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Installation media
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 4. Labels of the CDs containing the Web console installable images (continued) Supported Platform Microsoft Windows (32-bit operating-system support) Microsoft Windows (64-bit operating-system support) Linux x86 CD Label IBM Tivoli Dynamic Workload Console 8.4 for Windows (LCD7-1401-00) IBM Tivoli Dynamic Workload Console 8.4 for Windows x64 (LCD7-1407-00) IBM Tivoli Dynamic Workload Console 8.4 for Linux on x86 (LCD7-1402-00) IBM Tivoli Dynamic Workload Console 8.4 for Linux on x86-64 (LCD7-1406-00) IBM Tivoli Dynamic Workload Console 8.4 for Linux on System z9 and zSeries (LCD7-1404-00) IBM Tivoli Dynamic Workload Console 8.4 for Linux on POWER (LCD7-1403-00) IBM Tivoli Dynamic Workload Console 8.4 for Solaris x64 (LCD7-1405-00) IBM Tivoli Dynamic Workload Console 8.4 Solaris SPARC (LCD7-1400-00) Setup file path WEBUI\WINDOWS\ setup.exe

WEBUI\WINDOWS_X64\ setup.exe

WEBUI/LINUX/setup.bin

Linux x86-64

WEBUI/LINUX_X64/ setup.bin WEBUI/LINUX390/ setup.bin WEBUI/LINUXPPC/ setup.bin WEBUI/SOLARIS_X64/ setup.bin WEBUI/SOLARIS/setup.bin

Linux on IBM System z Linux on POWER

Solaris x64

Solaris SPARC

HP-UX on PA-RISC

IBM Tivoli Dynamic Workload WEBUI/HPUX/setup.bin Console 8.4 for HP-UX on PA-RISC (LCD7-1399-00) IBM Tivoli Dynamic Workload Console 8.4 for HP-UX on Itanium (LCD7-1945-00) WEBUI\HPIA64\setup.bin

HP-UX on Intel Itanium

Notes: 1. If you copy or mount the CD to a system directory, make sure that the path name to that directory does not contain the following unsupported characters: { } [ ] < > $ | ? ! # * + " / % or non US-ASCII characters. 2. If you plan to install on a Windows system from a mapped remote drive, make sure you map the remote folder locally on the system where you want to install, and then run the installation using the local path. 3. If you plan to install on Linux, make sure that the files contained in the mounted image have executable permission, and that the setup.bin file is not located in a path with blanks.

Installing
This section explains how to install the Web console using the available installation methods. It is divided into the following topics: v Starting the installation using the launchpad on page 16 v Installing using the graphical wizard on page 17
Chapter 1. Installing

15

Installation media
v Installing in silent mode on page 23

Starting the installation using the launchpad

Use the launchpad if you want to be guided through a set of panels that helps you become familiar with the product documentation. From this user interface you can access the following sources of information: v IBM Tivoli Dynamic Workload Console Download Documents v IBM Tivoli Information Center v IBM Publications Center v IBM Tivoli Dynamic Workload Console Installation and Troubleshooting Guide The use of the launchpad adds some installation prerequisites to the normal set. For more information, refer to Additional prerequisites for using the launchpad on page 8. The general procedure for starting the launchpad installation program is as follows: 1. Insert the CD containing the installation image for the required platform into the CD drive. 2. Start the launchpad as follows: For Windows The launchpad starts automatically. If not, from the root directory of the CD, run the launchpad.exe file. For UNIX From the root directory of the CD, run the launchpad.exe file. The launchpad opens:

3. Navigate the documentation and, when ready, click on Install IBM Tivoli Dynamic Workload Console in the left pane.

16

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Installing using the launchpad

4. Click on Install the IBM Tivoli Dynamic Workload Console, to start the installation process. For more information about how to continue the installation, refer to Installing using the graphical wizard.

Installing using the graphical wizard

| | | | | | | | Follow these steps to install the Web console using the installation wizard: 1. Move to the directory where the setup file is located, and start the installation by running:
setup.bin

Refer to Table 4 on page 14 to see the path to the setup file. The installation wizard first checks if there is enough free space available in the Java temporary directory. If not, the installation exits, and you must increase the size of the Java temporary directory, as described in System runtime requirements on page 8, before rerunning the installation wizard. 2. Select the language to use while installing the Web console, and click OK. In the welcome window click Next to continue with the installation. 3. The license agreement window is displayed. Read the license agreement and then select: I accept both the IBM and the non-IBM terms To continue with the installation. I do not accept the terms in the license agreement To exit installation. 4. In the following window:

select the WebSphere Application Server instance where you want to install the Web console. v If you choose to install a new instance of embedded version of WebSphere Application Server, follow the instruction in Installing on a new instance of embedded version of WebSphere Application Server on page 18.

Chapter 1. Installing

17

Installing using the graphical wizard

v If you choose to install on top of an existing WebSphere Application Server, follow the instruction in Installing on an existing WebSphere Application Server instance on page 21. For a list of supported WebSphere Application Servers, refer to Supported installation scenarios on page 12.

Installing on a new instance of embedded version of WebSphere Application Server

Follow these steps if you selected to install the embedded version of WebSphere Application Server and the Web console: 1. Choose the path where you want to install, from now on referred to as tdwc_install_dir, or accept the default path, and click Next to proceed. To prevent the installation from failing, make sure that the installation path is less than 33 characters long and that it does not contain the following special characters: Windows - () / % * ! ? ( ) # + < > | [ ] $ { } UNIX space character and - \ : = ~ * ! ? ( ) # + < > | [ ] $ { } 2. In the following window, select the installation type you prefer.

Choose: Default Installation If you want to use the default WebSphere Application Server settings. If so, refer to Default installation. or: Advanced Installation If you want to customize the WebSphere Application Server settings. If so, refer to Advanced installation on page 19. Default installation: Follow these steps to proceed with a Default installation: 1. Specify the User Name and Password of the WebSphere Application Server user that you want to become the Web console administrator, by default the User Name is wasadmin.

18

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Default installation
The User Name must be unique, 3 to 60 characters in length, and contain only the characters a-z, A-Z, 0-9, period (.), hyphen (-), underscore (_), and double-byte character set (DBCS) characters. The password must be 5 to 16 characters in length and contain only the characters a-z, A-Z, 0-9, period (.), hyphen (-), and underscore (_). Confirm the password, and click Next to continue. 2. In the next window:

select if you want the administrator to access to Tivoli Workload Scheduler Web console, to the Tivoli Dynamic Workload Broker Web console, or to both of them, then click Next. Note: If you select to access one of the two available Web user interfaces, after having installed you can authorize the user to access to the other user interface by assigning him one of the predefined roles created by the installation process. For more information, refer to Managing users and roles on page 37. 3. Check that the values displayed in the installation summary window are correct and click Install to start the installation. While the installation is in progress, you can stop it at any time by clicking Cancel. If you do, the currently processing installation step completes, and you are asked if you want to cancel the current installation. If you choose Yes, the installation is cancelled and a summary window is displayed showing the reason for the cancellation. 4. When the installation completes successfully, a window opens showing the links to access the web user interface on the Integrated Solutions Console portal, for more information refer to Accessing the Web console on page 32. If the installation fails the window contains the list of the items that failed to install and the location of the log file. 5. Click Finish to close the installer. Advanced installation: Follow these steps to proceed with an advanced installation:

Chapter 1. Installing

19

Advanced installation
1. In the next windows specify the port numbers you want to use for the WebSphere Application Server or accept the default values. Click Next to move to the next screen. These are the port numbers to specify: HTTP Transport Port The number of the port that the WebSphere Application Server uses for HTTP transport. Administrative Console Port The HTTP Administrative Console port on the WebSphere Application Server. HTTPS Transport Port The number of the port that the WebSphere Application Server uses for secure HTTP transport (HTTPS). Administrative Console Secure Port The HTTP Administrative Console secure port on the WebSphere Application Server. Bootstrap Port The port number for the bootstrap function. SOAP Connector Port The port number for the Simple Object Access Protocol (SOAP) connector on the WebSphere Application Server. ORB Listener Port The ORB Listener Port number on the WebSphere Application Server. SAS SSLPort The SAS SSL ServerAuth Listener Port number on the Embedded WebSphere Application Server. CSIV2 Server Authentication Port The CSIV2 SSL ServerAuth Listener Port number on the Embedded WebSphere Application Server. CSIV2 Client Authentication Port The CSIV2 SSL ClientAuth Listener Port number on the Embedded WebSphere Application Server. High Availability Manager Communication Port The High Availability Manager Communication port number for the Embedded WebSphere Application Server. Service Integration Port The Service Integration Port number for the Embedded WebSphere Application Server. Service Integration Secure Port The Service Integration Secure Port number for the Embedded WebSphere Application Server. MQ Transport Port The MQ Transport Port number for the Embedded WebSphere Application Server. MQ Transport Secure Port The MQ Transport Secure Port number for the Embedded WebSphere Application Server.

20

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Advanced installation
SIP Container Port The Session Initiation Protocol (SIP) Port number for the Embedded WebSphere Application Server. SIP Container Secure Port The Session Initiation Protocol (SIP) Secure Port number for the Embedded WebSphere Application Server. Click Next to continue. 2. If you are running the installation on a Windows system, select if you want to run the application server as a service, specifying a service ID, by default TDWC, and a name for the service, by default IBM WebSphere Application Server V6.1 - TDWC. 3. Complete the installation running the steps described in Default installation on page 18.

Installing on an existing WebSphere Application Server instance

Follow these steps if you selected to install the Web console on top of an existing WebSphere Application Server instance: 1. Select the existing WebSphere Application Server instance where you want to install the Web console by specifying the following values:

| | | | | | | | | | | |

Profile Name The name of the WebSphere Application Server profile defining the Web console runtime environment. Make sure the profile selected has: v The administrative console installed. You can install it also after having created the profile. v The administrative security enabled Server Name The name of the server specified in the profile to be used by the Web console. Note: WebSphere Application Server requires that the host name and server name pair used in a clustered environment must be unique. Because server1 is the hardcoded server name used by
Chapter 1. Installing

21

Advanced installation
| | | Tivoli Workload Scheduler, specify a server name different from that if you install the Web console on the same system where the Tivoli Workload Scheduler connector is installed. Cell Name The name of the group of one or more nodes in a WebSphere Application Server distributed network that the node belongs to. Node Name The unique WebSphere Application Server-specific name that identifies the system where you want to install. 2. Locate the path where the UpdateInstaller wizard is stored. This is a wizard invoked by WebSphere Application Server to install updates. 3. Specify the user ID and password of an existing WebSphere Application Server user that you want to become the Web console administrator, by default the user ID is wasadmin. 4. In the next window:

| | | | | | |

| | | | | | | | | | | | | | | |

Select if you want the administrator to access the Tivoli Workload Scheduler Web console, to the Tivoli Dynamic Workload Broker Web console, or both then click Next. Note: If you select to access one of the two available web user interfaces, after installing you can authorize the user to access the other user interface by assigning him one of the predefined roles created by the installation process. For more information, refer to Managing users and roles on page 37. 5. Check that the values displayed in the installation summary window are correct and click Install to start the installation. While the installation is in progress, you can stop it at any time by clicking Cancel. If you do, the currently processing installation step completes, and you are asked if you want to cancel the current installation. If you choose Yes, the installation is canceled and a summary window is displayed showing the reason for the cancellation. 6. When the installation completes successfully, a window opens showing the links to access the web user interface on the Integrated Solutions Console

22

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Advanced installation
portal. For more information refer to Accessing the Web console on page 32. If the installation fails the window contains a list of the items that failed to install and the location of the log file. 7. Click Finish to close the installer.

Installing in silent mode

You can run the installation in unattended mode from the command line by adding the -silent parameter when running the setup installation file. For the installation to work, you must specify all the settings that are usually prompted when installing using the installation wizard. The installation settings are provided using a response file. Refer to Sample response file for installation on page 29 for an example of a response file. There is a sample response file named tdwc.rsp on the product installation CD, in the directory:
.\WEBUI\OperatingSystem\ResponseFiles

| | | | | |

To install in silent mode, perform these steps on the machine on which you want to install the Web console: 1. Copy locally in a temporary directory the sample response file for that operating system. 2. Customize the options contained in the response file to suit your requirements and environment. For information on the available options, refer to Table 5 on page 24. For a list of supported Web console installation scenarios, refer to Table 3 on page 12. 3. Run the following command: On Windows:
setup.exe -silent -options response_file_name

On UNIX:
./setup.bin -silent -options response_file_name

where response_file_name is the fully qualified path name. 4. Check the result of the silent installation as follows: On Windows: The installation command is asynchronous, this means that when it is issued it spawns an installation procedure and then ends without returning any value or message. To have a clear statement on whether or not the silent installation ran successfully, refer to the installation result reported in the tdwcinstall.log installation log file stored in the temporary directory. On UNIX: The installation command is synchronous and it returns 0 if the installation ran successfully, a nonzero value if the installation failed. Note: In any case, for information about the installation result, refer to the tdwcinstall.log installation log file stored in the temporary directory. Table 5 on page 24 shows a list of the supported variables, together with a short description.

Chapter 1. Installing

23

Installing in silent mode

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 5. Silent installation configuration variables Variable licenseAccepted Description Set to false to skip the installation and exit, set to true to accept the license agreement and continue. Default value false Validation rules Mandatory

Must be true or false. Yes

INSTALL_METHOD

The installation NEW could install a new stand-alone WebSphere Application Server, or use an already installed WebSphere Application Server.

Must be one of these v NEW Installs a new embedded instance of embedded version of WebSphere Application Server 6.1 v ONWAS Installs on an existing installation of WebSphere Application Server V6.1

Yes

24

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Installing in silent mode

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
ISC_ADMIN_USER WebSphere Application Server admin user. wasadmin Table 5. Silent installation configuration variables (continued) Variable IS_DESTINATION Description Installation directory of the product Default value Windows: C:\Program Files\IBM\TDWC Validation rules 1. Supplied string must have a length of 1-32. 2. Cannot be read only 3. Must be in the appropriate format for a directory 4. Must not contain any incorrect characters for a directory name. 5. On Linux platforms, make sure that the WebUI.war file of the installation bundle is not located in a path whose name contains blanks. 6. Must not contain space characters on UNIX and Linux platforms. 7. Cannot contain any of the following characters: UNIX -\:=~* !?()# +<>|[] ${} Mandatory For NEW installation type only.

UNIX: /opt/IBM/TDWC

Windows /%*!?( )#+< >|[]${} User name length must Yes be in the range 3-60. User name can contain the following characters: a-z, A-Z, 0-9, period (.), hyphen (-), underscore ( _ ) and DBCS characters. Password length must be in the range 5-60. Password can contain the following characters: a-z, A-Z, 0-9, period (.), hyphen (-), and underscore (_). Yes

ISC_ADMIN_PASSWORD

WebSphere wasadmin Application Serve admin user's password.

Chapter 1. Installing

25

Installing in silent mode

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 5. Silent installation configuration variables (continued) Variable ISC_APPSERVER_DIR Description Fully qualified path for the WebSphere Application Server directory. WebSphere Application Server profile name. Default value The path name of the WebSphere Application Server. The name of the WebSphere Application Server profile defining the runtime environment. The name of the server specified in the profile to be used by Web console. The name of the group of one or more nodes in a WebSphere Application Server distributed network that the Node belongs to. The unique WebSphere Application Server-specific name that identifies the system where you want to install. The path where the UpdateInstaller is located. Validation rules Mandatory For ONWAS installation type only

WAS_PROFILE_NAME

For ONWAS installation type only

WAS_SERVER_NAME

WebSphere Application Server server name. WebSphere Application Server cell name.

For ONWAS installation type only

WAS_CELL_NAME

For ONWAS installation type only

WAS_NODE_NAME

WebSphere Application Server node name.

For ONWAS installation type only

UPDATE_INSTALLER_DIR

Fully qualified path for the WebSphere Application Server UpdateInstaller. The port number used to connect using HTTP to Tivoli Workload Scheduler web user interface.

For ONWAS installation type only

WC_adminhost

29060

For NEW installation type only

26

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Installing in silent mode

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 5. Silent installation configuration variables (continued) Variable WC_adminhost_secure Description The port number used to connect using secure HTTP (HTTPS) to Tivoli Workload Scheduler web user interface. Default value 29043 Validation rules Mandatory For NEW installation type only

WC_defaulthost

The number of 29080 the port that the WebSphere Application Server uses for HTTP transport. The number of 29443 the port that the WebSphere Application Server uses for secure HTTP transport (HTTPS). The port 22809 number for the bootstrap function for the Java Remote Method Invocation (RMI) connector. The Simple 28880 Object Access Protocol (SOAP) connector Port number. The SAS SSL ServerAuth Listener Port number. 29401

For NEW installation type only

WC_defaulthost_secure

For NEW installation type only

BOOTSTRAP_ADDRESS

For NEW installation type only

SOAP_CONNECTOR_ADDRESS

For NEW installation type only

SAS_SSL_SERVERAUTH_LISTENER_ADDRESS

For NEW installation type only For NEW installation type only For NEW installation type only For NEW installation type only

CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS The CSIV2 SSL ServerAuth Listener Port number. CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS The CSIV2 SSL MutualAuth Listener Port number. ORB_LISTENER_ADDRESS The ORB Listener Port number on the Embedded WebSphere Application Server.

29403

29402

29100

Chapter 1. Installing

27

Installing in silent mode

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 5. Silent installation configuration variables (continued) Variable DCS_UNICAST_ADDRESS Description The High Availability Manager Communication port number for the Embedded WebSphere Application Server. The Service Integration Port number for the Embedded WebSphere Application Server. The Service Integration Secure Port number for the Embedded WebSphere Application Server. The MQ Transport Port number for the Embedded WebSphere Application Server. Default value 29353 Validation rules Mandatory For NEW installation type only

SIB_ENDPOINT_ADDRESS

27276

For NEW installation type only

SIB_ENDPOINT_SECURE_ADDRESS

27286

For NEW installation type only

SIB_MQ_ENDPOINT_ADDRESS

25558

For NEW installation type only

SIB_MQ_ENDPOINT_SECURE_ADDRESS

The MQ 25578 Transport Secure Port number for the Embedded WebSphere Application Server. The Session Initiation Protocol (SIP) Port number for the Embedded WebSphere Application Server. The Session Initiation Protocol (SIP) Secure Port number for the Embedded WebSphere Application Server. 25060

For NEW installation type only

SIP_DEFAULTHOST

For NEW installation type only

SIP_DEFAULTHOST_SECURE

25061

For NEW installation type only

28

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Installing in silent mode

| | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 5. Silent installation configuration variables (continued) Variable ENABLE_TWS Description Specifies if the Tivoli Workload Scheduler web user interface has to be installed. Default value true Validation rules Mandatory

Must be true or false. Yes

ENABLE_TDWB

Specifies if the true Tivoli Dynamic Workload Broker Web console has to be installed. Specifies to start true the WebSphere Application Server automatically at system boot. The identifier TDWC assigned to the Windows service that starts WebSphere Application Server.

Must be true or false. Yes

CREATE_WAS_SERVICE

Must be true or false. On WINDOWS operating systems

WAS_SERVICE_NAME

Must be a unique string. Can contain the following characters: a-z, A-Z and 0-9.

Mandatory if CREATE_WAS _SERVICE is set to true.

Sample response file for installation

Sample response files for both UNIX and Windows platforms are available on the installation media. This is the content of the response file for UNIX platform: | | | | | | | | | | | | | | | | | | | | | | | | | | |
################################################################################ ## Licensed Materials - Property of IBM ## ## 5698WSH ## ## (C) Copyright IBM Corp. 2006-2007 All Rights Reserved. ## ## US Government Users Restricted Rights - Use, duplication, ## or disclosure restricted by GSA ADP Schedule Contract with ## IBM Corp. ## ################################################################################ ### Tivoli Dynamic Workload Console 8.4 - License Agreement # The text of the license agreement can be found in the DOCS/license directory # of the cdrom. # Allowable values include: # true To accept the license agreement as devised in the DOCS/license # directory of the cdrom. # false To not accept the license agreement as devised in the DOCS/license # directory of the cdrom. In this case the product will not be # installed. # -V licenseAccepted="false"

Chapter 1. Installing

29

Sample response file for installation

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
### Install Method # TDWC 8.4 may be either installed on top of an embedded instance of WebSphere # Application Server - Express V6.1, which is included in the installation # bundle of TDWC 8.4, or on top of an existing installation of WebSphere # Application Server V6.1. # Please check the documentation to know which editions of WebSphere Application # Server V6.1 are supported by TDWC 8.4. # Allowable values include: # NEW Installs TDWC 8.4 and an embedded instance of WebSphere # Application Server - Express V6.1 # ONWAS Installs TDWC 8.4 on top of an existing installation of WebSphere # Application Server V6.1 # -V INSTALL_METHOD="NEW" ### Install Location ("NEW" install type only) # The default install locations are: # C:\Program Files\IBM\TDWC on Windows # /opt/IBM/TDWC on UNIX/Linux # -V IS_DESTINATION="/opt/IBM/TDWC" ### WebSphere Application Server Installation ("ONWAS" install type only) # To use an existing installation of WebSphere Application Server V6.1, provide # the information to identify the profile on top of which TDWC 8.4 should be # installed. # Provide also the install location of the update installer. # Example: # -V ISC_APPSERVER_DIR="/opt/IBM/WebSphere/AppServer" # -V WAS_PROFILE_NAME="AppSrv01" # -V WAS_SERVER_NAME="server1" # -V WAS_CELL_NAME="hostnameNode01Cell" # -V WAS_NODE_NAME="hostnameNode01" # -V UPDATE_INSTALLER_DIR="/opt/IBM/WebSphere/UpdateInstaller" -V ISC_APPSERVER_DIR="" -V WAS_PROFILE_NAME="" -V WAS_SERVER_NAME="" -V WAS_CELL_NAME="" -V WAS_NODE_NAME="" -V UPDATE_INSTALLER_DIR="" ### WebSphere Application Server Administrative Credentials # In case of "NEW" install type, administrative credentials will be used to # create the new embedded instance of WebSphere Application Server - Express # V6.1. # In case of "ONWAS" install type, administrative credentials will be used to # access the existing installation of WebSphere Application Server V6.1. # -V ISC_ADMIN_USER="wasadmin" -V ISC_ADMIN_PASSWORD="wasadmin" ### WebSphere Application Server Ports ("NEW" install type only) # Specify the ports to be used by the embedded WebSphere Application # Server - Express V6.1 # -V WC_adminhost=29060 -V WC_adminhost_secure=29043 -V WC_defaulthost=29080 -V WC_defaulthost_secure=29443 -V BOOTSTRAP_ADDRESS=22809 -V SOAP_CONNECTOR_ADDRESS=28880 -V SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=29401 -V CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=29403

30

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Sample response file for installation

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
-V -V -V -V -V -V -V -V -V CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=29402 ORB_LISTENER_ADDRESS=29100 DCS_UNICAST_ADDRESS=29353 SIB_ENDPOINT_ADDRESS=27276 SIB_ENDPOINT_SECURE_ADDRESS=27286 SIB_MQ_ENDPOINT_ADDRESS=25558 SIB_MQ_ENDPOINT_SECURE_ADDRESS=25578 SIP_DEFAULTHOST=25060 SIP_DEFAULTHOST_SECURE=25061

### Web User Interfaces to enable for WAS administrator # TDWC consists of two web user interfaces that allow working with the following # products: # Tivoli Workload Scheduler # Tivoli Dynamic Workload Broker. # Users must be given specific TDWC roles to work with both interfaces. # If you want to automatically give these roles to the WAS administrator, # you have to properly set the variables defined in this section. # Example: # If you want the WAS administrator to be able to use both interfaces, # set the following values: # -V ENABLE_TWS="true" # -V ENABLE_TDWB="true" # -V ENABLE_TWS="true" -V ENABLE_TDWB="true"

Post-installation steps to connect to Tivoli Workload Scheduler Version 8.3 Fix Pack 3
If you plan to access an environment where Tivoli Workload Scheduler Version 8.3 Fix Pack 3 is installed, you must run an additional configuration task to enable Tivoli Workload Scheduler to work with the Web console. Notes: 1. You do not need to run these steps if you plan to connect to a Tivoli Workload Scheduler Version 8.4 environment. 2. To be able to recover to the initial configuration, make sure you run the backupConfig.sh or backupConfig.cmd script to backup the Tivoli Workload Scheduler configuration. For more information on how to run these scripts, refer to Backing up the WebSphere Application Server configuration files on page 55. This task must be run on the system where the Tivoli Workload Scheduler engine that you want to connect to is installed, and therefore: In a Tivoli Workload Scheduler distributed environment v On the master domain manager. v On a full status fault-tolerant agent (FTA) workstation where the Tivoli Workload Scheduler connector is installed. In a Tivoli Workload Scheduler z/OS environment On the distributed system where the Tivoli Workload Scheduler z/OS connector is installed. These are the steps you must run on that system: 1. Make sure that the WebSphere Application Server is started on the Tivoli Workload Scheduler workstation and then run the following script:

Chapter 1. Installing

31

Post-installation steps to connect to Tivoli Workload Scheduler Version 8.3 Fix Pack 3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | On Windows: As Administrator, from the directory TWS_home\wastools:
webui -operation enable -user TWS_user -password TWS_user_pw -port TWS_port [-server TWS_server]

On UNIX As root, from the directory TWS_home/wastools:

./webui.sh -operation enable -user TWS_user -password TWS_user_pw -port TWS_port [-server TWS_server]

where: TWS_user TWS_user_pw TWS_port The Tivoli Workload Scheduler administrator user ID. The Tivoli Workload Scheduler administrator password. The SOAP port of the WebSphere Application Server the Tivoli Workload Scheduler is based on. This is a mandatory setting when using the enable flag. Its default values are 31118 for distributed environments, and 31128 for z/OS environments. The name of the server specified in the WebSphere Application Server profile used by Tivoli Workload Scheduler. By default the value assigned to this field is server1.

TWS_server

2. Stop and start the WebSphere Application Server on the Tivoli Workload Scheduler system where you run the script. When you have completed these steps you are ready to create engine connections for the Tivoli Workload Scheduler workstation and to manage your Tivoli Workload Scheduler production environment. For information about how to accomplish these tasks, access the Web console online general help as described in Getting started with the installation on page 2, Step 7.

Accessing the Web console

When the installation completes successfully a window, showing a message about the successful installation and the links to access to the Integrated Solutions Console portal, is displayed. If you used the silent installation this information is stored in the tdwcinstall.log installation log file. For more details about where to find the installation logs, see Table 8 on page 53. From a supported browser, access one of the following web links provided by the installation program: http://tdwc_system:http_port/ibm/console https://tdwc_system:https_port/ibm/console where: tdwc_system It is either the hostname or the IP address of the system where you installed the Web console. http_port It is the port number used to access the Web console using an unsecure connection over HTTP. The default value for this port number is 29060.

32

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Accessing the Web console

| | | | | | | | | | | | | | | | | | | https_port It is the port number used to access the Web console using a secure connection over HTTPS. The default value for this port number is 29043. When connecting to the Integrated Solutions Console using an HTTPS connection, a security alert panel might appear. If it does, choose to proceed to continue your Web console working session. Similarly you might see security information panels while navigating through the Integrated Solutions Console; in this case choose to display nonsecure items to proceed. If you are using Internet Explorer you can avoid these panels from appearing by setting Display mixed content to Enable in the Security settings. In the Integrated Solutions Console login portlet, enter the user ID and password you specified during the installation, and click on Log in. On the navigation bar on the left, expand the Tivoli Workload Scheduler entry to access through the Web console to Tivoli Workload Scheduler environments such as Tivoli Workload Scheduler, Tivoli Workload Scheduler for z/OS, and Tivoli Workload Scheduler for Applications; expand the Tivoli Dynamic Workload Broker entry to access to Tivoli Dynamic Workload Broker environments.

| | | | | | To effectively use the functions of these two products you must define connections to the engines, respectively, the Tivoli Workload Scheduler engines and the Tivoli Dynamic Workload Broker servers. Without defining engine connections you can perform only this limited set of operations:

Chapter 1. Installing

33

Accessing the Web console

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | On Tivoli Workload Scheduler
Creating Creating Creating Defining browse tasks for report tasks event management tasks user preferences

On Tivoli Dynamic Workload Broker

Defining user preferences

If the user ID you used to connect to the Web console has assigned a role different from TWSWEBUIAdministrator and TDWBAdministrator, you will see a subset of the available panels. This subset depends on the authorizations assigned to the role associated to your user ID. For more information about roles, refer to Managing users and roles on page 37. If the user ID you used to connect to the Web console has no role assigned, then you will not see the entries for Tivoli Workload Scheduler, and Tivoli Dynamic Workload Broker in the Integrated Solutions Console portal navigation tree.

Quick steps to define a Tivoli Workload Scheduler engine connection

After having logged in to the Web console using the administrator userid, or another userid with assigned TWSWEBUIAdministrator or TWSWEBUIConfigurator roles, follow these steps to create an engine connection to one of your supported Tivoli Workload Scheduler engines: 1. In the Web console, click Tivoli Workload Scheduler to expand the tree. 2. Select Quick start 3. Click New Engine. 4. In the Engine Connection Properties panel assign a name to the engine connection and specify: Engine Type Hostname It can be either z/OS or distributed. It is the type of the Tivoli Workload Scheduler engine to connect to. It is the hostname or IP address of system where the distributed engine or the z/OS connector, for z/OS engine types, runs. It is the bootstrap port number for Tivoli Workload Scheduler engine. Its default values are 31117 for distributed engine, and 31127 for z/OS connector.

PortNumber

Remote Sever Name This setting is valid and mandatory only for z/OS engines. It is the name of the remote server of the engine as it is specified in the z/OS connector. Userid and Password They are the user ID and password that are used to connect to the engine. The operations you are allowed to run in the Tivoli Workload Scheduler environment from the panel of the Web console that you are allowed to access depend on the authorization assigned to this user in theTivoli Workload Scheduler security file.

34

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Quick steps to define a Tivoli Workload Scheduler engine connection

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | If you also want to test the connection to the Tivoli Workload Scheduler database, which is mandatory for managing reporting and event management functions, you must select also the Enable reporting check box, and specify the user credentials to access the database. 5. Click Test Connection to check that the configuration steps were successfully performed and that the Web console communicates with the selected engine. If the test connection fails, refer to The engine connection does not work on page 64. Note: Make sure you run Post-installation steps to connect to Tivoli Workload Scheduler Version 8.3 Fix Pack 3 on page 31 before testing the engine connection if you are connecting to a Tivoli Workload Scheduler version 8.3 Fix Pack 3 engine or z/OS connectors.

Quick steps to define a Tivoli Dynamic Workload Broker engine connection

The Web console supports a single connection to one Tivoli Dynamic Workload Broker engine at any given time for each authorized user. A different connection is supported for each authorized user. After having logged in to the Web console using the administrator user ID, or another user ID with assigned TDWBAdministrator or TDWBConfigurator roles, follow these steps to create an engine connection to a supported Tivoli Dynamic Workload Broker engine: 1. In the Web console, click Tivoli Dynamic Workload Broker to expand the tree. 2. Select Configuration 3. Click Server connection. 4. In the Server Connection specify: Hostname It is the host name of the Tivoli Dynamic Workload Broker server you want to connect to.

Non secure port It is the non-secure port to be used for connection. Secure port It is the secure port to be used for connection.

Use Secure Connection Specify whether a secure connection must be used. For more information about security, refer to IBM Tivoli Dynamic Workload Broker: Installation and Configuration Guide. Username Optionally specify a different user for the server connection. The connection to the new server is enabled using the credentials of the user you specified. Each user has access only to one server connection.

Specify the password for the authenticated user the connection applies to. 5. Click OK to save your changes. The server connection you specified is enabled and is immediately effective. Password

Chapter 1. Installing

35

Quick steps to define a Tivoli Dynamic Workload Broker engine connection

| | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Starting and stopping an application server instance

To start and stop the Web console or an engine you need to start and stop the application server instance that they are based on. Use these scripts belonging to the WebSphere Application Server product to start and stop an application server instance: On Windows: was_install_dir\AppServer\bin\stopServer.bat app_server -user user_id -password user_id_pw was_install_dir\AppServer\bin\startServer.bat app_server On UNIX: was_install_dir/AppServer/bin/stopServer.sh app_server -user user_id -password user_id_pw was_install_dir/AppServer/bin/startServer.sh app_server where: was_install_dir It is the directory specified when installing the Web console or the engine. app_server It is the server name specified in the WebSphere Application Server profile related to the Web console or to the engine. For example, it is tdwcserver for a Web console installed on an embedded version of WebSphere Application Server, or server1 for a Tivoli Workload Scheduler engine. user_id It is the administrator user ID specified when installing the Web console or the engine. user_id_pw It is the administrator user ID password specified when installing the Web console or the engine.

36

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Chapter 2. Configuring
This chapter describes how to configure the Web console. It is divided into the following sections: v Managing users and roles v Enabling the Web console to use a user registry on page 39 v Enabling the Web console to use the Single Sign-On method with engines on page 39 v Sample Web console configurations using user registry and Single Sign-On on page 43 v Updating the Secure Socket Layer protocol certificates on the Web console on page 45 Note: Only the steps described in Managing users and roles are mandatory. The steps described in the other sections are optional.

Managing users and roles

During the Web console installation, new predefined roles and groups are created in the Integrated Solutions Console. These roles determine which Web console panels are available to a user, and therefore which activities the user can perform from the Web console. These roles authorize users to access the Web console panels. The user specified in the engine connection determines which operations can be run locally on a connected engine. For example, if the user specified in a Tivoli Workload Scheduler engine connection is not authorized to run reporting in the Tivoli Workload Scheduler security file, then, even though the user logged in to the Web console can access the reporting panels, they cannot perform reporting operations on that Tivoli Workload Scheduler engine. For more information about how to configure the security file, refer to IBM Tivoli Workload Scheduler: Reference Guide. There is a one-to-one relationship between each new role, and the group with the same name. This means, for example, that all users belonging to the TWSWEBUIAdministrator group have the TWSWEBUIAdministrator role. You cannot modify the roles, but you can create new groups where you combine different roles. For example, you can create a group named my_operators and assign to it the TWSWEBUIOperator and the TDWBOperators roles so that all users added to this group can perform operator actions on both Tivoli Workload Scheduler and Tivoli Dynamic Workload Broker from the Web console. If you do not assign a role to an Integrated Solutions Console user, that user, after having logged in, will not see any entry for Tivoli Workload Scheduler, and Tivoli Dynamic Workload Broker in the navigation tree. During the installation the administrator is given full access from the Web console to the products that are specified in this installation step:

Copyright IBM Corp. 2007

37

Managing users and roles

|

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
TWSWEBUIDeveloper TWSWEBUIAnalyst TWSWEBUIConfigurator

Note: If the Integrated Solutions Console user registry is read only during the Web console installation, then only the roles are created. This is because write access to the Integrated Solutions Console user registry is required to create groups. Table 6 lists the groups created in the Integrated Solutions Console user registry for accessing the Tivoli Workload Scheduler environments using the Web console, and the panels they can access:
Table 6. Tivoli Workload Scheduler roles Roles Tivoli Workload Scheduler panels accessible from the Navigation Tree

TWSWEBUIAdministrator All panels TWSWEBUIOperator Dashboard My Tasks Workload Tracking Workload Submission on Request Workload Forecasting Preferences Note: The TWSWEBUIConfigurator role is also needed in order to work with Workload Forecasting tasks. Workload Definition Preferences Reporting Preferences Scheduling Environment Preferences

Table 7 on page 39 lists the groups created in the Integrated Solutions Console user registry for accessing the Tivoli Dynamic Workload Broker environments using the Web console, and the panels they can access:

38

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Managing users and roles

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 7. Tivoli Dynamic Workload Broker roles Roles TDWBAdministrator TDWBOperator Tivoli Dynamic Workload Broker panels accessible from the Navigation Tree All panels Scheduling Environment, except Agents Configuration Definitions, except Define a New Job Tracking Preferences Configuration Definitions Preferences Scheduling Environment Configuration Tracking, except Job Instances Preferences

TDWBDeveloper

TDWBConfigurator

Enabling the Web console to use a user registry

Follow these steps to configure the Web console to use a user registry: 1. log in to the Web console as administrator. 2. Expand the Security menu in the navigation tree on the left and click Secure administration, applications, and infrastructure. 3. In the drop-down list of available realm definitions, select Standalone LDAP registry, and click Configure. 4. Configure the user registry parameters, and save the settings. 5. In the Security menu, click Set as current, and save your changes. 6. Restart the server using the commands startServer and stopServer, as described in Starting and stopping an application server instance on page 36. As you complete running these steps, you can try to log in to the Web console using the user registry authentication method. The administrator account specified in step 3, is taken as the primary account.

Enabling the Web console to use the Single Sign-On method with engines
Single Sign-On (SSO) is a method of access control that allows a user to authenticate once and gain access to the resources of multiple applications sharing the same user registry. After the installation completes you can configure the Web console and the engine, both Tivoli Workload Scheduler and Tivoli Dynamic Workload Broker engines, to use the Single Sign-On method. To do this they must share the same LDAP user registry. This means that, as a prerequisite, you must have configured the Web console as described in Enabling the Web console to use a user registry, specifying Standalone LDAP registry in the available realm definitions, and configuring it to match the settings specified for the engine. For more information about how to share a user registry in WebSphere Application Server version 6.1, access the product infocenter at the following link http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp, select

Chapter 2. Configuring

39

Managing users and roles

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | WebSphere Application Server (Distributed platforms and Windows), Version 6.1, and then click Securing applications and their environment. The Lightweight Directory Access Protocol (LDAP) is an application protocol for querying and modifying directory services running over TCP/IP. If you configure the Web console to use Single Sign-On with an engine, then, whenever you connect to the Web console, you can run tasks on the engine without entering the user credentials again. WebSphere Application Server uses the Lightweight Third-Party Authentication (LTPA) mechanism to propagate user credentials. Either synchronize to share the LTPA token_keys between the Web console, and the engine on timely basis as the keys expire, or disable the automatic generation of the LTPA token_keys as follows: 1. Log in to the Web console. 2. Click Security, and then Secure administration, applications, and infrastructure. 3. Click Authentication mechanisms and expiration. 4. Click the Key set groups link. 5. Click on the name of the key set group displayed in the list. 6. Clear the Automatically generate keys check box. 7. Click OK. 8. Check in the list that the field Automatically generate keys beside the available key set group is set to false. Note: If you disabled the automatic generation of the LTPA token_keys on the Web console, you have to disable it also on each agent you want to communicate with using SSO. The steps to run are the same as those described for the Web console. The Integrated Solutions Console portal to connect is:
http://TWS_server_hostname:TWS_port/ibm/console

You can use the showHostProperties tool, under the wastool subdirectory to see the port number value, the default value is 31123. For more information about this tool, refer to Tivoli Workload Scheduler: Administration and Troubleshooting guide. To enable Single Sign-On between WebSphere Application Server based applications, you must share the LTPA token_keys between the two communicating WebSphere Application Servers. You must run this procedure between the Web console and each engine you want to connect to using the SSO method. For what concerns the Tivoli Dynamic Workload Broker and the Tivoli Workload Scheduler engines, except for the Tivoli Workload Scheduler z/OS connector, the LTPA token_keys can be exported in either direction, either exported from the Web console and imported on the engine, or exported from the engine and imported in the Web console. When enabling SSO between the Tivoli Workload Scheduler z/OS connector and the Web console, you must export the LTPA token_keys from the Tivoli Workload Scheduler z/OS connector, as it is described in Exporting the LTPA token_keys

40

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Managing users and roles

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | from the Tivoli Workload Scheduler z/OS connector version 8.3 Fix Pack 3 on page 42, and import them in the Web console. 1. Use the following script to export the LTPA token_keys from the WebSphere Application Server where the Web console resides, and to import them on the other system: On Windows: tdwc_install_dir\_tdwcutils\scripts\manage_ltpa.cmd On UNIX: tdwc_install_dir/_tdwcutils/scripts/manage_ltpa.sh There is also a copy of manage_ltpa.sh and manage_ltpa.cmd on each installation CD. Note: Because the manage_ltpa files are not delivered with the Tivoli Dynamic Workload Broker, you have to copy on the system where the Tivoli Dynamic Workload Broker engine is installed both the manage_ltpa and the manage_ltpa.py files either from the Web console installation CD, or from the directory installation_directory/_tdwcutils/scripts. Make sure the user who runs this script is allowed to access the profile. The syntax used to run the script is the following:
manage_ltpa -operation import|export -ltpafile LTPA_file_path -user username -password -port SOAP_port [-server -profilepath profile_path -ltpapassword LTPA_file_password passowrd server_name]

where: -operation Select export to read the LTPA token_keys from the profile and save it to a file. Select import to update the profile with the LTPA token_keys stored in a file. profilepath Specify the path to the profile on top of which the application, either the Web console, the Tivoli Workload Scheduler, or the Tivoli Dynamic Workload Broker, is installed. -ltpafile Specify the fully qualified path name of the file that contains, if you import, or where to encrypt, if you export, the LTPA token_keys. -ltpapassword Specify the password to read, if you import, or to encrypt, if you export, the file that contains the LTPA token_keys. This password is used only when importing and exporting that LTPA token_keys and it does not need to match the administrator password. -user The user ID of the administrator of the server defined in the selected profile.

-password The password of the administrator of the server defined in the selected profile. -port Specify the SOAP port used by the profile. By default the SOAP port is 28880 for a Web console installed on an Embedded Version of WebSphere Application Server version 6.1.0.9. Specify the name of the server of the profile where to import or export
Chapter 2. Configuring

-server

41

Managing users and roles

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | the LTPA tokens. By default the name of the server name is tdwcserver for a Web console installed on an Embedded Version of WebSphere Application Server version 6.1.0.9, and server1 for a Tivoli Workload Scheduler engine installed on an Embedded Version of WebSphere Application Server version 6.1.0.9. Repeat the same steps for all engines you want to access from the Web console using Single Sign-On. The same syntax described for the tool manage_ltpa applies also to importing or exporting Tivoli Workload Scheduler LTPA token_keys. The only difference are that: -user The Tivoli Workload Scheduler administrator, TWS_user.

-password The Tivoli Workload Scheduler administrator password. -port -server Specify the name of the server of the profile where to import or export the LTPA tokens. By default the name of the server name is server1. Tivoli Workload Scheduler engine consider that Note: For Tivoli Workload Scheduler the name of the manage_ltpa tool on windows is named manage_ltpa.bat. This file, and manage_ltpa.sh are stored under the subdirectory named wastools. 2. Stop and start each server you configured to use Single Sign-On to enable it. 3. Test if the Single Sign-On configuration is correctly set between the Web console and the engine by performing the following steps: a. Log in to the Web console. b. Edit the engine connection definition set on the Web console, remove the user credentials, and save the definition. c. Run a task on that engine connection. If you are not requested to enter the engine user credentials to run the task, then the Single Sign-On is correctly set. Specify the SOAP port used by the profile. By default the SOAP port is 31118.

Exporting the LTPA token_keys from the Tivoli Workload Scheduler z/OS connector version 8.3 Fix Pack 3
On the system where the Tivoli Workload Scheduler z/OS connector version 8.3 Fix Pack 3 is installed, use the following script to generate and export the LTPA token_keys: On Windows as Administrator: TWS_home\wastools\webui.bat On UNIX as root user: TWS_home/wastools/webui.sh with the following syntax:
webui -operation enable -user TWS_user -password TWS_user_pw -port TWS_port [pwdLTPA LTPA_file_password] [-server TWS_server]

where:

42

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Managing users and roles

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | TWS_user It is the Tivoli Workload Scheduler administrator, TWS_user. TWS_user_pw It is the Tivoli Workload Scheduler administrator's password. TWS_port It is the SOAP port used by the WebSphere Application Server profile. This is a mandatory setting when using the enable flag. By default this port number is 31128. LTPA_file_password It is the password used to create the LTPA token_keys. TWS_server It is the name of the WebSphere Application Server profile used. By default the value assigned to this field is server1. Note: Make sure that the wastool subdirectory contains the files webui.py, webui.sh or webui.bat, depending on the platform, delivered with Tivoli Workload Scheduler z/OS connector version 8.3, or later. For more information, refer to Tivoli Workload Scheduler for z/OS Connector Fix Pack 3 Readme. After having exported the LTPA token_keys into the file, import them on the Web console or on the engines, depending on your needs, using the manage_ltpa script.

Sample Web console configurations using user registry and Single Sign-On
This section shows some sample configurations you can obtain by combining user registries and the SSO method when connecting from a Web console to both Tivoli Workload Scheduler and Tivoli Dynamic Workload Broker engines. To simplify the figures only one Tivoli Workload Scheduler engine and one Tivoli Dynamic Workload Broker engine are displayed. Consider, however, that the same mixed configurations can be applied to more than one engine belonging to the same product, Tivoli Workload Scheduler or Tivoli Dynamic Workload Broker. In the figures the following acronyms are used: WAS TWS TDWB Tivoli Dynamic Workload Broker Figure 1 on page 44 shows a configuration where the Web console, the Tivoli Workload Scheduler engine, and Tivoli Dynamic Workload Broker engine each use their own user registry. In this case each application gets the user credentials from its own repository. WebSphere Application Server Tivoli Workload Scheduler

Chapter 2. Configuring

43

Managing users and roles

|
TWS engine Web console

WAS

WAS
TDWB engine

WAS
| | | | | | | | | | |
Figure 1. Sample configuration with different user registry

Figure 2 shows a configuration where the Web console, the Tivoli Workload Scheduler engine, and Tivoli Dynamic Workload Broker engine share the same user registry, in this case LDAP. This is accomplished by running the steps described in Enabling the Web console to use a user registry on page 39 between the Web console and the Tivoli Dynamic Workload Broker engine, and between the Web console and the Tivoli Workload Scheduler engine.

TDWB engine

Web console

TWS engine

WAS

WAS

WAS

LDAP
| | | | | | | | | | |
Figure 2. Sample configuration only sharing LDAP user registry with both a Tivoli Dynamic Workload Broker engine and a Tivoli Workload Scheduler engine

Figure 3 on page 45 shows a configuration where the Web console uses the SSO method with the Tivoli Workload Scheduler engine, and the Tivoli Dynamic Workload Broker engine. This is accomplished by adding to the previous configuration the LTPA token_keys sharing step described in Enabling the Web console to use the Single Sign-On method with engines on page 39. This step must be run between the Web console and the Tivoli Dynamic Workload Broker engine, and between the Web console and the Tivoli Workload Scheduler engine.

44

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Managing users and roles

|

TDWB engine

Web console

TWS engine

WAS

SSO

WAS

SSO

WAS

LDAP
| | | | | | | | | | |
Figure 3. Sample configuration using SSO with both a Tivoli Dynamic Workload Broker engine and a Tivoli Workload Scheduler engine

Figure 4 shows a configuration where the Web console uses the SSO method with the Tivoli Dynamic Workload Broker engine, and the Tivoli Workload Scheduler engine use its own user registry. Because the Web console and the Tivoli Dynamic Workload Broker use the SSO method they share the same LDAP user registry from where they get the user credentials. The Tivoli Workload Scheduler engine gets the user credentials from its own repository.
TDWB engine

TWS engine

SSO
Web console

WAS
LDAP

WAS

WAS
TDWB engine

SSO

TWS engine

WAS
| | | | | | | | | | | | | |

WAS

Figure 4. Sample configuration using SSO with a Tivoli Dynamic Workload Broker engine

Note: If you install the Web console on an external WebSphere Application Server where a Tivoli Dynamic Workload Broker engine is installed, the two applications are automatically configured to use SSO.

Updating the Secure Socket Layer protocol certificates on the Web console
The Secure Sockets Layer (SSL) protocol provides secure communications between remote server processes or applications. SSL security can be used to establish communications inbound to, and outbound from, an application. To establish secure communications, a certificate, and an SSL configuration must be specified for the application.

Chapter 2. Configuring

45

Updating the Secure Socket Layer protocol certificates on the Web console
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | A certificate is configured at installation time on the Web console, so that it is immediately ready to use SSL protocol when communicating with the Tivoli Workload Scheduler and the Tivoli Dynamic Workload Broker engines. The communication between the Web console and the Tivoli Workload Scheduler engine always uses the SSL protocol. You choose whether or not to use the SSL protocol when communicating between the Web console and a Tivoli Dynamic Workload Broker engine in the Server Connection properties of the Tivoli Dynamic Workload Broker engine. For more information, refer to Quick steps to define a Tivoli Dynamic Workload Broker engine connection on page 35. Follow these steps if you want to update a new SSL certificate on the Web console when communicating with a Tivoli Workload Scheduler engine: Log in as administrator to the Integrated Solutions Console. Click Security in the navigation tree. Click SSL certificate and key management. In the SSL certificate and key management panel click Key stores and certificates under Related Items. 5. Click NodeDefaultTrustStore, it contains the public keys for the certificates. 6. In the panel that is displayed click Personal certificates under Additional Properties. 7. Click Import to add your personal SSL certificate. Specify: v The complete path name to the certificate. v The type of certificate. v The password for the key file. v The certificate alias to import from the drop-down menu. To populate the entries in the drop-down menu click Get Key file aliases. If you plan to use SSL protocol to communicate with Tivoli Workload Scheduler, choose the certificate alias used by Tivoli Workload Scheduler. 1. 2. 3. 4. Click Apply and then OK to save the changes. 8. Log out from the Integrated Solutions Console. 9. Stop and then start the server to activate the changes. Note: To complete the SSL protocol configuration you have to import into Tivoli Workload Scheduler the personal certificate specifying the certificate alias used by the Web console. Use either ikeymantool, or keytool to update the SSL certificate on the Web console to communicate with a Tivoli Dynamic Workload Broker engine. For more information, refer to the Tivoli Dynamic Workload Broker: Installation and configuration. Stop and start the server to activate the changes.

Disabling Tivoli Workload Scheduler Version 8.3 Fix Pack 3 workstations from being connected to Web console
Run the following script if you want to disable the ability to establish engine connections from the Web console to a Tivoli Workload Scheduler Version 8.3 Fix Pack 3 workstation:

46

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Updating the Secure Socket Layer protocol certificates on the Web console
| | | | | | | | | On Windows:
webui -operation disable

Run the script as Tivoli Workload Scheduler administrator, from the directory TWS_home\wastools: On UNIX
./webui.sh -operation disable

Run the script as root, from the directory TWS_home/wastools: Restart the WebSphere Application Server on the Tivoli Workload Scheduler workstation where you run the script.

Chapter 2. Configuring

47

Updating the Secure Socket Layer protocol certificates on the Web console

48

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Chapter 3. Uninstalling
This chapter explains how to uninstall the Web console. It is divided into the following sections: v Uninstalling using the graphical wizard v Uninstalling in silent mode on page 50 v Uninstalling the Tivoli Workload Scheduler z/OS connector on page 50

Uninstalling using the graphical wizard

Use the following procedure to uninstall Tivoli Dynamic Workload Console using the InstallShield wizard: 1. Start the server. 2. Start the uninstall as follows: On Windows: Either: v From the tdwc_install_dir\_twsuninst directory, run the command:
uninstaller.exe

or: v From the Control Panel, click Add/Remove Programs. Scroll down the list of software, and select Tivoli Dynamic Workload Console. Click Change/Remove. On UNIX: From the tdwc_install_dir/_twsuninst directory, run the command:
./uninstaller.bin

| | | | | | | | | |

3. Select the language that you want to use to run the uninstall. 4. Click Next in the Tivoli Dynamic Workload Console uninstall welcome panel. 5. Provide the administrator user name and password you specified during the Web console installation, and click Next to proceed. 6. In the uninstall summary panel double-check that the directory from where the product is to be removed, and the features to be removed are correct, and then click Uninstall. If you installed the Web console and the embedded version of WebSphere Application Server, they are both uninstalled; if you installed the Web console on an external WebSphere Application Server only the Tivoli Dynamic Workload Console module is uninstalled. Note: When uninstalling a Web console installed on an external WebSphere Application Server, the Integrated Solutions Console Advanced Edition version 7.1 is not removed even though the panel says it is. This is a WebSphere Application Server limitation. 7. When the uninstall completes, a panel showing a message about the success of the operation is displayed. Click Finish to exit the InstallShield Wizard.

Copyright IBM Corp. 2007

49

Uninstalling in silent mode

Uninstalling in silent mode

You can perform a silent uninstall of the Web console. Before starting to uninstall ensure that the server is active, and move to a directory different from the tdwc_install_dir. Run the uninstall command as follows: On Windows: tdwc_install_dir\_tdwcuninst\uninstaller -silent -options response_file.rsp On UNIX: tdwc_install_dir/_tdwcuninst/uninstaller.bin -silent -options response_file.rsp

Sample response file for uninstall

A sample response file named tdwcuninst.rsp is provided on the installation CD. | | | | | | | | | | | | | | | | | | | This is its content:
################################################################################ ## Licensed Materials - Property of IBM ## ## 5698WSH ## ## (C) Copyright IBM Corp. 2006-2007 All Rights Reserved. ## ## US Government Users Restricted Rights - Use, duplication, ## or disclosure restricted by GSA ADP Schedule Contract with ## IBM Corp. ## ################################################################################ ### WebSphere Application Server Administrative Credentials -V ISC_ADMIN_USER="wasadmin" -V ISC_ADMIN_PASSWORD="wasadmin"

Uninstalling the Tivoli Workload Scheduler z/OS connector

Perform the following steps on the workstation where you installed the Tivoli Workload Scheduler z/OS connector to run the uninstall: 1. Navigate to the Tivoli Workload Scheduler z/OS connector uninstall directory: On Windows: TWS_install_dir\uninstall On UNIX: TWS_install_dir/uninstall 2. Start the uninstall by running the following command: On Windows: uninstall.exe On UNIX: ./uninstall.bin or use the shortcut icons if they were created at installation time. The uninstall panel is displayed. Click Next to proceed.

50

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Uninstalling the Tivoli Workload Scheduler z/OS connector

When the uninstall completes, a window showing, either a message about the successful completion or the list of items that failed to uninstall and the path file name of the log file, is displayed. 4. Click Finish to exit the uninstall. 3.

Chapter 3. Uninstalling

51

Uninstalling the Tivoli Workload Scheduler z/OS connector

52

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Chapter 4. Troubleshooting
This chapter explains the logging and tracing capabilities of the Web console and provides you with troubleshooting scenarios. It is divided into the following sections: v Log and trace files v Activating traces on page 54 v Removing manually the Web console and the embedded version of WebSphere Application Server on page 55 v Backing up the WebSphere Application Server configuration files on page 55 v Restoring the WebSphere Application Server configuration files on page 56 v Showing the security properties on page 57 v Changing the security properties on page 58 v Backing up the Web console data on page 60 v Troubleshooting scenarios on page 61

Log and trace files

Table 8 lists the log files created by Web console: | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 8. Locations of log files and trace files Path tdwc_install_dir/AppServer/profiles/ tdwc_profile/servers/tdwc_server/logs Files SystemOut.log, SystemErr.log trace.log Content The Web console runtime logs. If you installed on an embedded version of WebSphere Application Server, the profile_name is tdwcprofile, and the server name is tdwcserver. The Web console installation log.

On Windows: %TEMP% On UNIX: $TMPDIR if set, otherwise /tmp On Windows: %TEMP% On UNIX: $TMPDIR if set, otherwise /tmp On Windows: %TEMP%/tdwc84 On UNIX: $TMPDIR/tdwc84 if set, otherwise /tmp/tdwc84

tdwcinstall.log

tdwcuninstall.log

The Web console uninstall log.

wsadmin.log

The trace file containing the information about the configuration procedures stored during the installation phase.

Copyright IBM Corp. 2007

53

Log and trace files

| | | | | | | | | | | | | | |
Table 8. Locations of log files and trace files (continued) Path On Windows: %TEMP% On UNIX: $TMPDIR if set, otherwise /tmp Files securityConfig nnnn.log Content The Web console log file containing the details about the installation errors reported in the tdwcinstall.log file. The numeric value nnnn is automatically assigned at installation time. Access to the tdwcinstall.log file to read the filename of the securityConfignnnn.log file.

Note: For information about the path represented by tdwc_install_dir, refer to Installation prerequisites on page 3.

Activating traces
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Run the following steps to activate Web console traces at run time: 1. Log in to the Integrated Solutions Console as administrator. 2. In the navigation tree, click Troubleshooting, and then Logs and Trace. 3. Click the name of the server for which you want to run the traces, for example tdwcserver. 4. Click Diagnostic Trace. 5. Click Change Log Detail Levels. 6. Select: Configuration If you want to apply the changes to the trace settings after having restarted the server. Runtime If you want to apply the changes to the trace settings without restarting the server. 7. Choose the packages for which you want to activate the traces. For the Web console traces, make this selection: a. Scroll down to com.ibm.tws.*. b. Expand the tree. c. Click on com.ibm.tws.webui.*. d. Click on All Messages and Traces. e. Click OK. f. Click Save. 8. Stop and start the server. Alternatively, you can activate the Web console traces by editing the following XML file:
tdwc_install_dir\AppServer\profiles\tdwc_profile\config\cells\ tdwc_cell\nodes\tdwc_node\servers\tdwc_server\server.xml

Change the value assigned to the property startupTraceSpecification from: com.ibm.tws.webui.*=info to:

54

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Activating traces
com.ibm.tws.webui.*=all. Save the changes and then stop and start the server. When you enable tracing at run time the traces are stored in the tdwc_installation_directory/PortalServer/log/trace.log file. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Removing manually the Web console and the embedded version of WebSphere Application Server
Run the following steps, if you need to manually clean up the environment by removing both the Web console and the embedded version of WebSphere Application Server version 6.1: On Windows: 1. Stop the server either by running the command:
tdwc_install_dir\AppServer\profiles\tdwcprofile\bin\StopServer.bat tdwcserver -username tdwc_admin -password tdwc_admin_pw

or by stopping the corresponding service. 2. If you configured to start and stop the Web console as a service, remove the service by running this command:
tdwc_install_dir\AppServer\bin\wasservice.exe -remove TDWCService

3. Remove the directory tdwc_install_dir. 4. Remove the following directory:

C:\%Program Files%\Common Files\InstallShield\Universal\TDWC

5. Delete the following registry key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\ e625666383dedb70850864e2a6feaa2e1371705039

6. Restart the system. On UNIX: 1. Stop the server by running the command:
tdwc_install_dir/AppServer/profiles/tdwcprofile/bin/StopServer.sh tdwcserver -username tdwc_admin -password tdwc_admin_pw

2. Remove the directory tdwc_install_dir. 3. Remove the following directory: On AIX

/usr/lib/objrepos/InstallShield/Universal/TDWC

On all UNIX systems, except AIX

root_home_dir/InstallShield/Universal/TDWC

4. Restart the system.

Backing up the WebSphere Application Server configuration files

Use the backupConfig script to save into a zip file the WebSphere Application Server configuration files. The script is located in the following directory:
tdwc_install_dir\wastools

Use the following syntax to run the command:

Chapter 4. Troubleshooting

55

Backing up the WebSphere Application Server configuration files

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | On Windows:
backupConfig.bat [backup_file] [-nostop] [-quiet] [-logfile filename] [-replacelog] [-trace] [-username tdwc_admin] [-password tdwc_admin_pw] [-profileName tdwc_profile] [-help]

On UNIX:
backupConfig.sh [backup_file] [-nostop] [-quiet] [-logfile filename] [-replacelog] [-trace] [-username tdwc_admin] [-password tdwc_admin_pw] [-profileName tdwc_profile] [-help]

This is a sample output for the command:

C:\Program Files\IBM\TDWC\wastools>backupConfig.bat ADMU0116I: Tool information is being logged in file C:\Program Files\IBM\TDWC\AppServer\profiles\tdwcprofile\logs\backupConfig.log ADMU0128I: Starting tool with the tdwcprofile profile ADMU5001I: Backing up config directory C:\Program Files\IBM\TDWC\AppServer\profiles\tdwcprofile\config to file C:\Program Files\IBM\TDWC\wastools\WebSphereConfig_2007-09-13.zip ADMU0505I: Servers found in configuration: ADMU0506I: Server name: tdwcserver ADMU2010I: Stopping all server processes for node myhostNode02 ................................................................................ ................................................................................ ................................................................................ .............................. ADMU5002I: 270 files successfully backed up

For a detailed description of these commands, see the IBM Redbooks: WebSphere Application Server V6 System Management & Configuration Handbook.

Restoring the WebSphere Application Server configuration files

Use the restoreConfig script to restore the WebSphere Application Server configuration files previously backed up using backupConfig. The script is located in the following directory:
tdwc_install_dir\wastools

Use the following syntax to run the command: On Windows:

restoreConfig.bat backup_file [-location restore_location] [-quiet] [-nowait] [-logfile filename] [-replacelog] [-trace]

56

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Restoring the WebSphere Application Server configuration files

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | On UNIX:
restoreConfig.sh backup_file [-location restore_location] [-quiet] [-nowait] [-logfile filename] [-replacelog] [-trace] [-username tdwc_admin] [-password tdwc_admin_pw] [-profileName tdwc_profile] [-help] [-username tdwc_admin] [-password tdwc_admin_pw] [-profileName tdwc_profile] [-help]

This is a sample output for the command:

C:\Program Files\IBM\TDWC\wastools>restoreConfig.bat WebSphereConfig_2007-09-13.zip ADMU0116I: Tool information is being logged in file C:\Program Files\IBM\TDWC\AppServer\profiles\tdwcprofile\logs\restoreConfig.log ADMU0128I: Starting tool with the tdwcprofile profile ADMU0505I: Servers found in configuration: ADMU0506I: Server name: tdwcserver ADMU2010I: Stopping all server processes for node myhostNode02 ADMU5502I: The directory C:\Program Files\IBM\TDWC\AppServer\profiles\tdwcprofile\config already exists; renaming to C:\Program Files\IBM\TDWC\AppServer\profiles\tdwcprofile\config.old ADMU5504I: Restore location successfully renamed ADMU5505I: Restoring file WebSphereConfig_2007-09-13.zip to location C:\Program Files\IBM\TDWC\AppServer\profiles\tdwcprofile\config ................................................................................ ................................................................................ ................................................................................ ..............................ADMU5506I: 270 files successfully restored ADMU6001I: Begin App Preparation ADMU6009I: Processing complete.

For a detailed description of these commands, see the IBM Redbooks: WebSphere Application Server V6 System Management & Configuration Handbook.

Showing the security properties

The security properties are those set on the server where the Web console resides. They contain information about: v General security settings, such as the user registry to use (local operating system or LDAP, or custom user registry) v Local operating system user registry settings v Custom user registry settings embedded with the Integrated Solutions Console (WIM) v LDAP configuration settings Use the following utility to display the current security properties: UNIX Windows showSecurityProperties.sh showSecurityProperties.bat

Only the WebSphere Application Server security.xml configuration file is affected by this script. The path to the file is:
Chapter 4. Troubleshooting

57

Restoring the WebSphere Application Server configuration files

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
tdwc_home\appserver\profiles\tdwcprofile\config\cells\DefaultNode\security.xml

The security properties vary according to how your instance of Web console is configured.

Changing the security properties

Use this procedure if you want to move from a user registry to an LDAP user registry. The details are as follows: 1. Log on to the computer where Web console is installed as the following user: UNIX root

Windows Any user in the Administrators group. 2. Access the directory: tdwc_install_dir/wastools 3. Stop the application server. 4. From that same directory run the following script to create a file containing the current security properties: UNIX showSecurityProperties.sh > my_file_name

Windows showSecurityProperties.bat > my_file_name 5. Edit my_file_name with a text editor. Check the start of the file. It might be that the command writes a message from the application server (WASX7357I:) at the beginning of the file; if so, delete this message. 6. Change the value of the security properties, according to your requirements. You do not need to supply all of the parameters in the file. For more information about the available security properties that you can set, refer to Setting security properties in the template file for LDAP configuration. 7. Save the file my_file_name. 8. Run the script: Windows UNIX changeSecurityProperties.bat my_file_name changeSecurityProperties.sh my_file_name

The properties are updated, according to the rules given in the descriptions of each property type. 9. Start the server. 10. Check that the change has been implemented by running the showSecurityProperties script and comparing the output of the script again. Note: You must change the security configuration to use either the local OS or the file registry (WIM), from the Security entry in the Integrated Solutions Console navigation tree.

Setting security properties in the template file for LDAP configuration

A template file of security properties is supplied with the product. However, the template file does not contain any of the configuration values that were created by the installation process or any previous uses of the configuration utilities. If you decide to use the template instead of creating the properties document as described in step 4, you must be careful to ensure that the values you enter in the file for every parameter are those that you require to be used by the application server.

58

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Restoring the WebSphere Application Server configuration files

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | You must not use either template files belonging to different versions of the Web console, or template files belonging to Tivoli Workload Scheduler engine workstations. All the properties in the properties file are optional. When you modify the properties file, be aware of the following: v If a property is not provided in the properties file, the current value is not changed. v If a property is provided with a non-blank value, the current value is updated. v If a property is provided with a blank value, the setting is set to blank if the property is classified as erasable or left unchanged if not. These properties cannot be erased: v activeAuthMechanism v v v v v v v v v v v v v v v activeProtocol activeUserRegistry cacheTimeout enabled enforceJava2Security issuePermissionWarning LDAPCertificateMapMode LDAPHostName LDAPIgnoreCase LDAPPort LDAPreuseConnection LDAPSearchTimeout LDAPsslEnabled LDAPUseRegistryServerId useDomainQualifiedUserNames

The following is a sample of the SecurityProps_TEMPLATE.properties file:

################################################################ Global Security Panel ################################################################ #These parameters must not be changed configuring LDAP ################################################################ # enabled=true # enforceJava2Security=false # useDomainQualifiedUserNames=false # cacheTimeout=600 # issuePermissionWarning=false # activeProtocol=BOTH # activeAuthMechanism=LTPA # activeUserRegistry=LDAP ################################################################ LDAP Panel ################################################################ # IMPORTANT NOTES: # # The LDAPServerId or LDAPPrimaryAdminId must be set. # The LDAPUseRegistryServerId must be set to false if the LDAPServerId has been set, true if # the LDAPPrimaryAdminId has been set. # The LDAPServerType depends on your LDAP server
Chapter 4. Troubleshooting

59

Restoring the WebSphere Application Server configuration files

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
################################################################ # LDAPServerId= # LDAPPassword= # LDAPPrimaryAdminId= # LDAPUseRegistryServerId=false # LDAPServerType=IBM_DIRECTORY_SERVER # LDAPHostName= # LDAPPort=389 # LDAPBaseDN= # LDAPBindDN= # LDAPBindPassword= # LDAPsearchTimeout=120 # LDAPreuseConnection=true # LDAPIgnoreCase=true # LDAPsslEnabled=false # LDAPsslConfig= ################################################################ Advanced LDAP Panel ################################################################ # LDAPUserFilter= # LDAPGroupFilter= # LDAPUserIdMap= # LDAPGroupIdMap= # LDAPGroupMemberIdMap= # LDAPCertificateFilter=EXACT_DN # LDAPCertificateMapMode=

Backing up the Web console data

Follow these steps to make a backup copy of the data entered in the Web console such as tasks, engine connections, user preferences, and event rules: 1. Stop the server. 2. Save a copy of the content of this directory:
tdwc_install_dir/AppServer/profiles/tdwc_profile/registry

where tdwc_profile is either tdwcserver if you installed the embedded version of WebSphere Application Server, or the name of the profile you specified when installing the Web console on the external WebSphere Application Server. 3. Start the server. To restore the data you must: 1. Stop the server. 2. Replace with the saved copy the content of the directory:
tdwc_install_dir/AppServer/profiles/tdwc_profile/registry

3. Start the server.

Creating a core dump of the application server

If the Embedded Version of the WebSphere Application Server version 6.1 hangs, and you decide to contact IBM Software Support for assistance, it would help the diagnosis of the problem if you could provide one or more core dumps taken during the hang. This section describes how to that, as follows: 1. Log on as a WebSphere Application Server administrator 2. Change to the directory: tdwc_install_dir\AppServer\profiles\tdwcprofile and run the script wsadmin.sh (UNIX) or wsadmin.bat (Windows) to open the administration shell. 3. Set the jvm variable as follows:

60

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Restoring the WebSphere Application Server configuration files

| | | | | | | | | | | | | | | |
set jvm [$AdminControl completeObjectName type=JVM,process=tdwcserver,*]

4. Run the core dump as follows:

$AdminControl invoke $jvm dumpThreads

This creates a core dump in the tdwc_install_dir\AppServer\profiles\ tdwcprofile directory with the following name: Windows and Linux javacore.<yyyymmdd>.<hhmmss>.<pid>.txt where yyyy = year, mm = month, dd = day, ss = second, and pid = process ID. UNIX javacore<pid><time>.txt where pid = process ID, and time = the number of seconds since 1/1/1970. 5. Repeat step 4 several times. The more dumps you can take, the more information is available to the support team. 6. Send the dumps, the application server logs and a detailed description of what you were doing, to IBM Software Support.

Troubleshooting scenarios
In this section the troubleshooting scenarios are divided into: v Troubleshooting installation scenarios v Troubleshooting runtime scenarios on page 64

Troubleshooting installation scenarios

These scenarios impact the Web console installation. | | | | | | | | | |

The installation fails on AIX because of lack of available space in filesystem

Problem description: You launch the Web console installation on an AIX system, and check of the available space fails. A message informing you about the lack of space is displayed, and the installation stops. Suggested action: Click Cancel to exit the installation, refer to Table 2 on page 4 to see the required available disk space, free the needed space, or increase the filesystem size to the required value, and then restart the installation.

The silent uninstall does not work and an error code is returned
Problem description: If you try to perform a silent uninstall with a response file that does not exist, either because the file name is incorrect or because you specified the wrong directory, an error code is returned and the uninstall does not occur. Nothing is logged in the temporary directory and no messages are issued. Suggested action: Ensure that you specify a valid response file name.
Chapter 4. Troubleshooting

61

Troubleshooting installation scenarios

The Web console installation hangs

Problem description: The installation of Web console does not proceed. This occurs regardless of the method you used to install. Suggested action: Make sure an active personal firewall is not preventing the installation process from connecting to the network. If it is, allow the connection and then continue with the installation.

Warning messages stored when using launchpad on Linux

Problem description: When using launchpad on Linux operating systems warning messages might be displayed on the standard output. Suggested action: You can ignore these messages because they do not indicate any malfunctioning. | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Installation from a remote shared folder fails on Windows

Problem description: You try to install the Web console on a Windows operating system from a shared network folder that uses Universal Naming Convention (UNC). The installation fails. Suggested action: You must map the remote folder locally on the Windows system where you want to install the Web console and then run the installation using the local path.

Installation fails on a Linux 390 system whose hostname is not Fully Qualified Domain Name
Problem description: You try to install the Web console with the embedded WebSphere Application Server on a server whose hostname is not Fully Qualified Domain Name. The installation fails and the following error is stored in the tdwcinstall.log file:
ADMU3011E: Server launched but failed initialization. startServer.log, SystemOut.log(or job log in zOS) and other log files under /oracle/IBM/TDWC/AppServer/profiles/tdwcprofile/logs/tdwcserver should contain failure information. WASX7023E: Error creating "SOAP" connection to host "localhost"; exception information: com.ibm.websphere.management.exception.ConnectorNotAvailableException: com.ibm.websphere.management.exception.ConnectorNotAvailableException: ADMC0016E: The system cannot create a SOAP connector to connect to host localhost at port 28880.

Suggested action: Run the following command from the system prompt on the Linux 390 system where you tried to install the Web console:

62

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Troubleshooting installation scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
hostname --fqdn

If the command returns:

hostname: Unknown host

the host name is not resolved. You must specify a hostname with a fully qualified domain name to install WebSphere Application Server. Update the hostname notation, as explained in the WebSphere Application Server documentation, and then rerun the installation.

Undefined error when using launchpad on Windows

Problem description: You try to install the Web console on a Windows operating system using the launchpad and you get an "Undefined" error message. The launchpad does not start. Suggested action: Make sure that the path from where you launched the installation does not contain folder names longer than eight characters. If it does, then map the path to the launchpad.exe, and run the launchpad from that new path.

Java Virtual Machine (JVM) failure when installing with the Web console on a Red Hat Enterprise Linux (RHEL) Version 5 system
Problem description: When working with the Web console on a Red Hat Enterprise Linux Version 5 system, a user might see the error Failed to find VM - aborting. Suggested action: Red Hat Enterprise Linux Version 5 has a new security feature named Security Enhanced Linux, or SELinux for short. A weaker version of SELinux was included in Red Hat Enterprise Linux Version 4, and was disabled by default. Red Hat Enterprise Linux Version 5 defaults SELinux to enabled. SELinux helps to keep the host secure from certain types of malicious attacks. However, the default settings have been known in many cases to prevent Java from running properly. To fix this issue, you can choose one of the following options: v Configure SELinux so that it knows that the Web console Java related processes are acceptable to run. v Change the mode of SELinux to Permissive by entering setenforce 0 on the command line. SELinux will be fully enabled again the next time the system is rebooted or if setenforce 1 is entered on the command line.

Web console graphical installation and uninstall fail to start on Red Hat Enterprise Linux (RHEL) Version 5 on x86-64
Problem description: When launching the Web console installation or the Web console uninstall in graphical mode on Red Hat Enterprise Linux (RHEL) Version 5 x86-64 it might happen that the following error is displayed: For the installation:
Chapter 4. Troubleshooting

63

Troubleshooting installation scenarios

| | | | | | | | |
The installer is unable to run in graphical mode. Try running the installer with the -console or -silent flag.

For the uninstall:

The uninstaller is unable to run in graphical mode. Try running the uninstaller with the -console or -silent flag.

Suggested action: If you run into this problem launch the installation, or the uninstall in silent mode. For more information refer to Installing in silent mode on page 23, and Uninstalling in silent mode on page 50.

Troubleshooting runtime scenarios

These scenarios impact the Web console at run time. This guide contains only the troubleshooting runtime scenarios impacting the Tivoli Workload Scheduler environment. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | For the troubleshooting runtime scenarios impacting the Tivoli Dynamic Workload Broker environment, refer to the Tivoli Dynamic Workload Broker: Installation and Configuration guide.

The engine connection does not work

Problem description: You define an engine connection, you verify that the values entered for the engine connection are correct, and then you click Test Connection. The test fails and a connection error message is returned. Suggested action: Assuming that system_A is where you installed the Web console, and system_B is where you installed Tivoli Workload Scheduler, follow these verification steps to investigate and fix the problem: 1. Verify that there is no firewall between the two systems as follows: a. Make sure the two systems can ping each other. If you are trying to connect to a z/OS engine you must check that the system where the Web console resides and the system where the Tivoli Workload Scheduler z/OS connector is installed can ping each other. b. Make sure you can telnet from system_A to system_B using the port number specified in the engine connection settings (for example, 31117 is the default port number for distributed engine). If either of these two steps fails then there might be a firewall preventing the two systems from communicating. 2. Check if you can connect using the composer command line interface, or the Job Scheduling Console (JSC) to the Tivoli Workload Scheduler engine on system_B using the same credentials specified in the engine connection. If you cannot, then check if the user definition on system_B and the user authorization specified in the Tivoli Workload Scheduler security file are correct. 3. If you are using LDAP or another User Registry on the Web console make sure that: a. The connection to the user registry works.

64

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Troubleshooting run time scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b. The User Registry settings specified on the Integrated Solutions Console in the Security menu under Secure administration, applications, and infrastructure are correct. c. You restarted both the Web console's, and Tivoli Workload Scheduler's WebSphere Application Servers, after configuring the User Registry For more information about how to configure the Web console to use LDAP or about how to test the connection to a User Registry, refer to Enabling the Web console to use a user registry on page 39. 4. If you set up to use Single Sign-On between the Web console and the Tivoli Workload Scheduler engine, make sure you correctly shared the LTPA_token_keys as described in Enabling the Web console to use the Single Sign-On method with engines on page 39. If this checklist does not help you in identifying and fixing your problem then activate tracing on the Web console by running the steps listed in Activating traces on page 54 (adding also the Java packages com.ibm.ws.security.*=all:com.ibm.tws.*=all), and on the Tivoli Workload Scheduler engine by running the following steps: 1. Connect as WebSphere Application Server administrator to the system where the Tivoli Workload Scheduler engine is located. 2. Edit the file TWS_HOME/wastools/TracingProps.properties, add the statement:
tws_with_sec=com.ibm.ws.security.*=all:com.ibm.tws.*=all

and then save your changes. 3. Run the following script to start tracing:
TWS_HOME/wastools/changeTraceProperties.sh -user TWS_user -password TWS_user_password -mode tws_with_sec

where TWS_user and TWS_user_pw are the credentials of the Tivoli Workload Scheduler administrator. Connect to the Web console again, test the connection to the Tivoli Workload Scheduler engine, and then check the information stored in the traces under the following path: v On the Web console:
tdwc_install_dir/AppServer/profiles/tdwc_profile/logs/tdwc_server/trace.log

Note: If you installed the Web console on the embedded version of WebSphere Application Server, the tdwc_server is, by default, tdwcserver. v On the Tivoli Workload Scheduler engine:
TSW_home/AppServer/profiles/TWS_profile/logs/server1/trace.log

In these files you should see the information about the error that occurred. If useful, compare the connection information stored in the traces with the information set for WebSphere Application Server security on both sides. Refer to Showing the security properties on page 57 to list the information about the security properties.

Test connection takes minutes before returning failure

Problem description: You select an engine connection and click on Test Connection to check that the connection is working. The test takes several minutes to complete and then returns a failure.

Chapter 4. Troubleshooting

65

Troubleshooting run time scenarios

Suggested action: When the Test Connection is run, the result is returned only after the timeout expires. The timeout for running the Test Connection operation cannot be customized. The connection failed because of one of the following reasons: v The system where the Tivoli Workload Scheduler engine is installed is not active. v The IP address or the hostname of the system where the Tivoli Workload Scheduler engine is installed was not correctly specified. v A network firewall prevents the system where the Web console is installed and the system where the Tivoli Workload Scheduler engine is installed from communicating. Check which of these reasons causes the communication failure, fix the problem, and then retry. | | | | | | | | | | | | | | | | |

Engine connection settings are not checked for validity when establishing the connection
Problem description: You incorrectly defined an engine connection to a distributed engine specifying a value for Remote Server Name. The Remote Server Name is not a valid setting for a connection to a distributed engine. The check runs when you save the engine connection definition or when you run a test connection to that engine, but no exception about the incorrect setting is returned. Suggested action: Whenever the test connection is run, only the mandatory fields for that specific type of engine, distributed rather than z/OS, are used to test the connection. Fields that are not mandatory, such as Remote Server Name for distributed engine connections are not taken into account.

The test connection to a Tivoli Workload Scheduler engine fails Communication Failure - only for Tivoli Workload Scheduler version 8.3 with Fix Pack 3
Problem description: You select an engine connection and click on Test Connection to check that the connection is working. The test fails and the following errors are logged in the SystemOut.log file:
AWSWUI0766E Test connection to [TEST001] : failed. AWSWUI0779E Communication failure: host is not available or address and port are invalid.

Suggested action: Make sure the webui script was run on the machine where the Tivoli Workload Scheduler engine is installed. If not, run the script as described in Post-installation steps to connect to Tivoli Workload Scheduler Version 8.3 Fix Pack 3 on page 31, and then test the connection again.

Data not updated after running actions against browse tasks results
Problem description:

66

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Troubleshooting run time scenarios

After running an action on a list of objects returned from running a browse task the list is not updated. Suggested action: The scheduling objects lists are not automatically updated after running actions. Click on the Refresh button to update the list of objects. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Session has become invalid

Problem description: You try to use the Web console user interface, your working session closes, and you get the following warning:
Session has become invalid Your session has become invalid. This is due to a session timeout, an administrator has logged you out, or another user has invalidated your session by logging on with the same User ID.

Suggested action: Check which reason among those listed in the warning has occurred, solve the issue, and then log in again as described in Accessing the Web console on page 32 to continue your working session. If the session expired because either the HTTP session or the Lightweight Third Party Authentication (LTPA) session timeout was exceeded, you might decide to customize the timeout settings to values that are appropriate for your environment. Modifying the values assigned to the session timeout settings: The value assigned to these timeout settings defines after how many minutes a user is automatically logged out from the WebSphere Application Server. If you plan to perform long running operations, or to have many users connected concurrently to the Web console, or expect to have low performance on the system where the Web console is installed, you might want to increase these values. Perform these steps to change the values assigned to the timeout settings: 1. Open the configuration file:
tdwc_install_dir\AppServer\profiles\tdwc_profile \config\cells\tdwc_cell\nodes\tdwc_node\servers\ tdwc_server\server.xml

2. In the file, search for invalidationTimeout in the following tag:

<tuningParams xmi:id="TuningParams_1188622510500" usingMultiRowSchema="false" maxInMemorySessionCount="1000" allowOverflow="true" scheduleInvalidation="false" writeFrequency="TIME_BASED_WRITE" writeInterval="10" writeContents="ONLY_UPDATED_ATTRIBUTES" invalidationTimeout="30">

This is the parameter that sets the HTTP session timeout. By default invalidationTimeout is set to 30, which means that a user is logged out automatically after 30 minutes of inactivity. 3. Set invalidationTimeout to an appropriate value for your environment and for the activities you plan to perform. 4. Save the file.
Chapter 4. Troubleshooting

67

Troubleshooting run time scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5. Open the configuration file:
tdwc_install_dir\AppServer\profiles\tdwc_profile \config\cells\tdwc_cell\applications\isclite.ear\ deployments\isclite\deployment.xml

6. In the file, search for invalidationTimeout in the following tag:

<tuningParams xmi:id="TuningParams_1188878529796" usingMultiRowSchema="false" maxInMemorySessionCount="1000" allowOverflow="true" scheduleInvalidation="false" writeFrequency="TIME_BASED_WRITE" writeInterval="10" writeContents="ONLY_UPDATED_ATTRIBUTES" invalidationTimeout="30">

By default, invalidationTimeout is set to 30, which means that a user is logged out automatically after 30 minutes of inactivity. 7. Set invalidationTimeout to an appropriate value for your environment and for the activities you plan to perform. 8. Save the file. 9. Open the configuration file:
tdwc_install_dir\AppServer\profiles\tdwc_profile\config\cells\tdwc_cell\security.xml

10. In the file, search for timeout in the following tag:

<authMechanisms xmi:type="security:LTPA" xmi:id="LTPA_1" OID="oid:1.3.18.0.2.30.2" authContextImplClass="com.ibm.ISecurityLocalObjectTokenBaseImpl .WSSecurityContextLTPAImpl" authConfig="system.LTPA" simpleAuthConfig="system.LTPA" authValidationConfig="system.LTPA" timeout="120" keySetGroup="KeySetGroup_lab237165Node01_1">

By default timeout is set to 120, which means that a user is logged out automatically after 120 minutes regardless of whether or not the user performed any actions on the WebSphere Application Server. 11. Set the timeout value in the following section of the file to an appropriate value for your environment and for the activities you plan to perform. 12. Save the file. 13. Restart the WebSphere Application Server.

Actions run against scheduling objects return empty tables

Problem description: After running a browse task, you run an action against the scheduling objects listed in the result table, but you get, as a result of the action, an empty table or panel, and no error message is displayed. This occurs regardless of what action you try to run against the listed scheduling objects. Suggested action: Check if the connection with the Tivoli Workload Scheduler engine where you run the task failed by doing the following: v In the Configuration panel select Scheduler Connections v Select in the list the engine used to run the browse task and click on Test Connection.

68

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Troubleshooting run time scenarios

Note: The user ID you use to connect to the Web console must belong either to the TWSWEBUIAdministrator or to the TWSWEBUIConfigurator groups to test the engine connection. If the connection with the Tivoli Workload Scheduler engine is not active, make sure with the Tivoli Workload Scheduler administrator that the connection is restarted or start it again as described in the IBM Tivoli Workload Scheduler Reference Guide, and then rerun the action. If the connection with the Tivoli Workload Scheduler engine is active, then, on that engine, check that: v The Tivoli Workload Scheduler user running the command to list scheduling objects is authorized to do so. For more information on how to set user authorization, refer to the IBM Tivoli Workload Scheduler Reference Guide. v The global property enListSecChk is set to enable on the Tivoli Workload Scheduler master domain manager. For more information on how to set global properties, refer to the IBM Tivoli Workload Scheduler Planning and Installation Guide. Then rerun the action.

Connection problem with the engine when performing any operation

Problem description: Regardless what operation you try to run in the Web console, you get an error message saying that there is a connection problem with the engine. Suggested action: Do the following steps: 1. Exit the Web console. 2. Restart the WebSphere Application Server. 3. Log in again to the Web console. Continue with your activities on Web console.

Default tasks are not converted into the language set in the browser
Problem description: An existing user logs in to the Web console using a browser where the language set is different from the language that was set in the browser the first time he logged in. In the Manage Tasks panel, the default tasks are not translated into the new language. Suggested action: The default tasks are created, using the current language set in the browser, when the new user logs into the Web console for the first time. To have the default tasks translated into a different language, the WebSphere Application Server administrator must create a new Web console user, and use that to login to Web console for the first time using a browser configured with the requested language. By doing this the default tasks are created using the requested language.

Chapter 4. Troubleshooting

69

Troubleshooting run time scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

The output of a report run on Job Statistics View shows -1 in the Average CPU Time and Average Duration fields
Problem description: You run a report accessing the Job Statistics Database View, such as Job Run Statistics or a Custom SQL report, and the output shows the value -1 in Average CPU Time and Average Duration fields. Suggested action: The historical report, regardless of what kind of report you run (for Jobs, Workstations, or Custom SQL), reads in the database the information about the previous production plan run. If some fields in a database view are empty, the value returned in the report output is -1. This means that if you run JNextPlan for the first time, and then you run for example the Job Run Statistics report, the value of Average CPU Time and Average Duration fields is -1. Run JNextPlan again, or wait for the final job stream to run, to populate the database views and get values different from -1.

After Tivoli Workload Scheduler migration from version 8.3 to version 8.4 some fields in the output of reports show default values (-1, 0, unknown, regular)
Problem description: After migrating Tivoli Workload Scheduler from version 8.3 to version 8.4, the output on the Web console of reports run on old migrated jobs show default values for the new fields introduced with version 8.4. Suggested action: This is not a problem or a limitation but the result of migrating data from old tables to new tables containing newly created fields. After migration, it is necessary to assign a value to the new fields introduced in version 8.4 for job runs that occurred before migrating. The values assigned by default to these new fields are: For job run statistic reports:
Table 9. Default settings for new report output fields Value 0 0 0 0 0 -1 -1 Field Number of "Long Duration" job runs Number of "Suppressed" job runs Number of "Started Late" job runs Number of "Ended late" job runs Total Reruns Average CPU Time Average Duration

For job run history reports:

Table 10. Default settings for new report output fields Value unknown Field Workstation Name (Job Stream)

70

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Troubleshooting run time scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 10. Default settings for new report output fields (continued) Value -1 -1 -1 No Regular -1 0 0 unknown Field Started Late (delay hh:mm) Ended Late (delay hh:mm) Estimated Duration (hh:mm) Long Duration Run Type Iteration Number Return Code Job Number Login

The validate command run on a custom SQL query returns the error message AWSWUI0331E
Problem description: You are creating a Custom SQL report, and you run the Validate command to check your query. The validate fails and the following error message is returned:
AWSWUI0331E The SQL query could not be validated. The database internal message is: [ibm][db2][jcc][10103][10941] Method executeQuery cannot be used for update.

Suggested action: The validate failure is caused by a syntax error in the query statement, for example, a typing error, such as:
sele Workstation_name,Job_name,Job_start_time from MDL.JOB_HISTORY_V where Workstation_name like H%

In this query, sele is written in place of select. Verify the SQL query is correct and, optionally, try to run the same query from the DB2 command line to get additional details.

Failure in testing a connection or running reports on an engine using an Oracle database

Problem description: You test the connection to an engine by specifying the user credentials for an Oracle database, or you run a report on that engine connection. The operation fails and the following error message is displayed:
AWSUI0360E The JDBC URL is not configured on the selected engine, so the reporting capabilities cannot be used. Contact the Tivoli Workload Scheduler administrator."

Suggested action: Make sure that the Tivoli Workload Scheduler administrator has updated the TWSConfig.properties file by adding the following key:
com.ibm.tws.webui.oracleJdbcURL

specifying the JDBC Oracle URL. For example:

com.ibm.tws.webui.oracleJdbcURL=jdbc:oracle:thin:@//9.132.235.7:1521/orcl
Chapter 4. Troubleshooting

71

Troubleshooting run time scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Rerun the operation after the TWSConfig.properties has been updated. For more information about showing and changing database security properties for Tivoli Workload Scheduler, refer to the IBM Tivoli Workload Scheduler: Administration and Troubleshooting guide.

If you close the browser window, processing threads continue in the background
Problem description: You perform an action or make a selection and immediately close the browser window. You expect that processing terminated but the messages stored in the SystemOut.log file show that processing continued in the background. Suggested action: This is normal behavior for any Web application, when the client browser is closed no notification is delivered to the server according to the HTTP protocol specifications. This is the reason why the last triggered thread continues to process even after the browser window was closed. You do not need to run any action, just allow the thread to end.

The output of report tasks is not displayed in a browser with a toolbar installed
Problem description: You tested that the connection to the database set in the engine connection works properly but, after you run a report task, no window opens in your browser to display the task results. You have a third-party toolbar installed on your browser. Suggested action: A third-party toolbar (such as Yahoo! or Google or similar) installed on top of the browser might conflict with the correct operation of the Web console reporting feature. To make the reporting feature work correctly you must uninstall the toolbar and then rerun the report task.

Wrong user logged in when using multiple accesses from the same system using FireFox
Problem description: You try to access the Web console as user2 using FireFox on a system where connection through FireFox as user1 to the Web console is already active. FireFox logs you in to the Web console as user1 instead of user2. Suggested action: This is a FireFox limitation. If you have an active connection through FireFox to the Web console, then, if you want to open another session on the same system, you must use a different type of supported browsers. For a list of supported browsers, refer to Supported client browsers on page 8.

The list of Available Groups is empty in the Enter Task Information panel
Problem description:

72

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Troubleshooting run time scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | You are creating a task, and you notice that in the Enter Task Information the list of Available Groups is empty. You are using an LDAP user registry. Suggested action: Log into the Integrated Solutions Console as administrator and check the advanced LDAP configuration settings are correct as follows: 1. In the Navigation tree click on Security. 2. Click on Secure administration, applications, and infrastructure. 3. Check that the Available realm definitions field is set to Standalone LDAP registry. 4. Click on Configure. 5. Click on Advanced Lightweight Directory Access Protocol (LDAP) user registry settings under Additional Properties. 6. Verify that the settings for groups and users are correct for your configuration. For more information about how to set these values, refer to: http:// publib.boulder.ibm.com/infocenter/wasinfo/v6r0/topic/ com.ibm.websphere.express.doc/info/exp/ae/usec_advldap.html

DB2 or Oracle database connection error when running historical reports or testing connection
Problem description: You try to test the connection to an engine where you Enable Reporting, or you try to run a historical report, the report fails and the following database connection error is saved to the WebSphere Application Server logs:
[date_and_time] 00000044 SystemErr R Exception in thread "WnTransactionThread-10" java.lang.VerifyError: class loading constraint violated (class: com/ibm/db2/jcc/c/p method: getSQLJLogWriter()Lcom/ibm/db2/jcc/SQLJLogWriter;) at pc: 0 [date_and_time] 00000044 SystemErr R at java.lang.J9VMInternals.verifyImpl(Native Method) [date_and_time] 00000044 SystemErr R at java.lang.J9VMInternals.verify(J9VMInternals.java:59) [date_and_time] 00000044 SystemErr R at java.lang.J9VMInternals.verify(J9VMInternals.java:57) [date_and_time] 00000044 SystemErr R at java.lang.J9VMInternals.initialize (J9VMInternals.java:120) [date_and_time] 00000044 SystemErr R at com.ibm.db2.jcc.DB2Driver.connect(DB2Driver.java:163) [date_and_time] 00000044 SystemErr R at java.sql.DriverManager.getConnection (DriverManager.java:562) [date_and_time] 00000044 SystemErr R at java.sql.DriverManager.getConnection (DriverManager.java:186) [date_and_time] 00000044 SystemErr R at

The Web console is installed on an external WebSphere Application Server together with other products using either DB2 or Oracle databases. Suggested action: Because of a current WebSphere Application Server limitation, you must run these steps to run historical reports if your Web console is installed on an external WebSphere Application Server together with other products using either DB2 or Oracle databases. 1. Stop the WebSphere Application Server. 2. Remove from the directory:
tdwc_install_dir/AppServer/systemApps/isclite.ear/TWSWebUI.war/WEB-INF/lib

the following JDBC driver files:

Chapter 4. Troubleshooting

73

Troubleshooting run time scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
db2jcc.jar db2jcc_license_cu.jar ojdbc14.jar

3. Start WebSphere Application Server. Note: This WebSphere Application Server limitation does not affect your activities if: v You run Actual Production Details and Planned Production Details reports. v You run operations that do not require to select Enable Reporting in the engine connection properties.

JVM failure when working with the Web console on a Red Hat Enterprise Linux (RHEL) Version 5 system
Problem description: When working with the Web console on a Red Hat Enterprise Linux Version 5 system, a user may see the error Failed to find VM - aborting Suggested action: Red Hat Enterprise Linux Version 5 has a new security feature named Security Enhanced Linux, or SELinux for short. A weaker version of SELinux was included in Red Hat Enterprise Linux Version 4, and was disabled by default. Red Hat Enterprise Linux Version 5 defaults SELinux to enabled. SELinux helps to keep the host secure from certain types of malicious attacks. However, the default settings have been known in many cases to prevent Java from running properly. To fix this issue, you can choose one of the following options: v Configure SELinux so that it knows that the Web console Java related processes are acceptable to run. v Change the mode of SELinux to Permissive by entering setenforce 0 on the command line. SELinux will be fully enabled again the next time the system is rebooted or if setenforce 1 is entered on the command line.

WSWUI0331E error when running reports on an Oracle database

Problem description: You try to run a report on an engine connection where an Oracle database has been referenced. The report task fails and the following error is displayed:
WSWUI0331E SQL validate failure.The database internal message is:ORA-00942: table or view does not exist

If you try to run a SQL query statement in the Oracle database on the same table or view using the userid specified for the database connection in the engine connection properties, the query runs successfully. Suggested action: On Oracle databases only, you must run these steps, as Oracle database administrator, to allow the database user specified in the engine connection properties to run reports from the Web console: 1. Assign to the database user the CREATE TABLE Oracle System privilege. 2. Run the following script:

74

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Troubleshooting run time scenarios

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | On Windows TWS_home\dbtools\oracle\script\dbgrant.bat On UNIX: TWS_home/dbtools/oracle/script/dbgrant.sh

On a Tivoli Workload Scheduler engine the responsiveness decreases overtime

Problem description: When working with an Tivoli Workload Scheduler engine the responsiveness decreases overtime. Suggested action: The problem might be related to multiple production plan report request running on that Tivoli Workload Scheduler engine, since those operations are CPU consuming. Ensure to wait until the report completion before running again other requests of the same kind.

Not enough space message displayed when running production details reports
Problem description: When running production details reports the temporary directory on the Tivoli Workload Scheduler engine where the reports run, could be filled up. Suggested action: You need to free some space in the temporary directory on the Tivoli Workload Scheduler engine before continuing to work on that engine.

Running production details reports might overload the Tivoli Workload Scheduler engine
Problem description: The temporary directory on the Tivoli Workload Scheduler engine where the production details reports run, might be filled up. Suggested action: The amount of memory used by the application server to extract the data varies depending on the number of objects to be extracted. For example, to extract 70000 objects required almost 1 GB of RAM. By default the application server heap size is 512 MB, but it is possible to change this value as follows: 1. Log on to the Tivoli Workload Scheduler workstation as root. 2. Edit the following file:
TWS_home\AppServer\profiles\twsprofiles\config\cells\DefaultNode\nodes\ DefaultNode\servers\TWS_server\server.xml

3. Locate the option maximumHeapSize and set its value to at least 1024 (this value is expressed in Megabytes). 4. Stop and Start the application server. As a general recommendation, use filters to avoid extracting huge production report files.

Chapter 4. Troubleshooting

75

Troubleshooting run time scenarios

76

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Appendix A. Web console messages

In this appendix you find the information about the list of available Web console messages and their descriptions. The appendix is divided into the following sections: v IBM Tivoli message format v List of Web console messages on page 79

IBM Tivoli message format

This section explains the format of the message that Tivoli Dynamic Workload Console displays on your screen or writes in a log file. All messages have a message number and a message text. Many of the error and warning messages also have help. Only messages with message help are documented in this appendix. For messages without help, if you have any problems understanding the message or you are not sure on how to resolve the problems that they indicate, contact IBM Software Support for assistance. This is the format of a Web console message with the message help:
message_number message_text message_help

The following sections describe each part the message is made of.

Message code
The Web console message codes (numbers) have the following format:
<product_prefix><component_code><numeric_identifier><severity>

where the parts of the message are as follows: <product_prefix> A three-digit prefix AWS, which is used for all the Tivoli Workload Scheduler messages. <component_code> A two-digit component code, which for the Web console is UI. <numeric_identifier> A four-digit numeric identifier, which is unique within any combination of prefix and component code. <severity> The severity indicator, which is as follows: I Informational: Informational messages provide you with information or feedback about normal events that have occurred or are occurring, or request information from you in cases where the outcome is not negative, regardless of the response. Examples: v The status request is processing. v The files were successfully transferred. v Do you want to save your output in file a or in file b?
Copyright IBM Corp. 2007

77

IBM Tivoli message format

W Warning: Warning messages indicate that potentially undesirable conditions have occurred or could occur, but the program can continue. Warning messages often ask users to make decisions before processing continues. Examples: v The IP address could not be resolved to a host name. The IP address was added to the baseline file instead of the host name. v A file already exists with the same name. Do you want to overwrite this file? E Error: Error messages indicate problems that require intervention or correction before the program can continue. Examples: v The specified file could not be found. v You are out of space on the x drive. The file cannot be saved to this drive. An example of a complete message code is as follows:
AWSUI0002E

Message text
The message text is a printed representation of the message that was displayed on your screen or was written to the log file. Every attempt has been made to represent the message text exactly as it appears to the user in the displayed or written message. Any differences that occur are usually occasioned by the different layout of the book (in two columns) with respect to the message display panel or log. Further, where the system has included variable information in the message text, this variable information is represented in this publication by an italicized label, describing the type of information referred to by the variable. For example, if the message text that is displayed on your screen is as follows:
The tool cannot read the file: "migration.properties".

the message text shown in the publication would be as follows:

The tool cannot read the file: "properties_file_name".

In this case the label properties_file_name tells you that the information that is inserted by the system is the name of the file which could not be read.

Message help
This is the information provided in the message help part: Explanation An explanation, where necessary, of the message text. System action A description of what the system or process does as a result of the condition that caused the message. Operator response What you must do in response to the condition that caused the message.

78

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0001E AWSUI0003E
Often you are able to resolve such conditions yourself, but sometimes you are asked to contact IBM Software Support. See also A reference to any publication that might give you assistance with understanding or resolving the problem.

List of Web console messages

In this section you find the list of Web console messages grouped by topic as follows: v Installation messages v Interface messages on page 86 v Server Messages on page 149 v R3Batch Messages on page 151 Notes: 1. This publication does not contain any details of Informational messages, as they are complete within themselves, and do not need further explanation. 2. This guide contains runtime error messages impacting only the Tivoli Workload Scheduler environment. For the runtime error messages impacting the Tivoli Dynamic Workload Broker environment, refer to the Tivoli Dynamic Workload Broker: Installation and Configuration guide.

| | | |

Installation messages
AWSUI0001E The user name has an incorrect number of characters. The permitted range is between 3 and 60. Explanation: The value entered as user name does not fall within the permitted range. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a user name that falls within the supported range, and launch a new installation. Wizard installation Re-enter the user name ensuring that it falls within the supported range, and proceed with the installation. AWSUI0002E The user name can only contain the following characters: a-z, A-Z, 0-9, period (.), hyphen (-), underscore ( _ ) and DBCS characters. Explanation: The entered value contains characters that are not supported. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a user name that contains only supported characters. Wizard installation Re-enter the user name ensuring that it does not contain any unsupported characters, and proceed with the installation. AWSUI0003E The password has an incorrect number of characters. The permitted range is between 5 and 60. Explanation: The value entered as password does not fall within the permitted range. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running:

Appendix A. Web console messages

79

AWSUI0004E AWSUI0009E
Silent installation Edit the response file specifying a password that falls within the supported range, and launch a new installation. Wizard installation Re-enter the password ensuring that it falls within the supported range, and proceed with the installation. AWSUI0004E The password can only contain the following characters: a-z, A-Z, 0-9, period (.), hyphen (-), and underscore (_). Explanation: The entered value contains characters that are not supported. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a password that contains only supported characters. Wizard installation Re-enter the password ensuring that it does not contain any unsupported characters, and proceed with the installation. AWSUI0005E The password and the confirm password are not the same. Explanation: The confirm password must be the same as the password. System action: The graphical wizard installation, stops with an error message. Operator response: Re-enter the password and confirm password ensuring they are the same, and proceed with the installation. AWSUI0006E The user name cannot be blank. Explanation: A value must be entered in the user name field. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a valid user name, and launch a new installation. Wizard installation Enter a valid user name, and proceed with the installation. AWSUI0007E The password cannot be blank. Explanation: A value must be entered in the password field. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a valid password, and launch a new installation. Wizard installation Enter a valid password, and proceed with the installation. AWSUI0008E The installation path is too long: it must be shorter than 32 characters. Explanation: The value entered as installation path does not fall within the permitted range. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying an installation path that falls within the supported range, and launch a new installation. Wizard installation Re-enter the installation path ensuring that it falls within the supported range, and proceed with the installation. AWSUI0009E The installation path contains the following unsupported characters or non US-ASCII characters: unsupported_characters. Explanation: The entered value contains characters that are not supported. System action: If you are running the graphical

80

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0010E AWSUI0019E
wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying an installation path that contains only supported characters. Wizard installation Re-enter the installation path ensuring that it does not contain any unsupported characters, and proceed with the installation. AWSUI0010E A stand-alone Integrated Solutions Console has been found: it is not possible to install a new one. Explanation: An Integrated Solutions Console cannot be installed on a computer where another Integrated Solutions Console is already present. System action: The installation exits with an error. Operator response: Run a new installation on a different computer. AWSUI0011E The value install_method specified for the INSTALL_METHOD variable is not supported. The only supported values are: NEW and ONWAS. Explanation: The specified INSTALL_METHOD is not valid. System action: The installation exits with an error. Operator response: Edit the response file specifying a supported installation method. AWSUI0014E The TCP/IP port tcpip_port_label is not valid. Explanation: The value entered as TCP/IP port is not valid. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a valid TCP/IP port number, and launch a new installation. Wizard installation AWSUI0018E The user is not authorized to run this installation. Explanation: Administrators privileges are required to run the installation. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: Login as an Administrator and launch a new installation. AWSUI0019E The service ID can only contain the following characters: a-z, A-Z and 0-9. Explanation: The entered value contains characters that are not supported. System action: If you are running the graphical wizard installation, the installation stops with an error message. AWSUI0016E Port number tcpip_port_value has been specified for ports: tcpip_port_names. Explanation: The value entered for TCP/IP port has already been assigned to the other ports indicated in the message text. System action: The installation stops with an error message. Operator response: Re-enter a new TCP/IP port number, and proceed with the installation. Re-enter a valid TCP/IP port number, and proceed with the installation. AWSUI0015E Port number tcpip_port_value specified for tcpip_port_name is already in use. Explanation: The specified TCP/IP port is already used by another product. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a new TCP/IP port number, and launch a new installation. Wizard installation Re-enter a new TCP/IP port number, and proceed with the installation.

Appendix A. Web console messages

81

AWSUI0020E AWSUI0027E
If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a service ID that contains only supported characters. Wizard installation Re-enter the service ID ensuring that it does not contain any unsupported characters. AWSUI0020E The WebSphere Application Server service ID must not be blank. Explanation: A value must be entered in the service ID field. System action: The installation stops with an error message. Operator response: Enter a valid service ID, and proceed with the installation. AWSUI0022E The operation cannot proceed because WebSphere Application Server is not active and it is not possible to check the specified credentials. Start the server before proceeding. Explanation: WebSphere Application Server must be up and running for the installation to take place. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Start WebSphere Application Server and launch a new installation. Wizard installation Start WebSphere Application Server and proceed with the installation. AWSUI0023E The credentials provided for the WebSphere Application Server administrator are not correct. Explanation: The values entered as credentials for WebSphere Application Server are not correct. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying valid credentials, and launch a new installation. Wizard installation Re-enter the credentials ensuring that are valid, and proceed with the installation. AWSUI0024E The installation completed, but with errors. See the previous installation log messages. Explanation: The installation failed due to some errors. You can find the error messages in the installation log file, before current error. System action: The system deletes any installed files. Operator response: Check the errors that caused the installation failure in the installation log file, fix them and run a new installation. AWSUI0025E The console installation type is not supported. Use the graphical interactive installation or the silent (response file) installation. Explanation: This installation mode is not supported. System action: Installation does not start. Operator response: Launch a new installation using one of the supported methods: either the graphical wizard or the silent installation. AWSUI0026E The uninstallation completed, but with errors. See the previous installation log messages. Explanation: The uninstallation completed but not all the files have been removed. You can find the error messages in the log file, before current error. System action: The system uninstalls the application but leaves some files to be removed manually. Operator response: Check the errors that caused the uninstallation failure in the log file. Optionally, remove the unnecessary files that have not been uninstalled properly. AWSUI0027E An unsupported version of WebSphere Application Server has been selected. Explanation: The entered version of WebSphere Application Server is not supported. System action: If you are running the graphical wizard installation, the installation stops with an error message.

82

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0028E AWSUI0034E
If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a supported version of WebSphere Application Server, and launch a new installation. Wizard installation Enter a supported version of WebSphere Application Server, and proceed with the installation. AWSUI0028E Security is not enabled on the selected instance of WebSphere Application Server. Explanation: The installation of the product requires security to be enabled on the selected instance of WebSphere Application Server. System action: The installation exits with an error. Operator response: Enable security on the selected instance of WebSphere Application Server or select a different instance of WebSphere Application Server that has security enabled. AWSUI0029E There is no instance of WebSphere Application Server in the specified directory "directory_name". Explanation: The specified directory does not contain any instance of WebSphere Application Server. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a different directory, and launch a new installation. Wizard installation Specify a different directory that contains an instance of WebSphere Application Server, and proceed with the installation. AWSUI0030W Unable to verify the TCP/IP port "tcpip_port_name". Reason: error_message Explanation: The availability of the specified TCP/IP port could not be verified. System action: Installation continues without checking port availability. AWSUI0034E The specified WebSphere Application Server profile "profile_name" does not exist. Explanation: It has been specified a WebSphere Application Server profile that does not exist. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: Proceed with the installation. AWSUI0031E The WebSphere Update Installer location cannot be blank. Explanation: A location must be specified for the WebSphere Update Installer. System action: The installation stops with an error message. Operator response: Enter a valid location, and proceed with the installation. AWSUI0032E One of the parameters for WebSphere Application Server "was_info" was blank. Explanation: A value must be entered as a parameter for WebSphere Application Server. The field cannot be left blank. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a parameter, and launch a new installation. Wizard installation Enter a parameter for WebSphere Application Server, and proceed with the installation. AWSUI0033W The installation wizard cannot check the installation of the selected WebSphere Application Server. Check that it is installed correctly. Explanation: It was not possible to verify that WebSphere Application Server is correctly installed. System action: Installation continues. Operator response: Check that it is installed correctly, and proceed with the installation.

Appendix A. Web console messages

83

AWSUI0035E AWSUI0042E
Operator response: If you are running: Silent installation Edit the response file specifying a valid WebSphere Application Server profile name, and launch a new installation. Wizard installation Specify a valid WebSphere Application Server profile name , and proceed with the installation. AWSUI0035E The specified WebSphere Application Server application server "server_name" does not exist. Explanation: It has been specified a WebSphere Application Server that does not exist. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a valid WebSphere Application Server name, and launch a new installation. Wizard installation Specify a valid WebSphere Application Server name, and proceed with the installation. AWSUI0036E The specified WebSphere Application Server cell "cell_name" does not exist. Explanation: It has been specified a WebSphere Application Server cell that does not exist. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a valid WebSphere Application Server cell name, and launch a new installation. Wizard installation Specify a valid WebSphere Application Server cell name, and proceed with the installation. AWSUI0037E The specified WebSphere Application Server node "node_name" does not exist. Explanation: It has been specified a WebSphere Application Server node that does not exist. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a valid WebSphere Application Server node name, and launch a new installation. Wizard installation Specify a valid WebSphere Application Server node name , and proceed with the installation. AWSUI0038E There is no instance of the WebSphere Update Installer in the specified directory "directory_name". Explanation: The specified directory does not contain any WebSphere Update Installer. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running: Silent installation Edit the response file specifying a valid directory, and launch a new installation. Wizard installation Specify a valid directory, and proceed with the installation. AWSUI0042E There is insufficient space in the path file system to complete the installation. At least required_disk_space is required. Explanation: The specified file system does not have enough available free space for the installation to complete. Required space is specified in the message. System action: If you are running the graphical wizard installation, the installation stops with an error message. If you are running the silent installation, the installation exits with an error. Operator response: If you are running:

84

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0043E
Silent installation Free the required space on the file system, and launch a new installation. Wizard installation Free the required space on the file system, and proceed with the installation. AWSUI0043E The Tivoli Dynamic Workload Console is already installed on this system. You cannot install another instance. Explanation: It is not possible to install more than one instance of Tivoli Dynamic Workload Console on the same system. System action: Installation fails. Operator response: Uninstall the existing Tivoli Dynamic Workload Console or install the new Tivoli Dynamic Workload Console on a different system.

Appendix A. Web console messages

85

AWSUI0100E AWSUI0105E

Interface messages
AWSUI0100E The job stream list cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The job stream list could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0101E The plan view cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The plan view could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0102E The resource list cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The resource list could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0103E The resource plan view cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The resource plan view could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0104E The workstation list cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The workstation list could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0105E The job stream instance "instance_name" cannot be opened because of the following engine error: engine_error_message_ID Explanation: The job stream instance could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

86

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0106E AWSUI0112E
AWSUI0106E The job stream "job_stream_name" cannot be updated because of the following engine error: engine_error_message_ID Explanation: The job stream could not be updated due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0107E The Job Stream Editor cannot be opened because of the following engine error: engine_error_message_ID Explanation: The Job Stream Editor could not be opened due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0108E The Job Stream Instance Editor cannot be opened because of the following engine error: engine_error_message_ID Explanation: The Job Stream Instance Editor could not be opened due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0109E The Resource Editor cannot be opened because of the following engine error: engine_error_message_ID Explanation: The Resource Editor could not be updated due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0110E The structure cannot be built because of the following engine error: engine_error_message_ID Explanation: The structure could not be built due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0111E The job stream cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The job stream could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0112E The resource availability definition cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The resource availability definition could
Appendix A. Web console messages

87

AWSUI0113E AWSUI0119E
not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting AWSUI0113E The job stream cannot be saved if it does not contain at least one job, because of the following engine error: engine_error_message_ID Explanation: The job stream could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0114E The job stream cannot be saved because of the following engine error: engine_error_message_ID Explanation: The job stream could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0115E The resource "resource_name" cannot be saved because of the following engine error: engine_error_message_ID Explanation: The resource could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0116E The resource "resource_name" cannot be saved because of the following engine error: engine_error_message_ID Explanation: The resource could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0117E The dependency between the selected jobs cannot be added because they are both in the same job stream. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Select a dependency on a job in another job stream. Retry the operation. AWSUI0118E All of the fields in this panel are obligatory. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Complete all the fields in the panel before pressing OK. AWSUI0119E The jobs in the job stream instance were not found. Specify different filter criteria and run the list again. Explanation: See message. System action: The requested action was not completed successfully. The job list is returned empty. Operator response: Try to generate a new list by specifying different filter criteria.

88

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0120E AWSUI0128E
AWSUI0120E The job stream instance was not found. Specify different filter criteria and run the list again. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Specify different filter criteria and run the list again. AWSUI0121E The dependency cannot be created because it creates a circular dependency. Define a valid dependency. Explanation: In job A you have defined a dependency on job B, but job B is dependent, directly or indirectly, on job A. System action: The requested action was not completed successfully. Operator response: Define a valid dependency that does not create a circular dependency. Retry the operation. AWSUI0123E A job stream must be saved in the database before it can be scheduled. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Save the job stream in the database and then schedule it. AWSUI0124E The job stream instance cannot be found. Try a different name. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply the correct name for the job stream instance. Retry the operation. AWSUI0125E The workstation "workstation_name" cannot be saved because of the following engine error: engine_error_message_ID Explanation: The workstation could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0126E The workstation "workstation_name" cannot be saved because of the following engine error: engine_error_message_ID Explanation: The workstation could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0127E A class cast exception has occurred in the engine because of the following engine error: engine_error_message_ID Explanation: There was a class cast exception due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0128E The following problem has occurred with the job scheduling engine. engine_error_message_ID Explanation: There is a problem with the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.
Appendix A. Web console messages

89

AWSUI0129E AWSUI0135E
AWSUI0129E The panel cannot close because of the following engine error: engine_error_message_ID Explanation: The panel could not be closed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0130E The job dependency cannot be added because of the following engine error: engine_error_message_ID Explanation: The job dependency could not be added due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0131E You clicked OK, but the request cannot be processed because of the following engine error: engine_error_message_ID Explanation: The OK request could not be processed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0132E The job cannot be changed because of the following engine error: engine_error_message_ID Explanation: The job could not be changed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0133E The job cannot be added because of the following engine error: engine_error_message_ID Explanation: The job could not be added due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0134E The instance cannot be modified because of the following engine error: engine_error_message_ID Explanation: The instance could not be modified due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0135E The instance "instance_name" cannot be deleted because of the following engine error: engine_error_message_ID Explanation: The instance could not be deleted due to an error that occurred in the Tivoli Workload Scheduler

90

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0136E AWSUI0141E
engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0136E The instance "instance_name" cannot be held because of the following engine error: engine_error_message_ID Explanation: The instance could not be held due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0137E The instance "instance_name" cannot be released because of the following engine error: engine_error_message_ID Explanation: The instance could not be released due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0138E The object cannot be deleted because of the following engine error: engine_error_message_ID Explanation: The object could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0139E The object cannot be undeleted because of the following engine error: engine_error_message_ID Explanation: The object could not be undeleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0140E The status in the database cannot be modified because of the following engine error: engine_error_message_ID Explanation: The status in the database could not be modified due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0141E The job cannot be removed because of the following engine error: engine_error_message_ID Explanation: The job could not be removed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.
Appendix A. Web console messages

91

AWSUI0142E AWSUI0147E
AWSUI0142E The job dependency cannot be removed because of the following engine error: engine_error_message_ID Explanation: The job dependency could not be removed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0143E The dependency cannot be removed because of the following engine error: engine_error_message_ID Explanation: The dependency could not be removed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0144E The external dependency cannot be removed because of the following engine error: engine_error_message_ID Explanation: The external dependency could not be removed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0145E The requested action on the selected objects cannot be performed because of the following engine error: engine_error_message_ID Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0146E The job stream operation cannot be performed because of the following engine error: engine_error_message_ID Explanation: The job stream operation could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0147E The requested action on the selected object cannot be performed because of the following engine error: engine_error_message_ID Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

92

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0148E AWSUI0153E
AWSUI0148E The requested action on the selected objects cannot be performed because of the following engine error: engine_error_message_ID Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0149E The instance cannot be updated from services because of the following engine error: engine_error_message_ID Explanation: The instance could not be updated due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0150E The requested action on the selected object cannot be performed because of the following engine error: engine_error_message_ID Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0151E The requested action on the selected objects cannot be performed because of the following engine error: engine_error_message_ID Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0152E The requested action on the selected objects cannot be performed because of the following engine error: engine_error_message_ID Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0153E The requested action cannot be performed because of the following engine error: engine_error_message_ID Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

Appendix A. Web console messages

93

AWSUI0154E AWSUI0159E
AWSUI0154E The workstation cannot be opened because of the following engine error: engine_error_message_ID Explanation: The workstation could not be opened due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0155E The workstation editor cannot be opened because of the following engine error: engine_error_message_ID Explanation: The workstation editor could not be opened due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0156E The requested action on the selected objects cannot be performed because of the following engine error: engine_error_message_ID Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0157E The workstation cannot be deleted because of the following engine error: engine_error_message_ID Explanation: The workstation could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0158E The selected workstations cannot be deleted because of the following engine error: engine_error_message_ID Explanation: The selected workstations could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0159E The schedule specifications cannot be added because of the following engine error: engine_error_message_ID Explanation: The schedule specifications could not be added due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

94

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0160E AWSUI0165E
AWSUI0160E Another run cycle cannot be created because of the following engine error: engine_error_message_ID Explanation: Another run cycle could not be created due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0161E The requested action cannot be performed because of the following engine error: engine_error_message_ID Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0162E The operation cannot be interrupted because of the following engine error: engine_error_message_ID Explanation: The operation could not be interrupted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0163E The selected resource cannot be deleted because of the following engine error: engine_error_message_ID Explanation: The resource could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0164E The selected resources cannot be deleted because of the following engine error: engine_error_message_ID Explanation: The resources could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0165E Cannot read the resource header because of the following engine error: engine_error_message_ID Explanation: The resource header could not be retrieved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

Appendix A. Web console messages

95

AWSUI0166E AWSUI0175E
AWSUI0166E The resource cannot be opened because of the following engine error: engine_error_message_ID Explanation: The resource could not be opened due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0167E The resource dependency changes cannot be saved because of the following engine error: engine_error_message_ID Explanation: The resource dependency could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0168E The scheduling specifications cannot be added because of the following engine error: engine_error_message_ID Explanation: The scheduling specifications could not be added due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0169E The scheduling specifications cannot be added because of the following engine error: engine_error_message_ID Explanation: The scheduling specifications could not be added due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0173E The object "object_name" is currently locked because it is being updated by another user. It is displayed in read-only mode until the user releases it. Try again later. Explanation: See message. System action: Processing continues but the object is displayed in read-only mode. Operator response: Try to update the object later, after it has been released. AWSUI0174E The connector cannot be linked. The connector is not present on the server. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Check whether a connector is installed on the server. If a connector is not installed, install an instance. See also: Job Scheduling Console Users Guide AWSUI0175E This view cannot be detached. The maximum number of concurrent detachable views allowed is reached. Close one of the open views. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Close one of the open views and try to detach the view again.

96

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0176E AWSUI0185E
AWSUI0176E The job stream cannot be saved because it contains an external job that has no link, which is not allowed. Remove the external job that has no link or link it with another job. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Remove the external job that has no link or link it with another job. Retry the save of the job stream. AWSUI0177E The external dependency cannot be added, because a job stream cannot have external dependencies from other job scheduling engines. Explanation: An attempt was made to add a dependency from a different job scheduling engine. A job stream cannot have external dependencies from other job scheduling engines. System action: The requested action was not completed successfully. Operator response: Add the dependency into a job stream on the same engine. Retry the operation. AWSUI0178E The search objects cannot be found because of the following engine error: engine_error_message_ID Explanation: The search objects could not be found due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0180E The selected engine is not available because of the following engine error: engine_error_message_ID Explanation: The selected engine is not available due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0181E The view cannot be attached for the following reason: reason Explanation: See message. System action: The requested action was not completed successfully. Operator response: The selected view probably has a pending dialog. Close the dialog before attaching the view. AWSUI0182E The workstation plan view cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The workstation plan view could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0183E The job output cannot be loaded. The job output uses an unsupported encoding. Reason: reason Explanation: The job output could not be loaded because it uses an unsupported encoding. System action: The requested action was not completed successfully. Operator response: Contact IBM Customer Support for assistance. AWSUI0185E The common plan view for "V ALUE_1" cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The plan view could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully.
Appendix A. Web console messages

97

AWSUI0186E AWSUI0200E
Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0186E The selected engine is not available. There might be a connection problem or it might have a version that is not valid. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Verify the connection for the selected engine and make sure that the version is compatible. If necessary upgrade the engine or the console. Then try the action again. AWSUI0188E The job "job_name" cannot be updated because of the following engine error: engine_error_message_ID Explanation: The job could not be updated due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0193E The list "list_name" cannot be created because a list with the same name and the same path already exists. The panel cannot be closed. Explanation: Two lists cannot be created with the same name in the same path. System action: The requested action was not completed successfully. Operator response: Supply a new list name. Retry the operation. AWSUI0194E The job stream was not found. Try a different name. Explanation: The job stream was not found. System action: The requested action was not completed successfully. Operator response: Supply different filter criteria and run the list again. AWSUI0197W The number format is not correct. Explanation: The number format is not correct. The value remains unchanged. System action: The requested action was not completed successfully. Operator response: Supply a new number in the correct format. Retry the operation. AWSUI0199E The workstation definition for "workstation_name" cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The workstation definition could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0200E The resource availability definition cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The resource availability definition could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0196E The window cannot be closed. You cannot create the list "list_name" because a list with the same name and the same path already exists. Explanation: Two lists cannot be created with the same name in the same path. System action: The requested action was not completed successfully. Operator response: Supply a new list name.

98

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0201E AWSUI0206E
AWSUI0201E The job stream list cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The job stream list could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0202E The plan view cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The plan view could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0203E The resource list cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The resource list could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0204E The workstation plan view cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The workstation plan view could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0205E The workstation list cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The workstation list could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0206E The resource "resource_name" cannot be saved because of the following engine error: engine_error_message_ID Explanation: The resource could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

Appendix A. Web console messages

99

AWSUI0207E AWSUI0236E
AWSUI0207E The resource availability definition for "resource_name" cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The resource availability definition could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0208E The resource instance for "resource_name" cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The resource instance could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0209E The internal class name: "class_name" is not fully qualified. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Specify a fully qualified class name. AWSUI0210E The date format is incorrect. The date must be in the same format as the locale settings of the computer. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply the date, month, and year in the format specified in the locale settings on the computer. Retry the operation. AWSUI0211E The supplied deadline occurs before the start time. Supply a later deadline. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a deadline that is later than the start time. Retry the operation. AWSUI0225E The operation cannot be performed on this job instance. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Select another instance on which to perform the operation, or another operation to perform on the selected instance. AWSUI0226E The specified calendar cannot be found. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Check that you have identified the required calendar correctly. Specify another calendar or create the required calendar. AWSUI0235E The input field is mandatory. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Complete all mandatory fields. Mandatory fields are indicated by an asterisk after the field name, and a yellow background to the data input area. Retry the operation. AWSUI0236E The value exceeds the maximum length of maximum_length characters (Single Byte Character Set). Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a value with a number of characters that is less than or equal to the allowed maximum length. Retry the operation.

100

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0237E AWSUI0246E
AWSUI0237E The value is less than the minimum length of minimum_length characters (Single Byte Character Set). Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a value with a number of characters that is greater than the minimum length. Retry the operation. AWSUI0238E The Node is incorrect. Supply a valid IP address (in the format 999.999.999.999) or a valid node name (in the format: <server>.<domain>). Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a valid IP address (in the format 999.999.999.999) or a valid node name (in the format: <server>.<domain>). Retry the operation. AWSUI0239E The string contains one or more characters that are not alphanumeric. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a string using alphanumeric characters only. Retry the operation. AWSUI0240E An internal application error has occurred in the job stream editor. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Contact IBM Customer Support for assistance. AWSUI0241E An internal error has occurred. The view must run within an IBM Tivoli Workload Scheduler Job Scheduling Console. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Contact IBM Customer Support for assistance. AWSUI0242E An internal error has occurred. A runtime exception has been given by the JSDefaultRunCyclePlugIn. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Contact IBM Customer Support for assistance. AWSUI0243E The Job Stream Editor cannot be opened because of the following engine error: engine_error_message_ID Explanation: The Job Stream Editor could not be opened due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0244E An internal connection error caused by an oserv failure has occurred when running the connector. Details are logged in the Job Scheduling Console trace file. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Contact IBM Customer Support for assistance. AWSUI0245E A job stream must contain at least one job before it can be saved. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Define at least one job before saving the job stream. AWSUI0246E The necessary localization resources were not found. Explanation: The resources necessary to show the localized version were not found. System action: Processing continues but the dialogs
Appendix A. Web console messages

101

AWSUI0247E AWSUI0266E
are shown without messages. Operator response: Contact IBM Customer Support for assistance. AWSUI0247E The string is not valid because it is not a numeric value. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a numeric string. Retry the operation. AWSUI0248E The input is outside the accepted range of minimum_value to maximum_value. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a value within the accepted range. Retry the operation. AWSUI0253E The resource editor cannot be opened because of the following engine error: engine_error_message_ID Explanation: The resource editor could not be opened due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0254E The resource name has not been supplied. Explanation: The resource name is a mandatory field. System action: The requested action was not completed successfully. Operator response: Supply a name for the resource. Retry the operation. AWSUI0259E The time format is not correct. The correct format is format. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply the time in the correct format. Retry the operation. AWSUI0260E An internal error has occurred. The Job Scheduler Explorer Console must run within the Tivoli Console. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Contact IBM Customer Support for assistance. AWSUI0261E There was an unexpected error while updating. Repeat the operation. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Retry the operation. AWSUI0263E An internal error has occurred. The Time Zone value "non_valid_time_zone_value" is not a valid Time Zone. Explanation: See message. System action: Processing continues. Operator response: Contact IBM Customer Support for assistance. AWSUI0264E The Workstation name has not been supplied. Explanation: The Workstation name is a mandatory field. System action: The requested action was not completed successfully. Operator response: Supply a Workstation name. Retry the operation. AWSUI0266E This file cannot contain blanks. Explanation: The blank character is not a valid character. System action: The requested action was not completed successfully. Operator response: Supply the string again without using the blank character. Retry the operation.

102

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0267E AWSUI0283E
AWSUI0267E The rule is not valid. Ensure that the shift origin field is consistent with the periods selected. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Ensure that all rule details are correct. Supply an inclusive shift origin value in the periods selected. Retry the operation. AWSUI0269E The Duration of the job instance cannot be zero. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Set the Duration of the job instance to a value other than zero. Retry the operation. AWSUI0276E The query has not returned any results because the From Date value is later than the To Date value. Enter an earlier From Date or Time value or enter a later To Date or Time value Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply an earlier From Date, or type a later To Date. Retry the query. AWSUI0277E The query does not return any results because the Date filter is not set correctly. In the Dates section, when you set a value for the Date field you must also set a value for the Time field. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Set filter values for both the Date and the Time fields, or do not set values for either. Retry the query. AWSUI0278E The query does not return any results because the Date filter is not set correctly. In the Dates section, when a value is set for the Time field a value must also be set for the Date field. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Set filter values for both the Date
Appendix A. Web console messages

and the Time fields, or do not set values for either. Retry the query. AWSUI0279E An engine with the specified name already exists. Explanation: Two engines with the same name cannot exist for the same instance of the Tivoli Dynamic Workload Console. System action: The requested action was not completed successfully. Operator response: Supply a different engine name. AWSUI0280E An error occurred while saving the engines to the engines file. Details are logged in the Job Scheduling Console trace file. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Check the trace file and correct the cause of the error. Retry the operation. AWSUI0281E The host name could not be resolved, or the host computer is not running, or not accessible in the network. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Check the host name and make sure the computer where the host is running is active and accessible in the network (try pinging the host using the host name you supplied). Retry the operation. AWSUI0283E The object object_name cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The object could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

103

AWSUI0286E AWSUI0296E
AWSUI0286E A run cycle with the same name already exists in the job stream. Explanation: Two run cycles with the same name cannot exist for the same job stream. System action: The requested action was not completed successfully. Operator response: Supply a different name for the new run cycle. Retry the operation. AWSUI0289E The input value is greater than the upper limit of maximum_value. Explanation: The value must be less then or equal to 31/12/2999 23:59:59. System action: The requested action was not completed successfully. Operator response: Supply a value that is within the limit. Retry the operation. AWSUI0290E The imported file Engine.xml is corrupt. The Job Scheduling Console does not function correctly. Close the Job Scheduling console and delete the file Engine.xml from the directory <user_home_directory>/.twsconsole . Explanation: See message. System action: The requested action was not completed successfully. Operator response: Ignore any other messages and close the application. Delete the <user_home_directory>/.twsconsole/Engine.xml file and restart the Job Scheduling Console. AWSUI0291E The job stream job_stream_name cannot be submitted because of the following engine error: engine_error_message_ID Explanation: The job stream could not be submitted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. AWSUI0295E A job cannot depend on itself. Explanation: You have defined a dependency so that job A depends on job B, but jobs A and B are the same. System action: The requested action was not completed successfully. Operator response: Change the dependency to a job other than itself. Retry the operation. AWSUI0296E Cannot find the specified external dependency. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Ensure that the object of an external dependency exists before setting the dependency. Retry the operation. AWSUI0294E Cannot find the specified internal job. Explanation: A job that belongs to this job stream cannot be found. Perhaps it has been deleted. System action: The requested action was not completed successfully. Operator response: Check whether the job exists in the database. If it does not, remove the job from the job stream. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0292E Unable to add a dependency to the selected object. Explanation: System action: Operator response: AWSUI0293E Unable to add the dependency from V ALUE_0 to V ALUE_1Reason: V ALUE_2 Explanation: System action: Operator response:

104

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0297E AWSUI0307E
AWSUI0297E Cannot find the specified job definition. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply the job name of an existing job definition. AWSUI0298E Cannot write file file_name. Reason: system_error_message. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Check the reason given in the system_error_message. Resolve the problem. If you cannot determine the problem from the error message, check that there is sufficient space to write the file, and that the user using the console has permission to write in the indicated directory. Retry the operation. AWSUI0299E Cannot open file file_name. Reason: system_error_message. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Check the reason given in the system_error_message. Resolve the problem. If you cannot determine the problem from the error message, check that there is sufficient space to write the file, and that the user using the console has permission to write in the indicated directory. Retry the operation. AWSUI0300E The file file_name does not exist. Explanation: See message. System action: The requested action was not completed successfully. Operator response: If the file exists but with a different name, rename it to the expected name. Retry the operation. AWSUI0302E A job stream cannot contain two jobs with the same name. Explanation: You have tried to add a job to a job stream, but the job stream already contains a job with the same name. System action: The requested action was not completed successfully. Operator response: Resolve why you wanted to add two jobs with the same name. If you want to perform the same job twice within a job stream, consult the AWSUI0303E The same dependency cannot be defined twice in the same job stream. Explanation: A dependency between job streams must be unique. System action: The requested action was not completed successfully. Operator response: Modify one or both dependencies to make them unique. Retry the operation. AWSUI0304E A run cycle with the same name already exists in the Job Stream. Explanation: Run cycle names in job streams must be unique. System action: The requested action was not completed successfully. Operator response: Modify one or both run cycles to make their names unique. Retry the operation. AWSUI0305E Cannot logon to the remote server. Explanation: The remote server is not reachable. System action: The requested action was not completed successfully. Operator response: Check the validity of the user name and password. Check if the connection with the remote server is available. Check if the remote server is started. Retry the operation. AWSUI0306E The name is not valid. The initial character must be a letter, while subsequent characters can be mixed alphanumeric including permitted_special_characters but no blank characters are allowed. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a name that conforms to the indicated naming rules. AWSUI0307E The query name is not valid. The initial character must be a letter or a wildcard, while subsequent characters can be mixed alphanumeric including wildcards and permitted_special_characters Explanation: See message. System action: The requested action was not completed successfully.
Appendix A. Web console messages

Tivoli Workload Scheduler documentation for information on how to do this. Correct the data and retry the operation.

105

AWSUI0311E AWSUI0319E
Operator response: Supply a name that conforms to the indicated naming rules. AWSUI0311E The job output of job job_name cannot be loaded because of the following engine error: engine_error_message_ID Explanation: The job output could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested action was not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0312E The name is not valid. It must be alphanumeric including permitted_special_characters. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a valid value using only the permitted characters. Retry the operation. AWSUI0313E No value has been entered in the workstation field. If the job definition is specified, the workstation field is mandatory. Explanation: To rerun a job you have to specify either both the job definition and workstation, or neither of them (in this case, the original job definition and workstation will be used). System action: The requested action was not completed successfully. Operator response: Specify the workstation or clear the job definition field. Retry the operation. AWSUI0314E No value has been entered in the job definition field. If the workstation is specified, the job definition field is mandatory. Explanation: To rerun a job you have to specify either both the job definition and workstation, or neither of them (in this case, the original job definition and workstation will be used). System action: The requested action was not completed successfully. Operator response: Specify the job definition or clear the workstation field. Retry the operation. AWSUI0315E The name is not valid. The initial character must be a letter, a wildcard, or a national character, subsequent characters can be mixed alphanumeric including wildcards and national characters. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a valid value using only the permitted characters. Retry the operation. AWSUI0316E The name is not valid. The initial character must be a letter or permitted_initial_characters, subsequent characters can be mixed alphanumeric including permitted_special_characters. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a valid value using only the permitted characters. Retry the operation. AWSUI0317E The string must be alphanumeric including permitted_special_characters. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a valid value using only the permitted characters. Retry the operation. AWSUI0318E The field is mandatory - the value cannot be blank. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a valid value for this mandatory field. Retry the operation. AWSUI0319E An incorrect value has been supplied. The value must be an integer (whole number). Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply an integer for this value. Retry the operation.

106

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0324E AWSUI0336E
AWSUI0324E At least one of the following fields field_list must be completed. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Fill at least one of the fields indicated in the error message. Retry the operation. AWSUI0325E The field field_name cannot be empty. Explanation: See message. System action: The requested action was not completed successfully.c Operator response: Supply a valid value for this mandatory field. Retry the operation. AWSUI0326E The object cannot be found. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Check and correct the object name or specify another object. Retry the operation. AWSUI0327E The input value cannot contain only V ALUE_0 character or characters. Explanation: A string containing less than the indicated minimum characters has been entered. System action: The requested action was not completed successfully. Operator response: Enter a valid value of more than the indicated minimum characters. Retry the operation. AWSUI0329E The dependency cannot be created because it creates a circular dependency. Define a valid dependency. Explanation: In job A you have defined a dependency on job B, but job B is dependent, directly or indirectly, on job A. System action: The requested action was not completed successfully. Operator response: Define a valid dependency that does not create a circular dependency. Retry the operation. AWSUI0330E The field_name field is mandatory for internal dependencies. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a valid value for this mandatory field. Retry the operation. AWSUI0331E An internal error has occurred.. The SQL query could not be validated. The database internal message is: database_message Explanation: See message. System action: The requested action was not completed successfully. Operator response: Contact IBM Customer Support for assistance. AWSUI0333E At least one Status must be specified. Explanation: For the requested operation at least one Status value must be supplied. System action: The requested action was not completed successfully. Operator response: Supply at least one Status value. Retry the operation. AWSUI0334E The CSV separator must be specified. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply the CSV separator. Retry the operation. AWSUI0335E The Query SQL statement field is mandatory for the Custom SQL Report. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply the Query SQL statement field. Retry the operation. AWSUI0336E The connection to the database failed. Check that the database is available and the connection parameters are correct, and retry. Explanation: The connection to the database could not be established because the database is not active or the connection parameters set in the engine connection are not correct. System action: The requested action was not completed successfully. Operator response: Verify that the database is up and running and the connection parameters set in the engine connection are correct. Retry the operation.

Appendix A. Web console messages

107

AWSUI0337E AWSUI0347E
AWSUI0337E The supplied To time is earlier than the From time. Supply an earlier From time, or a later To time. Explanation: The query does not return any results because the From time is later than the To time. System action: The requested action was not completed successfully. Operator response: Supply an earlier From time, or a later To time. Retry the query. AWSUI0338E The selected date already exists in the list. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a different date. Retry the query. AWSUI0339E The list can contain a maximum of maximum_number items. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Review the items in the list and reduce the number of them until it is not more than the indicated maximum. Retry the query. AWSUI0340E At least one date must be included in the Specific Dates list. Explanation: The query does not return any results because the Specific Dates list is empty. System action: The requested action was not completed successfully. Operator response: Add at least one date to the Specific Dates list. Retry the query. AWSUI0341E The CSV separator field cannot contain any of the following non_valid_separator_characters. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a valid value using only the permitted characters. Retry the operation. AWSUI0342E You have clicked Delete without selecting a specific date. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Select one or more dates from the Specific Dates list to delete. Click Delete again. AWSUI0343E The specific dates list is empty. There is nothing to delete. Explanation: See message. System action: The requested action was not completed successfully. Operator response: You cannot delete a specific date unless it is in the list and has been selected. AWSUI0344E The validate command cannot be performed on an "Ask when Needed" Engine. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Choose an engine in the"Enter Task Information" panel. AWSUI0346E Database failure. Check the database is available and the connection parameters are correct and retry: database user: database_user_name, database JDBC URL: database_JDBC_URL If the problem persists contact the Tivoli Workload Scheduler administrator. The database internal message is: database_internal_message Explanation: The database might not be available or the parameters specified for the database configuration are not correct. System action: The requested action was not completed successfully. Operator response: Check the database credentials, if the problem persists, contact the Tivoli Workload Scheduler administrator. AWSUI0347E The reporting feature in the database configuration is not enabled for the selected engine. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Enable the reporting feature in the

108

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0358E AWSUI0376E
database configuration for the selected engine, or select a different engine where the reporting feature is enabled. Retry the operation. AWSUI0358E The output limit must be a positive value. The maximum allowed value is:maximum_value. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a valid output limit value. Retry the operation. AWSUI0359W The new engine supports a different set of actions and event types. The previous list of selected actions and event types has been reset. Explanation: The list of available actions and event types in the event rule task that you are editing depends on the engine specified. The engine has been modified and the new engine supports a different set of actions and event types. System action: The engine has been changed as requested and the list of selected actions and event types has been reset. Operator response: Edit your event rule definition specifying a new list of actions and event types. Retry the operation. AWSUI0360E The JDBC URL is not configured on the selected engine, so the reporting capabilities cannot be used. Contact the Tivoli Workload Scheduler administrator. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Ask the Tivoli Workload Scheduler administrator to configure the JDBC URL on the selected engine. Retry the operation. AWSUI0361E The field must be a positive value. The minimum permitted value is:minimum_value. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Change the input value to a positive value, greater than the indicated minimum. AWSUI0370E This command cannot be performed on an "Ask when Needed" Engine. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Choose an engine in the"Enter Task Information" panel. AWSUI0371W These event rules are already in the "draft" status and no action is performed on them. Explanation: You have tried to modify the status of the event rules to be "draft", but they are already in "draft" status. System action: The requested action was not completed successfully. Operator response: None AWSUI0372W These event rules are already in the "complete" status and no action is performed on them. Explanation: You have tried to modify the status of the event rules to be "complete", but they are already in "complete" status. System action: The requested action was not completed successfully. Operator response: None AWSUI0374E Unable to retrieve data for this engine. Explanation: The dashboard was unable to retrieve data from this engine. System action: The dashboard will try again at the next scheduled dashboard refresh. Operator response: Make sure the engine is reachable and properly configured. Check log files for details. AWSUI0376E The number of days must to be a positive number not greater than: maximum_number_of_days Explanation: See message. System action: The requested action was not completed successfully. Operator response: Correct the value for the number of days and retry the operation.

Appendix A. Web console messages

109

AWSUI0500E AWSUI0510E
AWSUI0500E The version of the scheduler engine engine_name is not supported. Explanation: The selected engine is either not supported or does not support the operation you are trying to perform. System action: The requested operation is not completed successfully. Operator response: Choose a scheduler engine that is a supported version, and retry the operation. AWSUI0501E The availability interval cannot be defined because the From priority is greater than the To priority. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a To priority greater than the From priority and retry the operation. AWSUI0503E The job definition name is mandatory but has not been supplied. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid job definition name and all the other mandatory fields in the panel and retry the operation. AWSUI0504E The number of scheduled dependencies exceeds the maximum number allowed. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Reduce the number of scheduled dependencies to less than the maximum and retry the operation. AWSUI0505E This job cannot be added the selected job stream because a job with the same name is already present, and two jobs with the same name in one job stream are not allowed. Explanation: See message. You might have tried to add the same job twice. System action: The requested operation is not completed successfully. Operator response: If you want to add this job to the selected job stream, modify the name of the job to make it unique, and retry the operation. AWSUI0506E You cannot define the same dependency twice in the same job. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Determine why you are trying to define the same dependency twice. If you accidentally tried to create the same dependency twice, take to further action. Otherwise, modify a dependency in the job stream and retry the operation. AWSUI0507E A job stream cannot have a follows dependency from one of its own jobs. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Delete the dependency and retry the operation. AWSUI0508E A job stream cannot have itself as a dependency. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Delete the dependency and retry the operation. AWSUI0509E The same dependency cannot be defined twice in the same job stream. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Modify the dependencies in the job stream to make them unique and retry the operation. AWSUI0510E Resource dependencies can be defined at the job stream level or the job level, but not both. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Delete one of the resource dependencies at the job level or job stream level and retry the operation.

110

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0511E AWSUI0521E
AWSUI0511E The "Submit into job stream" workstation name is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid job stream workstation name and all the other mandatory fields present in the panel and retry the operation. AWSUI0512E The workstation name is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid workstation name and all the other mandatory fields present in the panel and retry the operation. AWSUI0513E The script field is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid script and all the other mandatory fields present in the panel and retry the operation. AWSUI0514E The command field is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid command and all the other mandatory fields present in the panel and retry the operation. AWSUI0515E The parameter in the task string is not valid. The caret (^) character must precede the first letter and follow the last letter of a valid parameter name. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Enclose the parameter name between caret (^) characters and retry the operation. AWSUI0516E The job file field is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid job file and all the
Appendix A. Web console messages

other mandatory fields present in the panel and retry the operation. AWSUI0517E The login field is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid login and all the other mandatory fields present in the panel and retry the operation. AWSUI0518E The workstation class name is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid workstation class name and all the other mandatory fields present in the panel and retry the operation. AWSUI0519E The supplied workstation class must contain at least one workstation, or a wildcard must be used. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid workstation class or use a wildcard and retry the operation. AWSUI0520E The parameter name is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid parameter name and all the other mandatory fields present in the panel and retry the operation. AWSUI0521E The prompt name is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid prompt name and all the other mandatory fields present in the panel and retry the operation.

111

AWSUI0522E AWSUI0532E
AWSUI0522E The domain manager name is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid domain manager name and all the other mandatory fields present in the panel and retry the operation. AWSUI0523E The domain name is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid domain name and all the other mandatory fields present in the panel and retry the operation. AWSUI0524E The calendar name is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid calendar name and all the other mandatory fields present in the panel and retry the operation. AWSUI0525E At least one day must be defined for a calendar. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply at least one day for the calendar and retry the operation. AWSUI0526E The R/3 job information is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply the R/3 job information and all the other mandatory fields present in the panel and retry the operation. AWSUI0527E A job stream must be selected in the list. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select a job stream in the list and retry the operation. AWSUI0528E A job must be selected in the list. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select a job from the list and retry the operation. AWSUI0529E The SAP job on the task panel was not selected for this workstation. Select a new SAP job on the task panel, or change the workstation to the workstation the SAP job is defined on. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select a new SAP Job on the task panel, or change the workstation to the workstation the SAP job is defined on and retry the operation. AWSUI0530E Unable to validate the r3batch workstation because it is not in the plan, or the connection with the r3batch system has failed Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check that the r3batch workstation is in the plan. If it is not, fix the problem and retry the operation. If it is in the plan, try again later. AWSUI0531E The job definition cannot be saved. Reason: engine_error_message Explanation: The job definition could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0532E The job definition cannot be retrieved. Reason: engine_error_message Explanation: The job definition could not be retrieved due to an error that occurred in the Tivoli Workload

112

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0533E AWSUI0538W
Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0533E The job definition list cannot be loaded. Reason: engine_error_message Explanation: The job definition list could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0534E The job definition cannot be deleted. Reason: engine_error_message Explanation: The job definition could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0535E A new job definition cannot be created. The task type is unknown for job job_name. Edit the properties for this job and select a new task type and workstation. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Edit the properties for this job and select a new task type and workstation and retry the operation. AWSUI0536E Multiple job definitions cannot be deleted. Reason: engine_error_message Explanation: The job definitions could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0537E The workstation classes cannot be loaded. Reason: engine_error_message Explanation: The workstation classes could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0538W The workstation class cannot be loaded. Reason: engine_error_message Explanation: The workstation class could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

Appendix A. Web console messages

113

AWSUI0539E AWSUI0545W
AWSUI0539E Multiple workstation classes cannot be deleted. Reason: engine_error_message Explanation: The multiple workstation classes could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0540E The workstation class cannot be saved. Reason: engine_error_message Explanation: The workstation class could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting AWSUI0541E The workstation class cannot be deleted. Reason: engine_error_message Explanation: The workstation class could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0542E The Windows user list cannot be loaded. Reason: engine_error_message Explanation: The Windows user list could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0543E The Windows user cannot be deleted. Reason: engine_error_message Explanation: The Windows user could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0544E The selected Windows users cannot be deleted. Reason: engine_error_message Explanation: The selected Windows user list could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0545W The Windows user cannot be retrieved. Reason: engine_error_message Explanation: The Windows user could not be retrieved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the

114

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0546E AWSUI0552E
message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0546E The Windows user cannot be saved. Reason: engine_error_message Explanation: The Windows user could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0547E The Windows user instance cannot be saved. Reason: engine_error_message Explanation: The Windows user instance could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0548E The parameters cannot be loaded. Reason: engine_error_message Explanation: The parameters could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0549W The parameter cannot be retrieved. Reason: engine_error_message Explanation: The parameter could not be retrieved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0550E The multiple parameters cannot be deleted. Reason: engine_error_message Explanation: The multiple parameters could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0551E The parameter cannot be saved. Reason: engine_error_message Explanation: The parameter could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0552E The parameter cannot be deleted. Reason: engine_error_message Explanation: The parameter could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text.

Appendix A. Web console messages

115

AWSUI0553E AWSUI0559W
System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0553E The prompts cannot be loaded. Reason: engine_error_message Explanation: The prompts could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0554W The prompt cannot be retrieved. Reason: engine_error_message Explanation: The prompt could not be retrieved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0555E The multiple prompts cannot be deleted. Reason: engine_error_message Explanation: The multiple prompts could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0556E The prompt cannot be saved. Reason: engine_error_message Explanation: The prompt could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0557E The prompt cannot be deleted. Reason: engine_error_message Explanation: The prompt could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0558E The calendars cannot be loaded. Reason: engine_error_message Explanation: The calendars could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0559W The calendar cannot be retrieved. Reason: engine_error_message Explanation: The calendar could not be retrieved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text.

116

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0560E AWSUI0566E
System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0560E The multiple calendars cannot be deleted. Reason: engine_error_message Explanation: The multiple calendars could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0561E The calendar cannot be saved. Reason: engine_error_message Explanation: The calendar could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0562E The calendar cannot be deleted. Reason: engine_error_message Explanation: The calendar could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.
Appendix A. Web console messages

AWSUI0563E The domains cannot be loaded. Reason: engine_error_message Explanation: The domains could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0564W The domain cannot be retrieved. Reason: engine_error_message Explanation: The domain could not be retrieved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0565E The multiple domains cannot be deleted. Reason: engine_error_message Explanation: The multiple domains could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0566E The domain cannot be saved. Reason: engine_error_message Explanation: The domain could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text.

117

AWSUI0567E AWSUI0572E
System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0567E The domain cannot be deleted. Reason: engine_error_message Explanation: The domain could not be deleted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0568E The selected prompt "prompt_name" cannot be replied to. Reason: engine_error_message Explanation: The selected prompt could not be replied to due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0569E The selected multiple prompts "list_of_prompts" cannot be replied to. Reason: engine_error_message Explanation: The selected multiple prompts could not be replied to due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0570E The link action for the domain "domain_name" cannot be performed. Reason: engine_error_message Explanation: The link action for selected domain could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0571E The link action for the domains"domain_names" cannot be performed. Reason: engine_error_message Explanation: The link action for the selected domains cannot be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0572E The unlink action for the domain"domain_name" cannot be performed. Reason: engine_error_message Explanation: The unlink action for the selected domain could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

118

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0573E AWSUI0578E
AWSUI0573E The unlink action for the domains"domain_names" cannot be performed. Reason: engine_error_message Explanation: The unlink action for the selected domains could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0574E Some of the start actions for the domain"domain_name" were not completed. Reason: engine_error_message Explanation: Some of the start actions were not completed for the domain due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0575E The start action for the domains"domain_names" cannot be performed. Reason: engine_error_message Explanation: The start action for the selected domains cannot be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0576E Some of the stop actions for the domain"domain_name"were not completed. Reason: engine_error_message Explanation: Some of the stop actions were not completed for selected domain due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0577E The stop action for the domains"domain_names" cannot be performed. Reason: engine_error_message Explanation: The stop action for the selected domains could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0578E The manager for the domains"domain_names" cannot be switched. Reason: engine_error_message Explanation: The manager for the selected domains could not be switched due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message.

Appendix A. Web console messages

119

AWSUI0579E AWSUI0589E
AWSUI0579E There is an internal calendar error. An unanticipated condition was encountered during the last operation: internal_error_condition Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select another calendar and retry the operation. If the problem persists, contact IBM Software Support for assistance. AWSUI0580E A calendar name is required for all calendars. There is at least one calendar that has not been assigned a name. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Make sure that all the calendars have a name defined and retry the operation. AWSUI0581E There are no days selected in the calendar. At least one day must be defined for every calendar. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply at least one day for the calendar and retry the operation. AWSUI0582E No check boxes are selected. At least one check box must be selected in the rule panel. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select at least one check box from the rule panel and retry the operation. AWSUI0583E The password and confirmation password do not coincide. Enter the passwords again. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply the password and confirmation password again, making sure they are identical and retry the operation. AWSUI0584E Passwords cannot exceed maximum_characters characters. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a password with a number of characters that is less than or equal to the maximum length and retry the operation. AWSUI0585E A problem occurred during password encryption. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Retry the operation. If the problem persists, contact IBM Customer Support for assistance. AWSUI0586E Workstation name is a required field. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid Workstation Name and all the other mandatory fields present in the panel and retry the operation. AWSUI0587E The file name must include a fully qualified path. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a fully qualified valid file name (path and file name) and retry the operation. AWSUI0589E All dependencies for job scheduling objects in the database that include this workstation name are also updated. Explanation: A workstation class might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new name. System action: If OK is clicked the workstation class is renamed. Otherwise the rename action is ignored. Operator response: Click OK to rename the workstation class or click Cancel to cancel the rename action and retry the operation.

120

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0592E AWSUI0605E
AWSUI0592E The prompt might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new name. Explanation: The prompt might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new name. System action: If OK is clicked the prompt is renamed. Otherwise the rename action is ignored. Operator response: Click OK to rename the prompt or click Cancel to cancel the rename action and retry the operation. AWSUI0595E The parameter might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new name. Explanation: The parameter might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new name. System action: If OK is clicked the parameter is renamed. Otherwise the rename action is ignored. Operator response: Click OK to rename the parameter or click Cancel to cancel the rename action and retry the operation. AWSUI0596E An internal error has occurred. One or more errors occurred while the job list was being loaded. error_messages Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Retry the operation. If the problem persists, contact IBM Customer Support for assistance. AWSUI0598W An internal error has occurred. See the error.log file for details. Explanation: An error has occurred. See the error.log file for details. System action: Processing continues. Operator response: See the error.log file for details. If you can resolve the problem, do so. Retry the operation. If you cannot resolve the problem, or the problem persists, contact IBM Software Support for assistance. AWSUI0605E This job might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new workstation data. Explanation: This job might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new workstation data. System action: If OK is clicked the workstation is modified. Otherwise the request is ignored. Operator response: Click OK to modify the
Appendix A. Web console messages

AWSUI0600E The calendar might be part of a run cycle for a scheduler object in the database. If so, the run cycle is also updated with the new name. Explanation: The calendar might be part of a run cycle for a scheduler object in the database. If so, the run cycle is also updated with the new name. System action: If OK is clicked the calendar is renamed. Otherwise the rename action is ignored. Operator response: Click OK to rename the calendar or click Cancel to cancel the rename action and retry the operation. AWSUI0602E This domain might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new name. Explanation: A domain might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new name. System action: If OK is clicked, the domain is renamed. Otherwise the rename action is ignored. Operator response: AWSUI0604W This job might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new workstation data. Explanation: This job might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new workstation data. System action: If OK is clicked the workstation is modified. Otherwise the request is ignored. Operator response: Click OK to modify the workstation, or click Cancel to cancel the modification request and retry the operation.

121

AWSUI0606W AWSUI0614E
workstation, or click Cancel to cancel the modify request and retry the operation. AWSUI0606W This resource might be a dependency for a job scheduling object. If so, the dependency is also updated with the new workstation data. Explanation: This resource might be a dependency for a job scheduling object. If so, the dependency is also updated with the new workstation data. System action: If OK is clicked the workstation is modified. Otherwise the request is ignored. Operator response: Click OK to modify the workstation, or click Cancel to cancel the modify request and retry the operation. AWSUI0607W This job stream might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new workstation data. Explanation: This job stream might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new workstation data. System action: If OK is clicked the workstation is modified. Otherwise the request is ignored. Operator response: Click OK to modify the workstation, or click Cancel to cancel the modify request and retry the operation. AWSUI0608E This job might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new job name. Explanation: This job might be part of a dependency for a job scheduling object in the database. If so, the dependency is also updated with the new job name. System action: If OK is clicked the job is renamed. Otherwise the rename request is ignored. Operator response: Click OK to rename the job, or click Cancel to cancel the rename request and retry the operation. AWSUI0609E The parameter format for the login string is not valid. The caret (^) character must precede the first letter and follow the last letter of a parameter name. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Enclose the parameter name in caret (^) characters and retry the operation. AWSUI0610E The user login format for the MPE job is not valid. The user login must have the following format: [<user>].[<account>]<,group> where each section can have a maximum of eight characters. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply the user login in the following format: [<user>].[<account>]<,group>, where each section can have a maximum of eight characters, and retry the operation. AWSUI0611E The Details field is mandatory. V ALUE_0 Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid Details field and all the other mandatory fields presents in the panel and retry the operation. AWSUI0612E The Time restrictions field contains a character that is not valid. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid Time restriction and all the other mandatory fields presents in the panel and retry the operation. AWSUI0613E The "Repeat every" field contains a character that is not valid. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid "Repeat every" field and all the other mandatory fields in the panel and retry the operation. AWSUI0614E In the "Day of Month" section, the start year must precede the end year. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a start year that precedes

122

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0615E AWSUI0624E
the end year and retry the operation. AWSUI0615E In the "Day of Month" section, the start month must precede the end month. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a start month that precedes the end month and retry the operation. AWSUI0616W The Job name field is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid Job name and all the other mandatory fields in the panel and retry the operation. AWSUI0617E The Network agent field is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid Network agent and all the other mandatory fields in the panel and retry the operation. AWSUI0618E The dependency value has exceeded the maximum field length. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a dependency value with the number of characters less than or equal to the maximum field length and retry the operation. AWSUI0619E If the dependency value begins with a quote character it must end with a quote character. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Make sure that if the dependency field begins with a quote character it also ends with one, and retry the operation. AWSUI0620E There are too many quote characters in the dependency field. Explanation: The dependency field can be enclosed in quote characters, but there can only be two - at the beginning and the end. At least one more has been found. System action: The requested operation is not completed successfully. Operator response: Make sure that if the dependency field begins with a quote character it also ends with one, with no other quote characters in the field, and retry the operation. AWSUI0621E The dependency contains a workstation name that is not valid. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Correct the workstation name in the dependency field and retry the operation. AWSUI0622E This dependency contains a job stream name that is not valid. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Correct the job stream name in the dependency field and retry the operation. AWSUI0623E This dependency contains a job name that is not valid. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Correct the job name in the dependency field and retry the operation. AWSUI0624E The successors for the job stream cannot be retrieved. Reason: engine_error_message Explanation: The successor for the job stream could not be retrieved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation.
Appendix A. Web console messages

123

AWSUI0625E AWSUI0634E
See also: Administration and Troubleshooting for information about the engine error message. AWSUI0625E The successors of the job cannot be retrieved. Reason: engine_error_message Explanation: The successors for the job could not be retrieved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0626E The job or job stream cannot be submitted. Reason: engine_error_message Explanation: The job or job stream could not be submitted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0627E The time zone field is required for the master domain manager when time zones are enabled. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid time zone for the master domain manager and retry the operation. AWSUI0628W There is a Modify step error. Reason: engine_error_message Explanation: There is a Modify step error due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0630E The specified workstation, job name, or both, were not found. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid workstation, job name, or both, and retry the operation. AWSUI0631E The SAP job definition cannot be saved. Reason: engine_error_message Explanation: The SAP job definition could not be saved due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0633E The SAP job definition cannot be renamed. This is not valid for a modify operation. Explanation: The SAP job definition could not be renamed. System action: The requested action is not completed successfully. Operator response: Click Save and Close to rename the job. Otherwise, enter the original job name and click Modify and Close to modify the job and retry the operation. AWSUI0634E The file plan view cannot be loaded. Reason: engine_error_message Explanation: The file plan view could not be loaded due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully.

124

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0635E AWSUI0645E
Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0635E An internal error has occurred. The job output could not be loaded because it uses an unsupported encoding. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Contact IBM Software Support for assistance. AWSUI0636W The deadline is not later than the start time. Do you want to proceed? Explanation: See message. System action: The requested operation is not completed successfully. Operator response: The deadline must be greater than the start time, or one of the two must be set as blank. Retry the operation. AWSUI0637E The specified workstation or job stream name, or both, were not found. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid workstation name or job stream name, or both, and retry the operation. AWSUI0638E There is not enough memory to complete this action successfully. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Try closing other applications to free up memory. Retry the operation. If the problem persists you might need to reboot the workstation where you are running the console. AWSUI0639E The specified calendar does not exist. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify another calendar and retry the operation.
Appendix A. Web console messages

AWSUI0640W The specified domain domain_name does not exist. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Click OK to continue, or click Cancel to specify a new domain and retry the operation. AWSUI0641E The specified workstation was not found. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid workstation and retry the operation. AWSUI0643E The specified recovery workstation and job name combination was not found. Explanation: The workstation and job name combination specified as a recovery option was not found. Either the workstation, or the job name, or both are incorrect. System action: The requested operation is not completed successfully. Operator response: Make sure that the specified workstation and specified job name exist and are typed correctly and retry the operation. AWSUI0644E The recovery option job cannot have the same name as the job being defined. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a recovery option job name that is different from the job being defined and retry the operation. AWSUI0645E A job stream cannot have a dependency on one of its jobs when the resolution criteria is other than "Use default" or "Closest preceding". Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Change the resolution criteria for the dependencies of the job stream jobs and retry the operation.

125

AWSUI0646E AWSUI0701W
AWSUI0646E A job stream cannot have a dependency on itself when the resolution criteria is other than "Use default" or "Closest preceding". Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Change the resolution criteria for the dependencies of the job stream and retry the operation. AWSUI0648E The parameter in the login string is not valid. The caret (^) character must precede the first letter and follow the last letter of a valid parameter name. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Enclose the parameter name with caret (^) characters and retry the operation. AWSUI0649E The resource resource_name does not exist. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Choose a resource that exists and retry the operation. AWSUI0654E A job stream instance cannot have a dependency on itself or on its jobs. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Remove the job stream instance dependency on itself or on its jobs and retry the operation. AWSUI0655E A job instance cannot have a dependency on itself or on its job stream instance. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Remove the job instance dependency on itself or on its job stream instance and retry the operation. AWSUI0700W The parentheses in the return code expression "return_code_expression" are not correct. Each open parenthesis must match a corresponding closed parenthesis. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a correct return code expression and retry the operation. AWSUI0701W The return code expression "return_code_expression" contains one or more operands that are not correct. Only greater than or less than operands can be used. Explanation: See message. AWSUI0697W An internal error has occurred. Reason: engine_error_message Explanation: A problem has arisen due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0698W The start time is later than the latest start time. Do you want to proceed? Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply an earlier start time and retry the operation. AWSUI0699W The latest start time is later than the deadline time. Do you want to proceed? Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply an earlier start time and retry the operation.

126

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0702W AWSUI0714W
System action: The requested operation is not completed successfully. Operator response: Supply a correct return code expression using only boolean operators and retry the operation. AWSUI0702W The return code expression "return_code_expression" is not valid. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a correct return code expression and retry the operation. AWSUI0703W The return code expression "return_code_expression" contains one or more operands that are not correct. Only greater than or less than operands can be used. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a correct return code expression using only boolean operators and retry the operation. AWSUI0704W The plan cannot be submitted because an alternate plan was selected for the current engine. If an alternate plan is selected for an engine, its jobs or job streams cannot be submitted. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Restore the plan before submitting it and retry the operation. AWSUI0705W The restore operation can be performed only if an alternate plan was previously selected for the current engine. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select an alternate plan before performing the restore operation and retry the operation. AWSUI0707E The resource is not defined for the same workstation as the job. The job is hosted by workstation workstation_name. The resource resource_nameis hosted by workstation workstation_name Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select a resource that is defined for the same workstation as the job and retry the operation. AWSUI0708E The job output cannot be loaded because the STDLIST file is too large. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Remove some of the entries in the STDLIST file and retry the operation. AWSUI0710W The Windows user password cannot be changed because an alternate plan was selected for the selected engine. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Restore the plan and then change the Windows user password. AWSUI0713W The following external job dependencies do not exist: external_job_dependencies. Explanation: See message. System action: Processing continues. Operator response: Make sure that all the specified dependencies are correctly defined before the job stream is run. AWSUI0714W The following external job stream dependencies do not exist: external_job_stream_dependencies. Explanation: See message. System action: Processing continues. Operator response: Make sure that all the specified dependencies are correctly defined before the job stream is run.

Appendix A. Web console messages

127

AWSUI0720E AWSUI0728E
AWSUI0720E The job stream cannot be saved because either the resource resource_name does not exist, or the rights required to use it are not sufficient to use the resource. Explanation: A dependency was specified on a resource that does not exist, or the rights of the specifying user are not sufficient to use the resource. The resource might have been removed from the database after the dependency was added. System action: The requested operation is not completed successfully. Operator response: Remove the resource dependency. Create the resource and recreate the dependency and retry the operation. AWSUI0721E The job stream cannot have an external dependency on a job defined in the same job stream. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select a different job stream from the one where an external dependency is being defined and retry the operation. AWSUI0722E A positive number of resource units must be specified. Explanation: A negative or null number of units for the resource was specified. System action: The requested operation is not completed successfully. Operator response: Modify the number of units for the specified resource to a positive value less than or equal to the number of units available and retry the operation. AWSUI0723W An unrecognized time zone value for the date datewas specified. Select a recognized time zone value, or no time zone is set for date date. Explanation: See message. System action: Processing continues. Operator response: Select a recognized time zone value, or leave the field blank and retry the operation. AWSUI0724W An unrecognized time zone for the V ALUE_0was specified. The time zone displayed is that specified for the master domain manager. Select a recognized time zone value or the master domain manager time zone value is used. Explanation: See message. System action: Processing continues. Operator response: Select a recognized time zone value and retry the operation. AWSUI0725E In the section_name section, the To Date is earlier than the From Date. Supply an earlier From Date, or type a later To Date. Explanation: The query does not return any results because the From Date is later than the To Date. System action: The requested operation is not completed successfully. Operator response: Supply an earlier From Date, or type a later To Date and retry the query. AWSUI0726E In the section_name section, when a value for the Date field is set, a value for the Time field must also be set. Explanation: The query does not return any results because the date filter is not set correctly. System action: The requested operation is not completed successfully. Operator response: Set values for both Date and Time fields, or do not set values for either Date or Time fields and retry the query. AWSUI0727E In the section_name section, when a value for the Time field is set, a value for the Date field must also be set. Explanation: The query does not return any results because the date filter is not set correctly. System action: The requested operation is not completed successfully. Operator response: Set values both for Time and Date fields, or do not set values for either Date or Time fields and retry the query. AWSUI0728E The password for the Windows user Windows_usercannot be changed. Reason: OS_error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Make sure that the specified user name, Windows domain and workstation correctly correspond to an existing Windows user and retry the operation.

128

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0729E AWSUI0739E
AWSUI0729E The object cannot be unlocked. Reason: OS_error_message Explanation: It is not possible to unlock the object. Some problem has been encountered during this operation. System action: The requested operation is not completed successfully. Operator response: Refer to the reason indicated in the message to resolve the issue and retry the operation. AWSUI0730W The value specified for the upper limit of the time interval is lower than the one specified for the lower limit. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Change one or both of the limits to give a valid interval and retry the operation. AWSUI0731E The value specified for the validity interval end is lower than the one specified for the validity interval start. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Change one or both of the limits to give a valid interval and retry the operation. AWSUI0732E The Start time must be defined for a time dependent job.V ALUE_0 Explanation: When the job is a time dependent job it must have a start time defined. System action: The requested operation is not completed successfully. Operator response: Define the Start time or unset the job as time independent and retry the operation. AWSUI0733E The name specified for the Run cycle is not valid. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify a valid name for the Run cycle and retry the operation. AWSUI0734E The Run cycle name is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a name for the Run cycle and retry the operation. AWSUI0735E One or more jobs in the job stream are defined on a different workstation class than that of the job stream. Explanation: If a job stream is defined in a workstation class, then all of its jobs must be defined either on a workstation, or in the same workstation class. System action: The requested operation is not completed successfully. Operator response: Set the workstation of this job stream to the original value and retry the operation. AWSUI0736W The value specified for the upper limit of the time interval is equal to the one specified for the lower limit. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Change one of the limits to define a valid interval and retry the operation. AWSUI0737E The Run cycle cannot be saved because no days were selected in the list. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select one or more days in the list in order to specify the Run cycle frequency and retry the operation. AWSUI0739E The Start date is later than the End date. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Enter an End date that is later than the Start date or leave the End date blank. Retry the operation.

Appendix A. Web console messages

129

AWSUI0741E AWSUI0750E
AWSUI0741E The Offset field value is not valid. It must be numeric. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid number of days in the Offset field and retry the operation. AWSUI0742E The selected workstation must have Other as its operating system. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select another workstation that has Other as its operating system and retry the operation. AWSUI0743E The prompt "prompt_name" does not exist. Explanation: A dependency was specified on a prompt that does not exist. The prompt might have been removed from the database after the dependency was added. System action: The requested operation is not completed successfully. Operator response: Remove the prompt dependency. Create the prompt and recreate the dependency and retry the operation. AWSUI0744E The job "job_name" cannot be submitted. Reason: engine_error_message Explanation: The job could not be submitted due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0745E The Raise event did not complete successfully. Reason:engine_error_message Explanation: It is not possible to raise the specified event due to an error in the Tivoli Workload Scheduler for Applications. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text represents an error code reported by Tivoli Workload Scheduler for Applications. Resolve the error and retry the operation. See also: IBM Tivoli Workload Scheduler for Applications Users Guide for information about the error message. AWSUI0746E The Raise event field is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid value in the Raise event field and retry the operation. AWSUI0747E The Table criteria is in error. Reason:engine_error_message Explanation: There is a problem with Table criteria due to an error in the Tivoli Workload Scheduler for Applications. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text represents an error code reported by Tivoli Workload Scheduler for Applications. Resolve the error and retry the operation. See also: IBM Tivoli Workload Scheduler for Applications Users Guide for information about the error message. AWSUI0748E The requested action cannot be performed because it is supported from XBP level 2.0 and IBM Tivoli Workload Scheduler for Applications, version 8.2.1 - fix pack 1. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Choose another action, or upgrade to a supported level of XBP and retry the operation. AWSUI0750E The specified plan cannot be generated. Reason: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Fix the problem indicated in the error message and retry the operation.

130

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0751E AWSUI0773E
AWSUI0751E The newly generated plan cannot be used as an alternate plan. Reason: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Fix the problem indicated in the error message and retry the operation. AWSUI0753W The job definition "V ALUE_0" is being moved on the workstation class "V ALUE_1", verify that job streams that are using the job definition are defined on the workstation class "V ALUE_0". Do you want to continue? Explanation: The selected job definition is used by one or more job streams. Verify that these job streams are defined on the same workstation class System action: If OK is clicked, the job definition is saved. If cancel is clicked the save action is ignored. Operator response: Click OK to submit or click Cancel to cancel the submit action and retry the operation. AWSUI0754W The plan cannot be generated because an alternative plan was selected for the current engine. Explanation: If an alternative plan is selected for an engine, neither a trial nor a forecast plan can be generated. System action: The requested operation is not completed successfully. Operator response: Restore the plan before generating a new one. AWSUI0762E A task with the same name already exists. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Change the name of the task. Retry the operation. AWSUI0766E Test connection to [engine] : failed. Explanation: The network might be down or the connection credentials might not be correct. System action: The requested operation is not completed successfully. Operator response: Check the engine properties and the credentials specified. Correct any problem you find and retry the operation.
Appendix A. Web console messages

AWSUI0769E The operation cannot be performed on a task shared by another user. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: You can share your own tasks only. Create another task or duplicate the previous task and share it. AWSUI0770E An internal error has occurred. The duplicate task operation failed. Explanation: See message. System action: The duplicate operation was not performed. No task was created. Operator response: An internal problem prevents the task from being duplicated. Create the new task manually. AWSUI0771E The task no longer exists. The operation failed on the following task (task name follows): Explanation: The task has been deleted, renamed, or unshared. System action: The requested operation is not completed successfully. Operator response: Perform a refresh on the task list by reopening the task table. AWSUI0772E A task with the same name already exists. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify a different task name and retry the operation. AWSUI0773E The permitted characters are mixed alphanumeric excluding "()", wildcards and "special_characters". Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid value using only the permitted characters and retry the operation.

131

AWSUI0774E AWSUI0788E
AWSUI0774E The From priority cannot be greater than the To priority on the panel_name panel. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a To priority greater than the From priority and retry the operation. AWSUI0778E There has been an authentication failure: the user name or password is wrong. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check the user name and password, correct any error, and try again. AWSUI0779E There has been a communication failure: either the host is not available, or the address or the port (or both) are not correct. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check that the engine is available (try pinging it). Check the engine connection credentials. Retry the operation. AWSUI0780E The connection has been refused: the engine is not available. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check with the Tivoli Workload Scheduler administrator that the engine is running. When the problem is fixed retry the operation. AWSUI0782E The operation cannot be performed on the following shared engine (shared engine name follows): Explanation: The selected engine has been shared by another user. System action: The engine was not modified. Operator response: Create another engine and share it. AWSUI0783E The following engine no longer exists; it has been deleted or renamed (engine name follows): Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify another engine. AWSUI0784E The specified action cannot be performed because no item has been selected. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select at least one item from the list or table and retry the operation. AWSUI0785E The specified action cannot be performed on multiple items. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Make sure only one item is selected in the list or table and retry the operation. AWSUI0786E The specified action cannot be performed on the selected items. Explanation: You tried to perform an action on multiple items, but some or all of the selected items do not support the specified action. System action: The requested operation is not completed successfully. Operator response: Make sure that all the selected items are compatible with the specified action and retry the operation. AWSUI0788E number_of_non-compatible_items out of the total_items items you selected are not compatible with this action (action follows): Explanation: You tried to perform an action on multiple items, but some of them do not support that action. System action: The requested operation is not completed successfully. Operator response: Deselect the items not compatible with the action and retry the operation.

132

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0790E AWSUI0797E
AWSUI0790E The operation could not be completed because an error has occurred while accessing the Symphony file. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check the following: v That the Symphony file has been generated v That the Symphony file has the default name and location v That the Symphony file is not locked by another application v That the user running the console has the rights to open the Symphony file Solve any problems you find and retry the operation. AWSUI0791E The specified action cannot be completed because the following error occurred: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Use the error message to determine what the problem is. Fix the problem and retry the operation. AWSUI0792E You are not the owner of the selected items. You are not authorized to share or unshare items that belong to another user. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Request the owner of the items to share or unshare them. AWSUI0793E You have requested an operation that is allowed for distributed engines only. z/OS engines work only with the current plan. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: To perform the operation, use a distributed engine and retry the operation. AWSUI0794E The user ID specified in the connection profile of the engine in use does not have the necessary permissions in the Security file to perform the requested action on the selected plan object. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Ask the Tivoli Workload Scheduler administrator to grant the user the appropriate permissions to perform the required action on the selected plan object. Retry the operation. AWSUI0795E The connection to the engine has failed. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Ensure that the Tivoli Workload Scheduler engine is available in the network (try pinging it) and is up and running. Retry the operation. AWSUI0796E The specified action cannot be performed. Reason: engine_error_message Explanation: The action could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI0797E The operation has not been performed on those items that you are not authorized to share or unshare because they belong to another user. Explanation: See message. System action: The requested operation is not completed successfully for the items not owned by the user. Operator response: Ask the owner of the items to share or unshare them and retry the operation.

Appendix A. Web console messages

133

AWSUI0798E AWSUI0811E
AWSUI0798E The operation cannot be performed because the selected engine is a fault-tolerant-agent, which does not support the operation. Select another engine. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select another engine, and retry the action. AWSUI0801E The engine does not support reporting. Explanation: You attempted to test the database connection or to run a report task to an engine that does not support the reporting. System action: The requested operation is not completed successfully. Operator response: Change to an engine that supports reporting. AWSUI0802E You attempted to create the task without specifying either By day or By hour (or both). You must select at least one. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select one or both of the indicated options. Retry the operation. AWSUI0803W Test connection to "engine_name" : engine successful, database failed. Explanation: You have tested the connection to the indicated engine. The engine connection is working correctly but the database could not be accessed. System action: The requested operation is not completed successfully. Operator response: Ask the Tivoli Workload Scheduler administrator to resolve the problem with the access to the database for the indicated engine. Retry the operation. AWSUI0804E You tried to perform an action on multiple items, but the action has failed on some of them (a list of items for which the action failed follows): Explanation: See message. System action: The requested operation is not completed successfully on the indicated items. Operator response: Make sure only one item is AWSUI0808E The specified action cannot be performed because the default plan is not the current plan. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Set the current plan to be the default plan. Retry the operation. AWSUI0809E Missing or incomplete Database User ID and Password. If you selected to enable reporting, you must also specify them to enable you to connect to the database. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Complete the Engine Connection properties panel with the Database User ID and Password. Retry the operation. AWSUI0810E You are not authorized to delete items that belong to another user. Explanation: The selected item has been shared by another user. System action: The requested operation is not completed successfully. Operator response: Choose an object you own to delete. AWSUI0811E The user specified in the engine configuration is not authorized to perform the selected operation. Specify another authorized user or ask the Tivoli Workload Scheduler administrator to grant the user the rights to perform the selected operation. Explanation: See message. selected in the list or table and retry the operation. AWSUI0807E Reporting is not supported on fault-tolerant agents. Explanation: You tried to enable reporting or to run a report on an engine that is a fault-tolerant agent. System action: The requested operation is not completed successfully. Operator response: Clear the Enable Reporting check box in the Database section of the Scheduler Connection panel. Retry the operation.

134

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI0818E AWSUI0829W
System action: The requested operation is not completed successfully. Operator response: Specify another authorized user or ask the Tivoli Workload Scheduler administrator to grant the user specified in the engine configuration the rights to perform the selected operation. AWSUI0818E Master domain manager not found. Explanation: You have tried to change a workstation to become the master domain manager. As there can only be one master domain manager at any given time, the program must first change the definition of the existing master domain manager to remove the manager attribute. However it could not find the existing master domain manager definition. Perhaps someone else has performed the same action at the same time. System action: The requested operation is not completed successfully. Operator response: Check the workstation definitions for the master domain and determine which workstation is the manager. Determine why the problem occurred and whether you still need to change the workstation to become the master domain manager. If so, retry the operation. AWSUI0819W The workstation workstation_name is already the master domain manager. Explanation: You have tried to set this workstation as the master domain manager, but it already is. System action: The requested operation is not completed successfully. Operator response: None. AWSUI0820W The workstation workstation_name is already set as event processor. Explanation: You have tried to set this workstation as the event processor, but it already is. System action: The requested operation is not completed successfully. Operator response: None. AWSUI0822E The specified value must not contain any of the following characters: list_of_non_valid_characters. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Remove the non-valid characters from the value. Retry the operation. AWSUI0823E The value specified must be alphanumeric and may not include spaces. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Remove non-alphanumeric characters and spaces. Retry the operation. AWSUI0824E An error was found while verifying the SAP task. Either the task information or the command string (if supplied) contain an error. Explanation: See message. System action: The SAP task is not submitted. Operator response: Verify the task information is correct. If a command string was supplied, verify also that it is correct. Retry the operation. AWSUI0825E Unable to validate the r3batch workstation either because it is not in the plan or because the connection with the r3batch system failed. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check whether the r3batch workstation is in the plan. If it is not, add it. If the workstation is in the plan check that the workstation is up and running and that the R/3 system is up and running. Correct any errors and retry the operation. AWSUI0826W To create trial and forecast plans, you need to be the owner of a an engine connection. Currently, there are no connections owned by you. Explanation: See message. System action: The plan is not created. Operator response: Create an engine connection. Retry the operation. AWSUI0829W The event processor on workstation "workstation_name" is already up and running. Explanation: You have tried to start the event processor but it is already up and running. System action: Nothing. The system continues. Operator response: None.

Appendix A. Web console messages

135

AWSUI0830W AWSUI0839W
AWSUI0830W The event processor on workstation "workstation_name" is already stopped. Explanation: You have tried to stop the event processor but it is already stopped. System action: Nothing. The system continues. Operator response: None. AWSUI0831E The plan "plan_name" does not exist. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Verify that the plan name is correct in the report task. Correct the error and retry the operation. AWSUI0832E The Symphony file selected is not present or is corrupted. Contact the Tivoli Workload Scheduler administrator. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Ask the Tivoli Workload Scheduler administrator to run the Jnextplan command on the Tivoli Workload Scheduler engine, or to determine why the file is corrupt. Retry the operation. AWSUI0833E The operation could not be completed. Reason: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Use the information in the quoted error message to diagnose and correct the problem. Retry the operation. AWSUI0834E There is more than one job stream instance with the given name. You must refer to a single instance by specifying either the job stream ID or the scheduled start time. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select a single job stream instance by specifying either the job stream ID or the scheduled start time. Retry the operation. AWSUI0835E The start must be less than the end when defining a period to identify the Symphony data from which you wish to extract a plan. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Change either the start date and time or the end date and time (or both) to define a period to identify the Symphony data from which you wish to extract a plan. Retry the operation. AWSUI0836E The Name field is mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid value in the Name field and all other mandatory fields and retry the operation. AWSUI0837E The following value "field_value" is not valid. The value must be an integer between minimum_valueand maximum_value. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid value within the indicated range. Retry the operation. AWSUI0838E The values for Target server and Server group are mutually exclusive. Only one of the fields must contain a value. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a value for either the Target server or the Server group, but not both. Retry the operation. AWSUI0839W You have changed the job priority or the start time, or both. However, when rerunning a job, if you change the job priority or the start time, you must also select a job definition. The job will not be rerun. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: To rerun the job with a changed

136

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI1001E AWSUI1007E
job priority or start time, you must select a job definition. Otherwise, reset the job priority or the start time, or both, to the original values and rerun the job. AWSUI1001E The z/OS engine engine_name is not supported. Explanation: The z/OS engine version selected is not supported. System action: The requested operation is not completed successfully. Operator response: Select a supported engine version. Retry the operation. AWSUI1002E The selected period was not found. Period:period Explanation: The selected period was not found in the z/OS database. System action: The requested operation is not completed successfully. Operator response: Specify a valid period. Retry the operation. AWSUI1003E The setup of the selected job instance cannot be performed. There are no valid successors for job instance: job_instance_name. Explanation: There are no valid successors for the selected job instance. System action: The requested operation is not completed successfully. Operator response: Select at least one valid successor for the selected job instance. Retry the operation. AWSUI1004E The setup of the selected job instance cannot be performed. Reason: engine_error_message Explanation: The setup of the selected job instance could not be performed due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is an error code reported by the Tivoli Workload Scheduler engine. Refer to the Administration and Troubleshooting manual for more information. Resolve the problem in the engine and retry the operation that failed. AWSUI1005E The following error occurred while setting the step list: error_message Explanation: An error occurred when setting the step list because of one of the following reasons: v The selected Start Step cannot be restarted. Possible reasons are the JCL logic or the RCLOPTS initial parameter setting. v The action field is set to Start for more than one step, which is not allowed. v The action field is set to End for more than one step, which is not allowed. v A step marked as always executable is excluded from the selected Step List because of the RCLOPTS initial parameter setting. v A step marked as not executable is included in the selected Step List because of the RCLOPTS initial parameter setting. v The selected End Step does not come after the selected Start Step. System action: The requested operation is not completed successfully. Operator response: Identify the appropriate error scenario from those documented in the Explanation section. Correct the error and retry the operation. AWSUI1006E The selected workstation cannot be linked. Reason: engine_error_message Explanation: The selected workstation could not be linked due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is an error code reported by the Tivoli Workload Scheduler engine. Refer to the Administration and Troubleshooting manual for more information. Resolve the problem in the engine and retry the operation that failed. AWSUI1007E The selected workstation cannot be unlinked. Reason: engine_error_message Explanation: The selected workstation could not be unlinked due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is an error code reported by the Tivoli
Appendix A. Web console messages

137

AWSUI1008E AWSUI2006E
Workload Scheduler engine. Refer to the Administration and Troubleshooting manual for more information. Resolve the problem in the engine and retry the operation that failed. AWSUI1008E The rerun operations on the selected job stream instance cannot be performed. Reason: engine_error_message Explanation: The rerun operation could not be performed on selected job stream instance due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is an error code reported by the Tivoli Workload Scheduler engine. Refer to the Administration and Troubleshooting manual for more information. Resolve the problem in the engine and retry the operation that failed. AWSUI1009E The restart and cleanup operations on selected job instance cannot be performed. Reason: engine_error_message Explanation: The restart and cleanup operations could not be performed on selected job instance due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is an error code reported by the Tivoli Workload Scheduler engine. Refer to the Administration and Troubleshooting manual for more information. Resolve the problem in the engine and retry the operation that failed. AWSUI1011E The specified value is not valid for the PARALLELSERVERS resource. The valid range is from 1 to 99. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a value for the PARALLELLSERVERS resource that is within the range 1 to 99. Retry the operation. AWSUI1012E The specified job stream "job_stream_name" does not exist. Continue anyway? Explanation: See message. System action: The GUI waits for you to click OK or Cancel. Operator response: Click OK to continue, or Cancel to specify a new job stream. Retry the operation. AWSUI2000E A connection error has occurred. There has been an SQL failure when running the report. Details are logged in the trace file. Explanation: There is a connection problem with the database. Possible errors are: v The database is down v The database password provided when the engine was created is wrong or has been changed. System action: The requested operation is not completed successfully. Operator response: Check the error log and trace files for the possible cause of the problem. Check that the database is up and that the connection credentials are correct. Correct the problem and retry the operation. AWSUI2005E A connection error has occurred. There has been an SQL failure when running the report. Details are shown below: Database user ID: database_user_ID Database JDBC url: database_JDBC_url Database internal message: database_internal_message. Explanation: The database might not be available, the parameters specified for the database configuration might not be valid, or an error occurred during data transmission. System action: The requested operation is not completed successfully. Operator response: Ask the database administrator to do the following: v Check that the computer where the database is running is available in the network by pinging it v Check that the database is up and running v Check that the database connection credentials are correct v Check that the database configuration is correct Retry the operation. If the problem persists, contact IBM Software Support for assistance. AWSUI2006E One or more errors occurred during the running of the report. Details are shown below: Database user ID: database_user_ID Database JDBC url: database_JDBC_url Errors found: errors

138

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI2007E AWSUI4004E
Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Use the listed errors to determine what problems have occurred, fix them, and retry the operation. AWSUI2007E The following Tivoli Workload Scheduler engine error occurred during the running of the report: engine_error_message Explanation: The report could not be produced due to an error that occurred in the Tivoli Workload Scheduler engine. The error code is specified in the message text. System action: The requested operation is not completed successfully. Operator response: The reason displayed in the message text is the ID of an error reported by the Tivoli Workload Scheduler engine. Resolve the error and retry the operation. See also: Administration and Troubleshooting for information about the engine error message. AWSUI2008E The user specified in the engine configuration is not authorized to perform the selected operation. Modify the engine configuration to specify an authorized user or ask the Tivoli Workload Scheduler administrator to grant the specified user the rights to perform the selected operation. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Modify the engine configuration to specify an authorized user or ask the Tivoli Workload Scheduler administrator to grant the specified user the rights to perform the selected operation. AWSUI3040E The input value exceeds the maximum length of 4 characters. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a name that is not more than 4 characters. AWSUI3052E The input value exceeds the permitted range of 30 to 7200. Explanation: See message. System action: The requested action was not completed successfully. Operator response: Supply a value between 30 and 7200, inclusive. AWSUI4001E The supplied To Time is equal to the From Time, so the availability interval cannot be defined. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a To Time that is later than the From Time. Retry the operation. AWSUI4002E The specified calendar was not found in the z/OS database. Specify a valid calendar name. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify a valid calendar name. Retry the operation. AWSUI4003E The option "Cancel if late" and the Start time specifications are in conflict. To cancel the job if it is late, an earliest start time and a deadline must be defined. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Correct the conflicting properties. Retry the operation. AWSUI4004E More than one dependency was defined between two jobs. You can only define one dependency. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Define only one dependency. Retry the operation.

Appendix A. Web console messages

139

AWSUI4008E AWSUI4022E
AWSUI4008E If the job stream inherits scheduling information from a template, it cannot use the specified calendar. Complete either "Inherits from template" or "Calendar", but not both. Explanation: The "Inherits from template" field and the "Calendar" field are mutually exclusive. System action: The requested operation is not completed successfully. Operator response: Complete either "Inherits from template" or "Calendar", but not both. AWSUI4009E The specified template in "Inherits from template" does not exist. Specify a valid template. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify a valid template in "Inherits from template". AWSUI4013W Do you want to set the status of the scheduled instance instance_name to "Complete"? Explanation: See message. System action: The system waits for your response. Operator response: Click Yes to set the indicated scheduled instance state to "Complete" or click No to cancel the request. AWSUI4016W Do you want to set the status of the scheduled instance instance_name to "Waiting"? Explanation: See message. System action: The system waits for your response. Operator response: Click Yes to set the indicated scheduled instance state to "Waiting" or click No to cancel the request. AWSUI4017W Do you want to UN-NOP the scheduled instance instance_name? Explanation: See message. System action: The system waits for your response. Operator response: Click Yes to UN-NOP the selected scheduled instance or click No to cancel the request. AWSUI4018E The Node address field is mandatory when the port number is specified. Specify a node address in the Access Methods group. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify a valid Node address in the Access Methods group and retry the operation. AWSUI4019E The Name field is mandatory when the node address is specified. Specify a Name in the Access Methods group. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify a valid Name in the Access Methods group and retry the operation. AWSUI4020E The Name and Node address fields are mandatory when the port number is specified. Specify a Name and a Node address in the Access Methods group. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify a Name and a Node address in the Access Methods group and retry the operation. AWSUI4021E The identifier is not unique. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a unique identifier and retry the operation. AWSUI4022E The default calendar was not found in z/OS. All days will be counted as workdays. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: If you do not want all days to be treated as workdays, define a default calendar in the z/OS engine. Retry the operation.

140

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI4023E AWSUI4035W
AWSUI4023E The specified target workstation either does not exist, or cannot run the type of task associated with this job. Supply a valid workstation name. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid workstation name and retry the operation. AWSUI4024E The Offset-based Run Cycle cannot contain offsets outside the defined interval. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply offsets that are included in the defined interval, and retry the operation. AWSUI4025E The Rule-based Run Cycle cannot contain days outside the user-defined period. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Insert days that are included in the user-defined period, and retry the operation. AWSUI4027E The To date precedes the From date. Supply a later To date or an earlier From date. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a To Date greater than the From Date, and retry the operation. AWSUI4028E The specified target workstation cannot run the type of task associated with this job. Supply the name of a workstation that is enabled to run the task. Explanation: The target workstation must be enabled to run the type of task associated with a job. System action: The requested operation is not completed successfully. Operator response: Supply a name of a workstation that is enabled to run the task, or change the workstation itself so that it can run the type of task associated with this job. AWSUI4030E In the job stream definition there is a job that is unlinked to any of the remaining jobs, which is not allowed. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Link the job to other jobs or remove it from the job stream. Retry the operation. AWSUI4031E The job duration cannot be zero. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Set the duration of the job to a value other than zero, and retry the operation. AWSUI4032E The specified Open time interval is not valid because it overlaps with an existing Open time interval, which is not allowed. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Set the Open time interval to define an interval that does not overlap with an existing interval, and retry the operation. AWSUI4033E The Start time is earlier than the job stream Valid from date. Supply a later Start time. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a Start time later then the job stream Valid from date, and retry the operation. AWSUI4034W The logical resource object_name is not defined. Do you want to proceed? Explanation: See message. System action: The system waits for your response. Operator response: Click Yes to continue or No to cancel. AWSUI4035W The logical resources object_list are not defined. Do you want to proceed? Explanation: See message. System action: The system waits for your response.

Appendix A. Web console messages

141

AWSUI4036W AWSUI4058E
Operator response: Click Yes to continue or No to cancel. AWSUI4036W No duration alert will be issued for 99.59.01. Do you want to proceed? Explanation: The duration of the job has been set to 99 hours, 59 minutes, 1 second. This is an acceptable value but no alert will be displayed. System action: The system waits for your response. Operator response: Click Yes to continue or No to cancel. AWSUI4037E The job duration cannot be set to greater than 99.59.01 (99 hours, 59 minutes, 1 second). Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Set the duration of the job to a value that is less than or equal to 99.59.01. Retry the operation. AWSUI4040E The selected period was not found in the z/OS database. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Specify a valid period, or create the required period in the z/OS database. Retry the operation. AWSUI4041E The availability interval cannot be defined because the From priority is greater than the To priority. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a To priority greater than the From priority, and retry the operation. AWSUI4049E The status change for workstation workstation_name failed. Reason: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check the information given in the error_message. Correct the error and retry the operation. AWSUI4051E The job stream job_stream_name could not be found. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid job stream identifier and retry the operation. AWSUI4052E The Occurrence Token is not a 16 character hexadecimal String (0-9, A-F). Explanation: Either the entered value is longer than 16 characters, or non-valid characters have been used. System action: The requested operation is not completed successfully. Operator response: Supply a valid value using only valid characters (0-9, A-F).and not exceeding the allowed size. Retry the operation. AWSUI4053E The availability interval cannot be defined because the From priority is greater than the To priority. Please specify valid priorities on the panel_name panel. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a To priority greater than the From priority, and retry the operation. AWSUI4058E The workstation workstation_name cannot be linked. Reason: error_message Explanation: The system could not link the specified workstation, because it received an error from the engine connection. System action: The requested operation is not completed successfully. Operator response: Use the error message to determine what problem has occurred in the engine. Correct the problem and retry the operation. AWSUI4050E The job stream name is required in order to display the properties. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a job stream name and retry the operation.

142

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI4059E AWSUI4071E
AWSUI4059E The workstation workstation_name cannot be unlinked. Reason: error_message Explanation: The system could not unlink the indicated workstation, because of an error in the engine connection. System action: The requested operation is not completed successfully. Operator response: Use the error message to determine what problem has occurred in the engine. Correct the problem and retry the operation. AWSUI4062E The following error was found in the Dates section: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Use the error message to determine what is wrong with the dates, correct the error and retry the operation. AWSUI4063E The Start Date and Time and the Deadline Date and Time of the job stream are mandatory. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Enter valid values in these mandatory fields and retry the operation. AWSUI4064E The following error occurred: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Use the error message to determine what is wrong, correct the error and retry the operation. AWSUI4065E The job stream name "job_stream_name" is not valid. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a valid job stream name and retry the operation. AWSUI4066E A required value has not been entered in the Time field. The Time field is mandatory when a value is set for the Date field. Explanation: The system can perform the requested operation only if the Date and Time fields are both specified or both empty. System action: The requested operation is not completed successfully. Operator response: Supply a value in the Time field, or clear the Date field. Retry the operation. AWSUI4067E A required value has not been entered in the Date field. The Date field is mandatory when a value is set for the Time field. Explanation: The system can perform the requested operation only if the Date and Time fields are both specified or both empty. System action: The requested operation is not completed successfully. Operator response: Supply a value in the Date field, or clear the Time field. Retry the operation. AWSUI4068E The Date and Time fields are blank, but the corresponding check box (on their left), which indicates that they have been selected, is checked. Clear the check box or enter both the Date and the Time field. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Enter valid information in the Date and Time fields, or clear the corresponding check box to ignore them. Retry the operation. AWSUI4069E The action specified on object object_name cannot be performed. Reason: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Use the error message to correct the error, and retry the operation. AWSUI4071E A Job Setup action cannot be performed on the selected object, because the duration is not in the format hh:mm:ss. Explanation: See message.
Appendix A. Web console messages

143

AWSUI4072E AWSUI5006E
System action: The requested operation is not completed successfully. Operator response: Change the format of the job duration to hh:mm:ss, and retry the operation. AWSUI4072E The To Time is less than the From Time. Supply a later To Time or an earlier From Time. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply a To Time greater than the From Time and retry the operation. AWSUI4074E The status change for destination destination_name failed. Reason: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check the information given in the error_message. Correct the error and retry the operation. AWSUI4075E You cannot change the workstation for the selected job to "Computer" because the job is defined for number_of_parallel_servers parallel servers. Only one parallel server is permitted for operations on a computer workstation. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: If you want to define this job for a computer workstation you must change the parallel servers definition so that not more than one is defined. AWSUI4076E Either the "Fail" or the "Offline" option entered is not valid. The restart option must be "Restart", "Set to error", or "Leave". Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Correct the options and try again. AWSUI4077E The From Date or Time value is later than the To Date or Time value. Enter an earlier From Date or Time value, or a later To Date or Time value. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Supply an earlier From Date or Time, or type a later To Date or Time and retry. AWSUI4078E The object of type object_type and name object_name already exists in the table. Explanation: Duplicate objects cannot be inserted in the table. System action: The requested operation is not completed successfully. Operator response: Select a different object. AWSUI5002E The value "value" for type "type" is not valid. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5003E A value has not been supplied for a required field. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5004E The input value is shorter than the minimum allowed length of minimum_length bytes. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5005E The input value is longer than the maximum allowed length of maximum_length bytes. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5006E The input percentage value: "value" is not valid. Explanation: The data input is not valid. System action: none Operator response: See message text.

144

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI5007E AWSUI5019E
AWSUI5007E The input file size or duration cannot be negative. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5008E The input value is outside the required range. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5009E The input value is not one of the permitted values. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5010E The input value is outside the required range. The value must be between minimim_value and maximum_value. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5011E The input data to be supplied is a range, but either the maximum or the minimum value is blank. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5012E The supplied range, from value1 to value2 is not valid. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5013E An internal error has occurred. The correlation could not be calculated due to the following error: "error". Explanation: Unable to calculate the available correlation properties on the current events. System action: none Operator response: See message text. AWSUI5019E Unable to add the action [plugin= plugin_name , name= action_name] to pane pane. The error is: error Explanation: This message is displayed when an error occurs while adding an action to the actions area. System action: The action is not added or stored in the event rule. Operator response: See message text. AWSUI5016E Unable to close the Event Rule Editor for the following reason: reason Explanation: The Rule Editor cannot be closed. System action: none Operator response: See message text. AWSUI5017E Unable to save the event rule for the following reason: reason Explanation: The event rule cannot be saved cannot be closed. System action: No event rule is saved. Operator response: See message text. AWSUI5018E The following internal error has occurred while processing the rule definitions: error Explanation: This message is displayed when a not specific internal error occurs. System action: No change happens in the event rule. Operator response: See message text. AWSUI5015E Unable to open the Event Rule Editor for the following reason: reason Explanation: The Rule Editor cannot be opened. System action: none Operator response: See message text. AWSUI5014E An internal error has occurred. The program was not able to issue the heart beat to the server (that keeps the session active) because the following error occurred: error Explanation: Unable to execute an Heart Beat to keep the session up. System action: The session is not kept up Operator response: See message text.

Appendix A. Web console messages

145

AWSUI5020E AWSUI5032E
AWSUI5020E Unable to remove the action [id= action_ID , name= action_name] from pane pane. The error is: error Explanation: This message is displayed when an error occurs while removing an action from the actions area. System action: The action is not removed from the event rule. Operator response: See message text. AWSUI5021E Unable to add the event [plugin= plugin_name , name= event_name]. The error is: error Explanation: This message is displayed when an error occurs while adding an event to the events area. System action: The event is not added or stored in the event rule. Operator response: See message text. AWSUI5022E Unable to remove the event [id= event_ID , name= event_name]. The error is: error Explanation: This message is displayed when an error occurs while removing an event from the events area. System action: The event is not removed from the event rule. Operator response: See message text. AWSUI5023E The events cannot be resequenced, because the following event could not be moved: [id= event_ID , name= event_name]. The error is: error Explanation: This message is displayed when an error occurs while ordering an event in sequence with others. System action: The event is not moved Operator response: See message text. AWSUI5024E Unable to change the event type [type= event_type]. The error is: error Explanation: This message is displayed when an error occurs while changing the event type (filter, set, sequence). System action: The event type is not changed Operator response: See message text. AWSUI5025E The event rule name is not valid because it contains characters that are not permitted. Explanation: System action: The event rule cannot be saved. AWSUI5027E The event rule name cannot be longer than 40 characters. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5028E The event rule name cannot be blank. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5029E The date and time cannot be blank. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5030E The date is not valid. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5031E The date and time cannot both be blank. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5032E The description cannot be longer than 120 characters. Explanation: System action: The event rule cannot be saved. Operator response: See message text. Operator response: See message text. AWSUI5026E The event rule name cannot contain blanks. Explanation: System action: The event rule cannot be saved. Operator response: See message text.

146

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI5033E AWSUI5048E
AWSUI5033E The validity period is not valid. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5034E The validity date range is not valid. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5035E A required selection has not been made. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5036E At least one value must be selected. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5037E The time is not valid. Explanation: System action: The event rule cannot be saved. Operator response: See message text. AWSUI5038E The event rule cannot be saved because it contains errors. Explanation: There is an error in some field of the Rule Editor. The event rule cannot be saved. System action: The event rule cannot be saved and the button SAVE is disabled. Operator response: See message text. AWSUI5039W Too many results have been found. The list has been truncated. Explanation: Operator response: See message text. AWSUI5041E The search has failed. The error is: error Explanation: System action: Operator response: See message text. AWSUI5043E The event rule cannot be saved because the rule name was not specified. Explanation: System action: Operator response: See message text. AWSUI5044E The event rule cannot be saved because it is incorrect. Fix all highlighted errors before saving the event rule. Explanation: System action: Operator response: See message text. AWSUI5045E The input value does not match the syntax requirements for a regular expression. Explanation: System action: Operator response: See message text. AWSUI5046W There is no engine connection defined. An engine connection is required to work with the Event Rule Editor. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5047E Specify an integer between minValue and maxValue Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5048E Insert a value. Explanation: The data input is not valid. System action: none Operator response: See message text.
Appendix A. Web console messages

AWSUI5042E The event rule cannot be saved because it is not complete. Explanation: System action: Operator response: See message text.

147

AWSUI5049E AWSUI5052E
AWSUI5049E Specify a value between minValue and maxValue Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5051E The inserted value for type "type" is not valid. Explanation: The data input is not valid. System action: none Operator response: See message text. AWSUI5052E Authentication failed: the userid or password are incorrect. Explanation: The data input is not valid. System action: none Operator response: Specify the correct credentials to access the Tivoli Workload Scheduler engine.

148

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

AWSUI5500E AWSUI5509E

Server Messages
AWSUI5500E Unable to retrieve event configurations from the given engine. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check the log to find information about the problem cause. Check that the host where the engine resides is up and running, try to ping it. Ensure that Tivoli Workload Scheduler is up and running on that host. Fix any problem you find and retry the operation. AWSUI5501E Unable to retrieve action configurations from the given engine. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check the log to find information about the problem cause. Check that the host where the engine resides is up and running. Check that Tivoli Workload Scheduler is up and running on that host. Fix any problem you find and retry the operation. AWSUI5502E Unexpected look-up parameter type. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Try again to perform the operation. If the problem persists, contact IBM Software Support for assistance AWSUI5503E The event rule does not exist or has been previously deleted. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Select a different event rule and retry the operation. AWSUI5504E The event rule already exists. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Choose a different event rule name and retry the operation. AWSUI5509E The event rule "rule_name" already exists. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Choose a unique event rule name and retry the operation. AWSUI5505E The event rule is incorrect, the error is: error_message Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check the information supplied for the event rule. Use the information in the error_message to diagnose and resolve the problem. Retry the operation. AWSUI5506E Unable to create the filtering predicate because of the following error: error Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Use the information in the error_message to diagnose and resolve the problem. Retry the operation. AWSUI5507E Event rule type "event_rule_type" is not supported. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Choose a different event rule type. Retry the operation. AWSUI5508E The event rule cannot be renamed because this operation is not supported at the moment. Explanation: While editing an event rule, you cannot rename it. System action: The requested operation is not completed successfully. Operator response: To rename an event rule, return to the Browse Event Rules panel, select the rule, and select Create Another from the More Actions menu. Then save the new rule with the new name, and delete the original rule.

Appendix A. Web console messages

149

AWSUI5510E AWSUI5511E
AWSUI5510E The engine connection "engine_connection_name" does not exist. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Create the engine connection and retry the operation. AWSUI5511E An error has occurred. No further information is available. Check the log files for more details. Explanation: See message. System action: The requested operation is not completed successfully. Operator response: Check the log files and take the appropriate action. If the problem persists contact IBM Software Support for assistance.

150

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0001E EEWO0016E

R3Batch Messages
EEWO0001E Job aborted. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0010E The extended agent has not started. The command to launch it included no options. Explanation: See message. System action: R3batch stops Operator response: Verify the parameters you should supply to the r3batch command in the Users Guide . Reissue the command with the correct parameters. See also: The Users Guide for details of the command syntax. EEWO0011E The extended agent has not started. The command to launch it has syntax errors. Explanation: See message. System action: R3batch stops. Operator response: Verify the parameters you should supply to the r3batch command in the Users Guide . Reissue the command with the correct parameters. See also: The Users Guide for details of the command syntax. EEWO0012E The extended agent could not be initialized. Explanation: See message. System action: R3batch stops. Operator response: Check that the connections between the SAP system and the local host are correct. Check also that the local option file exists, is in the correct directory, has read permission for the user running r3batch , and is not corrupt. When you have found and corrected the error, rerun r3batch . EEWO0013E The extended agent could not find the following Tivoli Workload Scheduler home directory: TWS_home_directory . Explanation: TWS_home_directory is the directory where Tivoli Workload Scheduler is installed. System action: R3batch stops. Operator response: Check that the directory indicated in the message has the correct name. Check that the EEWO0014E The extended agent could not find the following method options file: method_options_file . Explanation: method_options_file is the file that contains the R/3 method options. System action: R3batch stops. Operator response: Check that the file indicated in the message has the correct name. Check that the file on the hard disk exists, and has read permission for the user running r3batch . If the file is missing, follow the instructions telling you how to create it in the Users Guide . When you have found and corrected the error, rerun r3batch . See also: The Users Guide for the instructions on how to create the method options file. EEWO0015E The method options file: method_options_file for the following job: job_name does not contain the required options. Explanation: method_options_file is the file that contains the R/3 method options. job_name is the name of the job that you are trying to run. System action: R3batch stops. Operator response: Check in the Users Guide for details of the options that must be supplied for the job that you want to run. When you have found and corrected the error, rerun r3batch . See also: The Users Guide for details of the options you must include in the method options file for each type of job. EEWO0016E The method options file: method_options_file for the following job: job_name does not contain all of the required options. Explanation: method_options_file is the file that contains the R/3 method options. job_name is the name of the job that you are trying to run. System action: R3batch stops. Operator response: Check in the Users Guide for details of the options that must be supplied for the job that you want to run. When you have found and corrected the error, rerun r3batch .
Appendix A. Web console messages

directory on the hard disk exists, and has read permission for the user running r3batch . When you have found and corrected the error, rerun r3batch .

151

EEWO0017E EEWO0103E
See also: The Users Guide for details of the options you must include in the method options file for each type of job. EEWO0017E An internal I/O error occurred reading the following method options file: method_options_file . Explanation: method_options_file is the file that contains the R/3 method options. System action: R3batch stops. Operator response: Check that there is sufficient disk space on the file system where the method options file is located. Check that the file has read permission for the user that is running r3batch . Check that the operating system has not reached the maximum number of files it can have open at the same time. When you have found and corrected the error, rerun r3batch . EEWO0018E An internal I/O error occurred reading the following method options file: method_options_file . Explanation: method_options_file is the file that contains the R/3 method options. System action: R3batch stops. Operator response: Check that there is sufficient disk space on the file system where the method options file is located. Check that the file has read permission for the user that is running r3batch . Check that the operating system has not reached the maximum number of files it can have open at the same time. When you have found and corrected the error, rerun r3batch . If the error persists, contact IBM Software Support for assistance. EEWO0019E An internal error occurred while trying to initialize the TWSMETH_CP code page. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0100E An internal error has occurred. The following unknown BAPI return code: BAPI_return_code ( BAPI_message ) was received while calling the following function: function . Explanation: BAPI_return_code is the code returned by the BAPI module. BAPI_message is the message associated with the code returned by the BAPI module. function is one of the functions used by the program. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0101E The following ABAP module cannot be found: " ABAP_module " . All required ABAP modules must be installed before running the extended agent. Explanation: ABAP_module is a required module that has not been installed. System action: R3batch stops. Operator response: Use the Users Guide to determine the ABAP modules required. Contact your SAP system administrator to have them installed. See also: The Users Guide for details of the ABAP modules required. EEWO0102E An internal error has occurred. The function ItCreate has failed for the following object: object in the following module: module . Explanation: object is the object that the function ItCreate was trying to perform on. module is the module being processed. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0103E R3batch has run out of memory (the function RfcAllocParamSpace has failed in the following module: module ). Explanation: module is the module being performed. System action: R3batch stops. Operator response: Check the following: 1. Verify if the workstation has enough memory available. Information about the memory requirements of Tivoli Workload Scheduler for Applications is provided in the Release Notes . If not, you may need to increase the memory of the workstation or make changes in memory management and paging to make more memory available to r3batch . Rerun r3batch . If the workstation memory is adequate, try closing all the applications that you do not need, and then rerun r3batch . If the problem persists, reboot the workstation, and then rerun r3batch .

2.

3.

4. If the problem persists, contact IBM Software Support for assistance.

152

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0104E EEWO0112E
See also: The Release Notes for details of memory requirements. EEWO0104E An internal error has occurred. The RFC system failed while calling the following module: module . Explanation: module is the module being performed. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0107E This extended agent for R/3 does not support your version of the SAP R/3 system, which is the following: R/3_version . Explanation: R/3_version is the version number of the SAP R/3 system on this workstation. System action: R3batch stops. Operator response: Use the Users Guide to determine the version or versions of SAP supported. If you are using a lower version of SAP than that or those supported, you should upgrade to a supported version. If you are using a higher version of SAP than that or those supported, you should check on the IBM products Web site to see if there is a later version of Tivoli Workload Scheduler for Applications available. See also: The Users Guide for details of the version or versions of SAP that are supported. EEWO0108E R3batch has found that the following component is not at the correct version: component . Explanation: component is the component of Tivoli Workload Scheduler for Applications that is at the wrong version level. System action: R3batch stops. Operator response: Upgrade the specific component, if possible. If not possible, upgrade or reinstall Tivoli Workload Scheduler for Applications. See the Users Guide for details of the installation. See also: The Users Guide for details of the installation. EEWO0109E An internal error has occurred. The following RFC function: function_name failed after the following number of attempts: attempts . Explanation: function_name is the name of the function being performed. attempts is a count of the number of tries that r3batch made at performing the function. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0110E An internal error has occurred. The RFC was not initialized when calling the following function: function_name . Explanation: function_name is the name of the function being performed. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0111E This user cannot define jobs on the following SAP R/3 system: SAP_system_name . Explanation: You do not have the required authority to define or create jobs on the SAP system. SAP_system_name is the name of the SAP system where you do not have permission to define or create jobs. System action: R3batch continues, but the job you are trying to run is not processed. Operator response: Consult your local SAP or Tivoli Workload Scheduler administrator to determine if the user ID that you have used is the correct one, and if this user should have the authorization to run jobs on the SAP system. When the problem is resolved restart r3batch . EEWO0112E The extended agent cannot create the following job: " job_name " with job ID: " job_ID " . Explanation: job_name is the name of the job that cannot be created. job_ID is the job ID of the job that cannot be created. System action: R3batch continues, but the job you are trying to run is not processed. The batch log ( r3batch_trace.log ) is produced giving more details of the steps that occurred before the job creation failed. Operator response: Use the batch log to determine the cause of the problem. If the log file does not contain enough information, set the debug_level to MAX as described in the Users Guide . Then rerun r3batch . When you have located and resolved the problem, rerun r3batch .

Appendix A. Web console messages

153

EEWO0113E EEWO0120E
EEWO0113E An internal error has occurred. An exception: exception_number has occurred while calling the following function module: function_module_name . Explanation: exception_number is the error number. function_module_name is the name of the function module being performed when the error occurred. System action: R3batch stops. Operator response: This error might not be repeated. Try restarting r3batch . If the error persists, contact IBM Software Support for assistance. EEWO0114E An internal error has occurred. The following database name is not correct: database_name . The help view is not retrieved. Explanation: database_name is the name of the database that is not correct. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0115E An internal error has occurred. The following counter ID is not valid: counter_ID . Explanation: counter_ID is the counter ID that is not valid. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0116E The extended agent could not open the following joblog (stdlist) file: joblog_file_name . Explanation: Another process has locked the joblog file. joblog_file_name is the name of the file that is locked. System action: R3batch continues. Operator response: Take these steps. v Use the operating system facilities to determine which process has locked the joblog file. v Wait until the process that has locked the file stops. v If the process does not stop in an acceptable time frame, consider forcing the other process to stop (you should evaluate the risk of leaving data in a corrupted state). Use the operating system facilities to accomplish this. EEWO0117E R3batch has failed because the workstation where it is running has insufficient memory. Explanation: See message. System action: R3batch stops. Operator response: Check the following: 1. Verify if the workstation has enough memory available. Information about the memory requirements of Tivoli Workload Scheduler for Applications is provided in the Release Notes . If not, you may need to increase the memory of the workstation or make changes in memory management and paging to make more memory available to r3batch . Rerun r3batch . If the workstation memory is adequate, try closing all the applications that you do not need, and then rerun r3batch . If the problem persists, reboot the workstation, and then rerun r3batch .

2.

3.

4. If the problem persists, contact IBM Software Support for assistance. See also: The Release Notes for details of memory requirements. EEWO0118E R3batch has failed because it could not create and start a job instance. Explanation: See message. System action: The job instance is not created. Operator response: Check the r3batch log file for the reason for the error and try and resolve it. If you have corrected the error, rerun r3batch . If the problem persists, contact IBM Software Support for assistance. EEWO0119E An internal error has occurred. The cleanup task could not delete the following job: " job_name " . The job ID is: " job_ID " . Explanation: job_name is the name of the job that cannot be deleted. job_ID is the job ID of the job that cannot be deleted. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0120E The job you are trying to monitor does not exists. The job number and name are as follows: " job_number : job_name " . Explanation: job_number is the job number of the job that does not exist.

154

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0121E EEWO0161E
job_name is the name of the job that does not exist. System action: The program might stop. Operator response: Verify that the job number and job name you are trying to monitor match an existing job. To determine which jobs are available, use the Find Job functionality in the Job Scheduling Console. If you have corrected the error, rerun r3batch . EEWO0121E The R/3 system might not be available. BDCWAIT has failed to start after the following number of failed attempts: attempts . Explanation: attempts is the number of times that r3batch tried to start BDCWAIT. System action: The program might stop. Operator response: Check that the R/3 system is running. Check the job status. If you find an error and correct it, rerun r3batch . EEWO0122E An internal error has occurred. R3batch could not scan the R/3 joblog for BDCWAIT messages. Explanation: See message. System action: The batch job stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0123E An internal error has occurred. R3batch could not check the BDC session status in the R/3 system. Explanation: See message. System action: The batch job stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0124E The following SAP R/3 system defined in the method options file is not running: SAP_system_name . Explanation: SAP_system_name is the name of the SAP R/3 system that is not running. System action: R3batch stops. Operator response: Verify that the information in the options file is correct. Check that the SAP system is available, for example, by pinging the IP address of the SAP system. If you have corrected the error, rerun r3batch . EEWO0125E The SAP job specified in the job definition cannot be performed, because it has an incorrect job type. Explanation: See message. System action: R3batch continues, but the job being processed is ignored. Operator response: Check that the SAP job name specified in the job definition is correct and matches with the name of the SAP job defined in the SAP system. Check that the job type is correct. If you have corrected the error, rerun r3batch . EEWO0126E The following mapping file cannot be read due to an I/O error: mapping_file_name . Explanation: mapping_file_name is the name of the return code mapping file that cannot be read. System action: The job processing continues, but the return code mapping is not performed. Operator response: Check that the file with the indicated name exists, in the correct directory, and with read permission for the user running r3batch . Open the file with a text editor to ensure that is readable. If you have corrected the error, rerun r3batch . EEWO0160E An internal error has occurred. The following method: " method_name " was called by the following request: " request_type " , which is currently not supported by the following module: module . Explanation: method_name is the name of the method being called. request_type is the type of request being made. module is the module that does not support this request. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0161E A syntax error occurred when r3batch was started. The following task parameter is unrecognized: task_parameter . Explanation: task_parameter is the task parameter that is not recognized. System action: R3batch stops. Operator response: See Users Guide for a description of the task parameters. Rerun r3batch , supplying only recognized task parameters.

Appendix A. Web console messages

155

EEWO0162E EEWO0173E
See also: The Users Guide for a description of the task parameters. EEWO0162E A syntax error occurred when r3batch was started. One or more parameters is missing from the following task: task_name . It needs the -c, -j, -l, -t, and -- parameters. Explanation: task_name is the name of the task that you are trying to run. System action: R3batch stops. Operator response: See Users Guide for a description of the task parameters. Rerun r3batch , supplying the correct task parameters. See also: The Users Guide for a description of the task parameters. EEWO0163E A syntax error occurred when r3batch was started. One or more parameters is missing from the following task: task_name . It needs the -c, -j, -t, and -- parameters. Explanation: task_name is the name of the task that you are trying to run. System action: R3batch stops. Operator response: See Users Guide for a description of the task parameters. Rerun r3batch , supplying the correct task parameters. See also: The Users Guide for a description of the task parameters. EEWO0164E A syntax error occurred when r3batch was started. One or more parameters is missing from the following task: task_name . It needs the -c, -t, and -- parameters. Explanation: task_name is the name of the task that you are trying to run. System action: R3batch stops. Operator response: See Users Guide for a description of the task parameters. Rerun r3batch , supplying the correct task parameters. See also: The Users Guide for a description of the task parameters. EEWO0165E A syntax error occurred when r3batch was started. One or more parameters is missing from the following task: task_name . It needs the -c, -j, -l, -o, -t, and -- parameters. Explanation: task_name is the name of the task that you are trying to run. System action: R3batch stops. Operator response: See Users Guide for a description of the task parameters. Rerun r3batch , supplying the correct task parameters. See also: The Users Guide for a description of the task parameters. EEWO0166E An internal error has occurred: GI and PI require task specification. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0167E An error occurred when r3batch was started. One or more internal parameters is missing from the following task: task_name . It needs the following parameter: parameter_name . Explanation: task_name is the name of the task being run. parameter_name is the name of the missing internal parameter. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0171E You have specified a step to run an ABAP or an external program, but the step number ( step_number ) cannot be determined. Explanation: step_number is the number of the step that is not in the correct format to be determined. System action: R3batch stops. Operator response: See the SAP system administrator. EEWO0172E You have defined a job as a series of steps, but one of the steps has a number which is out of range: step_number . Explanation: step_number is the number of the step that is not in the correct range. System action: R3batch stops. Operator response: See the SAP system administrator and determine the correct step number. EEWO0173E You have specified a step to run the following ABAP: ABAP_name which requires one or more variants, but no variants have been specified. Explanation: ABAP_name is the name of the ABAP

156

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0174E EEWO0180E
module which is specified to be run. System action: R3batch stops. Operator response: Determine the correct variants to use from the SAP system administrator. Change the job specification to add the variant or variants. If a variant is missing it must be created. There are two alternative ways to create a variant: v Follow the instructions in the Users Guide to create a variant using the Job Scheduling Console Operator response: Verify the correctness of the information in the step, such as the name of the job, the user name, and the variant details, correct any errors and retry the add step action. If the problem continues, also check the connectivity with the SAP system. If you find the problem and correct it, rerun r3batch . EEWO0177E The following step is not valid, and cannot be performed: step_number . Explanation: step_number is the number of the step that is not valid. System action: R3batch continues, but the step is not performed. Operator response: Verify the correctness of the information in the step. Verify the name of the job, the user name, and the variant details . If the problem continues, also check the connectivity with the SAP system. If you find the problem and correct it, rerun r3batch . EEWO0178E An internal error has occurred. The following incorrect step type: " step_type " has been supplied for step: " step_number " . Explanation: step_type is the non-valid type that has been supplied by the GUI for the step. step_number is the number of the step being processed. System action: R3batch continues, but the step is not performed. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0179E An internal error occurred because a variant name counter field was missing for the following report: " report_name " and variant: " variant_name " . Explanation: report_name the name of the report that r3batch was trying to create. variant_name the name of the variant that was being processed when the error occurred. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0180E During the preparation of the following report: " report_name " , r3batch could not make a copy of the following variant: " original_variant_name " because the copy name of the variant generated automatically by the program: " variant_copy_name " is the same as that of an existing variant.
Appendix A. Web console messages

v Ask the SAP system administrator to create the variant using the SAP GUI EEWO0174E An internal error occurred while accessing the variant selection table J1O1VARSO for the following report: " report_name " and variant: " variant_name ". Explanation: report_name the name of the report that r3batch was trying to create. variant_name the name of the variant that was being processed when the error occurred. System action: R3batch continues, but the job is not processed. Operator response: Rerun r3batch (the problem may have been transient). If the problem persists, contact IBM Software Support for assistance. EEWO0175E An internal error occurred while accessing the variant counter table J1O1VARCO for the following report: " report_name " and variant: " variant_name ". Explanation: report_name the name of the report that r3batch was trying to create. variant_name the name of the variant that was being processed when the error occurred. System action: R3batch continues, but the job is not processed. Operator response: Rerun r3batch (the problem may have been transient). If the problem persists, contact IBM Software Support for assistance. EEWO0176E There is an error in the job information that has prevented the r3batch program from creating the following step: step_number . Explanation: You are trying to add a step but an error in the step data prevents it from being added. step_number is the number of the step you are trying to add. System action: The step is not added.

157

EEWO0181E EEWO0187E
Explanation: report_name the name of the report that r3batch was trying to create. original_variant_name the name of the variant that was being processed when the error occurred. variant_copy_name the name of the copy that r3batch is trying to create - also the name of the existing variant. System action: R3batch stops. Operator response: Take either of these steps: v Change the name of the existing variant with which the copy name has clashed. v Change the name of the original variant which was being copied (the copy name is based on the original, so any change in the original name will create a copy with a different name) Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0184E A variant required for this job is locked by another application. Explanation: See message. System action: R3batch stops. Operator response: User the operating system tools to determine which application has locked the variant. Decide whether you should stop that application or wait for it to stop or unlock the variant of its own accord. If you find the problem and correct it, rerun r3batch . EEWO0185E The properties of the variant required for this job indicate that is protected by another user. Explanation: See message. System action: R3batch continues, but the processing of the job stops. Operator response: Contact the user that has protected the variant and request that the protection is removed so that you can use it for your job. If you find the problem and correct it, rerun r3batch . EEWO0186E A variant required for this job no longer exists. Explanation: See message. System action: R3batch stops. Operator response: Check in the job definition that the variant is correctly specified. If it is not, correct the job definition and rerun r3batch . If it is correctly specified, the variant is genuinely missing and must be created. There are two alternative ways to create a variant: v Follow the instructions in the Users Guide to create a variant using the Job Scheduling Console

Rerun r3batch . EEWO0181E R3batch could not obtain the semaphore identified in the global options file (required to control access to shared resources). Explanation: See message. System action: R3batch continues, but the variant is not processed. Operator response: Contact the SAP system administrator to determine why the semaphore is missing. If you find the problem and correct it, rerun r3batch . See also: See the Users Guide for more information about variants and semaphores. EEWO0182E R3batch could not create the following report: " report_name " because the variant: " variant_name " has one or more incorrect values (placeholders or counters). Explanation: report_name the name of the report that r3batch was trying to create. variant_name the name of the variant that was being processed when the error occurred. System action: R3batch continues, but the report is not created. Operator response: Contact the SAP system administrator to determine why the values are incorrect, and to correct them. If you find the problem and correct it, rerun r3batch . EEWO0183E An internal error has occurred while calling the function " j_1O1_variant_maintain_sel_tbl " , because the parameters to the call were not valid.

v Ask the SAP system administrator to create the variant using the SAP GUI When the job definition is pointing to an existing variant, rerun r3batch . EEWO0187E A variant required for this job is obsolete and cannot be used. Explanation: See message. System action: R3batch stops. Operator response: Check in the job definition that

158

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0189E EEWO0263E
the variant is correctly specified. If it is not, correct the job definition and rerun r3batch . If it is correctly specified, change the variant specification to refer to a variant that is not obsolete or create a new variant. There are two alternative ways to create a variant: v Follow the instructions in the Users Guide to create a variant using the Job Scheduling Console EEWO0224E R3batch cannot perform a job because it has the same job name user name and client number as an existing job. Explanation: See message. System action: R3batch stops. Operator response: Check if you have tried to accidentally run the same job twice. If you need to run this job, either wait for the previous job to finish, or contact the SAP system administrator to stop the previous job. Then rerun r3batch . EEWO0260E An internal error has occurred. The recovery process has started with a non-valid or missing batch job ID: job_ID . Explanation: job_ID identifies the job that cannot be processed. System action: The recovery process does not continue. The job recovery is not performed. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0261E An internal error has occurred. The recovery process has started with a non-numeric or wrong-length batch job ID. It must be an eight digit number: job_ID . Explanation: job_ID identifies the job that cannot be processed. System action: The recovery process does not continue. The job recovery is not performed. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0262E A syntax error has been found with the job options. The following option does not start with a hyphen: job_option . Explanation: job_option is the option that does not start with a hyphen. System action: R3batch stops. Operator response: Check the job option syntax in the Users Guide . Correct the syntax and rerun r3batch . See also: The Users Guide for details of the job options syntax. EEWO0263E A syntax error has been found with the job options. More job options were submitted than the maximum allowed: maximum_job_options . Explanation: maximum_job_options is the maximum number of job options that you can define.
Appendix A. Web console messages

v Ask the SAP system administrator to create the variant using the SAP GUI When the job definition is pointing to an existing, not-obsolete variant, rerun r3batch . EEWO0189E A variant required for this job cannot be created. The variant data is not valid (too long): variant_data . Explanation: variant_data is the data used to create a variant that is too long. System action: The program might stop. Operator response: Check the data used to create the variant. If you find an error and correct it, rerun r3batch . EEWO0223E Either no matching job could be found in the following R/3 instance: R/3_instance , or a job is found with steps but no start time. The following identify the job: Host: host_name Job: job_name User: user_name Client: client . Explanation: Probably you have supplied incorrect information to describe the R/3 job. host_name is the name of the SAP system host. job_name is the name of the job for which a match cannot be found on the R/3 system. user_name is the name of the user running the job. client identifies the R/3 client. System action: R3batch stops. Operator response: Check whether there is a job on the SAP system which has a matching R/3 client, job name and user name as the Tivoli Workload Scheduler for Applications job definition for this job. Also verify that the R/3 transaction SM37 shows the job in the " released " state. When you have identified the error, correct the Tivoli Workload Scheduler for Applications job definition and rerun r3batch .

159

EEWO0264E EEWO0270E
System action: R3batch stops. Operator response: Check the job option syntax in the Users Guide . Reduce the number of job options for this job, for example, by dividing it into two jobs, each of which would have a reduced number of job options. Correct the syntax and rerun r3batch . See also: The Users Guide for details of the job options syntax. EEWO0264E A syntax error has been found with the job options. The following job option requires a value after keyword: job_option . Explanation: job_option is the option that requires a value. System action: R3batch stops. Operator response: Check the job option syntax in the Users Guide . Correct the syntax by adding the value to the indicated option and rerun r3batch . See also: The Users Guide for details of the job options syntax. EEWO0265E A syntax error has been found with the job options. The following option sequence is not correct: " job_option1 " " job_option2 " . The " job_option3 " option requires a value, which cannot begin with a hyphen (minus sign). Explanation: There is a problem with the syntax of the job options. The above message might exactly explain the problem. However, it might be that an error of syntax has allowed the program to interpret a value as a job option. job_option1 , is the option that must not precede job_option2 . job_option3 requires a value, which cannot commence with a hyphen. System action: R3batch stops. Operator response: Check the full job option syntax in the Users Guide , not only for the indicated job options, but also for all others. Correct the syntax and rerun r3batch . See also: The Users Guide for details of the job options syntax. EEWO0266E A syntax error has been found with the job options. The following option could not be recognized: unrecognizable_job_option . Explanation: unrecognizable_job_option is a string that by its position in the syntax and the presence of a hyphen in the first position indicates that it is a job option, but that does not match a valid job option. System action: R3batch stops. Operator response: Check the job option syntax in the Users Guide . Correct the syntax and rerun r3batch . See also: The Users Guide for details of the job options syntax. EEWO0267E A syntax error has been found with the job options. The following job ID is not valid: job_ID . Explanation: job_ID is the job ID that is not valid. System action: R3batch stops. Operator response: Check the job option syntax in the Users Guide . Correct the job ID and rerun r3batch . See also: The Users Guide for details of the job options syntax. EEWO0268E An internal error has occurred. The recovery process has started with the following non-valid parameter: parameter . Explanation: parameter is the non-valid parameter of the job that cannot be processed. System action: The recovery process does not continue. The job recovery is not performed. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0269E A syntax error has been found with the job options. The following option: " job_option " has a non-valid value: " option_value " . Explanation: job_option is the option that has a non-valid value. option_value is the value that is not valid. System action: R3batch stops. Operator response: Check the job option syntax in the Users Guide . Correct the syntax by changing the value of the indicated option so that it is valid and rerun r3batch . See also: The Users Guide for details of the job options syntax. EEWO0270E A syntax error has been found with the job options. The following option: " job_option " has a non-valid value for the variant selection option sign: " option_value " . The value must be one of the following: " valid_values " .

160

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0271E EEWO0422E
Explanation: job_option is the option that has a non-valid value. option_value is the value that is not valid for the variant selection option sign. valid_values is a list of the permitted values for the option in this context. System action: R3batch stops. Operator response: Check the job option syntax in the Users Guide . Correct the syntax by changing the value of the indicated option so that it is valid and rerun r3batch . See also: The Users Guide for details of the job options syntax. EEWO0271E A syntax error has been found with the job options. The following option: " job_option " has a non-valid value for the variant selection option operation: " option_value " . The value must be one of the following: " valid_values " . Explanation: job_option is the option that has a non-valid value. option_value is the value that is not valid for the variant selection option operation. valid_values is a list of the permitted values for the option in this context. System action: R3batch stops. Operator response: Check the job option syntax in the Users Guide . Correct the syntax by changing the value of the indicated option so that it is valid and rerun r3batch . See also: The Users Guide for details of the job options syntax. v EEWO0383E R3batch failed to connect to the R/3 system on the following host: " host_name " , after the following number of attempts: attempts . v Explanation: host_name is the workstation where r3batch cannot connect to the R/3 system. attempts is the number of times that r3batch has tried. System action: R3batch stops. Operator response: The problem might have one of two causes: v Check that the client number, R/3 user ID and password in the options file are correct v Check with the SAP system administrator that the XA for SAP function modules (the programs for the Tivoli Workload Scheduler Xagent feature) have been installed and activated on the host If you have resolved the problem, rerun r3batch . EEWO0384E R3batch failed to establish a connection to the following R/3 instance: " R/3_instance " on the following host: " host_name " , after the following number of attempts: attempts . Explanation: R/3_instance identifies the R/3 instance that could not be connected to. host_name is the workstation where r3batch cannot connect to the R/3 system. attempts is the number of times that r3batch has tried. System action: R3batch stops. Operator response: The problem might have one of two causes: v Check that the client number, R/3 user ID and password in the options file are correct v Check with the SAP system administrator that the indicated R/3 instance is running on the host If you have resolved the problem, rerun r3batch . EEWO0420E An internal error has occurred. R3batch either could not open or could not copy the R/3 job. Explanation: See message. System action: The program might stop. Operator response: The problem might be one of several: v Check that there is available disk space in the file set where Tivoli Workload Scheduler for Applications is installed. If there is not sufficient space, create more space and rerun r3batch . Check that the user running r3batch has read and write permissions in the Tivoli Workload Scheduler for Applications install directory and its subdirectories. If there is a problem with permissions, correct it and rerun r3batch . Check that the operating system has not reached the maximum number of files that it can open at the same time. If this is the problem, either use the operating system facilities to allow more file descriptors, wait for other applications that are using files to close them, or stop other applications that are using files. Rerun r3batch .

v If the problem is not one of these, contact IBM Software Support for assistance. EEWO0422E The following variant option is not valid: variant_option Explanation: variant_option is the variant option (parameter) that is not valid.

Appendix A. Web console messages

161

EEWO0426E EEWO0506E
System action: R3batch stops. Operator response: Contact the SAP system administrator to determine the correct format and value for the indicated variant option. Correct the job definition and rerun r3batch . EEWO0426E R3batch cannot create the job. The following R/3 RFC user does not have the appropriate R/3 user authorization to create and start batch jobs: user_name . Explanation: user_name identifies the user that does not have R/3 authorization to create and start batch jobs. System action: R3batch stops. Operator response: Either contact the SAP system administrator to have the appropriate authorizations given to the indicated user, or change the RFC user in the job definitions to a user that has the required authorizations. Rerun r3batch . EEWO0428E An internal error has occurred. The program could not create the temporary variant table for this job (the rowptr from ItAppline is null). Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0429E The following job was not found, or is not in a correct state: " job_name " with the following job ID: " job_ID " . The state must be shown in R/3 as " Scheduled " , not " Released " or " Finished " . Explanation: job_name and job_ID identify the job that was not found, or is not in a correct state. System action: R3batch stops. Operator response: Check that the job has been correctly defined in the job definitions. Contact the SAP system administrator to determine the correct identification of the R/3 job, and that it exists, and that it is in one of the above-indicated statuses. Correct the problem and rerun r3batch . EEWO0439E The required options are not specified either in the global or in the local options file. Explanation: The action being performed by the r3batch x-agent running the SAP job needs the values of one or more specific options that it expects to find in the global or local option file. It could not find those options. The details of which options are required are EEWO0504E An internal error has occurred: (RFC failed: SXMI_LOGON). Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0505E An internal error has occurred: (RFC failed: SXMI_VERSIONS_GET). Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0506E An internal error has occurred: (RFC failed: SXMI_LOGON). Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. given in the Users Guide . Some options are mandatory for all actions while other options are action-specific. System action: The program continues, if possible, ignoring the action that encountered the error. Operator response: Check in the Users Guide to determine the required options. Amend the global or local options file (or both) to include those options. Rerun r3batch . EEWO0441E The following client number is not valid: " client_number " . Client numbers must be between 0 and 999. Explanation: client_number is the client number (SAP port number) that is not an integer between 0 and 999. System action: R3batch stops. Operator response: Contact the SAP system administrator to determine the correct value (the port number) of the R/3 client. Check that the client option in the global or local options file has this value, changing it if not. For more details about the options in the global and local options files see the Users Guide . Rerun r3batch . See also: The Users Guide for more details about the options in the global and local options files.

162

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0507E EEWO0558E
EEWO0507E An internal error has occurred: (RFC failed: SXMI_AUDITLEVEL_SET). Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0510E An internal error has occurred: (get_record: Non-valid keyword. Expected: expected_keyword ). Explanation: expected_keyword is the keyword expected at this point. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0550E No job name has been specified for the following user: user_name . Explanation: user_name identifies the user for which a job name has not been specified. System action: The program waits for you to correct the input or exit. Operator response: Supply a job name and continue. EEWO0551E Either no matching job could be found, or a job is found with steps but no start time, or the job that is found has a " released " status. The following identify the job: User: user_name Job: job_name . Explanation: user_name identifies the user for which the job cannot be run. job_name identifies the job that cannot be run. System action: The program waits for you to correct the input or exit. Operator response: Check whether the R/3 job name and user name match the Tivoli Workload Scheduler for Applications job definition for this job. Check if the R/3 transaction SM37 shows the job in the " released " state; as SAP jobs in the " released " state cannot be run. Correct the problem and continue. EEWO0553E The XBP interface reports that the external user is missing. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0554E R3batch has stopped because the R/3 XMI logging mechanism has returned an error. There might be a connection problem. Explanation: See message. System action: R3batch stops. Operator response: Check that the connection with the R/3 system is working correctly. If it is, or if the error persists, contact IBM Software Support for assistance. EEWO0555E R3batch could not invoke the R/3 XMI interface. There might be a connection problem. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0558E The XBP interface has returned the following error: " Cannot select the following job: job_name with the following job ID: job_ID " . Explanation: job_name is the name of the job that cannot be selected. job_ID is the ID of the job that cannot be selected. System action: R3batch stops.
Appendix A. Web console messages

EEWO0552E The R/3 job scheduling system has found an error for the following job: User: user_name Job: job_name . Explanation: user_name identifies the user for which the job cannot be run. job_name identifies the job that cannot be run. System action: R3batch stops. Operator response: Contact the R/3 system administrator to check the R/3 syslog, which should contain more details of the error. Also check the correctness of the indicated user name and job name. Correct the problem and rerun r3batch .

163

EEWO0559E EEWO0568E
Operator response: Check that the job name and ID are correctly identified in the job options. Ensure they match with the R/3 job. Correct any error you find and rerun r3batch , otherwise contact IBM Software Support for assistance. EEWO0559E The XBP interface has returned the following error: " Cannot process the job because the job name or job ID is missing. " . Explanation: See message. System action: R3batch stops. Operator response: Check that the job name and ID are correctly identified in the job options. Ensure they match with the R/3 job. Correct any error you find and rerun r3batch , otherwise contact IBM Software Support for assistance. EEWO0561E The XBP interface has returned the following error: " Cannot delete the following job: " . Job name: " job_name " Job ID: " job_ID " . Explanation: job_name is the name of the job that cannot be deleted. job_ID is the ID of the job that cannot be deleted. System action: R3batch stops. Operator response: Check that the job name and ID are correctly identified in the job options. Ensure they match with the R/3 job. Contact the R/3 system administrator to check the R/3 syslog, which should contain more details of the error. Check that the user has the correct permission to run the job. Correct any error you find and rerun r3batch , otherwise contact IBM Software Support for assistance. EEWO0562E The XBP interface has returned the following error: " The ABAP program name is missing. " Explanation: See message. System action: R3batch stops. Operator response: Check the ABAP program name in the job definition. Correct any error you find and rerun r3batch , otherwise contact IBM Software Support for assistance. EEWO0563E The XBP interface has returned the following error: " The archive information cannot be found. " Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0564E The XBP interface has returned the following error: " The supplied print parameters are not valid. " Explanation: See message. System action: R3batch stops. Operator response: Check the print parameters in the job definition (see the Users Guide for details. Correct any error you find and rerun r3batch , otherwise contact IBM Software Support for assistance. See also: The Users Guide for details of the print parameters. EEWO0565E The XBP interface has returned the following error: " The supplied archive parameters are not valid. " Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Contact IBM Software Support for assistance. EEWO0566E The target host name is required for external step definition. Explanation: You have defined a job with an external step, but the target host name is missing in the step definition. System action: The program waits for you to correct the input or exit. Operator response: Specify the host name or exit. EEWO0568E The following job cannot be started " immediately " : Job name: " job_name " Job ID: " job_ID " . Explanation: The indicated job has been defined to run immediately , but the job has dependencies that cannot be resolved immediately. job_name is the name of the job that cannot be run immediately. job_ID is the ID of the job that cannot be immediately. System action: R3batch stops. Operator response: Check that the job definition settings of an " immediate " run time and dependencies is correct. If not, correct the job definition and rerun r3batch . If the settings are correct, decide whether you want to wait for the dependencies to be resolved or delete them

164

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0569E EEWO0578E
to let the job go ahead. Take the appropriate action and rerun r3batch . EEWO0569E An internal error has occurred. The step count is not correct. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0570E The following job does not have steps: Job name: job_name Job ID: job_ID . Explanation: job_name is the name of the job that does not have steps. job_ID is the ID of the job that does not have steps. System action: R3batch waits for a response from you. Operator response: Edit the job definition to supply the missing step definitions and continue, or cancel the job. EEWO0571E An internal error has occurred. The step count is missing. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0572E A Process Chain cannot be started. Explanation: See message. System action: The program might stop. Operator response: Contact the SAP system administrator and verify the SAP log to analyze the reason for the process chain not starting. If you find an error in the definition of the process chain in the job definitions, correct it and rerun r3batch . If the error is on the R/3 side, wait for it to be fixed and rerun r3batch . EEWO0573E The transfer structure for the following InfoPackage is not yet active: infopackage_name . Explanation: infopackage_name identifies the InfoPackage that cannot be utilized. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0574E An internal error has occurred. The request ID could not be found. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0575E The action has been cancelled for the following InfoPackage: infopackage_name . Explanation: infopackage_name identifies the InfoPackage that has been cancelled. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0576E The job defined in the following InfoPackage is already running: infopackage_name . Explanation: infopackage_name identifies the InfoPackage that is already running. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0577E The source system of the following InfoPackage is not correct: infopackage_name . Explanation: infopackage_name identifies the InfoPackage with the incorrect source system. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0578E The following InfoPackage does not exist: infopackage_name . Explanation: The probable reason is that the InfoPackage has been deleted after the job was defined but before it was run. infopackage_name identifies the InfoPackage that does not exist. System action: R3batch stops. Operator response: Check the definition of the InfoPackage in the job definitions. Ask the R/3 system
Appendix A. Web console messages

165

EEWO0579E EEWO0702E
administrator to check for its existence in the R/3 system. Correct any error you find and rerun r3batch . EEWO0579E An internal error has occurred (incorrect parametrization) while retrieving the list of available InfoPackages. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0580E The following InfoPackage cannot be run as it is already running: infopackage_name . Explanation: infopackage_name identifies the InfoPackage that is already running. System action: The program might stop. Operator response: Check the definition of the InfoPackage in the job definitions. Check that you are not trying to run the same job twice. Decide whether you want to wait for the previous InfoPackage to finish, or if you want to stop the previous InfoPackage from running, to allow your job to run. In the latter case, ask the SAP system administrator to stop the previous InfoPackage. Rerun r3batch . EEWO0581E The required Business Information Warehouse component is not installed on this R/3 system. Explanation: See message. System action: R3batch stops. Operator response: Contact the SAP system administrator to discuss why the component is not available. Either have the component installed or change the job definition to allow the job to run without this component. Then rerun r3batch . EEWO0582E An internal error occurred while retrieving the version of the Business Information Warehouse component. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Check the log for information that might explain why the version of the component cannot be retrieved. If you cannot determine such a reason, contact IBM Software Support for assistance. EEWO0583E The required Business Information Warehouse component is not supported on this R/3 system level. Explanation: See message. System action: R3batch stops. Operator response: Contact the SAP system administrator to discuss why the component is not supported. Either have the component upgraded or change the job definition to allow the job to run without this component. Then rerun r3batch . EEWO0584E The following R/3 RFC user does not have the appropriate R/3 user authorization to change the status of the interception or parent-child functionality: user_name . Explanation: user_name identifies the user that does not have the appropriate R/3 user authorization for the indicated purposes. System action: R3batch stops. Operator response: Contact the SAP system administrator to determine if it is possible to change the RFC users permissions on the R/3 system, or whether you should run this job as a different R/3 RFC user. In the latter case, modify the job definitions to use the different RFC user. Then rerun r3batch . EEWO0700E An internal error has occurred. The job class is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0701E An internal error has occurred. The print parameters are not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0702E An internal error has occurred. The external program flags are not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem

166

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0703E EEWO0712E
persists, contact IBM Software Support for assistance. EEWO0703E The program cannot read the joblog. Explanation: See message. System action: R3batch stops. Operator response: The problem could have various causes: v Check that the user running the job has read permission for the joblog. Give the user this permission if it does not. Check that there is sufficient disk space in the file system of the joblog. Make more space available if it does not. Check that the operating system has not reached its maximum limit of open files. If it has, either extend this limit, wait for other jobs that are using files to close, or stop other jobs that are using files. EEWO0708E An internal error has occurred. The initial step is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0709E An internal error has occurred. The job data is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0710E An internal error has occurred. The EXTCOMPANY and EXTPRODUCT parameters are different within a session. Explanation: See message. EEWO0705E The client number is missing in both the local and global options files. Explanation: See message. System action: R3batch stops. Operator response: Check both the local and global options files in the method directory. Add the client number (the port of the target host) to one, other, or both of them, as appropriate. Rerun r3batch . See also: The Users Guide for details of the contents and syntax of the options files. EEWO0706E An internal error has occurred. The job select process failed. Explanation: See message. System action: The program might stop. Operator response: This is an internal error. Check the log to identify a possible cause. If no cause is evident, contact IBM Software Support for assistance. EEWO0707E An internal error has occurred. The dialog type is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0711E An internal error has occurred. The start date is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, check the log to identify a possible cause. If you identify the problem, correct it and rerun r3batch. Otherwise, contact IBM Software Support for assistance. EEWO0712E An internal error has occurred. The step number is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, check the log to identify a possible cause. If you identify the problem, correct it and rerun r3batch. Otherwise, contact IBM Software Support for assistance.

Rerun r3batch . If none of these actions resolves the problem, contact IBM Software Support for assistance.

Appendix A. Web console messages

167

EEWO0713E EEWO0725E
EEWO0713E The job ID is missing. Explanation: See message. System action: R3batch stops. Operator response: Check the job definition. If the job ID is missing, check with the SAP system administrator to determine the correct ID and enter it in the job definition. Rerun r3batch . If the job ID is not missing, this is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0714E An internal error has occurred. The joblog name is missing. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0715E An internal error has occurred. The job failed to close. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0716E An internal error has occurred. A job could not be deleted. The following identify the job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that could not be deleted. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0717E An internal error has occurred. A job could not be deleted because it is not active. The following identify the job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that could not be deleted. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0719E The following job does not exist: Job name: job_name Job ID: job_ID . Explanation: The R/3 job might have been deleted by a different action, or it might have the correct job name but an incorrect job ID. job_name and job_ID identify the job that does not exist. System action: R3batch stops. Operator response: Retry the operation (the error may be transient). If the problem persists, check on the SAP system to see if the job exists. If it does not, check the log to see if it has been deleted by another action, and if so, decide whether it needs to be rerun. If it does exist, but has a different job ID than that indicated in the message, change the job definition accordingly and rerun r3batch . In all other circumstances contact IBM Software Support for assistance. EEWO0722E An internal error has occurred. A job could not be submitted. The following identify the job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that could not be submitted. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, check the log to identify a possible cause. If you identify the problem, correct it and rerun r3batch. Otherwise, contact IBM Software Support for assistance. EEWO0724E An internal error has occurred. A file or database could not be locked. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0725E The logon has failed. This user is not authorized to work with the R/3 external job management system. Explanation: See message. System action: R3batch stops. Operator response: Contact the R/3 system administrator to determine if the user can be granted permission to work with the R/3 external job

168

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0726E EEWO0736E
management system. If not, you should rerun the job as a user that has this permission. EEWO0726E An internal error has occurred. The name and qid are missing. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0727E The following user does not have " execute " privileges: user_name . Explanation: See message. System action: R3batch stops. Operator response: Determine from the system administrator whether the user can be granted " execute " privileges. If not, you should rerun the job as a user that has these privileges. EEWO0729E The following user does not have any access privileges: user_name . Explanation: See message. System action: R3batch stops. Operator response: Determine from the system administrator whether the user can be granted " access " privileges. If not, you should rerun the job as a user that has these privileges. EEWO0730E No variants have been defined. Explanation: See message. System action: The program waits for you to correct the data or exit. Operator response: Define the missing variants and continue. See also: The Users Guide for details of the how to define variants. EEWO0731E The ABAP program does not exist. Explanation: See message. System action: The program waits for you to correct the data or exit. Operator response: Contact the R/3 system administrator to determine the correct name of the ABAP program. Modify the job definition and continue. See also: The Users Guide for details of the how to define ABAP programs. EEWO0735E ABAP and external program set Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0736E The selection has been cancelled. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0732E The ABAP program has no variants. Explanation: See message. System action: The program waits for you to correct the data or exit. Operator response: Define the missing variants and continue. See also: The Users Guide for details of the how to define variants. EEWO0733E The ABAP program is missing. Explanation: You have tried to define variants but have not yet identified an ABAP program. System action: The program waits for you to correct the data or exit. Operator response: Define the ABAP program associated with the variants you were trying to enter and continue. See also: The Users Guide for details of the how to define ABAP programs. EEWO0734E The ABAP program is not executable Explanation: You have defined an ABAP program that is not an executable file. System action: The program waits for you to correct the data or exit. Operator response: Choose a different ABAP program, change the job definition, and continue. See also: The Users Guide for details of the how to define ABAP programs.

Appendix A. Web console messages

169

EEWO0737E EEWO0747E
EEWO0737E An internal error has occurred. The startrow is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0738E The required interface is not supported by the R/3 system. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0739E The version of the required interface is not supported by the R/3 system. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0740E The user name is missing. Explanation: See message. System action: The program waits for you to correct the data or exit. Operator response: Add the missing user name to the job definitions and continue. EEWO0741E The following user does not have " release " privileges: user_name . Explanation: See message. System action: R3batch stops. Operator response: Determine from the system administrator whether the user can be granted " release " privileges. If not, you should rerun the job as a user that has these privileges. EEWO0742E The following user does not have " abort " privileges: user_name . Explanation: See message. System action: R3batch stops. Operator response: Determine from the system administrator whether the user can be granted " abort " privileges. If not, you should rerun the job as a user that has these privileges. EEWO0743E An internal error has occurred. The selection option is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0744E An internal error has occurred. The select job name is missing. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0745E An internal error has occurred. The select user name is missing. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0746E The following user does not have " delete " privileges: user_name . Explanation: See message. System action: R3batch stops. Operator response: Determine from the system administrator whether the user can be granted " delete " privileges. If not, you should rerun the job as a user that has these privileges. EEWO0747E An internal error has occurred. A running job could not be deleted. The following identify the job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that could not be deleted. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance.

170

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0748E EEWO0758E
EEWO0748E An internal error has occurred. The BP_JOB_COPY function could not copy the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that could not be copied. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0749E An internal error has occurred. The joblog of the job cannot be deleted. The following identify the job: Job name: job_name Job ID: job_ID Explanation: job_name and job_ID identify the job with a joblog that could not be deleted. System action: The program might stop. Operator response: Check R/3 syslog. EEWO0750E An internal error has occurred. An event is missing a parameter. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0751E An internal error has occurred. An event does not exist. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0752E An internal error has occurred. An event could not be raised. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0756E An internal error has occurred. An incorrect action was performed while maintaining the status of interception and parent-child functionality. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0757E An internal error has occurred. An incorrect confirmation type was found while confirming a job. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0758E An internal error has occurred. An incorrect client was found while retrieving intercepted jobs. Explanation: See message. System action: R3batch stops. EEWO0753E An internal error has occurred. The program could not commit the changes in the database tables when calling the following function module: module . Explanation: See message. System action: The program might stop. Operator response: Check R/3 syslog. EEWO0754E An internal error has occurred. The specified date and/or time is invalid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0755E An internal error has occurred. The specified server name is invalid Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance.

Appendix A. Web console messages

171

EEWO0759E EEWO0768E
Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0759E The confirmation of a job has failed. Explanation: See message. System action: The program might stop. Operator response: Check R/3 syslog. EEWO0760E An internal error has occurred. A selection parameter is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0761E Parent-child functionality is not active. Explanation: See message. System action: R3batch stops. Operator response: Activate parent-child functionality as described in the Users Guide . Rerun r3batch . See also: The Users Guide for instructions on how to activate parent-child functionality. EEWO0762E Interception functionality is not active. Explanation: See message. Operator response: Activate interception functionality as described in the Users Guide . Rerun r3batch . See also: The Users Guide for instructions on how to activate interception functionality. EEWO0763E An internal error has occurred. An incorrect counter value was found while retrieving the list of reports. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0764E The specified printer is not recognized by the R/3 system. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem EEWO0766E An internal error has occurred. The job data for the following job could not be read: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job with data that could not be read. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0767E An internal error has occurred. The new data for a job are not valid. The following identify the job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that has new data that is not valid. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0768E The following user does not have " modify " privileges: user_name . Explanation: See message. System action: R3batch stops. Operator response: Determine from the system administrator whether the user can be granted " modify " privileges. If not, you should rerun the job as a user that has these privileges. persists, contact IBM Software Support for assistance. EEWO0765E An internal error occurred during the registration of a child for the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job for which a child process could not be registered. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance.

172

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0769E EEWO0776E
EEWO0769E An internal error occurred while locking a job in the R/3 database table. The following identify the job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that could not be locked. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0770E An internal error occurred while attempting to release the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that could not be released. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0771E The target server for a job is not a valid server. The following identify the job: Job name: job_name Job ID: job_ID . Explanation: The target server indicated in the job definition is not correct. It has either been incorrectly typed or is not valid for the job. job_name and job_ID identify the job that does not have a valid server. System action: The program waits for you to change the job definitions and continue or to exit. Operator response: Contact the SAP system administrator to obtain the correct name of the target server for this job. Change the job definition accordingly and continue. EEWO0772E An internal error has occurred. The start date for a job is not valid. The following identify the job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that has a non-valid start date. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0773E An internal error has occurred. The following job can no longer be modified: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that could not be modified. System action: R3batch stops. Operator response: Retry the operation (the error may be transient). If it persists, contact the SAP system administrator to determine if the status of the indicated job has been changed such that it is no longer modifiable. If not, this is an internal error; contact IBM Software Support for assistance. EEWO0774E An internal error has occurred. A problem has been found with the print or archive mask, or both, while modifying an ABAP step of the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job with an ABAP step that has a problem with the print or archive mask, or both. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0775E An internal error has occurred. The step that needs to be added to a job has the wrong step type. The following identify the job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that has the wrong step type. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0776E An internal error has occurred. The program could not retrieve the print and archive parameters while adding a step to the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job for which print and archive parameters could not be retrieved. System action: R3batch stops.
Appendix A. Web console messages

173

EEWO0777E EEWO0784E
Operator response: Check that all network connections are working and retry the operation (the error may be transient). If the problem persists, this is an internal error; contact IBM Software Support for assistance. EEWO0777E An internal error has occurred. The program could not retrieve information about the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job for which information could not be retrieved. System action: R3batch stops. Operator response: Check that all network connections are working and retry the operation (the error may be transient). If the problem persists, this is an internal error; contact IBM Software Support for assistance. EEWO0778E An internal error has occurred. The program could not modify the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job that could not be modified. System action: R3batch stops. Operator response: Check that all network connections are working and retry the operation (the error may be transient). If the problem persists, this is an internal error; contact IBM Software Support for assistance. EEWO0779E An internal error has occurred. The program could not modify the worktable for the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job for which the worktable could not be modified. System action: R3batch stops. Operator response: Check that all network connections are working and retry the operation (the error may be transient). If the problem persists, this is an internal error; contact IBM Software Support for assistance. EEWO0780E An internal error has occurred. The program could not read the worktable for the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job for which the worktable could not be read. System action: R3batch stops. Operator response: Check that all network connections are working and retry the operation (the error may be transient). If the problem persists, this is an internal error; contact IBM Software Support for assistance. EEWO0781E An internal error has occurred. The program could not modify the step for the following job because no step information has been provided: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job for which the step information is not available. System action: R3batch stops. Operator response: Check that all network connections are working and retry the operation (the error may be transient). If the problem persists, this is an internal error; contact IBM Software Support for assistance. EEWO0782E The program has found an inconsistency in the data concerning the parent-child relationship for the following job: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job for which the parent-child relationship data is not consistent. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0783E An internal error has occurred. The program has found incorrect selection options. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0784E An internal error has occurred. The program has found that the following job does not have an expected step: Job name: job_name Job ID: job_ID . Explanation: job_name and job_ID identify the job for

174

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0785E EEWO0795E
which an expected step is missing. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0785E The variant already exists. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0786E An internal error has occurred. The following user is not authorized to perform the requested action: user_name . Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0787E An internal error has occurred. The report or variant is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0788E An internal error has occurred. The variant name is not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0789E An internal error has occurred. The action has not been performed. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0791E An internal error has occurred. The variant has not been supplied. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0792E An internal error has occurred. The report does not have selection screens. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0793E An internal error has occurred. The report definition could not be loaded. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0794E An internal error has occurred. The variant could not be locked. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0795E An internal error has occurred. The variant could not be deleted. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0790E An internal error has occurred. The variant selections do not match. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance.

Appendix A. Web console messages

175

EEWO0796E EEWO0806E
EEWO0796E An internal error has occurred. The variant variable maintenance parameters are not valid. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0797E An internal error has occurred. The table has no fields. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0798E An internal error has occurred. The table is not active. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0799E An internal error has occurred. The table is locked. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0800E An internal error has occurred. The values for the requested field could not be read. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0801E An internal error has occurred. The function module J_1O1_DATETIME has failed. The expression could not be evaluated. Explanation: See message. System action: R3batch stops. EEWO0803E An internal syntax error has occurred in the expression. Explanation: See message. System action: R3batch waits for you to input data or exit. Operator response: Check the syntax of the date expression in the job definition. If you find an error, correct it and continue. If you do not find an error in the expression, this is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. See also: The Users Guide for details of the syntax of the date expression. EEWO0804E An internal error has occurred. The job last run time feature is not yet supported. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0805E An internal error has occurred. The calendar placeholder feature is not yet supported. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0806E An internal syntax error has occurred: the date expression is not terminated Explanation: See message. System action: R3batch waits for you to input data or exit. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0802E An internal error has occurred. The result buffer for variant placeholders is too small. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance.

176

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0807E EEWO0822E
Operator response: Check the syntax of the date expression in the job definition. If you find an error, correct it and continue. If you do not find an error in the expression, this is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. See also: The Users Guide for details of the syntax of the date expression. EEWO0807E An internal syntax error has occurred: the date expression contains no data. Explanation: See message. System action: R3batch waits for you to input data or exit. Operator response: Check the syntax of the date expression in the job definition. If you find an error, correct it and continue. If you do not find an error in the expression, this is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. See also: The Users Guide for details of the syntax of the date expression. EEWO0808E An internal syntax error has occurred: the arithmetic expression is not terminated. Explanation: See message. System action: R3batch waits for you to input data or exit. Operator response: Check the syntax of the arithmetic expression in the job definition. If you find an error, correct it and continue. If you do not find an error in the expression, this is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. See also: The Users Guide for details of the syntax of the arithmetic expression. EEWO0809E An internal syntax error has occurred: the arithmetic expression contains no data. Explanation: See message. System action: R3batch waits for you to input data or exit. Operator response: Check the syntax of the arithmetic expression in the job definition. If you find an error, correct it and continue. If you do not find an error in the expression, this is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. See also: The Users Guide for details of the syntax of the arithmetic expression. EEWO0810E An internal syntax error has occurred in the arithmetic expression. Explanation: See message. System action: R3batch waits for you to input data or exit. Operator response: Check the syntax of the arithmetic expression in the job definition. If you find an error, correct it and continue. If you do not find an error in the expression, this is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. See also: The Users Guide for details of the syntax of the arithmetic expression. EEWO0811E An internal error has occurred. The internal buffer is too small for the arithmetic expression. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0820E An internal error has occurred. The job of the following InfoPackage has not started: InfoPackage_name. Explanation: InfoPackage_name identifies the InfoPackage associated with this job or step. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0821E An internal error has occurred. No scheduling data can be found for the following InfoPackage: InfoPackage_name. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0822E An internal error has occurred. The job of the following InfoPackage does not exist: InfoPackage_name. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance.
Appendix A. Web console messages

177

EEWO0823E EEWO0909W
EEWO0823E An internal error has occurred. The table does not contain the requested field. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0824E An internal error has occurred. The variant has no description in the requested language. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0825E An internal error has occurred. External command steps are not supported for versions of BC-XBP less than 2.0. Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0826E The extended agent could not delete a record from the interception criteria table on the target R/3 system. Explanation: The extended agent tried to delete an interception criteria record on the R/3 system and the remote operation failed. System action: The operation is not performed, The agent continues. Operator response: Retry the operation. If the problem persists, contact your R/3 system administrator. EEWO0901W The following product could not be registered for SIGTERM handling: " product_name " . SIGTERMs will be ignored. EEWO0902W The program cannot check the status of the job; but will try again later. Explanation: See message. System action: R3batch continues. Operator response: If it is important to know the status of the job, look at the syslog to attempt to identify what is preventing the status from being obtained. For example, there might be a network problem restricting the communication with the job. EEWO0903W The job has been cancelled by the Tivoli Workload Scheduler operator; see the R/3 joblog for details.

Explanation: See message. System action: R3batch continues, but the job has been cancelled. Operator response: Check the R/3 joblog for more details. Check with the Tivoli Workload Scheduler operator the reasons for the job cancellation and decide if this action requires any further action on your part. EEWO0904W The program could not copy the joblog to stdout. Explanation: See message. System action: R3batch continues. The problem with copying the joblog does not impact how the job is performed. Operator response: If you need to consult the joblog, do so on the R/3 system instead of locally. EEWO0908W An internal error has occurred. The program has found the following incorrectly formed BDCWAIT keyword: BDCWAIT_keyword .

Explanation: See message. System action: R3batch continues, but the BDCWAIT is ignored. Operator response: If the BDCWAIT is essential to the successful performance of the job, stop the job. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0909W An internal error has occurred. The following BDCWAIT keyword does not have the correct syntax: BDCWAIT_keyword .

Explanation: See message. System action: R3batch continues but SIGTERMs are ignored. Operator response: If you require SIGTERM handling for the correct processing of this job, stop the job, arrange with the system administrator to allow SIGTERM handling for this product and rerun r3batch .

Explanation: See message. System action: R3batch continues, but the BDCWAIT is ignored.

178

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0910W EEWO0916W
Operator response: If the BDCWAIT is essential to the successful performance of the job, stop the job. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0910W An internal error has occurred. No BDC sessions were found that matched the following session name: " session_name " . The BDCWAIT will be ignored. EEWO0913W The following trace level in the job definition is not valid: " trace_level " . The default value of 3 (DEBUG_MAX) is used instead.

Explanation: The -tracelvl option in the job definition has a non-valid value. System action: R3batch continues, using the default trace level: DEBUG_MAX. Operator response: Correct the value supplied in the job definition for the -tracelvl option to one of the values indicated in the Users Guide. . See also: The Users Guide for details of the -tracelvl option settings in the job definition. EEWO0914W An internal error has occurred. Either the joblog or the job protocol for the following job does not exist: Job name: job_name Job ID: job_ID .

Explanation: See message. System action: R3batch continues, but the BDCWAIT is ignored. Operator response: If the BDCWAIT is essential to the successful performance of the job, stop the job. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0911W An internal error has occurred. No BDC sessions were found that matched the following qid: " qid " . The BDCWAIT will be ignored.

Explanation: job_name and job_ID identify the job for which the job protocol does not exist. System action: R3batch continues, but log information is not available. Operator response: If you need to have log information for the successful running of this job, stop the job and contact the SAP system administrator to determine why the joblog or job protocol does not exist. When the problem has been resolved rerun r3batch . If the problem persists, contact IBM Software Support for assistance. EEWO0915W An internal error has occurred. Either the joblog or the job protocol for the following job is empty: Job name: job_name Job ID: job_ID .

Explanation: See message. System action: R3batch continues, but the BDCWAIT is ignored. Operator response: If the BDCWAIT is essential to the successful performance of the job, stop the job. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0912W An internal error has occurred. The BDC session found previously can no longer be found in the BDC status table. The wait is terminated for the following session: " session_name " and " queue_id " .

Explanation: The program creates an internal table of BDC sessions to maintain the status of each session. A session that had previously been found and loaded into the table can no longer be found. System action: R3batch continues, but the BDCWAIT is ended. Operator response: If the BDCWAIT is essential to the successful performance of the job, stop the job. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance.

Explanation: job_name and job_ID identify the job for which the joblog is empty. System action: R3batch continues, but log information is not available. Operator response: If you need to have log information for the successful running of this job, stop the job and contact the SAP system administrator to determine why the joblog or job protocol is empty. When the problem has been resolved rerun r3batch . If the problem persists, contact IBM Software Support for assistance. EEWO0916W An internal error has occurred. The step has no spool list Explanation: See message.

Appendix A. Web console messages

179

EEWO0917W EEWO0997W
System action: R3batch continues, but log information is not available. Operator response: If you need to have log information for the successful running of this job, stop the job and contact the SAP system administrator to determine why the step has no spool list. When the problem has been resolved rerun r3batch . EEWO0917W An internal error has occurred. The spool ID is not valid Explanation: See message. System action: R3batch continues, but log information is not available. Operator response: If you need to have log information for the successful running of this job, stop the job and contact the SAP system administrator to determine why the spool ID is not valid. When the problem has been resolved rerun r3batch . If the problem persists, contact IBM Software Support for assistance. EEWO0918W The report list selection is finished Explanation: The program is reading the report list from the SAP system. Depending on circumstances, this message may indicate that the process has completed successfully, or that the selection has terminated unexpectedly, with an internal error. System action: R3batch continues. Operator response: Check that the reports received from the SAP system are what you are expecting. If they are not, rerun r3batch (the problem may be transient). If the problem persists, contact IBM Software Support for assistance. EEWO0919W There are no background processing resources active in the R/3 system. Explanation: See message. System action: R3batch continues, but the job cannot be run. Operator response: Contact the R/3 system administrator to activate background processing resources in the R/3 system. EEWO0920W An internal error has occurred. The spoollist of the following job cannot be read: Job name: job_name Job ID: job_ID . Operator response: If you need to have log information for the successful running of this job, stop the job and contact the SAP system administrator to determine why the spool list cannot be read. When the problem has been resolved rerun r3batch . EEWO0921W An internal error has occurred. The program requires the " -flag type=exec " parameter to be specified for dynamic job creation.

Explanation: This is an internal error caused by one module of r3batch not supplying the indicated parameter when calling another module. System action: R3batch continues but the job is not created. Operator response: Contact IBM Software Support for assistance. EEWO0930W The following language is not valid: " language " . The following default language is used: " default_language " .

Explanation: See message. System action: R3batch continues. Operator response: If you do not want the job to continue in the indicated default language, stop the job. To correct the language selection, edit the job options and change the twsxa_lang or twsmeth_lang parameter values to a valid value as described in the Users Guide . Then rerun r3batch . See also: The Users Guide for more information about the language options. EEWO0950W The RFC user is already logged on Explanation: See message. System action: R3batch continues. Operator response: You might choose to warn the SAP system administrator that a job for this RFC user has been submitted, but that this user is already logged on. EEWO0997W An internal error occurred while trying to obtain the semaphore. The following RFC function module will not be synchronized: function_module .

Explanation: The semaphore allows the RFC function modules to synchronize their use of system resources. Without the semaphore, a module might time-out, waiting for a resource to become available. function_module is the RFC function module that cannot obtain a semaphore. System action: R3batch continues.

Explanation: job_name and job_ID identify the job for which the spoollist could not be read. System action: R3batch continues, but log information is not available.

180

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

EEWO0998W EEWO1034E
Operator response: If the use of the semaphore is important for the job being run, stop the job. Retry the operation (the error may be transient). If the problem persists, check in the log and with the SAP system administrator to try and determine why the semaphore could not be obtained. If this is not possible to determine, there is an internal error; contact IBM Software Support for assistance. EEWO0998W An internal error occurred while trying to open the semaphore. The following RFC function module will not be synchronized: function_module .

Explanation: The semaphore allows the RFC function modules to synchronize their use of system resources. Without the semaphore, a module might time-out, waiting for a resource to become available. function_module is the RFC function module that cannot open its semaphore. System action: R3batch continues. Operator response: If the use of the semaphore is important for the job being run, stop the job. Retry the operation (the error may be transient). If the problem persists, check in the log and with the SAP system administrator to try and determine why the semaphore could not be obtained. If this is not possible to determine, there is an internal error; contact IBM Software Support for assistance. EEWO1005W An error occurred while retrieving the spool list for a step: Explanation: See message. System action: R3batch continues, but return code mapping of this job cannot be performed. Operator response: If return code mapping is crucial to the job, stop it, and contact the SAP system administrator to determine why the spool list could not be retrieved. When the problem has been resolved rerun r3batch . EEWO1034E An internal error has occurred. Conman could not be run to submit the intercepted SAP job: Explanation: See message. System action: R3batch stops. Operator response: This is an internal error. Retry the operation (the error may be transient). If the problem persists, contact IBM Software Support for assistance.

Appendix A. Web console messages

181

List of Web console messages

182

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Appendix B. Accessibility
Accessibility features help users with physical disabilities, such as restricted mobility or limited vision, to use software products successfully. The major accessibility features in this product enable users to do the following: v Use assistive technologies, such as screen-reader software and digital speech synthesizer, to hear what is displayed on the screen. Consult the product documentation of the assistive technology for details on using those technologies with this product. v Operate specific or equivalent features using only the keyboard. v Magnify what is displayed on the screen. In addition, the product documentation was modified to include features to aid accessibility: v All documentation is available in both HTML and convertible PDF formats to give the maximum opportunity for users to apply screen-reader software. v All images in the documentation are provided with alternative text so that users with vision impairments can understand the contents of the images.

Navigating the interface using the keyboard

Standard shortcut and accelerator keys are used by the product and are documented by the operating system. Refer to the documentation provided by your operating system for more information. The Event Rule Editor panel is the only one that does not allow keyboard-only operations and CSS cannot be disabled. However, as an alternative, you can perform all the operations available in this panel by launching the composer command from the command line interface. You can find more details about this command in the Tivoli Workload Scheduler Reference Guide.

Magnifying what is displayed on the screen

You can enlarge information on the product windows using facilities provided by the operating systems on which the product is run. For example, in a Microsoft Windows environment, you can lower the resolution of the screen to enlarge the font sizes of the text on the screen. Refer to the documentation provided by your operating system for more information.

Copyright IBM Corp. 2007

183

184

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Appendix C. Support information

If you have a problem with your IBM software, you want to resolve it quickly. This section describes the following options for obtaining support for IBM software products: v Using IBM Support Assistant v v v v Searching knowledge bases on page 186 Obtaining fixes on page 187 Receiving weekly support updates on page 187 Contacting IBM Software Support on page 189

Using IBM Support Assistant

The IBM Support Assistant is a free, stand-alone application that you can install on any workstation. You can then enhance the application by installing product-specific plug-in modules for the IBM products you use. The IBM Support Assistant saves you time searching product, support, and educational resources. The IBM Support Assistant helps you gather support information when you need to open a problem management record (PMR), which you can then use to track the problem. The product-specific plug-in modules provide you with the following resources: v Support links v Education links v Ability to submit problem management reports The IBM Support Assistant Web site is at http://www.ibm.com/software/support/ isa/. Use this site for the following: v Obtain general information about the IBM Support Assistant v Download and install the IBM Support Assistant application. Full instructions are provided. v Determine if a plug-in is available for a specific product (or go direct to the plug-ins page at http://www.ibm.com/software/support/isa/plugins.html) To locate and download the plug-in for a product, use the IBM Support Assistant's interface. Full instructions on how to use the application and plugin are provided within the interface. For example, on version 3.0.1 of the IBM Support Assistant, click Updater, click New products and tools, expand Tivoli, select the plug-in, and click Install. If you cannot find the solution to your problem in the IBM Support Assistant, see Searching knowledge bases on page 186.

Tivoli Workload Scheduler IBM Support Assistant plug-in version and upgrade issues
The IBM Tivoli Workload Scheduler plug-in for the IBM Support Assistant has not changed since version 8.3. If you have already installed it in the IBM Support Assistant you need take no further action. If you are planning to install it for the first time with version 8.4 you should be aware that the plug-in name and many
Copyright IBM Corp. 2007

185

Support information
other references in the plug-in have "8.3" as the product version number. This does not mean that it will not work with version 8.4. The plug-in is fully compatible with version 8.4 and performs in exactly the same way as it does in version 8.3.

Searching knowledge bases

You can search the available knowledge bases to determine whether your problem was already encountered and is already documented.

Searching the local information center

IBM provides extensive documentation that you can install on your local computer or on an intranet server. You can use the search function of this information center to query conceptual information, instructions for completing tasks, and reference information. The information center is included on the separate Quick Start CD available as part of the product bundle. Insert the CD in a CD drive on a Windows computer, and the information centre automatically opens.

Searching the Internet

If you cannot find an answer to your question in the information center, search the Internet for the latest, most complete information that might help you resolve your problem. To search multiple Internet resources for your product, use the Web search topic in your information center. In the navigation frame, click Troubleshooting and support Searching knowledge bases and select Web search. From this topic, you can search a variety of resources, including the following: v IBM technotes v IBM downloads v IBM Redbooks v IBM developerWorks v Forums and newsgroups v Google

Search the IBM support Web site

The IBM software support Web site has many publications available online, one or more of which might provide the information you require: 1. Go to the IBM Software Support Web site (http://www.ibm.com/software/ support). 2. Select Tivoli under the Select a brand and/or product heading. 3. Select IBM Tivoli Workload Scheduler under Select a product 4. Click Go. 5. Under the Primary support resources heading and Learn subheading, choose from the list of different types of product support publications: v Information center v Support Technical Exchange v IBM Tivoli software training v Manuals v Redbooks

186

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Searching knowledge bases

A search for the selected documentation type is performed, and the results displayed. 6. Use the on-screen navigation to look through the displayed list for the document you require, or use the options in the Search within results for section to narrow the search criteria. You can add Additional search terms or select a specific Document type. You can also change the sort order of the to start the search. results (Sort results by). Then click To access some of the publications you need to register (indicated by a key icon beside the publication title). To register, select the publication you want to look at, and when asked to sign in follow the links to register yourself. There is also a FAQ available on the advantages of registering.

Obtaining fixes
A product fix might be available to resolve your problem. To determine what fixes are available for your IBM software product, follow these steps: 1. Go to the IBM Software Support Web site (http://www.ibm.com/software/ support). 2. Select Tivoli under the Select a brand and/or product heading. 3. Select IBM Tivoli Workload Scheduler under Select a product 4. Click Go. 5. Under the Primary support resources heading and Download, subheading, either choose one of the displayed most-popular downloads, or click View all downloads. A search for the downloads is performed, and the results displayed. 6. Use the on-screen navigation to look through the displayed list for the download you require, or use the options in the Search within results for section to narrow the search criteria. You can add Additional search terms, or select a specific Download type, Platform/Operating system, and Versions, and then click to start the search. 7. Click the name of a fix to read the description of the fix and to optionally download the fix. For more information about the types of fixes that are available, see the IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/ handbook.html.

Receiving weekly support updates

To receive weekly e-mail notifications about fixes and other software support news, follow these steps: 1. Go to the IBM Software Support Web site at http://www.ibm.com/software/ support. 2. Click My support under the Personalized support heading in the upper-right corner of the page. 3. If you have already registered for My support, sign in and skip to the next step. If you have not registered, click register now. Complete the registration form using your e-mail address as your IBM ID and click Submit.

Appendix C. Support information

187

Receiving support updates

4. Click Edit profile. 5. In the Products list, select Software. A second list is displayed. 6. In the second list, select a product segment, for example, Systems Management. A third list is displayed. 7. In the third list, select a product sub-segment, for example, Job Scheduling. A list of applicable products is displayed. 8. Select the products for which you want to receive updates, for example, IBM Tivoli Workload Scheduler and IBM Tivoli Management Framework. 9. Click Add products. 10. After selecting all products that are of interest to you, click Subscribe to email on the Edit profile page. 11. In the Documents list, select Software. 12. Select Please send these documents by weekly email from the list. 13. Update your e-mail address as needed. 14. Select the types of documents that you want to receive information about. 15. Click Update. If you experience problems with the My support feature, you can obtain help in one of the following ways: Online Send an e-mail message to [email protected], describing your problem. By phone Call 1-800-IBM-4You (1-800-426-4968).

188

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Receiving support updates

Contacting IBM Software Support

IBM Software Support provides assistance with product defects. Before contacting IBM Software Support, your company must have an active IBM software maintenance contract, and you must be authorized to submit problems to IBM. The type of software maintenance contract that you need depends on the type of product you have: v For IBM distributed software products (including, but not limited to, Tivoli, Lotus, and Rational products, as well as DB2 and WebSphere products that run on Windows, or UNIX operating systems), enroll in Passport Advantage in one of the following ways: Online Go to the Passport Advantage Web site at http://www.lotus.com/ services/passport.nsf/ WebDocs/Passport_Advantage_Home and click How to Enroll. By phone For the phone number to call in your country, go to the IBM Software Support Web site at http://techsupport.services.ibm.com/guides/ contacts.html and click the name of your geographic region. v For customers with Subscription and Support (S & S) contracts, go to the Software Service Request Web site at https://techsupport.services.ibm.com/ssr/ login. v For customers with IBMLink, CATIA, Linux, S/390, iSeries, pSeries, zSeries, and other support agreements, go to the IBM Support Line Web site at http://www.ibm.com/services/us/index.wss/so/its/a1000030/dt006. v For IBM eServer software products (including, but not limited to, DB2 and WebSphere products that run in zSeries, pSeries, and iSeries environments), you can purchase a software maintenance agreement by working directly with an IBM sales representative or an IBM Business Partner. For more information about support for eServer software products, go to the IBM Technical Support Advantage Web site at http://www.ibm.com/servers/eserver/techsupport.html. If you are not sure what type of software maintenance contract you need, call 1-800-IBMSERV (1-800-426-7378) in the United States. From other countries, go to the contacts page of the IBM Software Support Handbook on the Web at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region for phone numbers of people who provide support for your location. To contact IBM Software support, follow these steps: 1. Determining the business impact on page 190 2. Describing problems and gathering information on page 190 3. Submitting problems on page 190

Appendix C. Support information

189

Receiving support updates

Determining the business impact

When you report a problem to IBM, you are asked to supply a severity level. Therefore, you need to understand and assess the business impact of the problem that you are reporting. Use the following criteria: Severity 1 The problem has a critical business impact. You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution. Severity 2 The problem has a significant business impact. The program is usable, but it is severely limited. Severity 3 The problem has some business impact. The program is usable, but less significant features (not critical to operations) are unavailable. Severity 4 The problem has minimal business impact. The problem causes little impact on operations, or a reasonable circumvention to the problem was implemented.

Describing problems and gathering information

When describing a problem to IBM, be as specific as possible. Include all relevant background information so that IBM Software Support specialists can help you solve the problem efficiently. To save time, know the answers to these questions: v What software versions were you running when the problem occurred? v Do you have logs, traces, and messages that are related to the problem symptoms? IBM Software Support is likely to ask for this information. v Can you re-create the problem? If so, what steps were performed to re-create the problem? v Did you make any changes to the system? For example, did you make changes to the hardware, operating system, networking software, and so on. v Are you currently using a workaround for the problem? If so, be prepared to explain the workaround when you report the problem.

Submitting problems
You can submit your problem to IBM Software Support in one of two ways: Online Click Submit and track problems on the IBM Software Support site athttp://www.ibm.com/software/support/probsub.html. Type your information into the appropriate problem submission form. By phone For the phone number to call in your country, go to the contacts page of the IBM Software Support Handbook at http://techsupport.services.ibm.com/ guides/contacts.html and click the name of your geographic region. If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM Software Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Software Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the

190

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Receiving support updates

Software Support Web site daily, so that other users who experience the same problem can benefit from the same resolution.

Appendix C. Support information

191

192

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this publication 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 users 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 publication. The furnishing of this publication does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: 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 states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might 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 Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

Copyright IBM Corp. 2007

193

IBM may use or distribute any of the information you supply 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 Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. 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 publication 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. 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 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 the names and addresses used by an actual business enterprise is entirely coincidental. 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.

For the code entitled BIRT

The BIRT Excluded Components was obtained from the Eclipse Foundation: BIRT 2.1.2 (herein collectively referred to as Eclipse Code). Notices and important information, including instructions for obtaining source code, for the Eclipse Code may be found in associated about.html files (About Files) that accompany the Eclipse Code. These About Files are provided for informational purposes only, and notwithstanding anything to the contrary therein, your use of such Eclipse Code shall be governed by the terms of the IBM end user license agreement.

For the code entitled Commons-IO 1.3

Apache Jakarta Commons IO Copyright 2001-2007 The Apache Software Foundation

194

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

This product includes software developed by The Apache Software Foundation (http://www.apache.org/). The license governing this software is: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions License shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. Licensor shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, control means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. You (or Your) shall mean an individual or Legal Entity exercising permissions granted by this License. Source form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. Object form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. Work shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). Derivative Works shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. Contribution shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, submitted means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as Not a Contribution. Contributor shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
Notices

195

2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: a. You must give any other recipients of the Work or Derivative Works a copy of this License; and b. You must cause any modified files to carry prominent notices stating that You changed the files; and c. You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and d. If the Work includes a NOTICE text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.

196

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an AS IS BASIS WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets [] replaced with your own identifying information. (Dont include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same printed page as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the License); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Notices

197

For the code entitled Commons File Upload 1.1.1

This product includes software developed by The Apache Software Foundation (http://www.apache.org/). The license governing this software is: (the same as the one reported above for Commons-IO 1.3) Apache License Version 2.0, January 2004 http://www.apache.org/licenses/

For the code entitled Dojo 0.4.2

The Program includes Dojo 0.4.2 software and is obtained under the following New BSD license: Copyright (c) 2005-2006, The Dojo Foundation All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: v Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. v Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. v Neither the name of the Dojo Foundation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

For INSTALLSHIELD MULTI-PLATFORM 11.5 Code

The IBM license agreement and any applicable notices on the web download page for this product refers You to this file for details concerning terms and conditions applicable to software code identified as excluded components in the License Information document and included in InstallShield Multi-Platform 11.5 (the Program).

198

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively IBM), the third party software code identified below are Excluded Components and are subject to the terms and conditions of the License Information document accompanying the Program and not the license terms that may be contained in the notices below. The notices are provided for informational purposes. The Program includes the following Excluded Components: v Apache Ant V1.5.4 v v v v v v v Jakarta ORO V2.0.8 Quick V1.0.1 Xalan V2.5.2 HSQLDB V1.7.1 JTOPEN V4.4 BrowserLauncher V1.4b1 InfoZip Unzip stub file V5.40, V5.41, V5.42

APACHE CODE
The Program includes all or portions of the following software developed by the Apache Software Foundation. This software consists of voluntary contributions made by many individuals on behalf of the Apache Software Foundation. For more information on the Apache Software Foundation, please see http:// www.apache.org. The following is the list of Excluded Components governed under V1.1 of the Apache license: v Xalan V2.5.2 v Apache Ant V1.5.4 v Jakarta ORO V2.0.8 IBM is required to provide you, as the recipient of such software, with a copy of the following license from the Apache Software Foundation: The Apache Software License, Version 1.1 Copyright (c) 2000 The Apache Software Foundation. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. The end-user documentation included with the redistribution, if any, must include the following acknowledgment: This product includes software developed by the Apache Software Foundation (http://www.apache.org/). Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear. 4. The names Apache and Apache Software Foundation must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact [email protected].

Notices

199

5.

Products derived from this software may not be called Apache, nor may Apache appear in their name, without prior written permission of the Apache Software Foundation.

THIS SOFTWARE IS PROVIDED ``AS IS AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This software consists of voluntary contributions made by many individuals on behalf of the Apache Software Foundation. For more information on the Apache Software Foundation, please see: <http://www.apache.org/>. Portions of this software are based upon public domain software originally written at the National Center for Supercomputing Applications, University of Illinois, Urbana-Champaign. END OF APACHE NOTICES AND INFORMATION

JXML CODE
The Program is accompanied by the following JXML software: Quick V1.0.1 IBM is required to provide you, as the recipient of such software, with a copy of the following license from JXML: Copyright (c) 1998, 1999, JXML, Inc. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. All product materials mentioning features or use of this software must display the following acknowledgement: This product includes software developed by JXML, Inc. and its contributors: http://www.jxml.com/mdsax/contributers.html

200

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Neither name of JXML nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY JXML, INC. AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JXML OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. END OF JXML NOTICES AND INFORMATION

InfoZip CODE
The Program is accompanied by the following InfoZip software: One or more of: InfoZip Unzipsfx stub file V5.40, V5.41, V5.42 IBM is required to provide you, as the recipient of such software, with a copy of the following license from InfoZip: This is version 2000-Apr-09 of the Info-ZIP copyright and license. The definitive version of this document should be available at ftp://ftp.info-zip.org/pub/infozip/license.html indefinitely. Copyright (c) 1990-2000 Info-ZIP. All rights reserved. For the purposes of this copyright and license, Info-ZIP is defined as the following set of individuals: Mark Adler, John Bush, Karl Davis, Harald Denker, Jean-Michel Dubois, Jean-loup Gailly, Hunter Goatley, Ian Gorman, Chris Herborth, Dirk Haase, Greg Hartwig, Robert Heath, Jonathan Hudson, Paul Kienitz, David Kirschbaum, Johnny Lee, Onno van der Linden, Igor Mandrichenko, Steve P. Miller, Sergio Monesi, Keith Owens, George Petrov, Greg Roelofs, Kai Uwe Rommel, Steve Salisbury, Dave Smith, Christian Spieler, Antoine Verheijen, Paul von Behren, Rich Wales, Mike White This software is provided as is, without warranty of any kind, express or implied. In no event shall Info-ZIP or its contributors be held liable for any direct, indirect, incidental, special or consequential damages arising out of the use of or inability to use this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

Notices

201

1. Redistributions of source code must retain the above copyright notice, definition, disclaimer, and this list of conditions. 2. Redistributions in binary form must reproduce the above copyright notice, definition, disclaimer, and this list of conditions in documentation and/or other materials provided with the distribution. 3. Altered versions--including, but not limited to, ports to new operating systems, existing ports with new graphical interfaces, and dynamic, shared, or static library versions--must be plainly marked as such and must not be misrepresented as being the original source. Such altered versions also must not be misrepresented as being Info-ZIP releases--including, but not limited to, labeling of the altered versions with the names Info-ZIP (or any variation thereof, including, but not limited to, different capitalizations), Pocket UnZip, WiZ or MacZip without the explicit permission of Info-ZIP. Such altered versions are further prohibited from misrepresentative use of the Zip-Bugs or Info-ZIP e-mail addresses or of the Info-ZIP URL(s). 4. Info-ZIP retains the right to use the names Info-ZIP, Zip, UnZip, WiZ, Pocket UnZip, Pocket Zip, and MacZip for its own source and binary releases. END OF INFOZIP NOTICES AND INFORMATION

HSQL CODE
The Program is accompanied by the following HSQL Development Group software: HSQLDB V1.7.1 IBM is required to provide you, as the recipient of such software, with a copy of the following license from the HSQL Development Group: Copyright (c) 2001-2002, The HSQL Development Group All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of the HSQL Development Group nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL HSQL DEVELOPMENT GROUP, HSQLDB.ORG, OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING

202

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. END OF HSQL NOTICES AND INFORMATION

BROWSERLAUNCHER CODE
The Program is accompanied by the following BrowserLauncher software: BrowserLauncher V1.4b1 IBM is required to provide you, as the recipient of such software, with a copy of the following license from BrowserLauncher: This code is Copyright 1999-2001 by Eric Albert ([email protected]) and may be redistributed or modified in any form without restrictions as long as the portion of this comment from this paragraph through the end of the comment is not removed. The author requests that he be notified of any application, applet, or other binary that makes use of this code, but thats more out of curiosity than anything and is not required. This software includes no warranty. The author is not repsonsible for any loss of data or functionality or any adverse or unexpected effects of using this software. Credits: Steven Spencer, JavaWorld magazine (http://www.javaworld.com/javaworld/javatips/jw-javatip66.html) Thanks also to Ron B. Yeh, Eric Shapiro, Ben Engber, Paul Teitlebaum, Andrea Cantatore, Larry Barowski, Trevor Bedzek, Frank Miedrich, and Ron Rabakukk @author Eric Albert ([email protected]) @version 1.4b1 (Released June 20, 2001) END OF BROWSERLAUNCHER NOTICES AND INFORMATION

JTOPEN CODE
The Program is accompanied by the following JTOPEN software: JTOPEN V4.4 The source code for JTOPEN is available on the Web from: http://www-03.ibm.com/servers/eserver/iseries/toolbox/downloads.htm END OF JTOPEN NOTICES AND INFORMATION END OF INSTALLSHIELD MULTI-PLATFORM NOTICES AND INFORMATION
Notices

203

For the code entitled embedded version of IBM WebSphere Application Server (embedded WebSphere Application Server) V6.1
NOTICES AND INFORMATION FOR EXCLUDED COMPONENTS The IBM license agreement and any applicable information on the web download page for IBM products refers You to this file for details concerning notices applicable to software code identified as Excluded Components in the License Information document and included in the IBM WEBSPHERE APPLICATION SERVER product listed above (the Program). Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively IBM), the third party software code identified below are Excluded Components and are subject to the terms and conditions of the License Information document accompanying the Program and not the license terms that may be contained in the notices below. The notices are provided for informational purposes. Please note: This Notices file may identify information or Excluded Components listed in the agreements for the Program that are not used by, or that were not shipped with, the Program as you installed it. The Program includes the following Excluded Components: v Apache Ant v. 1.6.5 v Apache Commons-Discovery v. 0.2 v Apache Commons-Logging v. 1.0.3 v Apache Derby v. 10.1 v Apache Jakarta JSP Standard Tag Library (JSTL) Code v. 1.1 v Apache Jakarta Struts 1.1 * Apache Soap v. 2.3.1 v Apache Web Services Invocation Framework Code (WSIF) v. 2.0 v Cup Parser Generator for Java 1.0 v EMF 2.1.1 v International Components for Unicode (ICU) ICU4J version 3.4 v JYTHON 2.1.3 v OSGi Materials v XML4C v 5.5.0 v XML SCHEMAS

APACHE CODE
The Program includes all or portions of the following software which is subject to the Apache License Version 2.0, January 2004. This software may also consist of voluntary contributions made by many individuals to the Apache Software Foundation. For more information on the Apache Software Foundation, please see http://www.apache.org: v Apache Ant 1.6.5 v Apache Commons-Discovery v. 0.2 v Apache Commons-Logging v. 1.0.3 v Apache Derby v. 10.1 v Apache Jakarta JSP Standard Tag Library (JSTL) Code v. 1.1

204

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

v Apache Jakarta Struts v.1.1 v Apache Soap v. 2.3.1 v Apache Web Services Invocation Framework Code (WSIF) v. 2.0 IBM is required to provide you, as the recipient of such software, with a copy of the following license notice from the Apache Software Foundation: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions License shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. Licensor shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. Legal Entity shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, control means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. You (or Your) shall mean an individual or Legal Entity exercising permissions granted by this License. Source form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. Object form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. Work shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). Derivative Works shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. Contribution shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, submitted means any form of electronic, verbal, or written
Notices

205

communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as Not a Contribution. Contributor shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: a. You must give any other recipients of the Work or Derivative Works a copy of this License; and b. You must cause any modified files to carry prominent notices stating that You changed the files; and c. You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and d. If the Work includes a NOTICE text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative

206

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF APACHE NOTICES AND INFORMATION

CUP PARSER GENERATOR FOR JAVA

The Program includes CUP Parser Generator (JCUP) version 1.0 software which is Copyright 1996-1999 by Scott Hudson, Frank Flannery and C. Scott Ananian. All rights reserved. IBM obtained the JCUP Software under the terms and conditions of the following license: CUP Parser Generator Copyright Notice, License, and Disclaimer Copyright 1996-1999 by Scott Hudson, Frank Flannery, C. Scott Ananian
Notices

207

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both the copyright notice and this permission notice and warranty disclaimer appear in supporting documentation, and that the names of the authors or their employers not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. The authors and their employers disclaim all warranties with regard to this software, including all implied warranties of merchantability and fitness. In no event shall the authors or their employers be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software. END OF CUP PARSER GENERATOR FOR JAVA NOTICES AND INFORMATION

EPL CODE
The Program includes all or portions of the following software which IBM obtained under the terms and conditions of the Common Public License (CPL Code) or the Eclipse Public License (EPL Code). Eclipse EMF 2.1.2, and OSGI Materials You may download the source version of this component at: http://www.eclipse.org/ END OF EPL CODE NOTICES AND INFORMATION

JYTHON
The Program includes Jython 2.1.3 software which is Copyright (c) 2000, Jython Developers. All rights reserved. IBM did not modify the Jython software and obtained it under the terms and conditions of the following license: Copyright (c) 2000, Jython Developers All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: v - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. v Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. v Neither the name of the Jython Developers nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,

208

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. END OF JYTHON NOTICES AND INFORMATION

XML SCHEMAS
The Program includes XML SCHEMAS which were obtained by IBM under the following terms and conditions: W3C(R) SOFTWARE NOTICE AND LICENSE 1. 1. Copyright (C) 1994-2001 World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved. http://www.w3.org/ Consortium/Legal / 2. http://www.w3.org/Consortium/Legal/2002/copyright-software- 20021231 3. Copyright (C) 1994-2002 World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved. http://www.w3.org/ Consortium/Legal/ This W3C work (and included software, documentation such as READMEs, or other related items) is being provided by the copyright holders under the following license. By obtaining, using and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions: Permission to use, copy, modify, and distribute this software and its documentation, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the software and documentation or portions thereof, including modifications, that you make: 1. 1. The full text of this NOTICE in a location viewable to users of the redistributed or derivative work. 2. Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the W3C Software Short Notice should be included (hypertext is preferred, text is permitted) within the body of any redistributed or derivative code: Copyright (C) [$date-of-software] World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved. http://www.w3.org/Consortium/Legal/ 3. Notice of any changes or modifications to the W3C files, including the date changes were made. (We recommend you provide URIs to the location from which the code is derived.) THIS SOFTWARE AND DOCUMENTATION IS PROVIDED AS IS, AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER
Notices

209

RIGHTS. COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION. The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the software without specific, written prior permission. Title to copyright in this software and any associated documentation will at all times remain with copyright holders. END OF XML SCHEMA NOTICES

International Components for Unicode (ICU)

The program includes ICU4J version 3.4 The following terms and conditions apply to ICU code : Copyright (c) 1995-2003 International Business Machines Corporation and others All rights reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the Software), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, provided that the above copyright notice(s) and this permission notice appear in all copies of the Software and that both the above copyright notice(s) and this permission notice appear in supporting documentation. THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder. All trademarks and registered trademarks mentioned herein are the property of their respective owners END OF ICU NOTICES

OAISIS XML SCHEMAS

The Program includes XML SCHEMAS which were obtained by IBM under the following terms and conditions: Copyright (C) OASIS Open (2004-2005). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or

210

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to OASIS, except as needed for the purpose of developing OASIS specifications, in which case the procedures for copyrights defined in the OASIS Intellectual Property Rights document must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors or assigns. This document and the information contained herein is provided on an AS IS basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. END OF OASIS XML SCHEMA NOTICES END OF EMBEDDED WEBSPHERE APPLICATION SERVER NOTICES AND INFORMATION

Trademarks
AIX, AIX 5L, BookManager, DB2 Universal Database, developerWorks, eServer, IBM, the IBM logo, IBMLink, iSeries, LoadLeveler, Lotus, NetView, Passport Advantage, POWER, pSeries, RACF, Rational, Redbooks, s/390, System i, System z, Tivoli, the Tivoli logo, Tivoli Enterprise Console, WebSphere, z/OS, z9, and zSeries are trademarks of International Business Machines Corporation in the United States, other countries, or both.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries or both.

Adobe, the Adobe logoare either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries. Intel, Intel logo, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others.

Notices

211

212

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Glossary A
access method. An executable file used by extended agents to connect to and control jobs on other operating systems (for example, z/OS) and applications (for example, Oracle Applications, PeopleSoft, and SAP R/3). The access method is specified in the workstation definition for the extended agent. This term applies only to Tivoli Workload Scheduler distributed environment. See also "extended agent". actual start time. The time that a job or job stream, planned to run during current production, actually starts. See also: v "earliest start time" v latest start time v "planned start time" v "scheduled time" ad hoc job. A job used to run a command or a script file that is inserted into the current production plan. These jobs are not saved in the Tivoli Workload Scheduler database. See also: v "database" v "plan" ad hoc prompt dependency. A prompt dependency that is defined within the properties of a job or job stream and is unique to that job or job stream. This term applies only to Tivoli Workload Scheduler distributed environment. See also "prompt dependency". availability. The degree to which a system or resource is ready when needed to process data. responsibilities of its domain manager. This term applies only to Tivoli Workload Scheduler distributed environments. See also: v "fault-tolerant agent" v "full status" v "domain manager" backup master domain manager. An agent in a distributed Tivoli Workload Scheduler network that can assume the responsibilities of the master domain manager. It is installed as a full status, fault-tolerant agent. See also: v "fault-tolerant agent" v "full status" v "master domain manager"

C
calendar. A list of scheduling dates used either to identify the dates when job streams or jobs can be run (when used with inclusive run cycles), or when they cannot be run (when used with exclusive run cycles). carry forward. A property of a job stream that, if not completed before the end of the current production period, is carried forward to the next and then to subsequent periods, until the latest start time is reached or the job stream completes. See also "latest start time". computer workstation. In the Tivoli Workload Scheduler for z/OS, either: v A workstation that performs z/OS processing of jobs and started-task jobs, and that usually reports status to Tivoli Dynamic Workload Console for z/OS automatically. v A processor used as a workstation. It can refer to single processors or multiprocessor complexes serving a single job queue, for example JES2 or JES3 systems. connector. An installed component that provides the interface between the Tivoli Dynamic Workload Console and the engine. Controller. See "workstation". cpu time. The processor time used by a job when running. See also "duration". current plan. In the Tivoli Workload Scheduler for z/OS the detail plan of activity that covers a period of at least 1 minute, and not more than 21 days. A current plan typically covers 1 or 2 days. The current plan for

B
batchman. A process running on Tivoli Workload Scheduler workstations. This process accesses the copy of the Symphony file distributed to workstations at the beginning of the production period and updates it, resolving dependencies. It is the only process that can update the Symphony file. This term applies only to Tivoli Workload Scheduler distributed environments. See also: v "processes" v "production period" v "symphony file" backup domain manager. A full status fault-tolerant agent in a distributed network that can assume the

Copyright IBM Corp. 2007

213

database external dependency

Tivoli Workload Scheduler for z/OS is the equivalent of the production plan for Tivoli Workload Scheduler distributed environments. domain manager. An installed component in a Tivoli Workload Scheduler distributed network that is the management hub in a domain. All communication to and from the agents in the domain is routed through the domain manager. This term applies only to Tivoli Workload Scheduler distributed environments. See also "workstation" duration. The elapsed time that a job is expected to take to complete (estimated duration) and actually takes (actual duration). See also: v "cpu time" v "time restriction"

D
database. In Tivoli Workload Scheduler for distributed environments it consists of a set of tables defined in relational database, such as DB2 or Oracle, containing the definitions for all scheduling objects (jobs, job streams, resources, workstations, domains, parameters, prompts and files), job and job stream statistics, user data, and the last time an object was modified. In the Tivoli Workload Scheduler for z/OS it consists of collection of the following data: calendar, period, workstation description, JCL variable table, application description, and operation instruction. deadline. The time by which a job or job stream is set to complete. When a job or job stream passes the deadline, notifications are sent to users and integrated applications, but the job or job stream is not prevented from running if all time restrictions and dependencies are satisfied. Jobs or job streams that have not yet started or that are still running after the deadline time has expired are considered late in the plan. See also "plan". dependency. A prerequisite that must be satisfied before a job or job stream can start or continue to run. See also: v "external dependency" v "file dependency" v "follows dependency" v "prompt dependency" v "resource dependency" distributed network. A connected group of workstations defined using Tivoli Workload Scheduler for distributed environments. See also: v "engine" v "workstation" distributed workstation. A workstation in the Tivoli Workload Scheduler distributed environment on which jobs and job streams are run. See also: v "engine" v "workstation" domain. A named group of workstations in a Tivoli Workload Scheduler distributed network, consisting of one or more agents and a domain manager acting as the management hub. All domains have a parent domain except for the master domain. This term applies only to Tivoli Workload Scheduler distributed environments. See also: v "domain manager" v master domain manager"

E
earliest start time. The time before which a job or job stream cannot start. The job or job stream can start after the earliest start time provided that all other time restrictions and dependencies are satisfied. See also: v actual start time v latest start time v planned start time v "scheduled time" end-to-end network. A network obtained by connecting one or more Tivoli Workload Scheduler fault-tolerant agents in a distributed network to a Tivoli Workload Scheduler for z/OS node in a z/OS network using TCP/IP, to perform workload scheduling. In this configuration, the Tivoli Workload Scheduler for z/OS node becomes the master domain manager of the fault-tolerant agents to schedule and manage jobs in the distributed network. See also: v "engine" v "workstation" engine. The core software for the scheduling environment. The engine can be either a z/OS engine (installed as part of the product "Tivoli Workload Scheduler for z/OS") or a distributed engine (installed as part of the product "Tivoli Workload Scheduler"). extended agent. An agent used to integrate Tivoli Workload Scheduler job control features with other operating systems (for example, z/OS) and applications (for example, Oracle Applications, PeopleSoft, and SAP R/3). Extended agents must be hosted by a master domain manager, domain manager, or an agent (not another extended agent), and use access methods to communicate with external systems. This term applies only to Tivoli Workload Scheduler distributed environments. See also "access method. external dependency. A dependency defined in one job or job stream that refers to another job stream or to a job in another job stream.

214

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

external job jobman

external job. A job referred to in an external dependency. See also "external dependency.

H
host. A workstation required by extended agents. It can be any Tivoli Workload Scheduler workstation except another extended agent. This term applies only to Tivoli Workload Scheduler distributed environments.

F
fault-tolerant agent. A installed agent component in a distributed Tivoli Workload Scheduler network capable of resolving local dependencies and launching its jobs in the absence of a domain manager. This term applies only to Tivoli Workload Scheduler distributed environments. fence. An attribute on a workstation that regulates whether a job can be run on a workstation. The job fence is a priority level that the priority of a job must exceed before it can run. This term applies only to Tivoli Workload Scheduler distributed environments. file dependency. A dependency where a job or job stream cannot start until it finds a specific file is present in a specific path on a specific workstation. Sometimes called an opens file dependency. This term applies only to Tivoli Workload Scheduler distributed environments. See also "dependency". follows dependency. A dependency where a job or job stream cannot start until other jobs or job streams have completed successfully. See also "dependency". forecast plan. A projection over a selected timeframe based on the job streams and dependencies defined in the database. This term applies only to Tivoli Workload Scheduler distributed environments. See also v "database" v "plan" FTA. See "fault-tolerant agent" full status. An attribute of an agent that enables it to be updated with the status of jobs and job streams running on all other workstations in its domain and in subordinate domains, but not on peer or parent domains. A backup domain manager or master domain manager must be full status. See also: v backup domain manager" v domain" v master domain manager"

I
installation_directory. The installation directory of Tivoli Dynamic Workload Console. By default the product is installed under /opt/IBM/ISC on UNIX operating systems, and on %Program Files%\IBM\ISC on Windows operating systems. internal status. The current status of jobs and job streams in the Tivoli Workload Scheduler engine. The internal status is unique to Tivoli Workload Scheduler. See also "status. internetwork dependencies. A dependency between jobs or job streams in separate Tivoli Workload Scheduler networks. This term applies only to Tivoli Workload Scheduler distributed environments. See also "network agent. internetwork job or job stream. A job or job stream in a remote Tivoli Workload Scheduler network that is referenced by an internetwork dependency defined for a job or job stream in the local network. This term applies only to Tivoli Workload Scheduler distributed environments. See also "network agent.

J
job. A unit of work scheduled for a specific run date in the plan that is processed at a workstation. In Tivoli Workload Scheduler for z/OS, a job is an operation performed at a computer workstation. job limit. See "limit" job status. See status. job stream. A list of jobs that scheduled to run as a unit in the plan (such as a weekly backup application), along with run cycles, times, priorities, and other dependencies that determine the exact order in which the jobs run. jobman. A job management process that controls the launching of jobs under the direction of batchman and reports job status back to mailman. This term applies only to Tivoli Workload Scheduler distributed environments. See also: v batchman" v jobmon" v mailman"

G
general workstation. In the Tivoli Workload Scheduler for z/OS this is a workstation where activities other than printing, and processing are carried out. A general workstation is usually manual, but it can also be automatic. Manual activities can include data entry and job setup.

Glossary

215

jobmon portlet
jobmon. A job management and monitoring process in the Windows version of Tivoli Workload Scheduler. A separate jobmon process is spawned to launch and monitor each job. It reports job status back to jobman. This term applies only to Tivoli Workload Scheduler distributed environments. See also: v jobman" v processes"

N
netman. The network management process that is started first when the Tivoli Workload Scheduler workstations starts up. It processes start, stop, link or unlink commands or requests to run actions impacting the job processing on that workstation. The netman process examines each request received and either implements the request itself or spawns a local Tivoli Workload Scheduler process to do so. This term applies only to Tivoli Workload Scheduler distributed environments. See also "processes". network agent. A logical extended agent used to create dependencies between jobs and job streams on separate Tivoli Workload Scheduler networks. This term applies only to Tivoli Workload Scheduler distributed environments. See also "internetwork dependencies.

L
latest start time. The time before which the job or job stream must start. The job or job stream can start before the latest start time provided that all other dependencies are satisfied. See also: v actual start time v earliest start time v planned start time v "scheduled time" limit. A means of allocating a specific number of job slots into which Tivoli Workload Scheduler is allowed to launch jobs. A job limit can be set for each job stream, and for each workstation. For example, setting the workstation job limit to 25 permits Tivoli Workload Scheduler to have no more than 25 jobs running concurrently on the workstation. list. A means of filtering plan and objects and presenting them in a table. Lists on Tivoli Dynamic Workload Console are the result of running tasks.

O
opens file dependency. See file dependency. open interval. The time interval during which a workstation is active and can process work. owner ID. In Tivoli Workload Scheduler for z/OS, the identifier that represents the job stream owner.

P
parameter. An entity that enables job instance-specific values to be substituted in job and job stream scripts, either from values set in the database or at run time. Parameters cannot be used when scripting extended agent jobs. This term applies only to Tivoli Workload Scheduler distributed environments. plan. The means of scheduling jobs. Objects in the database become instances in the plan. See also: v "database" v "forecast plan" v "trial plan" planned start time. The time that Tivoli Workload Scheduler estimates a job instance will start. This estimate is based on start times of previous instances of the job. See also: v actual start time v earliest start time v latest start time v "scheduled time" portlet. A pluggable user interface components that are managed and displayed in a web portal.

M
mailman. The mail management process running on Tivoli Workload Scheduler workstations. It routes messages about jobs processing status to local and remote workstations. This term applies only to Tivoli Workload Scheduler distributed environments. See also "processes". master domain manager. network. It maintains the database of all scheduling objects in the domain and the central configuration files. The master domain manager generates and distributes the production plan through the network as a program control file named Symphony file. In addition, logs and reports for the network are maintained on the master domain manager. See also: v backup master domain manager v database v domain v plan MDM. See master domain manager".

216

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

predecessor status
predecessor. A job or job stream that must complete successfully before successor jobs or job streams can be started. See also "successor. pre-canned tasks. A set of predefined browse tasks that are made available to each new user. The user can run, share, and customize them to obtain lists of scheduling object to work with. predefined prompt dependency. A prompt dependency that is defined in the database and can be associated to any job or job stream. This term applies only to Tivoli Workload Scheduler distributed environments. See also "prompt dependency. printer workstation. In Tivoli Workload Scheduler for z/OS, a workstation that prints output and usually reports status automatically. priority. A way of determining the order in which jobs and job streams start. Priorities for each job and job stream range from 0 to 101. A job or job stream with a priority of 0 does not run. production period. The time frame covered by the production plan or by the current plan. See also "production plan". production plan. Contains all job scheduling activity planned for a production period. The plan is stored in the Symphony file, and consists of all the jobs, job streams, and dependency objects that are scheduled to run for that period, including any jobs or job streams carried forward from the previous plan. See also: v "carry forward" v "plan" processes. Network processes that control the production environment and network traffic. This term applies only to Tivoli Workload Scheduler distributed environments. See also: v "batchman" v "jobman" v "jobmon" v "mailman" v "netman" prompt dependency. A dependency where an operator must respond affirmatively to a prompt so that the dependent job or job stream can run. This term applies only to Tivoli Workload Scheduler distributed environments. See also: v "ad hoc prompt dependency" v "predefined prompt dependency" resource dependency. A dependency where a job or job stream cannot start until the required quantity of the defined resource is available. See also "resource. restart and cleanup. A recovery function that ensures the restart of a job and the related cleanup actions, for example, deleting temporary files or dataset created in a job run. rule-based run cycle. A run cycle that uses rules based on lists of ordinal numbers, types of days, and common calendar intervals (or period names in Tivoli Workload Scheduler for z/OS). For example, the last Thursday of every month. Rule-based run cycles are based on conventional periods, such as calendar months, weeks of the year, and days of the week. In Tivoli Workload Scheduler for z/OS, run cycles can also be based on periods that you define, such as a semester. This term is only used as such in Tivoli Workload Scheduler for z/OS, but the concept applies also to the distributed product. See also: v "run cycle" run cycle. Specifies the days that a job stream is scheduled to run. The specification can be in the form of a rule or as a combination of period and offset. See also: v "calendar" v "rule-based run cycle"

S
schedule. See job stream. scheduled time. The time when a job or job stream is scheduled to run. See also: v actual start time v earliest start time v latest start time v "planned start time" special resource. In Tivoli Workload Scheduler for z/OS, a resource that is not associated with a particular workstation, such as a data set. standard agent. An installed agent component in a distributed Tivoli Workload Scheduler network that runs jobs, but requires a domain manager to resolve local dependencies and launch the jobs. started task operation. In Tivoli Workload Scheduler for z/OS, an operation that starts or stops started tasks. This operations are run at a computer workstation with the STC option specified. status. The current job or job stream status within the Tivoli Dynamic Workload Console . The Tivoli Dynamic Workload Console status is common to Tivoli Workload Scheduler and Tivoli Workload Scheduler for z/OS. See also "internal status.
Glossary

R
resource. Either physical or logical system resources. Resources are used as dependencies for jobs and job streams. See also "resource dependency.

217

successor z/OS workstation

successor. A job that cannot start until all of the predecessor jobs or job streams on which it is dependent are completed successfully. See also: "predecessor. Symphony file. (batchman) to run the plan. The file is built and loaded when the production plan is created or extended on the master domain manager. During the production phase, this file is continually updated to indicate the current status of production processing: work completed, work in progress, and work to be done. The lists run from the Tivoli Dynamic Workload Console view the contents of the Symphony file (plan) and are performed against it. See also: v batchman" v "plan" v "distributed workstation" v z/OS workstation" workstation resource. In Tivoli Workload Scheduler for z/OS, a physical resource, such as a tape driver, that must be allocated among jobs. When you define a workstation, you can specify the quantity of each of the two resources (R1 and R2) that are available to jobs. When defining jobs to that workstation, you can specify the number of these resources that must be available for the operation to start on that workstation. write-to-operator workstation. In Tivoli Workload Scheduler for z/OS, a general workstation that lets you use scheduling facilities to issue a write-to-operator (WTO) message at a specific operator console defined by the workstation destination. WTO operation. In Tivoli Workload Scheduler for z/OS, jobs that consists of and operator instruction that is passed to IBM Tivoli NetView. These operations are run at a general workstation with the WTO option specified.

T
task. A filter that returns, when run, a list of scheduling objects of the same type whose attributes satisfy the criteria set in the task definition. time restriction. Determines the times before which, after which, or both, that a job or job stream cannot be run. Specifying both defines a time frame within which a job or job stream runs. Jobs can also have a repetition rate. For example, Tivoli Workload Scheduler can launch the same job every 30 minutes between the hours of 8:30 a.m. and 1:30 p.m. tracker. In Tivoli Workload Scheduler for z/OS, a component that runs on every system in your complex. It acts as the communication link between the z/OS system that it runs on and the controller. trial plan. A projection of the current production plan for a different period, using the same start date. It is used to determine the effect of different plan decisions. This term applies only to Tivoli Workload Scheduler distributed environments. See also "plan". TWS_home. In the Tivoli Workload Scheduler environment, the installation path of the Tivoli Workload Scheduler engine. TWS_user. In the Tivoli Workload Scheduler environment, the user who installed the Tivoli Workload Scheduler engine on a system. If referred to when running configuration steps in the Tivoli Workload Scheduler environment, the TWS_user is the user who installed the Tivoli Workload Scheduler master domain manager.

X
x-agent. See extended agent.

Z
z/OS network. A connected group of workstations that use the Tivoli Workload Scheduler z/OS engine to perform workload scheduling. See also: v "engine" v "workstation" z/OS workstation. A representation of system configuration elements in the Tivoli Workload Scheduler for z/OS network. For the z/OS engine, workstations can be: v Computer v General v Printer Tivoli Workload Scheduler for z/OS requires that you define for every workstation: the type of work it does, the quantity of work it can handle at any particular time, and the time it is active. See also "workstation".

W
workstation. A definition of an individual computer or computer partition on which jobs and job streams are run. Types of workstation vary depending on the type of engine. See also:

218

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Index Numerics
5601-453, program number 5601-454, program number 5765-086, program number xiv xiv xiv configuration files (continued) restore 56 connecting to Tivoli Dynamic Workload Broker engine Tivoli Workload Scheduler engine 34 conventions, typeface xv customer support See Software Support

35

A
accessibility xiv Web console 183 accessing Integrated Solutions Console Portal 32 Tivoli Dynamic Workload Console 32 Web console 32 activating runtime tracing 54 tracing 54 advanced installation 19 application servefr creating core dump 60 available functions Tivoli Dynamic Workload Broker 33 Tivoli Workload Scheduler 33

D
default installation 18 directory names, notation xvi

E
education 185 See Tivoli technical training enabling single sign-on 39 Tivoli Dynamic Workload Broker 19, 22, 37 Tivoli Workload Scheduler 19, 22, 37 user registry 39 environment variables, notation xvi error, definition 78 explanation, element 78 explanation, message element 78

B
backup configuration files 55 Web console data 60 backupConfig script 55 BookManager xiv books see publications v

F
fix packs obtaining 187 fixes See fix packs

C
cell WebSphere Application Server 22 changing security properties 58 choosing installation method 14 launchpad installation 14 silent installation 14 wizard installation 14 cleaning up a failed installation 55 component codes 77 component codes, used in message numbers 77 components Embedded Version of the WebSphere Application Server version 6.1.0.9 12 installed 12 Integrated Solutions Console (ISC) 6.1.0.9 bundle 12 Tivoli Dynamic Workload Console module 12 configuration Secure Socket Layers 45 configuration files backup 55 Copyright IBM Corp. 2007

G
glossary See terminology

H
help 78

I
IBM Redbooks 185 IBM support assistant 185 IBM Tivoli Message Standard 77 information centers at IBM support Web site, searching for problem resolution 186 local, searching for problem resolution 186 informational messages, definition 77 informational, definition 77 installation 1 advanced 19 AIX requirements 4

219

installation (continued) CDs 14 components 12 default 18 directory 3 getting started 2 HP-UX Intel Itanium requirements 7 HP-UX PA-RISC requirements 7 images 14 launchpad requirements 8 Linux on Power requirements 5 Linux on System z requirements 6 Linux on zSeries requirements 6 Linux x86 requirements 4 Linux x86-64 requirements 5 log files 53 path 3 prerequisites 3 requirements 3 scenarios 12 setup file 14 silent 23 SUN SPARC requirements 7 SUN x64 requirements 7 Tivoli Workload Scheduler z/OS connector 10 troubleshooting 61 Windows requirements 6 Windows x64 requirements 6 installation message list of available 79 installation messages 79 installing 1 advanced 19 default 18 in silent mode 23 launchpad requirements 8 on embedded WebSphere Application Server 18 on external WebSphere Application Server 21 Tivoli Workload Scheduler z/OS connector 10 using launchpad 16 using response file 23 using wizard 17 integrating with Tivoli Workload Scheduler 31 with Tivoli Workload Scheduler Version 8.3 Fix Pack 3 31 with Tivoli Workload Scheduler z/OS environment 31 interface messages 86 Internet, searching for problem resolution 186

M
manage_ltpa script 41 managing new users 37 roles 37 manuals see publications v message format 77 list of available 79 messages Web console 79

N
node WebSphere Application Server 22 notation environment variables xvi path names xvi typeface xvi numbers codes 77 numeric identifier 77 numeric identifier, messages 77

O
online publications accessing xii operator response, element 78 operator response, message element 78 ordering publications xiv overview 1

P
path names, notation xvi post-installation configuration 31 problem determination describing problems 190 determining business impact 190 submitting problems 190 problem resolution 185 product library v product codes 77 profile WebSphere Application Server 21 program numbers 5601-453 xiv 5601-454 xiv 5765-086 xiv publications v accessing online xii library v online xiv ordering xiv

K
knowledge bases, searching for problem resolution 186

L
LDAP sample configuration 43 using 39 library v log files accessing 53 content 53 location 53 LTPA token_keys sharing 40 Tivoli Workload Scheduler z/OS connector

R
42 R3Batch messages 151 Redbooks, IBM 185

220

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Removing Tivoli Dynamic Workload Console 49 restore configuration files 56 restoreConfig script 56 roles authorizations 38, 39 for Tivoli Dynamic Workload Broker 37 for Tivoli Workload Scheduler 37 runtime browsers supported 8 log files 53 requirements 8 troubleshooting 64 runtime messages for Tivoli Dynamic Workload Broker 79

support Web site, searching to find software problem resolution 186 supported browsers for launchpad 8 configurations 12 hardware 3 runtime browsers 8 software 3 Tivoli Dynamic Workload Broker servers 12 Tivoli Workload Scheduler engine 9 Tivoli Workload Scheduler z/OS engine 9 system action, element 78 system action, message element 78

T
technical training See Tivoli technical training template file security properties 58 terminology accessing Web site xii text 78 Tivoli Dynamic Workload Broker 1 available functions 33 enabling 19, 22, 37 runtime messages 79 Tivoli Dynamic Workload Broker engine connection 35 Tivoli Software Glossary xii Tivoli software information center xii Tivoli technical training xv Tivoli Workload Scheduler 1 available functions 33 enabling 19, 22, 37 Tivoli Workload Scheduler engine connection 34 Tivoli Workload Scheduler for Applications 1 Tivoli Workload Scheduler for z/OS 1 Tivoli Workload Scheduler z/OS connector LTPA token_keys 42 trace files at runtime 54 using 54 training See also Tivoli technical training technical xv troubleshooting runtime scenario for Tivoli Dynamic Workload Broker 64 for Web console 64 troubleshooting scenarios installation 61 runtime 64 typeface conventions xv

S
sample configuration LDAP 43 ssingle sign-on 43 user registry 43 script backupConfig 55 manage_ltpa 41 restoreConfig 56 webui 31 Secure Socket Layers configuration 45 security properties changing 58 showing 57 template file 58 see also, element 79 see also, message element 79 server starting 36 WebSphere Application Server 21 server messages 149 severity 77 severity code, messages 77 sharing LTPA token_keys 40 showing security properties 57 silent installation configuration variables 23 response file 23 sample response file 29 single sign-on enabling 39 sample configuration 43 softcopy books xiv software support 185 Software Support contacting 189 describing problems 190 determining business impact 190 receiving weekly updates 187 submitting problems 190 starting server 36 Web console 36 support 185 support assistant 185

U
uninstalling clean-up 55 manually 55 sample response file 50 silent mode 50 using a response file 50 using wizard 49 z/OS connector 50

Index

221

Uninstalling Web console 49 UpdateInstaller WebSphere Application Server 22 user registry enabling 39 sample configuration 43 using groups 37 LDAP 39 roles 37 user registry 39

V
variables, environment, notation xvi

W
warning, definition 78 Web console accessibility 183 installation messages 79 messages 79 starting 36 Web console data backup 60 WebSphere Application Server APARs 3 cell 22 embedded 3 instances 3 node 22 profile 21 server 21 supported 3 UpdateInstaller 22 versions 3 webui script 31 welcome panel 33

Z
z/OS connector configure 11 install 10 uninstall 50

222

IBM Tivoli Workload Scheduler: Dynamic Workload Console Installation and Troubleshooting Guide

Program Number: 5698-WSH

Printed in USA

SC32-1572-01

Spine information:

IBM Tivoli Workload Scheduler

Version 8.4

Dynamic Workload Console Installation and Troubleshooting Guide