Add a new Group to the end of a Group List (QzhbAddGroupToList) API
In theIBM® HTTP Server for i, use the QzhbAddGroupToList() API to add a new group to an in-memory group list.
Required Parameter Group: | |||
1 | grplist | Input | Binary(4) |
2 | group | Input | Char(*) |
3 | group_len | Input | Binary(4) |
4 | grp | Output | Binary(4) |
5 | errcode | I/O | Char(*) |
Threadsafe: Yes |
Authorities and locks
None.
Required parameter group
- grplist
- INPUT:BINARY(4)
The group list handle returned from a call to the QzhbCreateGroupList() or QzhbOpenGroupList() API.
- group
- INPUT:CHAR(*)
The group name to add to the list.
- group_len
- INPUT:BINARY(4)
The length of the group name. The length must be greater than or equal to 1.
- grp
- OUTPUT:BINARY(4)
The handle of the newly created group, or the handle of an existing group if the named group already exists. Attempting to add a group that already exists is not considered an error by the system.
- errcode
- I/O:CHAR(*)
The structure in which to return error information.
Error messages
- CPF3CF1 E
- Error code parameter not valid.
- CPF3C1D E
- Input variable length in parameter &1 not valid.
- HTPA001 E
- Input parameter &1 not valid.
- HTPA203 E
- Input group list handle in parameter &1 not valid.