Open Apache Config File (QzuiOpenConfig) API
The QzuiOpenConfig() API allows you to read into memory an IBM® HTTP Server for i server configuration file. The handle that is returned by the QzuiOpenConfig() API is used in subsequent API calls to manipulate directives and scopes within the server configuration data.
| Required Parameter Group: | |||
| 1 | name | Input | Char(*) |
| 2 | namelength | Input | Binary(4) |
| 3 | writelock | Input | Binary(4) |
| 4 | cfg | Output | Binary(4) |
| 5 | errcode | I/O | Char(*) |
| Threadsafe: Yes | |||
Authorities and locks
- *X authority to each directory in the path of the specified group file
- *WX authority to the last directory in the path that will contain the group file path
Required parameter group
- name
- INPUT:CHAR(*)
File name (including path) to the configuration file to be opened.
- namelength
- INPUT:BINARY(4)
Length of the file name.
- writelock
- INPUT:BINARY(4)
Has the following values: 0 = no lock, 1 = exclusive write lock will be put on config file.
- cfg
- OUTPUT:BINARY(4)
Handle to the memory copy of the config file.
- 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.
- CPFB602 E
- Cannot open file.
- HTPA001 E
- Input parameter &1 not valid.
- HTPA104 E
- Server configuration not found or is unreadable.