.FILE MOVE

This subroutine will move a file or directory from one location to another, creating any required directories.

Usage:

      PASS         <error_message>            FIELD            SHARE? Y
      PASS         <source_file>              FIELD            SHARE? N
      PASS         <dest_file>                FIELD            SHARE? N
      GOSUB    --- .FILE MOVE
      *        check for errors
      IF       --- .FILE MOVE                 NE

Description:

This subroutine will move a file or directory from one location to another, creating any required directories. All parameters are required, if any are missing the subroutine will CANCEL.

<error_message> contains additional error information if the command fails (Required). Must be PASSed with Share "Y".

<source_file> is the source file or directory to be moved (Required).

<dest_file> is the location where the file should be moved to (Required).

If <source_file> is a directory, then <dest_file> must also be a directory. If <source_file> is a file, then <dest_file> must also be a file.

If --- .FILE MOVE is not blank, you can check the <error_message> field for more information on why the move failed.

File permissions and ownership are not changed by the move.

Comments:

Read what other users have said about this page or add your own comments.

-- JeanNeron - 2012-01-25