COPY-FILE: Difference between revisions
(created page for the COPY-FILE command) |
(expanded text with info from SINTRAN III Reference manual) |
||
| Line 1: | Line 1: | ||
@COPY-FILE <destination> <source> | @COPY-FILE <destination file>, <source file> | ||
Copies data between peripheral units and files. | Copies data between peripheral units and files. | ||
The command reads pages of 1K words from <source> file and writes on the <destination> file. <destination> may be a new file to be created by enclosing the name in double quotation marks. Data is completely code-independent and the copy operation continues until all pages has been copied from a file or until time-out is received from a peripheral unit | Copies data from a source to a destination file. The file is copied page by page if both files are mass storage files. The command reads pages of 1K words from <source> file and writes on the <destination> file. <destination> may be a new file to be created by enclosing the name in double quotation marks. Data is completely code-independent and the copy operation continues until all pages has been copied from a file or until time-out is received from a peripheral unit. | ||
This command may also be used to copy to or from peripherals. | This command may also be used to copy to or from peripherals. | ||
This command will also correctly copy files with holes. | This command will also correctly copy files with holes. | ||
; <destination file> : a file to which data is copied. It may be any type of file (default type = DATA). | |||
; <source file> : a file from which data is copied (default type = SYMB). | |||
Rules: | |||
#Permitted for all users. | |||
#If the <destination file> is a peripheral file and the mass storage <source file> is an indexed file with a hole, the copying will stop at the hole and an error message is produced ("no such page"). | |||
#If both files are mass storage files, the file is copied including the hole. | |||
#All pages allocated to the <source file> are copied, except if there are zero bytes in the file. | |||
#If the <destination file> does not exist, quotes may be used to create the file. The file will then be indexed. | |||
== Related commands == | == Related commands == | ||
@[[COPY]] | @[[COPY]] | ||
@[[COPY-USER-FILES]] | |||
== References == | == References == | ||
{{ND-doc|60.128.01}} (printed June 1980), page 1-40 | |||
{{ND-doc|60.050.06}} section 3.4.4 | {{ND-doc|60.050.06}} section 3.4.4 | ||
{{ND-doc|60.174.Q01}} | {{ND-doc|60.174.Q01}} | ||
[[Category:Background Commands]] | [[Category:Background Commands]] | ||
Revision as of 21:04, 16 July 2013
@COPY-FILE <destination file>, <source file>
Copies data between peripheral units and files.
Copies data from a source to a destination file. The file is copied page by page if both files are mass storage files. The command reads pages of 1K words from <source> file and writes on the <destination> file. <destination> may be a new file to be created by enclosing the name in double quotation marks. Data is completely code-independent and the copy operation continues until all pages has been copied from a file or until time-out is received from a peripheral unit.
This command may also be used to copy to or from peripherals.
This command will also correctly copy files with holes.
- <destination file>
- a file to which data is copied. It may be any type of file (default type = DATA).
- <source file>
- a file from which data is copied (default type = SYMB).
Rules:
- Permitted for all users.
- If the <destination file> is a peripheral file and the mass storage <source file> is an indexed file with a hole, the copying will stop at the hole and an error message is produced ("no such page").
- If both files are mass storage files, the file is copied including the hole.
- All pages allocated to the <source file> are copied, except if there are zero bytes in the file.
- If the <destination file> does not exist, quotes may be used to create the file. The file will then be indexed.
Related commands
@COPY
References
Norsk Data Document ND–60.128.01 SINTRAN III REFERENCE MANUAL (printed June 1980), page 1-40
Norsk Data Document ND–60.050.06 SINTRAN III USERS GUIDE section 3.4.4
Norsk Data Document ND–60.174.Q01 SINTRAN III QUICK REFERENCE CARD