getegid (BPX1GEG, BPX4GEG) — Get the effective group ID
Function
The getegid callable service gets the effective group ID (GID) of the calling process.
Requirements
| Operation | Environment |
|---|---|
| Authorization: | Supervisor state or problem state, any PSW key |
| Dispatchable unit mode: | Task |
| Cross memory mode: | PASN = HASN |
| AMODE (BPX1GEG): | 31-bit |
| AMODE (BPX4GEG): | 64-bit |
| ASC mode: | Primary mode |
| Interrupt status: | Enabled for interrupts |
| Locks: | Unlocked |
| Control parameters: | All parameters must be addressable by the caller and in the primary address space. |
Format
|
AMODE 64 callers use BPX4GEG with the same parameter.
Parameters
- Effective_group_ID
- Returned parameter
- Type:
- Integer
- Length:
- Fullword
The name of a fullword to which the getegid service returns the effective group ID of the calling process.
Usage notes
If this service fails, the process ends abnormally.
Related services
- geteuid (BPX1GEU, BPX4GEU) — Get the effective user ID
- getgid (BPX1GID, BPX4GID) — Get the real group ID
- getuid (BPX1GUI, BPX4GUI) — Get the real user ID
- setegid (BPX1SEG, BPX4SEG) — Set the effective group ID
- seteuid (BPX1SEU, BPX4SEU) — Set the effective user ID
- setgid (BPX1SGI, BPX4SGI) — Set the group ID
- setuid (BPX1SUI, BPX4SUI) — Set user IDs
Characteristics and restrictions
There are no restrictions on the use of the getegid service.
Examples
For an example using this callable service, see BPX1GEG (getegid) example.