The summary dump (SUMDUMP) data access service (IEAVTFRD) allows your formatting routine to access the 31-bit portion of summary dump data contained in an SVC dump. IEAVTFRD is reenterable and can be invoked in 24- or 31-bit addressing mode.

Control is passed to IEAVTFRD with the CALL macro, using standard linkage conventions. Register 1 must contain the address of the exit parameter list. IEAVTFRD uses the ADPLCOM1 field of the exit parameter list during its processing. This word must be set to zero prior to the first invocation of IEAVTFRD, and must not be changed between invocations.

Summary dump records are sorted on the first invocation of IEAVTFRD. However, only one of the sorted records is returned for each call to IEAVTFRD. The records are returned in sorted address order.

You should invoke IEAVTFRD to read all of the available records, rather than stopping when a particular record has been read.

Storage obtained by IEAVTFRD is not freed until the end of the summary dump data is reached (return code 8 or greater). If all the records are not read, storage remains allocated. The system will free it at the end of the session or earlier, but it may impact other activities until this is done.

When IEAVTFRD returns control to your module, register 0 contains the address of a simulated summary dump record. (This is only feasible for summary dump data in the 31-bit portion of address spaces. Data outside the range is ignored.) Register 15 contains a return code. For nonzero return codes, IEAVTFRD prints an explanatory message in the dump output.

* Information in the SMWK is used to determine whether a summary dump was in progress at the time of a stand-alone dump. The RTCT is used to locate the SMWK.