Retrieve the next Group in the Group List (QzhbGetNextGroup) API
In the IBM® HTTP Server for i, use the QzhbGetNextGroup API to retrieve the next group from an in-memory group list.
| Required Parameter Group: | |||
| 1 | grplist | Input | Binary(4) |
| 2 | prev_grp | Input | Binary(4) |
| 3 | grp | Output | Binary(4) |
| 4 | 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.
- prev_grp
- INPUT:BINARY(4)
The group handle returned from a call to the QzhbGetNextGroup(), QzhbGetNextGroup(), QzhbFindGroupInList(), or QzhbAddGroupToList() API, that returns the group immediately following this group. A handle of 0 returns the first group in the group list.
- grp
- OUTPUT:BINARY(4)
The group name handle returned if the next group is found in the list. If no next group exists, then error HTPA206 is returned.
- 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.
- HTPA203 E
- Input group list handle in parameter &1 not valid.
- HTPA204 E
- Input group handle in parameter &1 not valid.
- HTPA206 E
- Group file &1 not found in group list.