# PXFGETGRGID (L*X, M*X)

POSIX Subroutine: Gets group information for the specified GID.

## Module

USE IFPOSIX

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.

## Example

See the example in PXFGETGROUPS

Parent topic: POSIX* Library Routines

## See Also

PXFSTRUCTCREATE