Home
HCL Workload Automation for Z
Welcome to the HCL Workload Automation for Z 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
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 HCL Workload Automation for Z 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.
EQQWXHTM – Build an HTML version of a calendar
Combining EQQWXHTM with other processes
EQQWXHTM provides you with a presentation layer to review date based information in a simple and meaningful way. When combined with other Workload Automation Programming Language elements, you can automate parts of your date data management.
Run date review
Starting from HCL Workload Automation for Z Version 8.6 SPE, you can use the LIST GENDAYS PIF request to generate run dates from rules. You can the use the GETDATES command to find the run dates of any individual application.

HCL Workload Automation for Z
Welcome to the HCL Workload Automation for Z documentation, where you can find information about how to install, maintain, and use the product.
- 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 HCL Workload Automation for Z Program Interface (PIF).
  - 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 HCL Workload Automation for Z 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 HCL Workload Automation for Z; 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 HCL Workload Automation for Z 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 HCL Workload Automation for Z 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 HCL Workload Automation for Z 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.
    - Running WAPLEXEC programs
      WAPLEXEC programs can be run by EQQYXJPX, naming the WAPLEXEC program with the CMD symbolic parameter.
    - EQQWXCSR – Update resources in the Current Plan
    - EQQWXCSV – Generate applications from a CSV file
    - EQQWXHTM – Build an HTML version of a calendar
      - Function
        The EQQWXHTM program produces an HTML representation of a calendar. The calendar can be a simple calendar for the year with no scheduling information, or it can contain highlighted dates extracted from HCL Workload Automation for Z, such as calendar free days and run dates.
      - Process control
        You are provided with many keywords to modify the presentation of the calendar, by setting them either within the ARGS symbolic parameter or SYSIN.
      - Running the command
        In addition to normal Workload Automation Programming Language JCL requirements, EQQWXHTM needs the following DD statements allocated.
      - Combining EQQWXHTM with other processes
        EQQWXHTM provides you with a presentation layer to review date based information in a simple and meaningful way. When combined with other Workload Automation Programming Language elements, you can automate parts of your date data management.
        Annual calendar creation and review
        The SEQQWAPL library has DATE members containing public holidays for some countries; you can use them to create variables containing dates for public holidays. For countries without DATE members, use VARDATE to create your own rules for public holidays.
        Run date review
        Starting from HCL Workload Automation for Z Version 8.6 SPE, you can use the LIST GENDAYS PIF request to generate run dates from rules. You can the use the GETDATES command to find the run dates of any individual application.
    - EQQWXIAX – Input Arrival Cross Reference
    - EQQWXJBU – Update applications for a job
    - EQQWXNOE – Protecting against unconnected applications
    - EQQWXPER – Generate week number variables for a period
  - Messages and Return Codes
    Messages and return codes provide information for problems occurred.
- Driving HCL Workload Automation for Z

Run date review

Starting from HCL Workload Automation for Z Version 8.6 SPE, you can use the LIST GENDAYS PIF request to generate run dates from rules. You can the use the GETDATES command to find the run dates of any individual application.

The following example shows a sample job for exporting run dates into flat files (RUNDATES):

//RUNWAPL  EXEC EQQYXJPX,
//SUBSYS=WSJC
//OPREVAL  DD DISP=SHR,DSN=ADCDMST.CZ.JCL(OPREVAL) 
//OPREVAL  DD DISP=SHR,DSN=ADCDMST.CZ.JCL(OPREVAL) 
//OMONTH   DD DISP=SHR,DSN=ADCDMST.CZ.JCL(OMONTH)
//OAPPLY   DD DISP=SHR,DSN=ADCDMST.CZ.JCL(OAPPLY)
//SYSIN    DD *
OPTIONS FIELDSEP(,)
OUTPUT GNDAY DATA(OPREVAL) FIELDS(GNDAYDATE,TAG) LABEL(NONE) 
GETDATES ADID(FD2PREVAL) FROMDATE(120101) TODATE(121231) OUTPUT(C) 
OUTPUT GNDAY DATA(OMONTH)
GETDATES ADID(FD2MONTH)  FROMDATE(120101) TODATE(121231) OUTPUT(C) 
OUTPUT GNDAY DATA(OAPPLY)
GETDATES ADID(FD2APPLY)  FROMDATE(120101) TODATE(121231) OUTPUT(C)

The RUNDATES job finds the run dates for three separate applications across the year. You can the use these files as input in the EQQWXHTM command to combine the run dates with calendar information.

The following example shows a sample job for presenting run dates in a calendar (RUNCAL):

//RUN2012  EXEC EQQYXJPX, 
//         ARGS='YEAR(2012)', 
//         CMD=EQQWXHTM,
//         SUBSYS=WSJC
//OUTHTML  DD DISP=SHR,DSN=ADCDMST.CZ.JCL(RUN2012)
//CLSDDATE DD DISP=SHR,DSN=ADCDMST.CZ.JCL(CALDATES) 
//OPREVAL  DD DISP=SHR,DSN=ADCDMST.CZ.JCL(OPREVAL) 
//OMONTH   DD DISP=SHR,DSN=ADCDMST.CZ.JCL(OMONTH) 
//OAPPLY   DD DISP=SHR,DSN=ADCDMST.CZ.JCL(OAPPLY) 
//SYSIN    DD * 
DAYS(M D W D V Z Z) TITLE(FD2 data voor 2012)
MONTHS(JANUARI FEBRUARI MAART APRIL MEI JUNI
       JULI AUGUSTUS SEPTEMBER OKTOBER NOVEMBER DECEMBER)
PROCESS(CLSDDATE,OPREVAL==green,OMONTH==blue,OAPPLY==red)
HILITE(gray-yellow)

Because each application was exported into a separate file, you can assign a different color to each application, making it easier to spot each application that runs on specific dates in a single calendar.

The run dates for year 2015 — Figure 1. Run dates for year 2015

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.