0LASubrFileMove < Main

Tags: view all tags
---+ .FILE MOVE

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

<br />%TOC%
---++ Usage:

<pre>      PASS         &lt;error_message&gt;            FIELD            SHARE? Y
      PASS         &lt;source_file&gt;              FIELD            SHARE? N
      PASS         &lt;dest_file&gt;                FIELD            SHARE? N
      GOSUB    --- .FILE MOVE
      *        check for errors
      IF       --- .FILE MOVE                 NE
</pre>

---++ 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.

&lt;error_message&gt; contains additional error information if the command fails (Required). Must be PASSed with Share "Y".

&lt;source_file&gt; is the source file or directory to be moved (Required).

&lt;dest_file&gt; is the location where the file should be moved to (Required). 

If &lt;source_file&gt; is a directory, then &lt;dest_file&gt; must also be a directory. If &lt;source_file&gt; is a file, then &lt;dest_file&gt; must also be a file. 

If --- .FILE MOVE is not blank, you can check the &lt;error_message&gt; 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._

<br />%COMMENT%

-- Main.JeanNeron - 2012-01-25
Topic revision: r1 - 2012-01-25 - JeanNeron