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.
Workload Automation Programming Language for z/OS User's Guide and Reference
Overview
The Workload Automation Programming Language is a programming language that provides you with easy access to the features of the IBM® Z Workload Scheduler Program Interface (PIF).
IBM® Z Workload Scheduler PIF concepts
The following sections explain the basic concepts of the IBM® Z Workload Scheduler programming interface (PIF) and data structure.

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.3.
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.
- 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
- 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
  - About this publication
  - Overview
    The Workload Automation Programming Language is a programming language that provides you with easy access to the features of the IBM® Z Workload Scheduler Program Interface (PIF).
    - Similarities to the Scheduling Operational Environment
    - Version compatibility
      Workload Automation Programming Language is compatible with all the supported versions of IBM® Z Workload Scheduler.
    - Setting up the Workload Automation Programming Language environment
      If you run a version of SOE or Workload Automation Programming Language JCL that refers to SEQQWAPL members without the EQQ prefix, ensure that you set up the environment by running the EQQWPLCO sample job.
    - Language support
      Command syntax is in English, but output messages might be displayed in other languages in later releases.
    - Command language
      The WAPL command language is a combination of Workload Automation Programming Language core commands, Data Access commands (native PIF requests), Current Plan Operation commands, Function Based commands (extended PIF requests), IBM® Z Workload Scheduler TSO commands, and Batch Loader. The syntax uses the same conventions for all commands, which is easy to learn and to use.
    - Output files
      By default, Workload Automation Programming Language does not generate any output from a LIST or SELECT command. To generate an output, you must specify OUTPUT statements to define the segments and fields to be extract.
    - Batch loader
      Workload Automation Programming Language can extract all IBM® Z Workload Scheduler database objects and Current Plan JCL into a Batch Loader format.
    - IBM® Z Workload Scheduler PIF concepts
      The following sections explain the basic concepts of the IBM® Z Workload Scheduler programming interface (PIF) and data structure.
      - Data sources and structures
        The use of the IBM® Z Workload Scheduler PIF is all about reading and writing data from IBM Z Workload Scheduler.
      - IBM® Z Workload Scheduler PIF requests
  - Running Workload Automation Programming Language
    You can run Workload Automation Programming Language as a batch job by using the compiled REXX exec, as a load module, online within a TSO session, as a started task workstation, or as a console command. A user program must run as an authorized program.
  - Core programming commands
    The following sections describe the Workload Automation Programming Language commands that control the behavior and logic of the program. Use the commands to set options, return codes, determine an output, modify the flow, change variables, or make decisions.
  - Workload Automation Programming Language functions
    Some commands in Workload Automation Programming Language operate in REXX mode. These commands are CONSOLE, DISPLAY, DO, IF, LOG, SETVAR when the equal sign (=) is used, and WRITE.
  - Data Access commands based on PIF
    The Data Access commands supported by Workload Automation Programming Language are low level commands based on the IBM Z Workload Scheduler programming interface (PIF).
  - Current Plan Operation commands
    Use the Current Plan Operation commands to perform specific functions against operations in the current plan, using a common set of keywords to identify the operation you want.
  - Current Plan Occurrence commands
    Use the Current Plan Occurrence commands to perform specific functions against all operations within a single occurrence in the current plan, using a common set of keywords to identify the occurrence.
  - Function Based commands
    The Function Based commands combine various low level PIF commands. Use the Function Based commands to perform specific scheduling or operational functions.
  - Using TSO commands within Workload Automation Programming Language
    Some TSO commands are specific to IBM® Z Workload Scheduler; you can run them natively in TSO, through program EQQEVPGM, and through Workload Automation Programming Language.
  - Batch loader commands
    The batch loader function of Workload Automation Programming Language uses a set of statements to define or modify objects within the IBM® Z Workload Scheduler database.
  - Variable substitution
    Workload Automation Programming Language supports variable substitution within its control statements. In this way, the actual values required for each command run are provided (for example, the occurrence name or Input Arrival date).
  - Performance considerations
    With Workload Automation Programming Language you can use different methods to perform the same action. Each method has different implications for ease of use and performance, the balance of which might change depending on the volume of records to which it is being directed.
  - Resource reference
  - OPTIONS keywords
    Use the following keywords with the OPTIONS statement.
  - Workload Automation Programming Language variables
    In addition to the IBM® Z Workload Scheduler variables and user variables, Workload Automation Programming Language has access to some additional information relating to the job running Workload Automation Programming Language and when scheduled the operation and occurrence within which it is running.
  - WAPLEXEC programs
    The Workload Automation Programming Language for z/OS is a REXX based tool provided to give you easy access to the features of the IBM® Z Workload Scheduler Program Interface (PIF). Workload Automation Programming Language can be extended by WAPLEXEC programs, which are REXX programs using Workload Automation Programming Language functions to tackle specific tasks or functions.
  - Messages and Return Codes
    Messages and return codes provide information for problems occurred.
- Driving IBM Z Workload Scheduler
Messages and Codes
Glossary
Notices

IBM® Z Workload Scheduler PIF concepts

The following sections explain the basic concepts of the IBM® Z Workload Scheduler programming interface (PIF) and data structure.