Get Server Instance Names (QzuiGetInstanceNames) API
The QzuiGetInstanceNames() API allows you to obtain a list of IBM® HTTP Server for i instance names.
| 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 | |||
Authorities and locks
- *EXECUTE authority to the QUSRSYS library
- *OBJOPR and *READ authority to the QUSRSYS/QATMHINSTC file
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 the QzuiGetInstanceNames() API.
| Offset | Type | Field |
|---|---|---|
| 0 | Char(10) | Instance name |
| 10 | Char(2) | Reserved |
| 12 | Binary(4) | Running status |
| 16 | Binary(4) | Instance type 1 = HTTP Server |
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.