CPF3C1D E
Input variable length in parameter &1 not valid.
CPF3C21 E
Format name &1 not valid.
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.
Create a Server Instance (QzhbCreateInstance) API
Required Parameter Group:
1 name Input Char(10)
2 idata Input Void
3 idata_size Input Binary(4)
4 format Input Char(8)
5 errcode I/O Char(*)
Threadsafe: Yes
Use the QzhbCreateInstance API to create a new server instance. This API provides a
structure for input to all start-up data values to be set for a new server instance.
Use this API following a call to the QzhbGetInstanceData API to create an instance
based on an existing instance.
Authorities and locks
To invoke this API, the user must have the following authorities:
v*EXECUTE and *ADD authority to the QUSRSYS library
v*OBJOPR, *ADD, *DLT,and either *OBJMGT or *OBJALTER authority to the
QUSRSYS/QATMHINSTC file
Required parameter group
name
INPUT:CHAR(10)
The name for the new server instance you want to create. 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.
62 WebProgramming Guide V4R5