pad_$edit_wait

PAD_$EDIT_WAIT                    Domain/OS                     PAD_$EDIT_WAIT


NAME
     pad_$edit_wait - wait until an edit window closes

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

     void pad_$edit_wait(
          ios_$id_t &stream_id,
          status_$t *status)

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

     procedure pad_$edit_wait(
          in stream_id: ios_$id_t;
          out status: status_$t);

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

           integer*4 status
           integer*2 stream_id

           call pad_$edit_wait(stream_id, status)

DESCRIPTION
     Pad_$edit_wait suspends program execution until the edit pad specified by
     stream_id closes.  Call pad_$edit_wait before reading from a file that
     may be open on an edit pad, because attempts to read a file open on an
     edit pad will fail until the pad is closed.

     If the edit pad is closed by a WC -Q command to the Display Manager and
     the file the pad was opened on did not previously exist, pad_$edit_wait
     returns with the pad_$edit_quit error in status to indicate the file was
     deleted while open.

     stream_id
          The ID of the edit pad to wait on.

     status
          The completion status.

SEE ALSO
     pad_$force_prompt, pad_$icon_wait.
Museum
