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

Use the QzuiGetInstanceData API to retrieve the data from a specified server instance file. The data information is returned in the format specified by INSD0110. See INSD0110 format for more information.

Authorities and locks

Required parameter group

name
INPUT:CHAR(10)

Name of the server instance from which data is retrieved.

buf
OUTPUT:CHAR(*)

Buffer in format INSD0110 containing instance file data.

buf_size
INPUT:BINARY(4)

Length of instance data buffer.

format
INPUT:CHAR(8)

Format of the instance data (INSD0110).

See INSD0110 format for more information.

buf_actlen
OUTPUT:BINARY(4)

Actual length of instance data returned.

running
OUTPUT:BINARY(4)

Indicates if the instance is currently running (1 = running).

errcode
I/O:CHAR(*)

Error information structure.

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.
CPF3CF1 E
Error code parameter not valid.
HTPA001 E
Input parameter &1 not valid.
HTPA101 E
Server instance &1 not found or is unreadable.
HTPA127 E
Server instance &1 is not a HTTP Server (powered by Apache) type instance.