Report message example

A report message: The following example shows a report message text as it would appear in the message buffer.

CHECK(IBMRACF,RACF_SENSITIVE_RESOURCES)                             
START TIME: 06/01/2005 12:50:57.749916                              
CHECK DATE: 20040703  CHECK SEVERITY: HIGH                          
                                                                    
                          APF Dataset Report                        
                                                                    
S Data Set Name                           Vol    UACC Warn ID*  User
- --------------------------------------- ------ ---- ---- ---- ----
E SYS1.LINKLIB                            PETPB1 Updt No   ****     
E SYS1.SVCLIB                             PETPB1 Updt No   ****     
E SYS1.SIEALNKE                           PETPB1 Updt No   ****     
                             .
                             .
                             .
  TCPIP.V3R2M0.SEZALINK                   D83AE8 Read No   ****

This example shows that:

The report actually consists of four messages, IRRH255R through IRRH258R. However, unless you run the check in debug mode and use SDSF to display messages, the message identifier is not displayed for report messages.
The first three messages, IRRH255R through IRRH257R contain the report title lines, with the report name supplied by a variable.
The fourth message, IRRH258R, contains the report data as a series of variables.
The same message explanation tags are required in a report message as they are in an exception message, although they do not show up in the message buffer.

The following example shows how we coded the message:

<msglist xreftext="csectname" rules="1">
<!-- ============================================================= -->          
<!--  Message:    IRRH255R                                         -->          
<!-- ============================================================= -->          
<msg class="report">                                                            
<msgnum xreftext="255">IRRH255R</msgnum>                                        
<msgtext>                                                                       
<lines class="center">                                                          
                                                                            
<mv>report-name</mv>Report                                                      
                                                                            
</lines>                                                                        
</msgtext>                                                                      
<msgitem class="explanation"><p>                                                
Header line for the RACF_SENSITIVE_RESOURCES check.                             
</p></msgitem>                                                                  
<msgitem class="sysact"><p>                                                     
Processing continues.                                                           
</p></msgitem>                                                                  
<msgitem class="oresp"><p>                                                      
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="spresp"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="probd"><p>                                                      
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="source"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="refdoc"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="automation"><p>                                                 
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="module"><p>                                                     
IRRHCR00                                                                        
</p></msgitem>                                                                  
<msgitem class="rcode"><p>                                                      
</p></msgitem>                                                                  
<msgitem class="dcode"><p>                                                      
</p></msgitem>                                                                  
</msg>                                                                          
<!-- ============================================================= -->          
<!--  Message:    IRRH256R                                         -->          
<!-- ============================================================= -->          
<msg class="report">                                                            
<msgnum xreftext="256">IRRH256R</msgnum>                                        
<msgtext>                                                                       
S Data Set Name                           Vol    UACC Warn ID*  User            
</msgtext>                                                                      
<msgitem class="explanation"><p>                                                
Header line for the RACF_SENSITIVE_RESOURCES check                              
</p></msgitem>                                                                  
<msgitem class="sysact"><p>                                                     
Processing continues.                                                           
</p></msgitem>                                                                  
<msgitem class="oresp"><p>                                                      
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="spresp"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="probd"><p>                                                      
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="source"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="refdoc"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="automation"><p>                                                 
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="module"><p>                                                     
IRRHCR00                                                                        
</p></msgitem>                                                                  
<msgitem class="rcode"><p>                                                      
</p></msgitem>                                                                  
<msgitem class="dcode"><p>                                                      
</p></msgitem>                                                                  
</msg>                                                                          
<!-- ============================================================= -->          
<!--  Message:    IRRH257R                                         -->          
<!-- ============================================================= -->          
<msg class="report">                                                            
<msgnum xreftext="257">IRRH257R</msgnum>                                        
<msgtext>                                                                       
- --------------------------------------- ------ ---- ---- ---- ----            
</msgtext>                                                                      
<msgitem class="explanation"><p>                                                
Data set header line for the RACF_SENSITIVE_RESOURCES check                     
</p></msgitem>                                                                  
<msgitem class="sysact"><p>                                                     
Processing continues.                                                           
</p></msgitem>                                                                  
<msgitem class="oresp"><p>                                                      
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="spresp"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="probd"><p>                                                      
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="source"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="refdoc"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="automation"><p>                                                 
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="module"><p>                                                     
IRRHCR00                                                                        
</p></msgitem>                                                                  
<msgitem class="rcode"><p>                                                      
</p></msgitem>                                                                  
<msgitem class="dcode"><p>                                                      
</p></msgitem>                                                                  
</msg>                                                                          
<!-- ============================================================= -->          
<!--  Message:    IRRH258R                                         -->          
<!-- ============================================================= -->          
<msg class="report">                                                            
<msgnum xreftext="258">IRRH258R</msgnum>                                        
<msgtext>                                                                       
<mv>status</mv>                                                                 
<mv>data-set-name</mv>                                                          
<mv>volume</mv>                                                                 
<mv>UACC-access</mv>                                                            
<mv>idSplat-access</mv>                                                         
<mv>warning</mv>                                                                
<mv>userId-access</mv>                                                          
</msgtext>                                                                      
<msgitem class="explanation"><p>                                                
Data line for data set analysis report.                                         
</p></msgitem>                                                                  
<msgitem class="sysact"><p>                                                     
Processing continues.                                                           
</p></msgitem>                                                                  
<msgitem class="oresp"><p>                                                      
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="spresp"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="probd"><p>                                                      
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="source"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="refdoc"><p>                                                     
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="automation"><p>                                                 
None.                                                                           
</p></msgitem>                                                                  
<msgitem class="module"><p>                                                     
IRRHCR00                                                                        
</p></msgitem>                                                                  
<msgitem class="rcode"><p>                                                      
</p></msgitem>                                                                  
<msgitem class="dcode"><p>                                                      
</p></msgitem>                                                                  
</msg>
     . 
     .
     .
</msglist>

A report message in debug mode: If you are running in debug mode and using SDSF, the report message above displays with the message number on every line:

HZS1098I   CHECK(IBMRACF,RACF_SENSITIVE_RESOURCES)                             
HZS1090I   START TIME: 06/01/2005 13:29:16.860783                              
HZS1095I   CHECK DATE: 20040703  CHECK SEVERITY: HIGH                          
IRRH255R                                                                       
IRRH255R                             APF Dataset Report                        
IRRH255R                                                                       
IRRH256R   S Data Set Name                           Vol    UACC Warn ID*  User
IRRH257R   - --------------------------------------- ------ ---- ---- ---- ----
IRRH258R   E SYS1.LINKLIB                            PETPB1 Updt No   ****     
IRRH258R   E SYS1.SVCLIB                             PETPB1 Updt No   ****

The message number is not displayed on every line if you are looking at the report message in the message buffer or with the print command. That is only a feature of SDSF.