Welcome
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. The documentation has been updated for version 10.2 Fix Pack 5.
Scheduling End-to-end with z-centric Capabilities
Managing return codes

Product requirements
This section contains links to the HCL Workload Automation Product Requirements.
Overview
Best practices
Mobile Applications Userʼs Guide
Dynamic Workload Console User's Guide
AI Data Advisor (AIDA) User's Guide
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.8.
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. The documentation has been updated for version 10.2 Fix Pack 5.
- 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
  - 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
  - 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
Messages and Codes
Glossary
Product library in PDF format
Notices

Managing return codes

By default, all nonzero error codes are considered as an error. Optionally, you can define the error codes that, for job-tracking purposes, are not considered as errors. To do this, set the following parameters:

NOERROR

Defines a list of error codes that, for job-tracking purposes, are treated as normal completion codes. When setting this value on an HCL Workload Automation Agent, beware that the maximum length allowed for a return code is 4 digits. If the HCL Workload Automation Agent returns an error code higher than 9999, it is truncated at the fourth rightmost digit. For example, 12345 is considered as 2345.

For negative error codes, specify a five-character sequence starting with the minus (-) symbol, for example -0008.

ERRRES

Defines a list of error codes that, for job-tracking purposes, result in an automatic reset of an operation. The operation is reset to status A (arriving) and contains the message Error, automatically reset in its operation details panel. An error code can be either of the following:

4-digit job or started-task return code (nnnn)
System abend code (Sxxx)
User abend code (Uxxx)
HCL Workload Automation for Z-defined code

The HIGHRC parameter is supported for positive RC on HCL Workload Automation Agents and agents. Jobs ending with negative RC are always considered in error. The negative RC are handled through NOERROR. For a detailed description of NOERROR and ERRRES, see Customization and Tuning.

The following is a list of the return codes for each job type with advanced options: