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.
Scheduling End-to-end with z-centric Capabilities
Defining and managing jobs
Defining a job in the JOBLIB data set
You define the jobs to be run on HCL Workload Automation Agent workstations in a job definition member of the JOBLIB data set. In the JOBLIB member, you can either define the job contents or invoke a script or an executable that is stored locally on the HCL Workload Automation Agent workstation.

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
  - About this publication
  - Configuring
  - Customizing the HTTP connections
    The communication between the HCL Workload Automation Agents and the HCL Workload Automation for Z controller is direct, through the HTTP or HTTPS protocol.
  - Defining user IDs and passwords with the USRREC statement
    Use the USRREC initialization statement to define the passwords for the users who need to schedule jobs to run on Windows™ workstations. You do not need to do this if you run native job types on non-Windows workstations.
  - Defining variables and passwords for local resolution
  - Defining and managing HCL Workload Automation Agent workstations in the database
    After defining the destinations of your HCL Workload Automation Agents, you need to define the HCL Workload Automation Agents as HCL Workload Automation for Z computer automatic workstations.
  - Defining and managing dynamic workstations
    When you add dynamic capabilities to your environment, you can schedule your workload dynamically.
  - Setting the security features
  - Defining and managing jobs
    - Defining jobs from the Dynamic Workload Console
      How to define a new job definition using the Dynamic Workload Console.
    - Defining a job in the JOBLIB data set
      You define the jobs to be run on HCL Workload Automation Agent workstations in a job definition member of the JOBLIB data set. In the JOBLIB member, you can either define the job contents or invoke a script or an executable that is stored locally on the HCL Workload Automation Agent workstation.
    - Using variable substitution
      The variable substitution mechanism that is used in HCL Workload Automation for Z native job types works the same way when scheduling jobs on HCL Workload Automation Agents. The variable substitution mechanism changes when you define job types with advanced options, such as Java™ jobs that run a Java class, or file transfer jobs that transfer files to and from a server, to name a few. These types of jobs are created and edited using the Dynamic Workload Console.
    - Defining file dependencies to check for file changes
    - Checking for file changes with filemonitor
    - Promoting critical jobs
      An overview of the mechanism that is behind the promotion of critical jobs, or of their predecessors, running on HCL Workload Automation Agents, including pools and dynamic pools.
    - Killing operations
  - Administering IBM i dynamic environment
    On overview on how to administer the HCL Workload Automation IBM i dynamic environment.
  - Monitoring and recovering jobs
  - Running a script when a job completes
  - Viewing the job logs from the host
    An overview on how to view or retrieve the job logs issued in the z-centric environment and how to attach a header with job run information on top of each log.
  - Troubleshooting
    Troubleshooting agent problems
  - Configuring to schedule J2EE jobs
  - Security order of precedence used for the execution of J2EE tasks
  - Configure to schedule job types with advanced options
  - Managing return codes
  - Collecting job metrics
- Quick Reference
- Diagnosis Guide and Reference
- Workload Automation Programming Language for z/OS User's Guide and Reference
- Driving HCL Workload Automation for Z

Defining a job in the JOBLIB data set

You define the jobs to be run on HCL Workload Automation Agent workstations in a job definition member of the JOBLIB data set. In the JOBLIB member, you can either define the job contents or invoke a script or an executable that is stored locally on the HCL Workload Automation Agent workstation.

If you do not specify any content in the job definition member, the error code JCLI is issued.

To define the job contents, the following syntax rules apply:

The lines that start with //* OPC, //*%OPC, or //*>OPC are used for variable substitution and automatic recovery. They are removed before the script is downloaded onto the HCL Workload Automation Agent.
Each line starts between column 1 and column 80.
The last backslash (\) in a line is considered the character of continuation.
Blanks at the end of the line are automatically removed.

To define the job properties, use the JOBREC statement. In the JOBREC statement, you can define different job types.