Retrieve the next Group in the Group List(QzhbGetNextGroup) API
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
Use the QzhbGetNextGroup API to retrieve the next group from an in-memory
group list.
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 QzhbAddGroupToListAPI, that
returns the group immediately following this group. Ahandle 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.
68 WebProgramming Guide V4R5