IBM AS/400E manual Server instance APIs, Outputvoid

Error messages

CPF3CF1 E

Error code parameter not valid.

CPF3C1D E

Input variable length in parameter &1 not valid.

HTPA001 E

Input parameter &1 not valid.

HTPA106 E

Input configuration handle not valid.

HTPA107 E

Input directive handle in parameter &1 not valid.

Server instance APIs

The server instance APIs are in *SRVPGM QZHBCONF in library QHTTPSVR. ILE C programs must include header file QHTTPSVR/H(QZHBCONF).

While each individual API lists its own authorities, the following authorities are needed to run all server instance APIs:

v*OBJOPR, *READ, *ADD, and *EXECUTE to the QUSRSYS library

v*READ, *ADD, *DELETE, *EXECUTE, *OBJOPR, *OBJEXIST, and either *OBJMGT or *OBJALTER to the QUSERSYS/QATMHINSTC file

v*READ, *ADD, *DELETE, *EXECUTE, *OBJOPR, *OBJEXIST, and either *OBJMGT or *OBJALTER to the QUSERSYS/QATMHINSTA file

Note: The QUSERSYS/QATMINSTA file is the administration (ADMIN) server instance file.

Retrieve a list of all Server Instances (QzhbGetInstanceNames) API

Required Parameter Group:
1	buf	Output	Void
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 QzhbGetInstanceNames API to retrieve a list of all server instance names defined on your AS/400.

Authorities and locks

To invoke this API, the user must have the following authorities:

v*EXECUTE authority to the QUSRSYS library

v*OBJOPR and *READ authority to the QUSRSYS/QATMHINSTC file

Required parameter group

buf

OUTPUT:VOID

56Web Programming Guide V4R5