Starting CA7ONL gets message CA-7.914 - LOCATE FAILED FOR JCL DATASET 'hlq.CAL2HELP' and task hangs without completing initialization phase.

Products

• CA 7 Workload Automation

Issue/Introduction

When starting CA7ONL task and it hangs with error message:

CA-7.914 - LOCATE FAILED FOR JCL DATASET ‘hlq.CAL2HELP’

and the initialization phase doesn’t complete successfully.

Cause

This is the message text for CA-7.914, as reported in the CA7 Workload Automation Message Reference Guide:

CA-7.914

LOCATE FAILED FOR JCL DATA SET x...x

Reason:

The data set name specified in the JCL statement in the product's initialization file is not cataloged, and no VOLSER parameter was given. Issued by SASSINWC.

Action:

Catalog the JCL data set or provide a VOLSER parameter.

During its initialization phase, CA7ONL task should successfully allocate some mandatory libraries to allow the correct functionality of the workload operations and the CAL2HELP is one of these libraries. It is the CA Workload Automation SE online help library.

If CA7ONL isn’t able to correctly allocate this library during initialization phase, it remains in a hang condition.

Resolution

When CA7ONL starts and it cannot locate the dataset on DASD because it is in an ARCIVE/MIGRAT status, it is necessary to manually restore this dataset and restart CA7ONL task in ERST mode.

Note: Since the dataset is not in an explicit DD statement in the CA7ONL task, a manual restore is necessary.