Create_Volume subroutine [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== Create_Volume subroutine    ======


 
==== Description ====
 
Creates or updates a volume definition, adding a row to SYSPTRS (the system table that stores volume definitions), or modifying the row if it exists.
 
==== Syntax ====
 
**Create_Volume**( //volume_name// , //filing_system, location, control_location,// //status//)
 
==== Parameters ====
 
The Create_Volume subroutine has the following parameters.

^Parameter^Description^
|//volume_name//|Key to row in SYSPTRS, containing the volume definition|
|filing_system|Value mark delimited list of filing system(s) associated with this volume.|
|location|Directory containing the files to be created using this volume, if the files are stored in a directory.|
|control_location|Directory containing control files associated with this volume.|
|////status////|Error return, returned as null.  Use [[get_status|Get_Status()]] to determine if an error occurred.||

 
==== See Also ====
 
[[declare|Declare]], [[detach_table|Detach_Table]] , [[alias_table|Alias_Table]] , [[get_status|Get_Status()]], [[attach_table|Attach_Table]], [[detach_volume|Detach_Volume]]
 
==== Example ====
 
<code>
declare subroutine create_volume, fsmsg

declare function get_status

/*  create volume named My_Vol in C:\Datafolder, storing linear hash files.  */

create_volume("MY_VOL","RTP57",'C:\Datafolder','','')

if get_status(errcode) then

   fsmsg()

   return 1

end

 
**
**
 
 
</code>