Get Server Instance Names (QzuiGetInstanceNames) 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 buf Output Char(*)
2 buf_size Input Binary(4)
3 format Input Char(8)
4 buf_actlen Output Binary(4)
5 count Output Binary(4)
6 errcode I/O Char(*)
Threadsafe: Yes

Use the QzuiGetInstanceNames API to return a list of instance names, the type of instance and the running status of the instance.

Authorities and locks

Required parameter group

buf
OUTPUT:CHAR(*)

Buffer to hold instance names and running data.

buf_size
INPUT:BINARY(4)

Size of buffer passed.

format
INPUT:CHAR(8)

Format of instance name data (INSN0110).

buf_actlen
OUTPUT:BINARY(4)

Number of bytes of data placed in buf.

count
OUTPUT:BINARY(4)

Total number of instance names.

errcode
I/O:CHAR(*)

Error information structure.

INSN0110 format

This data format is used by QzuiGetInstanceNames HTTP Server (powered by Apache) API.

Offset Type Field
0 Char(10) Instance name
10 Char(2) Reserved
14 Binary(4) Running status
18 Binary(4) Instance type 1 = HTTP Server (powered by Apache)

Error messages

CPF3C17 E
Error occurred with input data parameter.
CPF3C19 E
Error occurred with receiver variable specified.
CPF3C1D E
Input variable length in parameter &1 not valid.
CPF3C21 E
Format name &1 not valid.
HTPA001 E
Input parameter &1 not valid.