0LASubrFileMakeDir < Main

Tags: view all tags
---+ .FILE MAKE DIR

_This subroutine is called to create a directory in the filesystem._

<br />%TOC%
---++ Usage:
<pre>    PASS        &lt;error_message&gt;           FIELD           SHARE? Y
    PASS        &lt;directory_name&gt;          FIELD           SHARE? N
    GOSUB   --- .FILE MAKE DIR
     *       check for errors
    IF      --- .FILE MAKE DIR            NE
</pre>
---++ Description:

This subroutine is called to create a directory in the filesystem. Both parameters are required, the subroutine will CANCEL if they are not received.

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

&lt;directory_name&gt; is the directory name to create (Required).

If .FILE MAKE DIR is not blank, you can check &lt;error_message&gt; for more information on why the command failed.

This command is run by the appx engine, not by 'shelling out' to the O/S level, therefore the directory will have the permissions of the engine. On Linux/Unix systems, if the 'setuid' bit is set, then those will be the permissions of user 'appx'. If you do not have the 'setuid' bit set, then the those will be the permissions of whatever user you have the engine configured to impersonate. On Windows the permissions will be that of the current user.
---++ Comments:

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

<br />%COMMENT%

-- Main.PeteBrower - 2011-08-12
Topic revision: r2 - 2012-01-25 - JeanNeron