user manual

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
HTPA101 E
Server instance &1 not found or is unreadable.
HTPA102 E
Unable to update server instance &1.
CPF9802 E
Not authorized to object &2 &3.
Group file APIs
The group file APIs are in *SRVPGM QZHBCONF in library QHTTPSVR. ILE C
programs must include header file QHTTPSVR/H(QZHBCONF).
Create a new Group File (QzhbCreateGroupList) API
Required Parameter Group:
1 path Input Binary(4)
2 path_len Input Binary(4)
3 grplist Output Binary(4)
4 errcode I/O Char(*)
Threadsafe: Yes
Use the QzhbCreateGroupList API to create a new empty group file, and return a
handle to that empty in-memory version of the file. Normally this API would be
followed by calls to the QzhbAddGroupToList and QzhbAddUserToGroup APIs,
followed by the QzhbCloseGroupList API to write group information out.
Upon successful completion of this API, a new group list handle is returned. This
is a handle much like the one returned by the QzhbOpenGroupList API against an
already existing file, with a writelock argument of 1 (TRUE). After a call to the
QzhbCreateGroupList API the new file is left open for write access and the
QzhbCloseGroupList API can be invoked with a write argument of 1. For more
details about the writelock argument, see “Read a Group File into Memory
(QzhbOpenGroupList) API” on page 65.
Authorities and locks
To invoke this API, the user must have the following authorities:
v *X authority to each directory in the path of the specified group file
v *WX authority to the last directory in the path that will contain the group file
path
64 Web Programming Guide V4R5