pgm_get_puid(A)

PGM_$GET_PUID                     Domain/OS                      PGM_$GET_PUID


NAME
     pgm_$get_puid - get a process UID

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

     void pgm_$get_puid(
          pgm_$proc &process_handle,
          uid_$t *process_uid,
          status_$t *status)

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

     procedure pgm_$get_puid(
          in process_handle: pgm_$proc;
          out process_uid: uid_$t;
          out status: status_$t)

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

           integer*4 process_handle, process_uid(2), status

           call pgm_$get_puid(process_handle, process_uid, status)

DESCRIPTION
     Pgm_$get_puid supplies the process UID (Unique Identifier) of the process
     on process_handle.

     process_handle
          A process handle for a child process.  A process handle is not valid
          if the program was invoked in background mode.

     process_uid
          The process UID of the process on process_handle.

     status
          The completion status.
Museum
