BPX4TSP (tcsetpgrp) example

The following code sets the controlling terminal's foreground process group to a new value. For this example to work, STDIN must be associated with the controlling terminal. For the callable service, see tcsetpgrp (BPX1TSP, BPX4TSP) — Set the foreground process group ID. AMODE 31 callers use BPX1TSP (tcsetpgrp) example.

                                              
       MVC   PROCID,..             Process group ID set by setpgrp      
         SPACE ,                                                        
         CALL  BPX4TSP,              Set foreground process group ID   +
               (=A(STDIN_FILENO),    Input: File descriptor            +
               PROCID,               Input: Foreground process group ID+
               RETVAL,               Return value: 0 or -1             +
               RETCODE,              Return code                       +
               RSNCODE),             Reason code                       +
               MF=(E,PLIST)          ----------------------------------