Create Apache Server Instance (QzuiCreateInstance) 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(10)
2	idata	Input	Char(*)
3	idata_size	Input	Binary(4)
4	format	Input	Char(8)
5	errcode	I/O	Char(*)
Threadsafe: Yes

Use the QzuiCreateInstance API to create a new server instance file for the parameters passed to it.

Authorities and locks

*EXECUTE and *ADD authority to the QUSRSYS library
*OBJOPR, *ADD, *DLT, and either *OBJMGT or *OBJALTER authority to the QUSRSYS/QATMHINSTC file

Required parameter group

name: INPUT:CHAR(10)
The name of the instance to be created.

idata: INPUT:CHAR(*)
The instance data.

idata_size: INPUT:BINARY(4)
The length of the instance data.

format

INPUT:CHAR(8)

The format of the instance data (INSD0110).

See INSD0110 format for more information.

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

Error messages

CPF3C17 E: Error occurred with input data parameter.

CPF3C19 E: Error occurred with receiver variable specified.

CPF3CF1 E: Error code parameter not valid.

CPF9822 E: Not authorized to file &1 in library &2.

HTPA001 E: Input parameter &1 not valid.

HTPA102 E: Unable to update server instance &1.

HTPA103 E: Value in field &1 of the instance data structure not valid.