Overview

The Workload Automation Programming Language is a programming language that provides you with easy access to the features of the HCL Workload Automation for Z Program Interface (PIF).

Workload Automation Programming Language gives you full access to all the PIF commands in an easy-to-use syntax, as well as a Batch Loader feature for all elements of the database. Extended PIF commands perform more complex functions from a single statement, such as determining the status of elements, and access to the HCL Workload Automation for Z TSO commands from within the same command stream.

Workload Automation Programming Language handles all the complicated elements of communication blocks and data exchange, allowing you to communicate with HCL Workload Automation for Z without having any specialized knowledge of memory manipulation or data definitions, allowing you to integrate HCL Workload Automation for Z with your operational environment with minimum effort.

After installing APAR PI79321, you can call Workload Automation Programming Language in the following ways:
  • As a stand-alone batch job calling the main compiled REXX EXEC entry point EQQYXTOP with commands passed as SYSIN. The JCL procedure EQQYXJPX is provided for this purpose.
  • As a batch job, called from your own REXX routines calling the main compiled REXX EXEC entry point EQQYXTOP, passing commands, and receiving output through the REXX stack. The JCL procedure EQQYXJPX is provided for this purpose.
  • As a started-task workstation operation, passing the commands through operation user fields. Samples EQQWCMD1 and EQQWCMD2 are provided to set up started-task workstation operations.
  • As a load module, named EQQWAPL, with commands passed either through SYSIN or using a control block created by a calling program. The JCL procedure EQQYXJPL is provided for this purpose. Online within TSO as part of a dialog process, calling the main compiled REXX EXEC entry point EQQYXTOP, passing commands, and receiving output through the REXX stack. Samples EQQWTS* are provided to set up calling WAPL from within TSO dialogs.
Note: The load module EQQWAPL runs without a TSO environment, therefore not all the commands and options are available to it. For details about the limitations, see Running Workload Automation Programming Language as a load module.
Workload Automation Programming Language works as a session-based interface to HCL Workload Automation for Z, sending a sequence of commands to a specified HCL Workload Automation for Z subsystem. It communicates with only one controller at a time, but can communicate with multiple subsystems in a single run, opening and closing communication in turn.
Note: Although Workload Automation Programming Language can perform functions across many items in the database and plans in a single run, the main design criteria for the processing engine is focused on flexibility, simple syntax, and ease of use. Because of this, running Workload Automation Programming Language against large amounts of data in a single run can result in long run times. For large data handling, use EQQYCAIN or bespoke PIF programs instead.