End View Creation (QteEndViewCreation) API

Required Parameter Group:

Error code

I/O

Char(*)

  Default Public Authority: *USE

  Service Program: QTECRTVS

  Threadsafe: No

The End View Creation (QteEndViewCreation) API is used by a processor when all debug data views have been created. At that time, views are written to the output IBM i^® library file member or IBM i integrated file system file (if any) specified on the Start View Creation API. This End View Creation API should not be called if the view is not complete (for example, if a compiler that is creating the view fails the compilation).

If the output file specified on the Start View Creation API is an IBM i integrated file system file, the End View Creation API will create a debug view integrated file system file. The debug view integrated file system file will be used to hold debug view information. The debug view integrated file system file will have the same name as the integrated file system output file with the extension of ".dbgvwinfo" appended at the end.

Authorities

Authority Required

The authorities required are dependent on the output file specified on the Start View Creation API.

*OBJOPR + *ADD authority to the output file
*EXECUTE authority to the output file library
*X authority to each directory in the path of the debug view file
*WX authority to the parent directory of the debug view file

Required Parameter

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
CPF3CF1 E	Error code parameter not valid.
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPF9546 E	View information damaged.
CPF9549 E	Error addressing API parameter.
CPF9556 E	API not valid at this time.
CPF955D E	View data overflow. All debug data lost.
CPF9803 E	Cannot allocate object &2 in library &3.
CPF9809 E	Library &1 cannot be accessed.
CPF9810 E	Library &1 not found.
CPF9815 E	Member &5 file &2 in library &3 not found.
CPF9820 E	Not authorized to use library &1.
CPF9822 E	Not authorized to file &1 in library &2.
CPFA0D4 E	File system error occurred. Error number &1.

API introduced: V3R1

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