Change Apache Server Instance Data (QzuiChangeInstanceData) API
In the IBM® HTTP Server for i, use the QzuiChangeInstanceData() API to change the information contained in the instance file. The information is retrieved in the format specified by INSD0110.
| Required Parameter Group: | |||
| 1 | name | Input | Char(10) |
| 2 | idata | Input | Char(*) |
| 3 | idata_size | Input | Binary(4) |
| 4 | format | Input | Char(8) |
| 5 | errcode | I/O | Char(*) |
| Threadsafe: Yes | |||
Authorities and locks
- *EXECUTE authority to the QUSRSYS library
- *OBJOPR, *OBJMGT, *ADD, and *DLT authority to the QUSRSYS/QATMHINSTC file
Required parameter group
- name
- INPUT:CHAR(10)
Name of the server instance from which data is retrieved.
- idata
- INPUT:CHAR(*)
Buffer in format INSD0110 containing instance file data.
- idata_size
- INPUT:BINARY(4)
Length of instance data passed.
- format
- INPUT:CHAR(8)
Format of the instance data (INSD0110).
- errcode
- I/O:CHAR(*)
Error information structure.
INSD0110 format
This data format is used by the QzuiCreateInstance(), QzuiGetInstanceData(), and QzuiChangeInstanceData() APIs.
| Offset | Type | Field |
|---|---|---|
| 0 | Char(10) | Autostart |
| 12 | Binary(4) | Threads |
| 16 | Binary(4) | CCSID |
| 20 | Char(10) | Outgoing table name |
| 30 | Char(10) | Outgoing table library |
| 40 | Char(10) | Incoming table name |
| 50 | Char(10) | Incoming table library |
| 60 | Char(512) | Config file (full path) |
| 572 | Char(512) | Server root path |
Field description
Note: In the descriptions below, *GLOBAL indicates that the global
server parameter value for this field is used by the instance, and
*CFG indicates that the value from the named configuration file is
used. All character strings are padded with blanks as necessary, and
are NOT null terminated.
- Autostart
- Indicates if the instance starts automatically. It is a 10 character string that contains *NO, *YES, or *GLOBAL.
- Threads
- The number of threads to use for this instance. It is an integer from 0 to 999, where 0 means the *CFG value.
- CCSID
- The character set to be used by the instance. It is an integer from 0 to 65533, where 0 means *GLOBAL.
- Outgoing table name
- The name of the table object to use as the EBCDIC to ASCII conversion table for outgoing data. It is a 10 character name or *GLOBAL.
- Outgoing table library
- The library containing the EBCDIC to ASCII table. This field is blank if the outgoing table name is *GLOBAL.
- Incoming table name
- The name of the table object to use as the ASCII to EBCDIC conversion table for incoming data. It is a 10 character name or *GLOBAL.
- Incoming table library
- The library containing the ASCII to EBCDIC table. This field is blank if the incoming table name is *GLOBAL.
- Config file (full path)
- The path to the server instance configuration file.
- Server root path
- The path to the server root.
Error messages
- CPF3C17 E
- Error occurred with input data parameter.
- CPF3C1D E
- Input variable length in parameter &1 not valid. CPF3C21 E
- CPF3C21 E
- Format name &1 not valid.
- CPF3CF1 E
- Error code parameter not valid.
- CPF9822 E
- Not authorized to file &1 in library &2.
- CPFB602 E
- Cannot open file.
- HTPA001 E
- Input parameter &1 not valid.
- HTPA101 E
- Server instance &1 not found or is unreadable.
- HTPA102 E
- Unable to update server instance &1.
- HTPA103 E
- Value in field &1 of the instance data structure not valid.
- HTPA127 E
- Server instance &1 is not a HTTP Server type instance.