pgm_proc_wait()

PGM_$PROC_WAIT                    Domain/OS                     PGM_$PROC_WAIT


NAME
     pgm_$proc_wait - wait on a process

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/pgm.h>

     void pgm_$proc_wait(
          pgm_$proc &process_handle,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/pgm.ins.pas';

     procedure pgm_$proc_wait(
          in process_handle: pgm_$proc;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/pgm.ins.ftn'

           integer*4 process_handle, status

           call pgm_$proc_wait(process_handle, status)

DESCRIPTION
     Pgm_$proc_wait suspends the calling process until the process on
     process_handle terminates.  Pgm_$proc_wait returns with the completion
     status of the process waited for in status.

     Using pgm_invoke to invoke a program in default mode and then calling
     pgm_$proc_wait is effectively the same as invoking a program in wait
     mode.

     process_handle
          The process handle of the process to wait for.  A process cannot
          wait on a program invoked in background mode.

     status
          The child process completion status.
Museum
