| 1 | Qualified job name | Input | Char(26) |
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:
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.
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:
|
||
| 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. |
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')
| Message ID | Error Message Text |
|---|---|
| CPF1321 E | Job &1 user &2 job number &3 not found. |
| CPF1332 E | End of duplicate job names. |
| CPF222E E | &1 special authority is required. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C36 E | Number of parameters, &1, entered for this API was not valid. |
| CPF3C3B E | Value for parameter &2 for API &1 not valid. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPF8100 E | All CPF81xx messages could be returned. xx is from 01 to FF. |
| CPF9800 E | All CPF98xx messages could be signaled. xx is from 01 to FF. |