CALC291E error message from an EARL r6.1 reporting program after Common Services upgrade

Products

• COMMON SERVICES FOR Z/OS
• Earl

Issue/Introduction

Following a recent install of Common Services, a user has encountered problems with time-outs when running an EARL reporting program against their IMS databases.  However, production is currently OK.  I attempted to recompile the reporting program but the compile fails.  I receive the following messages which appear to refer to a licensing error.  Can you please advise.

>    3       DBFIL:  FILE CAEADLI RECORD = 9000I
***CALC291E STATEMENT BEGINNING ON LINE    3 ERROR - RESTRICTED TO CA USER MODULE

  

 

 

 

 

 

 

Environment

Release: Common Services r15.0 
Component: EARL r6.1

Cause

The EARL component distributed with Common Services can only access Broadcom product specific files.  The entire EARL product is required in order to access user defined files  

Resolution

If not licensed for the entire EARL product then this message is valid and indicates that the EARL request is attempting to access "non-Broadcom" data on the FILE statement.  In this instance there are two alternatives: 

• Refer only to the Broadcom product specific data on the FILE statement
• Purchase the entire EARL product

If licensed for the entire EARL product and are receiving this message, then the EARL loadlib is most likely missing from the JCL of the reporting job.  The EARL product loadlib contains members such as EARLVSAM and other EARL* modules which are required in order to report on user files.  Check the //STEPLIB concatenation and if necessary, concatenate this library to the Common Services library in the //STEPLIB concatenation of the job.  Make sure to define the Common Services library ahead of the Earl library in the //STEPLIB concatenation order. 

Additional Information

Refer to the explanations of the CALC291E message and the Configuration of the Earl component Common Services r15.0 product and message documentation