The structure in which to return error information.
Error messages
CPF3CF1 E
Error code parameter not valid.
HTPA001 E
Input parameter &1 not valid.
CPF9802 E
Not authorized to object &2 &3.
Create a Configuration (QzhbCreateConfig) API
Required Parameter Group:
1 name Input Char(10)
2 basedname Input Char(10)
3 basedfile Input Char(8)
4 basedf_len Input Binary(4)
5 errcode I/O Char(*)
Threadsafe: Yes
Use the QzhbCreateConfig API to create a new configuration. Youcan create a new
configuration based on an existing configuration by passing in an existing
configuration name. You can also create an empty configuration file or a
configuration file that is based on a text file.
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/QATMHTTPC file
Required parameter group
name
INPUT:CHAR(10)
The configuration file name. The name can be up to 10 characters long
(padded with blanks).
basedname
INPUT:CHAR(10)
The name of an existing configuration file used to create a new configuration
file. The name can be up to 10 characters long (padded with blanks). To create
an empty configuration, pass a NULL (omit) for this parameter or pass all
blanks.
basedfile
INPUT:CHAR(8)
The path to the text file used to create the new configuration. This parameter is
omissable.
basedf_len
INPUT:BINARY(4)
Chapter2. Application Programming Interfaces 43