ios_$set_obj_flag

IOS_$SET_OBJ_FLAG                 Domain/OS                  IOS_$SET_OBJ_FLAG


NAME
     ios_$set_obj_flag - set object attributes

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

     void ios_$set_obj_flag(
          ios_$id_t &stream_id,
          ios_$obj_flag_t &obj_flag,
          boolean &on_off,
          status_$t *status)

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

     procedure ios_$set_obj_flag(
          in stream_id: ios_$id_t;
          in obj_flag: ios_$obj_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, obj_flag
           integer*4 status
           logical on_off

           call ios_$set_obj_flag(stream_id, obj_flag, on_off, status)

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

     stream_id
          The ID of a stream on which the object is open.

     obj_flag
          The object attribute to change.  Specify one of the following:

          ios_$of_ascii
               The object contains ASCII data.

          ios_$of_async
               Process groups holding valid file descriptors for the object
               will be asynchronously notified via a SysV or BSD SIGIO signal
               (an Aegis unix_sig_$io_f fault) when nonblocking I/O (usually
               input from the object) is possible.

          ios_$of_cond
               Input and output to the object will be performed conditionally,
               as if the ios_$cond_opt was specified on each I/O call.

          ios_$of_delete_on_close
               The object will be deleted when all streams open on it close.

          ios_$of_ftncc
               The object uses FORTRAN carriage control characters.

          ios_$of_mand_lock
               The object will be locked during I/O operations.

          ios_$of_sparse_ok
               The object can be sparse.  A process can seek beyond the end of
               the object before writing to it.

     on_off
          A Boolean value indicating whether the specified attribute should be
          a member of the set.  The attribute in obj_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 set of possible object attri-
     butes; and even if the object attributes allow an operation, the
     connection's attributes or the type manager's attributes may still
     prevent the operation.

SEE ALSO
     ios_$inq_file_attr, ios_$inq_obj_flags.
Museum
