Get Apache Server Instance Data (QzuiGetInstanceData) API
The QzuiGetInstanceData() API allows you to retrieve configuration data from a specified IBM® HTTP Server for i server instance file.
| 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 | |||
The data information is returned in the format specified by INSD0110. See INSD0110 format for more information.
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)
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 type instance.