Copy_OS_To_Row routine [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.
====== Copy_OS_To_Row routine     ======


 
==== Description ====
 
Copies one or more operating system files to a native table.
 
==== Syntax ====
 
**Copy_OS_To_Row**(//srcfilelist, desttablename, destkeylist, overwriteflag, convertflag, lockflag//)
 
==== Parameters ====
 
The Copy_OS_To_Row routine has the following parameters.

^Parameter^Description^^
|//srcfilelist//|Specifies an operating system file or list of files. The file name includes the operating system drive and path.||
|//desttablename//|Specifies the name of the destination table.||
|//destkeylist//|Specifies a list of destination keys. If //destkeylist// is null, //srcfilelist// is used. A one to one correspondence must exist between //srcfilelist// and //destkeylist//.||
|//overwriteflag//|Determines whether or not to overwrite existing rows in //desttablename//.\\ \\ __Value__ __Description__\\ 0 - Do not overwrite (default).\\ 1 - Only replace an existing row. If the destination row does not exist, then skip it.\\ 2 - Over-write rows, unconditionally.|
|//convertflag//|Determines whether or not to convert carriage return/linefeed characters to field marks. If null, the default is to perform the conversion (0). ctrl+z is converted to null. When copying compiled scripts or other binary data, always suppress the conversion by setting the convertflag.\\ \\ __Value__ __Description__\\ 0 - Perform conversion (default).\\ 1 - Do not perform conversion.|
|//lockflag//|Determines whether or not to lock the DOS source files and destination rows during the copy operation.\\ \\ __Value__  __Description__ \\ 0 - No locking (default).\\ 1 - Lock.|

 
==== See Also ====
 
[[copy_row|Copy_Row]], [[copy_row_to_os|Copy_Row_To_OS]]
 
==== Example ====
 
<code>
The following example illustrates how to copy operating system files to OpenInsight tables from the command line:

run Copy_OS_To_Row "C:\AUTOEXEC.BAT", "SYSPROCS", "AUTOEXEC", 2
</code>