The save area trace report

The save area trace report is displayed in the first few pages of the formatted section of an SVC dump, immediately following the VRA diagnostic information report. This report is identified by the string ==Save Area trace.

The following sample shows a save area trace report.

The information in this report includes the register contents, module invocation sequence, and execution environments that lead up to the point of error. The save areas for the current failing agent execution block (EB) and all associated agent EBs are traced from the point of error and are displayed in order of invocation.

The address and content of each save area is displayed and identified by the name of the invoking module, as follows:

Save Area: module_name  service_level_identifier
           .... WD1 ...  HSA ...  LSA ...  
                RET ...  EPA ...   R0 ...
                R1  ...  R2  ...   R3 ...  
                R4  ...  R5  ...   R6 ...
                R7  ...  R8  ...   R9 ...  
                R10 ...  R11 ...  R12 ...
 

The module_name identifies the module responsible for obtaining the save area as reflected in the module entry point list (MEPL) at the time of error. The service_level_identifier is also obtained from the corresponding MEPL entry, and consists of the compilation date and the PTF number, which reflects the latest maintenance applied. As a first step in diagnosing errors, be sure that the PTF number is up-to-date. If no maintenance has been applied against this module, this field defaults to the function modification identifier (FMID). The SA identifies the address and contents of each word of the save area and is displayed by using the same format and register abbreviation conventions as defined by z/OS® SNAP. All save area data references reflect the primary address space at time of execution.

The report displays the current execution environment each time the current agent EB changed during processing. This information consists of the address of the associated EB, the z/OS job name that is associated with the home address space, the home address space identifier (HASID), the primary address space identifier (PASID), the agent EB z/OS execution mode (task control mode (TCB), or service request mode (SRB)).

The report also displays the contents of the register save area chains for the current failing agent EB, and all suspended agent EBs at time or error. The name of the control block from which the registers for the current agent EB were obtained is displayed, along with the current execution status of the agent EB at time of error. The control block and registers might be displayed twice; once to list the registers at the time the agent was suspended, and once to list the registers in the save area at the last time they were saved.

All register data references refer to the primary address space (PASID) associated with the currently active EB. Each time the primary address space changes during execution, the following information is displayed:

CHANGE of ADDRESS SPACE, NEW PASID=pasid

The save area trace can be terminated when a control block or data page is not found in the dump.

Figure 1. Save area trace report
==Save Area trace 
  ---------------                                                                                                   
  Note: Save Area may be broken at 00000000_7EDDC390, starting format right after this point                        
               Save Area: DSNXERST 12/06/02 14.31  + 013C EPA: DSNXLDBD 05/12/03 16.15  + 0000                      
                          00000000_7EDDCA50  WD1 00000000_7EDDCE14 HSA 00000000_7EDDC390 LSA 00000000_7EDDCBD8      
                                             RET 00000000_0830D5C4 EPA 00000000_083E7FD8  R0 00000000_7EDDCB94      
                                              R1 00000000_7EDDCB78  R2 00000000_060B2448  R3 00000000_7F4CD730      
                                              R4 00000000_060B28F0  R5 00000000_060B28F0  R6 00000000_060B8620      
                                              R7 00000000_00000140  R8 00000000_00000000  R9 00000000_00000000      
                                             R10 00000000_076130FE R11 00000000_076120FF R12 00000000_0830D488      
                                                                                                                    
                          Extension:   EB 00000000_060B8620   CT 00000000_7F4CD730 MSIB 00000000_00000000      00000
                                          00000000_00000000      00000000_00000000      00000000_00000000      .....
                                                                                                                    
                            Service: 7EDDC5A0 7EDDCD78 00000000 06066FB0 | =.E.=.........?. |                       
               Save Area: DSNXLDBD 05/12/03 16.15  + 0146 EPA: DSNWVCOL 03/19/03 15.27  + 0000                      
                    Note: This save area may be residual                                                            
                          00000000_7EDDCBD8  WD1 00000000_00000000 HSA 00000000_7EDDCA50 LSA 00000000_7EDDD8B0      
                                             RET 00000000_883E811E EPA 00000000_067484B8  R0 00000000_7EDDD568      
                                              R1 00000000_7EDDCE59  R2 00000000_060B2448  R3 00000000_083E800C      
                                              R4 00000000_060B28F0  R5 00000000_060B28F0  R6 00000000_060B8620      
                                              R7 00000000_00000162  R8 00000000_00000000  R9 00000000_00000000      
                                             R10 00000000_076130FE R11 00000000_076120FF R12 00000000_083E99F8      
                                                                                                                    
                          Extension:   EB 00000000_060B8620   CT 00000000_7F4CD730 MSIB 00000000_00000000      00000
                                          00000000_00000000      00000000_00000000      00000000_00000000      .....
                                                                                                                    
                            Service: 00000000 0000000C 00000000 7EDDD248 | ............=.K. |