Welcome
IBM Z Workload Scheduler
Welcome to the IBM Z Workload Scheduler documentation, where you can find information about how to install, maintain, and use the product. The documentation has been updated for version 10.2 SPE (Revised July 2025).
Planning and Installation
Planning
Planning your configuration
When planning the configuration for your installation, consider the areas explained in the following topics, which describe the connections between the IBM Z Workload Scheduler systems and provide some examples of basic configurations.
How to connect IBM Z Workload Scheduler systems
IBM Z Workload Scheduler systems can be connected by using any of the following methods.

Product requirements
This section contains links to the IBM® Workload Scheduler Download Documents, System Requirements, and Release Notes.
Product Library in PDF format
This section contains links to the PDF versions of all the publications provided in IBM Documentation for IBM Workload Automation.
Considerations for GDPR readiness
Overview
Mobile Applications Userʼs Guide
Dynamic Workload Console User's Guide
AI Data Advisor (AIDA) User's Guide
Scheduling Job Integrations with IBM Workload Automation
IBM® Workload Scheduler
Welcome to the IBM® Workload Scheduler documentation, where you can find information about how to install, maintain, and use IBM Workload Scheduler. The documentation has been updated for IBM Workload Scheduler Version 10.2.5.
IBM Z Workload Scheduler
Welcome to the IBM Z Workload Scheduler documentation, where you can find information about how to install, maintain, and use the product. The documentation has been updated for version 10.2 SPE (Revised July 2025).
- Memo to Users
- Program Directory
- Dynamic Workload Console Readmes
  For the latest information about a Dynamic Workload Console fix pack, see the appropriate Readme File.
- Planning and Installation
  - About this publication
  - Planning
    - Overview
    - Planning your configuration
      When planning the configuration for your installation, consider the areas explained in the following topics, which describe the connections between the IBM Z Workload Scheduler systems and provide some examples of basic configurations.
      - Trackers
      - Initialization statements
        IBM Z Workload Scheduler initialization statements specified in the parameter library describe, among other things, the configuration of your installation.
      - Communication
      - How to connect IBM Z Workload Scheduler systems
        IBM Z Workload Scheduler systems can be connected by using any of the following methods.
        TCP/IP
        IBM Z Workload Scheduler uses Transmission Control Protocol/Internet Protocol (TCP/IP) to connect a tracker to the controller using a TCP/IP link.
        z/OS cross-system coupling facility
        IBM Z Workload Scheduler uses the z/OS cross-system coupling facility (XCF) to connect IBM Z Workload Scheduler systems using XCF communication links.
        VTAM® (network communication function)
        IBM Z Workload Scheduler uses the network communication function (NCF) to connect a tracker to the Z controller using a VTAM link. The Z controller transmits work to the tracker through NCF, and the same connection is used to pass back event information.
      - Workstation destination
        The various physical and logical locations where tasks are performed at your installation are represented in IBM Z Workload Scheduler by workstations. Each workstation groups related activities. Every operation in the application description database and the current plan is associated with a workstation. You define workstations in the workstation description database.
      - Workload restart
        You can use workload restart (WLR) to restart and reroute work in your IBM Z Workload Scheduler configuration. WLR tracks the status of workstations. It can be invoked when a workstation becomes inactive; that is, when the Z controller cannot communicate with the tracker at the destination that the workstation represents.
      - JES considerations
        The JES type and configuration in your installation has implications on your IBM Z Workload Scheduler configuration.
      - Basic configuration examples
        The examples in this topic shows the configurations using the various connection methods. They are based on a single-image z/OS environment.
      - Basic data store configuration examples
        You need to install a Data Store for each spool tracked by IBM Z Workload Scheduler in the configuration.
      - Configuring a backup controller for disaster recovery
    - Planning your installation
      During the planning stage of your IBM Z Workload Scheduler project, consider carefully how you want to install the scheduler to control your production workload. The installation consists of installing the tracker and Z controller in combinations to suit your processing environment, and connecting them using one or more of the communication methods described in zos/src_inst/eqqi1planyrconfig.html#planyrconfig. Later, you can customize your IBM Z Workload Scheduler systems to include more functions.
  - Installing and migrating IBM Z Workload Scheduler
  - Installing Dynamic Workload Console and Z connector
    How to install, upgrade, configure, and uninstall the Dynamic Workload Console and Z connector, which is automatically installed with a Dynamic Workload Console instance.
  - Deploying with containers
    Docker is a state-of-the-art technology that creates, deploys, and runs applications by using containers. Packages are provided containing an application with all of the components it requires, such as libraries, specific configurations, and other dependencies, and deploy it in no time on any UNIX, Windows, and Linux on Z workstation, regardless of any different settings between the source and the target workstation.
  - Deploying AI Data Advisor
    You can deploy AI Data Advisor (AIDA) by using Docker or Kubernetes.
  - Installing IBM Z Workload Scheduler Agent (z-centric)
    The following topics describe how to install, migrate, and uninstall the IBM Z Workload Scheduler Agent (also known as z-centric agent).
  - Installing IBM Z Workload Scheduler Agent on IBM i systems
  - Integrating Workload Automation with Zowe™
    Zowe™ is an open source project that enables you to interact with z/OS through modern interfaces. You can issue Workload Automation commands through the Zowe command-line interface (CLI), and access Workload Automation REST APIs through the Zowe API Mediation Layer (ML).
  - Sample library (SEQQSAMP)
    The SEQQSAMP library contains samples to help you install, migrate, and customize IBM Z Workload Scheduler.
  - Invoking the EQQEXIT macro
  - Invoking the EQQLSENT macro
- Customization and Tuning
- Managing the Workload
  You can plan when and how your workload runs and manage it as part of a plan.
- Scheduling End-to-end with z-centric Capabilities
- Quick Reference
- Diagnosis Guide and Reference
- Workload Automation Programming Language for z/OS User's Guide and Reference
- Driving IBM Z Workload Scheduler
Messages and Codes
Glossary
Notices

How to connect IBM Z Workload Scheduler systems

IBM Z Workload Scheduler systems can be connected by using any of the following methods.

TCP/IP link
XCF communication links
VTAM® link

The controller uses any of these methods to transmit work to a tracker system. The tracker system uses the same connection to transmit events back to the Z controller.

Distributed agents communicate with the controller by using TCP/IP services.