Table of Contents

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.

ParameterDescription
volume_nameKey to row in SYSPTRS, containing the volume definition
filing_systemValue mark delimited list of filing system(s) associated with this volume.
locationDirectory containing the files to be created using this volume, if the files are stored in a directory.
control_locationDirectory containing control files associated with this volume.
statusError return, returned as null. Use Get_Status() to determine if an error occurred.

See Also

Declare, Detach_Table , Alias_Table , Get_Status(), Attach_Table, Detach_Volume

Example

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

 
**
**