Required parameter group
path
INPUT:BINARY(4)
The path to the group file to be created in the Integrated File System. Youcan
specify an absolute or relative path to the working directory.This path should
be in the job CCSID.
path_len
INPUT:BINARY(4)
The length of the path string.
grplist
OUTPUT:BINARY(4)
The variable that receives the integer handle of the newly created empty group
list. Subsequent API calls use this handle.
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.
HTPA202 E
Unable to update group file &1.
HTPA208 E
Group file &1 already exists.
Read a Group File into Memory (QzhbOpenGroupList) API
Required Parameter Group:
1 path Input Binary(4)
2 path_len Input Binary(4)
3 writelock Input Binary(4)
4 grplist Output Binary(4)
5 errcode I/O Char(*)
Threadsafe: Yes
Use the QzhbOpenGroupList API to read in an existing group file, and return a
handle to an in-memory version of the file. See “Free Group File from Memory
(QzhbCloseGroupList) API”on page 67 for information about freeing memory and
optionally writing the group list information out.
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
Chapter2. Application Programming Interfaces 65