Open Apache Config File (QzuiOpenConfig) 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	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

Use the QzuiOpenConfig API to cause the configuration file specified to be read into memory and a handle is returned. This handle is used in subsequent API calls to manipulate directives and scopes within the file.

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.