Add Config Object (QzuiAddConfigObject) API
In the IBM® HTTP Server for i, 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.
| 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 | |||
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.