ios_change_path_name()

IOS_$CHANGE_PATH_NAME             Domain/OS              IOS_$CHANGE_PATH_NAME


NAME
     ios_$change_path_name - change an object's pathname

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

     void ios_$change_path_name(
          ios_$id_t &stream_id,
          char *new_pathname,
          short &new_namelength,
          status_$t *status)

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

     procedure ios_$change_path_name(
          in stream_id: ios_$id_t;
          in new_pathname: univ name_$long_pname_t;
          in new_namelength: integer;
          out status: status_$t);

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

           integer*2 stream_id, new_name_length
           integer*4 status
           character new_pathname*1023

           call ios_$change_path_name(stream_id, new_pathname,
          &                           new_namelength, status)

DESCRIPTION
     Ios_$change_path_name changes the pathname of the object open on
     stream_id.

     Note that this call can change the delete-on-close object attribute.  For
     example, if ios_$change_path_name assigns a name to an unnamed object,
     the object's delete-on-close attribute implicitly changes to false.
     Likewise, specifying a null pathname for a previously named object impli-
     citly changes the object's delete-on-close attribute to true.  Be aware
     that this side effect can cause unexpected results in cases where a pro-
     gram explicitly changes the delete-on-close attribute, and then calls
     ios_$change_path_name.

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

     new_pathname
          The new name of the object.

     new_namelength
          The length of new_pathname in bytes.

     status
          The completion status.
Museum
