#include <qsysetid.h> int qsysetgid(gid_t gid);Service Program Name: QSYSETIDS
If the thread has *ALLOBJ special authority, qsysetgid() sets the real, effective and saved groups to gid.
If the thread does not have *ALLOBJ special authority, but gid is equal to the real, effective or saved group IDs, the qsysetgid() function sets the effective group ID to gid. The real group and saved group IDs remain unchanged.
Any supplementary group IDs of the calling thread remain unchanged.
Job scoped locks with a lock state of *SHRRD are held on the user profiles associated with the real user ID, effective user ID, saved user ID, real group ID, effective group ID, saved group ID, and all of the supplemental groups.
This field must contain one of the following values:
If qsysetgid() is not successful, errno indicates one of the following errors.
Error condition | Additional information |
---|---|
[EAGAIN] |
User profile associated with the gid is locked. Try again. |
[EDAMAGE] |
The user profile associated with the gid or an internal system object is damaged. |
[EINVAL] |
The value of the gid argument is not valid. Following are possible reasons:
|
[ENOTSUP] |
Operation not supported. The current effective user profile specifies OWNER(*GRPPRF), but the group profile associated with this gid is not equal to the user profile's first group and the user's first group is not in the list of supplemental groups. |
[EPERM] |
Operation not permitted. Following are possible reasons:
|
[EUNKNOWN] |
An unknown error has occurred. Check the joblog for error messages. |
Top | UNIX-Type APIs | APIs by category |