VERIFIED SOLUTION i

Explanation of a "CM02" return code using the CODE-1 Plus G1CP transaction in CICS

Product Feature: Installation / Upgrade
Operating System: z/OS, CICS
Products Affected:  CODE-1 Plus

 
A CM02 return code indicates a problem with a CODE-1 Plus database file.  A CM02 return code will always contain a DB error, a command and a filename which will help to troubleshoot the problem.  Here is an example of a CM02 return code:
  
CODE-1 PLUS PROGRAM ERROR, RETURN CODE=CM02
G1CPDCM DB ERROR WAS: 21 COMMAND WAS: READ FILENAME WAS: LCLDB
 
Other DB ERRORs include:
 
84 = Database is disabled
12 = FILENOTFOUND   (the filename supplied in the FILE option is not defined to CICS)
16 = INVREQ  (Incorrect definition of the file in CICS and how it's being used.  For example, READ is not allowed according to the resource definition)
54 = ISCINVREQ  (a remote region reports an unknown condition)
22 = LENGERR  (length error - wrong file for file name)
70 = NOTAUTH  (the security definition for the file has been changed)
19 = NOTOPEN  (most likely the requested file is CLOSED and UNENABLED)
53 = SYSIDERR  (for a coupling facility data table, the connection to the coupling facility data table server has failed. This could be because the server itself has failed, or
        the 
server is available, but CICS has failed to connect to it)
 
The C1PCSD JCL member in the install JCL library will contain all the CICS definitions needed for CODE-1 Plus, including the database definitions.  It is important to run the C1PCSD with every CODE-1 Plus upgrade to make certain each database is correctly defined to CICS with the correct settings and dataset names.  In addition, always make certain the database files are open and enabled
 
 
UPDATED:  September 4, 2017