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
Processing the Discovery Library book file inTivoli Business Service Manager

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

Processing the Discovery Library book file in Tivoli Business Service Manager

After extracting the ITWS950.<hostname>.<timestamp>.refresh.xml file with the dataxtract command, run the following steps to copy the job stream, job, and workstation definitions in the Tivoli Business Service Manager data base:

Copy the file into the ../opt/IBM/tivoli/tbsm/discovery/dlbooks directory of the system running Tivoli Business Service Manager and allow it all permissions.
Copy the new NamingRules.xml file into ../opt/IBM/tivoli/tbsm/XMLtoolkit/xml and allow it all permissions.
Change directory to ../opt/IBM/tivoli/tbsm/XMLtoolkit/bin and run the following command to stop the XML toolkit:
```
 ./tbsmrdr_stop.sh
```
Check the log file in ../opt/IBM/tivoli/tbsm/XMLtoolkit/log/msgGTM_XT.log.0 to be sure the toolkit is stopped.

Go back to ../opt/IBM/tivoli/tbsm/XMLtoolkit/bin and run the following command to save the book file in the Tivoli Business Service Manager data base:

./putArtifact -U db_username -P db_userpw  -n /path_to_file/NamingRules.xml
 -c scrconfig

The command should return the following messages:

Command processing started: putArtifact
GTMCL7120I The specified file or artifact has been written to the database.
Command processing completed.
*GTMCL7131I The specified file or artifact has a previous version that has 
been removed from the available configurations and has been maintained as 
a backup version.

The same information is logged in ../opt/IBM/tivoli/tbsm/XMLtoolkit/log/msgGTM_CI.log.0

From ../opt/IBM/tivoli/tbsm/XMLtoolkit/bin run:
```
./tbsmrdr_start.sh
```
and look in /opt/IBM/tivoli/tbsm/XMLtoolkit/log/msgGTM_XT.log.0 for the following message:
```
GTMCL5290I: Book ITWS950.<hostname>.<timestamp>.refresh.xml processed 
successfully.
```

Follow these steps to view the object definitions in the Tivoli Business Service Manager console:

In the tree menu select Administration and then Service Administration.
The Service Administration page is displayed.
In the Service Navigation portlet on the upper left click Templates and then click Service Component Repository in the drop down menu.
Expand Component Registry.
To view the HCL Workload Automation workstations, jobs and job streams, expand Application Servers > Application Servers.
To view the computers defined as HCL Workload Automation workstations, expand Servers > All.