ECOPY
Expands DataBasic items and copies them from a file to a terminal, printer, another file, or to items with different item-ids within the same file.
Syntax
ECOPY file-specifier item-list {(options}
Syntax Elements
file-specifier Specifies a dictionary section and a data section.
item-list One or more item-ids separated by blanks, a list generated by an English command, or an asterisk (*) to specify all items (but see Prompt below).
Options
D Deletes items from the source file after they are copied to the destination file. Cannot be used with the P or T option.
F Outputs a new page before each item when specified with the P or T option.
I Lists the destination item-ids as they are copied.
L Suppresses the line numbers when used with the P or T option.
N Suppresses automatic paging with used with the T option.
O Overwrites existing destination file items with source file items. Cannot be used with the P or T option.
P Sends output to the printer.
S Suppresses printing of item-id NOT COPIED messages.
T Copies items to the terminal.
X Specifies a hexadecimal dump to the terminal or printer. Requires the P or T option.
Prompt
If you enter the command without specifying an item-list, the following prompt displays:
ITEM ID:
Enter the item-id(s) or an asterisk for all items.
Note
This behaviour can be changed by setting the DEFAULT.TO.ALL environment option.
Comments
The ECOPY command copies and expands compressed DataBasic source items. In all other respects, ECOPY acts just like the TCL command, COPY.
ECOPY remains on the system only for the sake of compatibility with earlier versions of Reality, on which compressed DataBasic source items were used to circumvent the 32K item limit. This limitation is no longer in effect and compression is no longer necessary.