Add Config Object (QzuiAddConfigObject) API

Important: Information for this topic supports the latest PTF levels for HTTP Server for i5/OS . It is recommended that you install the latest PTFs to upgrade to the latest level of the HTTP Server for i5/OS. Some of the topics documented here are not available prior to this update. See http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm Link outside Information Center for more information.
Note: This API is for HTTP Server (powered by Apache)
Required Parameter Group:
1 cfg Input Binary(4)
2 obj_type Input Binary(4)
3 key Input Char(*)
4 key_size Input Binary(4)
5 val Input Char(*)
6 val_size Input Binary(4)
7 place Input Binary(4)
8 where Input Binary(4)
9 object Output Binary(4)
10 errcode I/O Char(*)
Threadsafe: Yes

Use the QzuiAddConfigObject API to add scope or directive to the configuration. It may be placed relative to a directive or scope, at the end or beginning of the file, or at the beginning or end of a scope. A handle to the object is returned allowing directives to be added to it.

Authorities and locks

None.

Required parameter group

cfg
INPUT:BINARY(4)

Handle to the config.

obj_type
INPUT:BINARY(4)

Type of object to add (0 = directive, 1 = scope).

key
INPUT:CHAR(*)

Keyword of scope or directive to add.

key_size
INPUT:BINARY(4)

Size of key passed.

val
INPUT:CHAR(*)

Value for scope.

val_size
INPUT:BINARY(4)

Size of value.

place
INPUT:BINARY(4)

Placement directive (0 = at the end of the file, 1 = at start of file, 2 = after ″where″, 3 = before ″where″, 4 = at start of scope specified by ″where″, 5 = at end of scope specified by ″where″).

where
INPUT:BINARY(4)

Optional handle to scope or directive for scope placement.

object
OUTPUT:BINARY(4)

Handle of the object added.

errcode
I/O:CHAR(*)

Error information structure.

Error messages

CPF3C17 E
Error occurred with input data parameter.
CPF3C19 E
Error occurred with receiver variable specified.
CPF3C1D E
Input variable length in parameter &1 not valid.
CPF3CF1 E
Error code parameter not valid.
HTPA001 E
Input parameter &1 not valid.
HTPA106 E
Input configuration handle not valid.
HTPA121 E
Object handle in parameter &1 not valid.
HTPA122 E
Object handle in parameter &1 not a scope.
HTPA124 E
Combination of insertion position and relative object not valid.
HTPA126 E
Keyword &1 not valid for object type.