Dump Flight Recorder (QWTDMPFR) API

The Dump Flight Recorder (QWTDMPFR) API dumps the contents of flight recorders for jobs that have them. A flight recorder is an object that stores trace information to record a history of what has happened in system programs. The flight recorder contains only information that helps to identify the flow of system programs and status information. The flight recorder for a job is a temporary object and is not available after an IPL.

The following types of jobs have flight recorders:

• Subsystem monitors
• System jobs

You can use the QWTDMPFR API to collect information for your IBM service representative. This API dumps the contents of job flight recorders to spooled files. You can then collect the files and submit them to your IBM service representative for debugging.

Authorities and Locks

None.

Optional Parameter Group

Qualified job name

INPUT; CHAR(26)

The name of the job whose flight recorder is to be dumped. The qualified job name has three parts:

Job name	CHAR(10). A specific job name or one of the following special values: *ACTIVE The flight recorders for all active system jobs and all active subsystem monitor jobs is dumped.
User name	CHAR(10). A specific user profile name, or blanks when the job name is a special value.
Job number	CHAR(6). A specific job number, or blanks when the job name is a special value.

Usage Notes

The QWTDMPFR API can be called with no parameters. This invocation dumps flight recorders for all active system jobs and all active subsystem monitor jobs. This is usually the best choice. You can use a Call Program (CALL) command from the Command Entry prompt.

CALL PGM(QSYS/QWTDMPFR)

The QWTDMPFR API can be called with one parameter. This allows you to dump the flight recorder for a single job. The job does not need to be active, as long as there has not been an IPL since the job was active. You can use a Call Program (CALL) command from the Command Entry prompt and use a job name parameter. The qualified job name must be specified in upper case characters because the command analyzer does not change character strings that appear between quote marks.

CALL PGM(QSYS/QWTDMPFR) PARM('QTAPARB   QSYS      001234')

Error Messages