genevaers / Run-Control-Apps

GenevaERS Run Control
Apache License 2.0
0 stars 2 forks source link

Change format of RCA report #82

Open rhness opened 2 months ago

rhness commented 2 months ago

The Run-Control Generator (RCG) and the Run-Control Analyzer (RCA) are now being merged and will together be known the Run-Control App (RCA). The format of the RCA report should be changed to recognize this fact, and also to make it consistent with the other Performance Engine reports.

The header of the View Extract control report looks like this:

~EXTRRPT                                           

GenevaERS - The Single-Pass Optimization Engine    
(https://genevaers.org)                            
Licensed under the Apache License, Version 2.0     
Performance Engine for z/OS - Base Product         
Release PM 5.01.001                                

Program ID:      GVBMR95E                          
Program Title:   View Extract Process              
Built:           2024-09-21 00:15:27               

Executed:        2024-09-21 00:16:28               

Report DD Name:  EXTRRPT                           
Report Title:    GVBMR95E Control Report           

The header of the RCG control report currently looks like this:

~RCGRPT                                              

GenevaERS - The Single-Pass Optimization Engine      
(https://genevaers.org)                              
Licensed under the Apache License, Version 2.0       
Performance Engine for z/OS - Base Product           
Release PM PM4.18.00 D                               

Program ID:      GVBRCG                              
Program Title:   Run-Control File Generator          
Built:           1.1.0_RC4 (2024-09-21 04:15)        

Executed:        Sep 21, 2024 : 12:16:25 AM          

Report DD Name:  RCGRPT                              
Report Title:    GVBRCG Control Report               

Please change the format to look like this:

~RCARPT                                              

GenevaERS - The Single-Pass Optimization Engine      
(https://genevaers.org)                              
Licensed under the Apache License, Version 2.0       
Performance Engine for z/OS - Base Product           
Release PM 4.18.109

Program ID:      rcapp-1.1.0_RC4-jar-with-dependencies.jar
Program Title:   Run-Control App
Built:           2024-09-21 04:15

Executed:        2024-09-22 09:00

Report DD Name:  RCARPT                              
Report Title:    GVBRCA Control Report               

The release number will be supplied in the environment variable GERS_PE_REL_NBR.

Please make similar changes to RCALOG.

Also, remove unneeded sections of the report when GENERATE=N (or defaults to N).

When GENERATE=Y, the report sections should look like this (as RCGRPT currently looks):

================                                                     
Report Sections:                                                     
================                                                     

    Tag    Section name                                              
    -----  ------------------------------------------------------    
    ~PARM  Contents of RCGPARM file                                  
    ~OPTS  Options in effect                                         
    ~DFOL  Contents of DBFLDRS file                                  
    ~RUNV  Contents of RUNVIEWS file                                 
    ~DVWS  Contents of DBVIEWS file                                  
    ~OINI  Contents of DSNAOINI file                                 
    ~RUNV  Contents of RUNVIEWS file                                 
    ~VIEW  Views selected                                            
    ~IFIL  Input files                                               
    ~OFIL  Output files                                              
    ~REFW  Reference Work Files                                      
    ~WRNS  SAFR compiler warnings                                    
    ~ERRS  SAFR compiler errors                                      
    ~EXEC  Execution summary                                         

When GENERATE=N (or defaults to N), the report sections should look like this:

================                                                     
Report Sections:                                                     
================                                                     

    Tag    Section name                                              
    -----  ------------------------------------------------------    
    ~PARM  Contents of RCGPARM file                                  
    ~OPTS  Options in effect                                         
    ~EXEC  Execution summary                                         
rhness commented 1 month ago

I'd like to request a small change. Above I said:

I've found that I'm already using that variable for the unformatted release number (such as 418109).

I'd now like the RCA report to use GERS_PE_REL_NBR_FORMATTED. This variable contains the release number with dots (such as 4.18.109).

rhness commented 1 week ago

Please note that the date/time stamp for the "Executed:" label should be in CCYY-MM-DD hh:mm format.