PXFGETGRGID (L*X, M*X)

POSIX Subroutine: Gets group information for the specified GID.

Module: USE IFPOSIX

Syntax

CALL PXFGETGRGID (jgid, jgroup, ierror)

jgid
(Input) INTEGER(4). The group ID to retrieve information about.


jgroup
(Input) INTEGER(4). A handle of structure group.


ierror
(Output) INTEGER(4). The error status.

If successful, ierror is not changed; otherwise, an error code.

The PXFGETGRGID subroutine stores the group information from /etc/group for the entry that matches the group GID jgid  in the structure associated with handle jgroup.

Note

To get a handle for an instance of the group structure, use PXFSTRUCTCREATE with the string 'group' for the structure name.

See Also

PXFSTRUCTCREATE

Example

See the example in PXFGETGROUPS