pad_force_prompt()

PAD_$FORCE_PROMPT                 Domain/OS                  PAD_$FORCE_PROMPT


NAME
     pad_$force_prompt - force an incomplete record to an input pad

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

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

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

     procedure pad_$force_prompt(
          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_$force_prompt(stream_id, status)

DESCRIPTION
     A call to pad_$force_prompt forces the Display Manager to display the
     last partial record written to a transcript pad as a prompt in the
     related input pad specified by stream_id.  The displayed text is not fol-
     lowed by a record terminator, pad_$newline, and is usually intended as a
     prompt to the user.  The input and transcript pads must be in cooked mode
     for pad_$force_prompt to work.

     stream_id
          The stream ID for the input pad where the prompt should appear.  The
          specified input pad must be in cooked mode.

     status
          The completion status.

SEE ALSO
     pad_$cooked, pad_$edit_wait, pad_$icon_wait, pad_$raw.
Museum
