CEEPRMCC - syntax checking under z/OS batch

CEEPRMxx parmlib members can be syntactically checked for errors under z/OS® batch. Before calling the syntax checker, a CEEPRMxx parmlib member must be created and placed in a PDS or PDSE. You can find the format and requirements for creating the parmlib member in CEEPRMxx parmlib member.

The CEEPRMCC program reads and parses a CEEPRMxx parmlib member for syntax errors, and displays the runtime options report if no errors are found. The runtime options report only displays options that are specified inside the CEEPRMxx parmlib members.

Syntax

The CEEPRMCC program expects the following inputs:

The PARM parameter of the EXEC job control statement to select one or more CEEPRMxx parmlib members:
```
// 		PARM='CEE=(xx,yy,...,nn)'
```
The two alphanumeric characters, xx,yy,...,nn, are the suffix of the CEEPRMxx parmlib members to be checked. Embedded blanks are not allowed within the PARM.
An optional CEEPRMCK DD statement to specify the data set where CEEPRMxx parmlib members are located:
```
//CEEPRMCK		DD DSN=MEENAK.SYSTEM.PARMLIB,DISP=SHR
```
If no DD is specified, the CEEPRMCC program uses the default data set SYS1.PARMLIB.

Usage notes

An input data set must be a fixed record format and a record length of 80.

Return codes

The possible return codes are as follows:

0: Successful completion.
4: No members were specified.
8: Input members were not specified or not valid.
12: A closing parenthesis was missing when specifying input members.
16: One or more chars were found after the closing parenthesis of the input members.
20: One or more embedded blanks were found.
24: SYS1.PARMLIB allocation to the CEEPRMCK DD failed.
28: The specified data set had one or more incorrect attributes.
32: The specified data set did not exist.
1004: The input members string contained a single char suffix.
1008: The specified members could not be read.
1012: The specified members had one or more syntax errors.
1016: The specified member has three or more char suffix.

Examples

The following example shows how to check the CEEPRMJM parmlib member, which resides in the MEENAK.SYSTEM.PARMLIB data set:
```
//CEEPRMCJ    EXEC PGM=CEEPRMCC, 
//            PARM='CEE=(JM)'
//CEEPRMCK    DD DSN=MEENAK.SYSTEM.PARMLIB,DISP=SHR
```

If there are syntax errors, no runtime options report will be displayed. Error messages will be written to the Language Environment® message file. CEE3761I will be followed by other existing error messages related to syntax errors in CEEPRMxx parmlib members and end with CEE3762I, for example:

CEE3761I The following messages pertain to the call to the Language 
Environment Parmlib checker. 
CEE3731I The following messages pertain to the system default 
runtime options in the CEEDOPT in CEEPRMME.
CEE3616I The string 'NNE' was not a valid or supported suboption 
of the runtime option STORAGE in this release.
CEE3762I The Language Environment Parmlib checker has completed.

The following example shows sample output when no errors are found:

CEE3762I The Language Environment Parmlib checker has completed.         
                                                                         
CEE3745I 11.14.01 Display CEEDOPT                                        
CEE=(ME)                                                                 
                                                                         
LAST WHERE SET                 OPTION                                    
-----------------------------------------------------------------------  
PARMLIB(CEEPRMME)                POSIX(OFF)                              
PARMLIB(CEEPRMME)                STORAGE(NONE,NONE,NONE,0)               
                                                                         
                                                                         
CEE3745I 11.14.01 Display CEECOPT                                        
CEE=(ME)                                                                 
                                                                         
LAST WHERE SET                 OPTION                                    
-----------------------------------------------------------------------  
PARMLIB(CEEPRMME)                STORAGE(NONE,NONE,20,2048)              
                                                                         
                                                                         
CEE3745I 11.14.01 Display CELQDOPT                                       
CEE=(ME)                                                                 
                                                                         
LAST WHERE SET                 OPTION                                    
-----------------------------------------------------------------------  
PARMLIB(CEEPRMME)                POSIX(OFF)                              
PARMLIB(CEEPRMME)                STORAGE(NONE,NONE,30,3072)              

CEE3745I 11.14.01 Display CEEROPT
CEE=(MS)                         
                                 
PARMLIB(CEEPRMMS) CEEROPT(ALL)   
                                 

CEE3745I 11.14.01 Display CELQROPT
CEE=(MS)                          
                                  
PARMLIB(CEEPRMMS) CELQROPT(NONE)