Change Apache Server Instance Data (QzuiChangeInstanceData) 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 idata Input Char(*)
3 idata_size Input Binary(4)
4 format Input Char(8)
5 errcode I/O Char(*)
Threadsafe: Yes

Use the QzuiChangeInstanceData API to change the information contained in the instance file. The idata information is retrieved in the format specified by INSD0110.

Authorities and locks

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 date.

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
10 Binary(4) Threads
14 Binary(4) CCSID
18 Char(10) Outgoing table name
28 Char(10) Outgoing table library
38 Char(10) Incoming table name
48 Char(10) Incoming table library
58 Char(512) Config file (full path)
570 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 (powered by Apache) type instance.