Set Lock Flight Recorder (QWTSETLF) API

Required Parameter:

Set value

Input

Char(4)

Optional Parameter:

Error code

I/O

Char(*)

Default Public Authority: *EXCLUDE

Threadsafe: No

The Set Lock Flight Recorder (QWTSETLF) API turns the lock flight recorder on and off. The value of *ON is passed to the program to turn the lock flight recorder on, and *OFF is passed to turn the lock flight recorder off.

When the lock flight recorder is turned on, the system will begin logging successful lock operations on devices in the lock flight recorder for the device being locked.

This API should be used only when recommended by your IBM^® service representative.

Authorities and Locks

None.

Required Parameter

Set value

INPUT; CHAR(4)

The value passed to turn the lock flight recorder on or off. The valid values are:

*ON	Turn flight recorder on.
*OFF	Turn flight recorder off.

Optional Parameter

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.

Error Messages

Message ID	Error Message Text
CPF119B E	Value &1 specified for parameter is not valid.
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

[ Back to top | Miscellaneous APIs | APIs by category ]