Create Apache Server Instance (QzuiCreateInstance) API

The QzuiCreateInstance() API allows users to create a new IBM® HTTP Server for i server instance.

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

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.