Starting CA7ONL it can happen to get message CA-7.914 - LOCATE FAILED FOR JCL DATASET ‘hlq.CAL2HELP’ and task hangs without completing initialization phase.

Document ID : KB000008192
Last Modified Date : 14/02/2018
Show Technical Document Details
Issue:

CA7ONL is the task which manages the CA 7 Central Control System. It performs an initialization process starting the functions that schedule and control the production environment. It is based on an initialization file that controls the environment. Statements within the file define the following items:

â–  Environment in which the Central Control System resides

â–  Processing options to exercise

â–  Terminal and security definitions to use

â–  Type of initialization to perform

â–  Scheduling calendar (see page 221) definitions

 

An initialization process is necessary regardless of whether you use CA WA CA 7 Edition in batch-only mode for maintenance type functions or in online mode for automatic scheduling and production control.

Sometimes it can happen that, starting CA7ONL task, it can hang with error message:

 

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

 

and the initialization phase doesn’t complete successfully.

How to correct this problem?

 

Environment:
CA 7
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:

 

The CAL2HELP is updated very rarely by the product maintenance or by the customers, moreover the CA7ONL task doesn’t open it in input/output during initialization because it doesn’t reference it explicitly in the task with a DD card but it should be able to allocate it, so it can happen to have it in an ARCIVE/MIGRAT status due to CA-DISK or IBM DFHSM products activity if nothing is done to prevent them from managing this library.

If this is the case, when CA7ONL starts, it cannot locate the library on dasd because it is in an ARCIVE/MIGRAT status, in addition the task isn’t also able to engage an Automatic Restore of this library because there isn’t an explicit DD card in the CA7ONL task jcl which references it, so the error:

 

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

 

is got and CA7ONL hangs.

It is necessary to manually restore this library and restart the CA7ONL task in ERST mode to bypass this problem.

If, after this suggestion, the error still occurs, please open a Case with CA Support.