gtpp1m17Program Development Support Reference

Selective File Dump (SFD) Debugging Tool

The content of records collected by the selective file dump (SFD) debugging tool on the real-time log tape are formatted for printing by the diagnostic output formatter (DOF) utility. The DOF utility writes the START OF SELECTIVE DUMP heading at the beginning of output from each selective file dump request and the trailer END OF SELECTIVE DUMP at the end of the particular dump request output. The DOF utility identifies every printed file record with the SELD RECORD heading or the SELD CHAINED RECORD heading and the record file address.

Selective File Trace (SFT) Debugging Tool

The DOF utility formats and prints the file address and final contents of each ZTRCE-specified record that was updated during the defined trace period. Any intermediate updates that occurred are not recorded. DOF writes the START OF SELECTIVE TRCE heading and the trailer END OF SELECTIVE TRCE at the start and end of each trace period's output. This process is repeated for each trace period recorded on the real-time tape.

Optional Logging Function

If you requested the optional logging function, the DOF utility prints the logged information after the last selective dump or selective trace file in each test unit has been printed. The start of a log for a test unit is identified by the START OF LOGGED FILE ADDRESSES heading. The trailer, END OF LOGGED FILE ADDRESSES, marks the end of the log for that test unit. If multiple ZTRCE commands with the log function active are entered, each pair of ZTRCE and ZTHLT commands would produce a separate log.

Keyboard Lock

When the DOF utility is processing output messages for a 3270 terminal and the output message locks the keyboard, then the DOF utility expects an additional output message to unlock the keyboard. You can use the screen reset indicator in the RUNID card to handle keyboard lock conditions during tests.

Position 17 determines what action the DOF utility takes when keyboard lock occurs during package tests. If position 17 on the RUNID is blank, the DOF utility assumes the CLEAR key was used and assumes the current screen is complete. The current screen is printed and the area cleared to prepare for the next output message. If position 17 is R, then the DOF utility assumes the RESET key was used and does not assume the current screen is complete. The RESET option is always in effect when keyboard lock occurs during system tests.