Close Apache Config File (QzuiCloseConfig) API

In the IBM® HTTP Server for i, 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 file name is specified, the configuration is written to that file, otherwise it is written to the original file.

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

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.