When 1 is specified in the write parameter, the directives are written to the
configuration file before being freed from memory.If a write fails, the memory
is not freed, the handle is still valid, and error information is returned.
When 0 is specified, the dirrectives are not written, but the object lock is
released if it was obtained at QzhbOpenConfig time.
Note: In order to specify a write of 1, you must have previously specified a
writelock of 1 on the QzhbOpenConfig API.
errcode
I/O:CHAR(*)
The structure in which to return error information.
Error messages
CPF3CF1 E
Error code parameter not valid.
HTPA001 E
Input parameter &1 not valid.
HTPA105 E
Unable to update server configuration &1.
HTPA106 E
Input configuration handle not valid.
Search for a Main Directive (QzhbFindDirective) API
Required Parameter Group:
1 cfg Input Binary(4)
2 value Input Char(*)
3 value_len Input Binary(4)
4 startdir Input Binary(4)
5 num Input Binary(4)
6 case_sens Input Binary(4)
7 dir Output Binary(4)
8 errcode I/O Char(*)
Threadsafe: Yes
Use the QzhbFindDirective API to find a main directive in a configuration file
previously opened by a call to the QzhbOpenConfig API. If a directive is found, a
handle to the directive is returned and can be used on subsequent calls to other
APIs.
Authorities and locks
None.
Required parameter group
cfg
INPUT:BINARY(4)
The handle returned by a call to the QzhbOpenConfig API.
value
INPUT:BINARY(4)
Chapter2. Application Programming Interfaces 47