====== 4.5 Volume ======
[[dido:public:s_cli:05_contents:01_prt:04_dll:start| Return to DidoDLL]]


===== Purpose =====
[[dido:public:s_cli:05_contents:01_prt:04_dll:volume| Return to Top]]

The purpose of the DEFINE VOLUME command is to define a localized name mapping an actual path to a directory to a symbolic name. The symbolic name provides a logical name for use throughout the DIDO CLI. This helps with maintenance because the actual path is maintained in a single location. 

===== Syntax =====
[[dido:public:s_cli:05_contents:01_prt:04_dll:volume| Return to Top]]

<code>
DEFINE VOLUME <VolumeName> AS
   PATH = <DirectoryPath>
   MODE = <DirectoryPermissions>;
</code>

==== Where ====
[[dido:public:s_cli:05_contents:01_prt:04_dll:volume| Return to Top]]

  * **VolumeName**           ::= The symbolic name used to reference the volume throughout the DIDO CLI.
  * **DirectoryPath**        ::= The path to the directory associated with the volume.
  * **DirectoryPermissions** ::= The mode (i.e., permissions) associated with the volume (i.e., R, W, X). The default is RW.

==== Examples ====
[[dido:public:s_cli:05_contents:01_prt:04_dll:volume| Return to Top]]

<code sql | Examples of Defining Volume in DidoLL>
    DEFINE VOLUME config AS
      path      = "/etc/myDidoRoot/"
      mode      = "RX";
    DEFINE VOLUME data AS
      path      = "/etc/myDidoRoot/"
      mode      = "RW";
    DEFINE VOLUME wallet AS
      path      = "~/myWallet/";
    DEFINE VOLUME wallet AS
      path      = "~/universityWallet/";

</code>


/**=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
/* To add a discussion page to this page, comment out the line that says 
  ~~DISCUSSION:off~~
*/
~~DISCUSSION:on|Outstanding Issues~~
~~DISCUSSION:off~~