Close Apache Config File (QzuiCloseConfig) 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	write	Input	Binary(4)
3	fname	Input	Char(*)
4	fname_size	Input	Binary(4)
5	errcode	I/O	Char(*)
Threadsafe: Yes

Use the QzuiCloseConfig API to optionally write the memory copy of the configuration out to the file and then free the memory copy. If the filename is specified, the configuration is written to that file, otherwise it is written to the original file.

Authorities and locks

If the file is closed without write, no authority is needed
*X authority to each directory in the path of the specified group file
*RW authority to the group file for a writelock value of 1

Required parameter group

cfg: INPUT:BINARY(4)
Handle to the config to be closed.

write: INPUT:BINARY(4)
Has the following values: 0 = no write, 1 = write.

fname: INPUT:CHAR(*)
Path and name of config file to be written (optional).

fname_size: INPUT:BINARY(4)
Length of file name ( 0 for no file name).

errcode: I/O:CHAR(*)
Error information structure.

Error messages

CPF3C17 E: Error occurred with input data parameter.

CPF3C1D E: Input variable length in a parameter &1 not valid.

CPF3CF1 E: Error code parameter not valid.

HTPA001 E: Input parameter &1 not valid.

HTPA120 E: Unable to update server configuration &1.