ios_set_conn_flag()

IOS_$SET_CONN_FLAG                Domain/OS                 IOS_$SET_CONN_FLAG


NAME
     ios_$set_conn_flag - set connection attributes

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

     void ios_$set_conn_flag(
          ios_$id_t &stream_id,
          ios_$conn_flag_t &conn_flag,
          boolean &on_off,
          status_$t *status)

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

     procedure ios_$set_conn_flag(
          in stream_id: ios_$id_t;
          in conn_flag: ios_$conn_flag_t;
          in on_off: boolean;
          out status: status_$t);

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

           integer*2 stream_id, conn_flag
           integer*4 status
           logical on_off

           call ios_$set_conn_flag(stream_id, conn_flag, on_off, status)

DESCRIPTION
     Calling ios_$set_conn_flag with on_off set to true adds an attribute to a
     connection, and with on_off set to false it removes an attribute from a
     connection.  Ios_$set_conn_flag only affects one attribute at a time.

     stream_id
          The ID of a stream.  Ios_$set_conn_flag sets the attributes for the
          connection associated with stream_id.

     conn_flag
          The connection attribute to change.  Specify  one of the following:

          ios_$cf_append
               The connection's stream marker will be positioned at the end of
               the object (EOF) before each output call.

          ios_$cf_ipc
               The connection behaves like an interprocess communication (IPC)
               channel.

          ios_$cf_no_read
               The connection cannot be read.

          ios_$cf_read_intend_write
               The connection is open for read access and may later be opened
               for write access.  Other processes can read from the stream but
               cannot write to it or get "read with intent to write" access.

          ios_$cf_sequential
               The connection is accessible only by sequential I/O calls.

          ios_$cf_tty
               The connection behaves like a terminal.

          ios_$cf_unregulated
               Multiple processes can write to the connection.

          ios_$cf_vt
               The connection behaves like a virtual terminal.

          ios_$cf_write
               The connection can be written to.

     on_off
          A Boolean value indicating whether the specified attribute should be
          a member of the set.  The attribute in conn_flag is added to the set
          if on_off is true; it is removed if on_off is false.

     status
          The completion status.

NOTES
     A type manager may not support the entire list of possible connection
     attributes; and even if the connection attributes allow an operation, the
     object's attributes or the type manager's attributes may still prevent
     the operation.

SEE ALSO
     ios_$inq_conn_flags.
Museum
