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
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.
SHOW – Show diagnostic information
Use the SHOW command to show diagnostic information, to help you understand with what information Workload Automation Programming Language is operating.
SHOW USRF – Display Operation User Fields for this job
Use the SHOW USRF command to show the names and values of all Operation User Fields attached to the job.

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.
    - CALL – Execute external program, subroutine, or variable
      Use the CALL command to call routines that might be in another REXX routine or variable.
    - DISPLAY – Echo information to SYSTPRT
      Use the DISPLAY command to echo information to the SYSTSPRT output.
    - DO and END – Block and Loop commands
      Use the DO and END commands to designate a block of code to run together. You can either use them to group multiple commands for IF-THEN-ELSE or to repeat blocks of code.
    - DROP – Drop elements from memory
      Use the DROP command to drop saved structures from memory.
    - EXIT – Terminate processing
      Use the EXIT statement to terminate processing at that point.
    - FILTER – Post process selected records to reduce output
      Use the FILTER command to post process what was returned to Workload Automation Programming Language from HCL Workload Automation for Z, to selectively reduce the output actually returned by Workload Automation Programming Language.
    - GOTO – Continue execution from an in scope label
      Use the GOTO command to allow the process to skip to a named line of code, as long as it is in scope.
    - IF-THEN-ELSE – Conditional execution
      Use the IF and THEN construct to conditionally execute a Workload Automation Programming Language statement, or block of statements if true. Use the ELSE statement to allow an alternative statement or block to run, if the condition is not true. These commands use underlying REXX processing to evaluate the expression.
    - INCLUDE – Include code from other data sets or members to be run
      Use the INCLUDE statement to include Workload Automation Programming Language statements from other data sets or members in the Workload Automation Programming Language command stream. With this command, you can also access user fields belonging to the operation that controls the job to use their values as SYSIN.
    - ITERATE – Proceed to the next iteration of current loop
      Use the ITERATE command to exit the current iteration of a DO block, and resume processing at the DO statement.
    - LEAVE – Exit the current loop
      Use the LEAVE command to exit the current iteration of a DO block, and resume processing following the END statement.
    - LOG – Echo information to the log
      Use the LOG command to echo information to the log output.
    - MERGE – Merge SAVELIST output
      Use the MERGE command to merge the contents of two lists into a single list with no duplicates.
    - NOACT – Peform no action
      The main purpose of the NOACT command is to be a null action for complex IF expressions where the action you really want is the ELSE condition.
    - OPTIONS – Define run time options and PIF requests
      Use the OPTIONS commands to set both Workload Automation Programming Language and HCL Workload Automation for Z options.
    - OUTPUT – Define output record
    - READ – Read an external file or the external data queue
      Use the READ command to load external data sources into OBJECT variables.
    - RETURN – Exit the subroutine
      Use the RETURN command to exit the subroutine and return the processing to the instruction that follows the CALL command.
    - SETMAX – Manipulate the maximum return code
      Use the SETMAX command to modify the maximum return code and maximum response code, at any point in the Workload Automation Programming Language command sequence.
    - SETSEV – Set message severity
      Use the SETSEV command to change the severity of an individual message in Workload Automation Programming Language to allow different return code processing to take place.
    - SHOW – Show diagnostic information
      Use the SHOW command to show diagnostic information, to help you understand with what information Workload Automation Programming Language is operating.
      - SHOW FILES – Display files allocated to Workload Automation Programming Language
        Use the SHOW FILES command to list each file in turn that it detected as being allocated to the Workload Automation Programming Language step when Workload Automation Programming Language started.
      - SHOW OBJECT – Display the object structure of an HCL Workload Automation for Z record
        Various commands allow you to create object variables. The format of the object variables reflects the structure of the record being retrieved. Use the SHOW OBJECT command to list the structure of a specific record.
      - SHOW OPTIONS – Display Workload Automation Programming Language OPTIONS currently effective
        Use the SHOW OPTIONS command to show each Workload Automation Programming Language option, with its current setting. Although some PIF options are ghosted in Workload Automation Programming Language, not all of them are; only the options with default settings in Workload Automation Programming Language that are different from native PIF are shown. This command is designed to show only the Workload Automation Programming Language settings.
      - SHOW RC – Display return codes
        Use the SHOW RC to list the return codes of each previous job step and Workload Automation Programming Language command.
      - SHOW SAVELIST – Display the contents of a SAVELIST
        Use the SHOW SAVELIST command to list the contents of a saved list of results.
      - SHOW SPE – Display active Small Product Enhancements
      - SHOW SYSINFO – Display information about the LPAR
        Use the SHOW SYSINFO command to show information about the LPAR where the Workload Automation Programming Language job is running. This is useful to determine the correct values to be set for OPTIONS TRACKERS.
      - SHOW SUBSYSTEM – Display controller information
        Use the SHOW SUBSYSTEM command to show information about the connected HCL Workload Automation for Z controller.
      - SHOW USRF – Display Operation User Fields for this job
        Use the SHOW USRF command to show the names and values of all Operation User Fields attached to the job.
      - SHOW VARIABLES – Display current variable values
        Use the SHOW VARIABLE command to show the current values of the Workload Automation Programming Language variables and the table to which they belong.
    - SUBROUTINE – Indicate the start of a subroutine
      Use the SUBROUTINE statement to indicate the start of a new subroutine, which can be run by the CALL SUB command.
    - TRANSLATE – Define rules for life-cycle translation
      Use the TRANSLATE command to set up a series of rules to translate values of specific fields, or types of fields in the Batch Loader output generated by Workload Automation Programming Language. This command affects only Batch Loader output.
    - WAIT – Delay before continuing with the next command
      Use the WAIT command to swap out the job for a specified amount of time.
    - WRITE – Echo information to a file or the external data queue
      Use the WRITE command to echo information to a file or to the external data queue.
  - 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.
  - Messages and Return Codes
    Messages and return codes provide information for problems occurred.
- Driving HCL Workload Automation for Z

SHOW USRF – Display Operation User Fields for this job

Use the SHOW USRF command to show the names and values of all Operation User Fields attached to the job.

The following example shows the output for the

SHOW
USRF

command:

03/17 01.18.10 EQQI200I SHOW USRF                  
03/17 01.18.11 EQQI013A Job ADCDMSTU,JOB01991 in UFTEST 1409071119 CPU1_010
03/17 01.18.11 EQQI612A User field AUTHGROUP = ADCD
03/17 01.18.11 EQQI612A User field CATEGORY = C    
03/17 01.18.11 EQQI299I Statement completed - RC=0