Installation and Configuration Best Practices › Using the EDCHEK Interface

Using the EDCHEK Interface

The EDCHEK feature is the most commonly used ISPF interface and is invoked to validate JCL while in an ISPF Edit session. To use EDCHEK, execute either command !JCK or EJCK. These commands validate the JCL and display the results on the terminal. The command !JCK executes a program while EJCK executes a CLIST, which allows the passing of runtime options. For example, the command ” EJCK LIST” passes the option LIST to display all the reports requested. The command “EJCK PANEL” displays an options panel before executing.

To use the EDCHEK interface:

1. Place the CA JCLCheck CAZ2LOAD in the LINKLIST, as best practice. The CA JCLCheck CD51LOAD must also be in the LINKLIST when ChekPlex is used. If these libraries cannot go in the LINKLIST, then they must be in the STEPLIB allocation in the TSO logon procedure.

   Note: All the STEPLIB concatenated libraries must be APF-authorized.

2. Allocate the following libraries to your logon procedure:
   • CAZ2CLS0 library to SYSPROC concatenation
   • CAZ2PNL0 library to ISPPLIB concatenation
   • CAZ2SKLO library to ISPSLIB concatenation
   • CAZ2MSG0 library to ISPMLIB concatenation

   Alternately, you can use the LIBDEF method of allocating your system libraries as follows:

   • ISPEXEC LIBDEF ISPMLIB DATASET ID('CAI.CAZ2MSG0')
   • ISPEXEC LIBDEF ISPPLIB DATASET ID('CAI.CAZ2PNL0')
   • ISPEXEC LIBDEF ISPSLIB DATASET ID('CAI.CAZ2SKL0')
   • ISPEXEC LIBDEF ISPTLIB DATASET ID('CAI.CAZ2TBL0')

     Important: Do not use LIBDEF ISPLLIB to allocate the CA JCLCheck load libraries (CAZ2LOAD and CD51LOAD). ISPLLIB modules cannot run authorized.

3. Add the following entries to SYS1.PARMLIB(IKJTSOnn), as APF-authorization for CA JCLCheck in TSO/ISPF mode is required:
   • CAZ2CTSO in the AUTHTSF table
   • JCLCHECK in the AUTHCMD table
   • JCLCHECK in the AUTHPGM table

     To validate this setup, enter TSO CAZ1TSF. When APF-authorized, the display shows:

     CAZ1TSF - JCLCHECK AUTHTSF ENTRY 'CAZ2CTSO' FOUND

     CAZ1TSF - JCLCHECK AUTHCMD ENTRY 'JCLCHECK' FOUND

     CAZ1TSF - JCLCHECK AUTHPGM ENTRY 'JCLCHECK' FOUND

4. Allocate the EDCHKDD DD data set to your TSO logon procedure or logon CLIST.

   The EDCHKDD DD statement allocates a data set that contains CA JCLCheck runtime options.