3 idata_size Input Binary(4)
4 format Input Char(8)
5 errcode I/O Char(*)
Threadsafe: Yes
Use the QzhbChangeInstanceData API to change the start-up data for a specific
server instance. This API provides a structure for input, even when not changing
values, to all start-up data values to be set for a server instance. This API is
typically used following a call to the QzhbGetInstanceData API, and after one or
more fields in the structure have been modified.
Authorities and locks
To invoke this API, the user must have the following authorities:
v*EXECUTE authority to the QUSRSYS library
v*OBJOPR, *OBJMGT, *ADD, and *DLTauthority to the
QUSRSYS/QATMHINSTC file
Required parameter group
name
INPUT:CHAR(10)
The server instance name. The name can be up to 10 characters long (padded
with blanks).
idata
INPUT:VOID
The buffer where the instance data is stored. The contents of the buffer is
defined by the format specifed by the format parameter. All fields in the idata
parameter must contain valid values.
idata_size
INPUT:BINARY(4)
The size of the idata structure. The minimum size is the length needed for the
INSD0100 format, 1104 bytes.
format
INPUT:CHAR(8)
The format of the data returned. The possible format names follow:
INSD0100
For information about the INSD0100 format, see “INSD0100 Format”on
page 59.
errcode
I/O:CHAR(*)
The structure in which to return error information.
Error messages
CPF3CF1 E
Error code parameter not valid.
Chapter2. Application Programming Interfaces 61