Get Instance Type (QzuiGetInstanceType) API

The QzuiGetInstanceType() API allows you to obtain the type of an IBM® HTTP Server for i instance. If the specified instance is not a valid instance, a –1 is returned.

Required Parameter Group:
1 name Input Char(10)
2 itype Output Binary(4)
3 errcode I/O Char(*)
Threadsafe: Yes

Authorities and locks

  • *EXECUTE authority to the QUSRSYS library
  • *OBJOPR and *READ authority to the QUSRSYS/QATMHINSTC file

Required parameter group

name
INPUT:CHAR(10)

The name of the instance.

itype
OUTPUT:BINARY(4)

The type of instance (-1 = Invalid, 1 = Apache)

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.
HTPA101 E
Server instance &1 not found or is unreadable.