Dataset cai.SHLQ was not found in the catalog when trying to use the IIR Historical Reporting ISPF tool

Products

• Database Analyzer (IMS Tools)
• Mainframe Configuration Manager for IMS for z/OS
• IMS TOOLS - MISC
• Compress Data Compression (IMS Tools)
• Database Analyzer for IMS for z/OS
• Database Copier for IMS for z/OS
• Database Organizer for IMS for z/OS
• Mainframe Extended Terminal Manager (IMS Tools)
• High Performance Recovery for IMS for z/OS
• Database Organizer (IMS Tools)
• Mainframe Program Restart Manager for IMS for z/OS
• Secondary Index Builder for IMS for z/OS
• Secondary Index for IMS for z/OS
• DATABASE MANAGEMENT SOLUTIONS FOR IMS FOR Z/OS

Issue/Introduction

When trying to access the IIR Historical Reporting tool, through the ISPF Interface, the following ISPF dialog error is issued:

ISPF Dialog Error
Command ===>

 

                              ISPF Dialog Error                               
Command ===>                                                                  
                                                                              
******************************************************************************
* ISPD014                                                                    *
*                                                                            *
* Data set not cataloged                                                     *
* 'CAI.SHLQ' was not found in catalog.                                       *
*                                                                            *
*                                                                            *
*                                                                            *
*                                                                            *
*                                                                            *
*                                                                            *
* Current dialog statement:                                                  *
* LIBDEF ISPLLIB DATASET ID('PTIPROD.RI15GA1.CIMTLOAD','CAI.SHLQ','CAI.HLQ') *
*                                                                            *
* Enter HELP command for further information regarding this error.           *
* Press ENTER key to terminate the dialog.                                   *
*                                                                            *
*                                                                            *
******************************************************************************

The user is then returned to the ISPF Primary Option Menu.

Resolution

This error implies that the IIR Historical Reporting Application is being invoked by executing the IIREMAIN clist rather than through the normal process of executing the $ITK clist.

More specifically for this error, the IIREMAIN clist has not been customized.

To execute this clist, three variables ITKHLQ, CAILIB and CUSLIB need to be updated.

/* TOOLKIT HIGH LEVEL QUAILIFIER */                          
ITKHLQ = 'CAI.IMS.TOOLKIT'                                     /* <=== CHANGE    */
                                                        
/* DATACOM LIBRARIES */                                 
/* CAILIB - DATACOM/AD TARGET LIBRARY HLQ */            
/* CUSLIB - DATACOM/AD CUSTOM TARGET HLQ  */            
CAILIB  = 'CAI.HLQ'                                            /* <=== CHANGE    */
CUSLIB  = 'CAI.SHLQ'                                           /* <=== CHANGE    */