Step 16. Activating support for the API

Include this task when installing a controller, or standby controller that you want to communicate with through the IBM Z Workload Scheduler API.

IBM Z Workload Scheduler uses LU to LU communication to pass data between an ATP and a subsystem through the API. To use API requests GET, PUT, and DELETE, the LU that the ATP sends requests to (the target LU) must be owned by the controller. For CREATE requests, if the target LU is not owned by an IBM Z Workload Scheduler address space where an event-writer task is started, the ATP must send requests so that the events are broadcast on the target z/OS system. Tivoli® Workload Automation: Developer's Guide: Driving Tivoli® IBM Z Workload Scheduler and IBM Z Workload Scheduler: Customization and Tuning describe when a request is broadcast.

To activate support for the API, perform these actions in the order shown:
  1. Define VTAM® resources.
  2. Update APPC options.
  3. Activate IBM Z Workload Scheduler support for APPC.
If you are installing a standby controller, perform corresponding actions on the standby system.
You might need to refer to one or more of these publications:
  • VTAM® Resource Definition Reference
  • APPC Management
  • z/OS Initialization and Tuning Reference
  • Tivoli® Workload Automation: Developer's Guide: Driving Tivoli® IBM Z Workload Scheduler, which documents the API

The actions described here are based on z/OS systems. If you use a later z/OS release, check for enhancements that might make some actions unnecessary.