Start Problem Log Services (QsxStartProblemLogServices) API

Required Parameter Group:

1	Handle	Output	Binary(4)
2	Error code	I/O	Char(*)

  Default Public Authority: *USE

  Service Program: QSXSRVPL

  Threadsafe: No

The Start Problem Log Services (QsxStartProblemLogServices) API sets up the environment to allow creating, changing, deleting, and retrieving problem log entries. The procedure performs the following functions:

Opens the problem log files for update.
Starts commitment control
Returns a handle that must be supplied as a parameter by the using problem log APIs.

Only one instance of the problem log services may be started from a job. Attempting to start multiple instances of the problem log services will result in an error. Attempting to use one of the problem log APIs without the proper handle will also result in an error.

Authorities and Locks

API Public Authority: *USE

Required Parameter

Handle: OUTPUT; BINARY(4)
This provides a means of associating the problem log services that are started with subsequent problem log activities that will be performed.
Error code: I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

Message ID	Error Message Text
CPF3C1E E	Required parameter &1 omitted.
CPF3C90 E	Literal value cannot be changed.
CPF3CF1 E	Error code parameter not valid.
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPF7A86 E	Problem log services already started.
CPF9821 E	Not authorized to program &1 in library &2.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.
CPFA320 E	Pointer parameter is null.

API introduced: V3R1

[ Back to top | Problem Management APIs | APIs by category ]