Use this command to start the selective file dump (SFD) debugging
tool. The SFD debugging tool writes the contents of specified file
records to the real-time tape.
Use the SFD debugging tool and the selective file trace (SFT) debugging
tool (also referred to as the selective file dump and trace (SFDT) debugging
tools) to locate file-related errors during online operations or while testing
under the control of the program test vehicle (PTV) utility.
Requirements and Restrictions
None.
Format
- A
- indicates that the file address is expressed as a file address reference
format (FARF) record type. Chained records will contain a FARF file
address in the forward chain field.
- N
- indicates that the file address is expressed as a file address compute
(FACE) program record type and ordinal number. Chained records will
contain a FACE-type ordinal in the forward chain field.
- S
- indicates that the file address is a FACE record type and ordinal
number. Chained records will contain a FARF file address in the forward
chain field.
- option
- is one of the following dump options:
- 2
- dumps chained records that have a standard header for 4-byte file
addresses.
- 3
- does not dump chained records.
- 8
- dumps chained records that have a standard header for 8-byte file
addresses.
- hexfileaddr
- is the file address of the record specified as an 8- or 16-digit
hexadecimal value. You can specify up to 82 file addresses.
- rectype*firstord-lastord*
- is the file address specified as one or more sets of records. Each
set consists of a series of file records of one FACE record type with
contiguous FACE ordinal numbers, specified with a 19- or 39-byte field,
where:
- rectype
- is the FACE record type indicator in hexadecimal characters.
- firstord
- is the 6- or 16-digit hexadecimal ordinal number of the first record in
the set.
- lastord
- is the 6- or 16-digit hexadecimal ordinal number of the last record in the
set.
You can specify up to 43 fields with one command. The number of
records specified in a single command cannot exceed 420.
Additional Information
All output from the SFDT debugging tools is written to the real-time tape
(RTL/RTA). SFD and SFT output may be interspersed with other test
or control program output also on the real-time tape. Use the offline
diagnostic output formatter (DOF) utility to process the SFDT output.
Examples
The following example writes the contents of the specified file record to
the real-time tape.
+--------------------------------------------------------------------------------+
|User: ZSELD A2 184800B3 |
| |
|System: SFD COMPLETE |
+--------------------------------------------------------------------------------+
Related Information