Home
HCL Workload Automation
Welcome to the HCL Workload Automation documentation, where you can find information about how to install, maintain, and use HCL Workload Automation. The documentation has been updated for HCL Workload Automation Version 10.2.2.
Scheduling with the Agent for z/OS
Using the agent for z/OS
Using variables in your agent for z/OS jobs
You can include variables in your job definition.
Variables resolved by the agent for z/OS
These variables are resolved by the agent for z/OS in the JCL before the JCL is passed on to JES for execution.
Predefined variables in JCLs
Predefined variables are supplied with HCL Workload Automation for use with the agent for z/OS.
Predefined job-related variables in JCLs
These variables are related to information about the job instance.

HCL Workload Automation
Welcome to the HCL Workload Automation documentation, where you can find information about how to install, maintain, and use HCL Workload Automation. The documentation has been updated for HCL Workload Automation Version 10.2.2.
- Planning and Installation
- User's Guide and Reference
- Administration Guide
- Scheduling with the Agent for z/OS
  - Overview
    Use the agent for z/OS to schedule work from HCL Workload Automation on the JES2 or JES3 subsystem of z/OS.
  - Installing and configuring
    This chapter describes the tasks you need to complete to download, install, and configure the agent for z/OS software on the target z/OS system.
  - Using the agent for z/OS
    - Computer and workstation names of the agent
      The first time the agent for z/OS connects with HCL Workload Automation, it is automatically given a computer name.
    - Listing the agents for z/OS
      In the Dynamic Workload Console and in composer, the agents for z/OS® are listed as workstations of type agent.
    - Defining jobs
      Like you do for all other HCL Workload Automation jobs, you can define jobs for an agent for z/OS from either the composer command line or from the Dynamic Workload Console.
    - Defining the JCL
      How to define the JCL.
    - Running event-driven workload automation
    - Submitting jobs
      All agent for z/OS jobs can be either part of a job stream and be submitted in a plan, or be submitted at any time using the conman submit commands or proper Dynamic Workload Console panels.
    - Using variables in your agent for z/OS jobs
      You can include variables in your job definition.
      - Variables resolved by HCL Workload Automation
        The variables are assigned their values by means of dynamic workload broker at job submission time before the job is passed to the agent for z/OS.
      - Variables resolved by the agent for z/OS
        These variables are resolved by the agent for z/OS in the JCL before the JCL is passed on to JES for execution.
        Configuring the agent to run variable substitution
        To be able to run this type of variable substitution, you must configure some keywords of the TWSOPTS statement.
        Coding variables in JCL
        Coding variables in JCL follows certain rules.
        User-defined variables in JCLs
        You can add your own defined variables in the JCLs.
        Predefined variables in JCLs
        Predefined variables are supplied with HCL Workload Automation for use with the agent for z/OS.
        Predefined job stream-related variables in JCLs
        These variables are related to information about the job stream instance.
        Predefined job-related variables in JCLs
        These variables are related to information about the job instance.
        Predefined date-related variables in JCLs
        These variables are related to the current date and time; that is, the time and date on which the job was submitted.
        Predefined dynamic-format variables in JCLs
        Predefined dynamic-format variables are time-and-date-related.
        Predefined temporary variables in JCLs
        You can create temporary variables using the SETVAR directive.
        JCL tailoring directives
        The agent for z/OS uses special comment statements, called directives, to manage the inclusion and exclusion of lines and to control aspects of variable substitution.
    - Managing job instances
      You manage jobs submitted to an agent for z/OS with the same commands available for all HCL Workload Automation jobs.
    - Tracking jobs
      The agent uses the JES/SMF exits to track the status changes for all the jobs submitted through it.
    - Viewing job logs
      Viewing the logs of jobs submitted through the agent for z/OS.
    - Using system commands to control the agent
      You can use z/OS® system commands to start, stop, cancel, or modify the agent for z/OS.
    - How the agent responds to a domain manager switch
      This section describes the mechanism that keeps the agent for z/OS connected to your HCL Workload Automation network when you switch to a backup manager.
  - Troubleshooting and reference
    This chapter documents potential problems and reference information.
- Database Views
- High Availability Cluster Environment
- Driving HCL Workload Automation
- Extending HCL Workload Automation

Job-related variables

These variables are related to information about the job instance.

Predefined job-related variables are listed in the following table:

Table 1. Predefined job-related variables
Variable name	Length (in bytes)	Description
OSSID	16	Subsystem name of the agent for z/OS.