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.
Managing the Workload
You can plan when and how your workload runs and manage it as part of a plan.
Controlling and monitoring
Learn how to manage the workload when it becomes part of a plan and is run with real dates and times.
Using Tivoli Business Service Manager to monitor objects in the database

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.
  - About this publication
  - Planning and scheduling
    Learn how to organize your workload while it runs, and the dependencies among its parts.
  - Controlling and monitoring
    Learn how to manage the workload when it becomes part of a plan and is run with real dates and times.
    - Monitoring the workload
    - Updating the current plan
    - Handling operations that end in error
    - Monitoring special resources
    - Browsing a job log with IBM Tivoli Output Manager
    - Using Tivoli Business Service Manager
    - Reporting with HCL Workload Automation for Z
    - Sending an email when an alert condition occurs
    - Opening incidents through ServiceNow
      To have the Z controller open incidents through ServiceNow© and manage issues through a ticketing systems, you can use the Servicenow plug-in (available for z-centric agents on Automation Hub) or integrate HCL Workload Automation for Z with ServiceNow, as described in the following procedure.
    - Posting incidents and sharing information through a chat tool
    - Integrating with IBM Z JCL Expert
    - Using Open Services for Lifecycle Collaboration
    - Using Tivoli Business Service Manager to monitor objects in the database
      - Generating the application, operation, and workstation data sets from the database
        HCL Workload Automation for Z includes the following samples that help you generate the data sets that you will later process into the Discovery Library book XML file of Change and Configuration Management Database on the HCL Workload Automation master domain manager.
      - Processing the Discovery Library book file inTivoli Business Service Manager
  - TSO commands
  - Batch programs
  - Report examples
  - Supported z/OS Commands
  - Status, error, and reason codes
  - Fields displayed in ready and error lists
  - Defining event rules and invoking EQQLSENT macro
  - HCL Workload Automation for Z ISPF variables allowed in the EQQAJCLE panel
- 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
- Driving HCL Workload Automation for Z

Using Tivoli Business Service Manager to monitor objects in the database

An additional type of integration of which you can take advantage is based on the Discovery Library Adapter (DLA) mechanism. A DLA can send resource information to Change and Configuration Management Database (CCMDB) without the overhead of a Web Application Server, database, or other middleware. To integrate with the CCMDB via the Discovery Library, all an application needs to do is produce an XML file containing the resource information.

The DLA provided with HCL Workload Automation is capable of processing snapshots of the Application and Workstation data bases sent by HCL Workload Automation for Z.

The overall procedure consists in the following steps:

On HCL Workload Automation for Z run the REXX execs that generate the lists of applications, operations, and workstations (in the form of data sets) from the data base. Samples of the execs are provided in the product and they are discussed later.
Copy or forward the data sets onto an HCL Workload Automation master domain manager where CCMDB is installed.
On the master domain manager, go to the TWA_home/tws/CCMDB directory and run the dataxtract command to create an XML file (also called Discovery Library book - IdML book) that includes the contents of the three data sets.
The format of the XML file is:
```
ITWS950.hostname.timestamp.refresh.xml
```
Copy or send the XML file on the computer running Tivoli Business Service Manager.
Here, process the file as defined in Processing the Discovery Library book file in Tivoli Business Service Manager to write it into the data base of Tivoli Business Service Manager.
In Tivoli Business Service Manager this information can be catalogued as SERVICE OBJECTS based on LOB (lines of business) to complement the information received by the Event Integration Facility (EIF) probe from HCL Workload Automation for Z through the event pump mechanism (described in Using Tivoli Business Service Manager to monitor operations in the plan).