Dump Lock Flight Recorder (QWTDMPLF) API

Required Parameter Group:

Device name

Input

Char(10)

Optional Parameter Group:

Error code

I/O

Char(*)

Default Public Authority: *USE

Threadsafe: No

The Dump Lock Flight Recorder (QWTDMPLF) API dumps the following information into spooled files:

The contents of the lock flight recorder for the device specified in the parameter passed to the program
QSYSARB job log
QLUS job log
Job logs of the active jobs that have used the device as indicated in the lock flight recorder data
The history log (QHST)
Device description of the device
Controller description of the controller to which the device is attached
Line description of the line to which the controller is attached
A Work with Object Locks (WRKOBJLCK) listing for the device
A Work with Configuration Status (WRKCFGSTS) listing for the controller
The subsystem description of active subsystems that have touched the device
Associated internal system objects

You can use the QWTDMPLF API to collect information for your IBM^® service representative.

Authorities and Locks

Authority to use the API: To use this API, you must have service (*SERVICE) special authority

Device name: INPUT; CHAR(10)
The name of the device for which flight recorder information will be dumped.

Error code: I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.

Message ID	Error Message Text
CPF119C E	Value &1 specified for parameter is not valid.
CPF222E E	&1 special authority is required.
CPF3C90 E	Literal value cannot be changed.
CPF3CF1 E	Error code parameter not valid.
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.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V2R2