# PXFSETPGID (L*X, M*X)

POSIX Subroutine: Sets the process group ID.

## Module

USE IFPOSIX

CALL PXFSETPGID (ipid,ipgid,ierror)

ipid | (Input) INTEGER(4). The process group ID to change.
ipgid | (Input) INTEGER(4). The new process group ID.
ierror | (Output) INTEGER(4). The error status.

If successful, ierror is set to zero; otherwise, an error code.

The PXFSETPGID subroutine sets the process group ID of the process specified by ipid to ipgid.

If ipid is zero, the process ID of the current process is used. If ipgid is zero, the process ID of the process specified by ipid is used.

PXFSETPGID can be used to move a process from one process group to another, but both process groups must be part of the same session. In this case, ipgid specifies an existing process group to be joined and the session ID of that group must match the session ID of the joining process.

Parent topic: POSIX* Library Routines