| copy | Index Level | copydos |
| Syntax |
copy-list {{file.reference} {itemlist*} {(options}
to:{(file.reference} {itemlist} |
| Category | TCL |
| Type | Verb |
| Description |
copies a saved list to either a new item-id, a new file.reference, or to the specified output device.
If a file.reference is not specified, the items are copied from the "pointer-file". If no "itemlist*" is specified, the default item-id, "%user.name" is used. In D3, a "file.reference" may be specified because any file can hold lists. Conversely, the "copy" command may also be used, but it does not default to the "pointer-file". "cl" is a shorthand for "copy-list". |
| Options |
n (integer number) Copies only the first "n" items.
d Deletes the source item(s) from the source file after copying. f Issues a form-feed between items; each item starts on a new page. Only valid with "t" and "p" options. i Suppresses display of item-ids. n Activates nopage function on output to the terminal. o Overwrites duplicate item-id{s}. p Copies list to printer, via the Spooler. s Suppresses display of line numbers when used with "t" or "p" options. s Suppresses error message output on a file copy. t Copies list to terminal. u If item-id is in destination file, copies item, but renames it by concatenating current item-id with a character, starting with lower case "a". x Lists output in hexadecimal. |
| See Also | save-list select el delete-list tcl2 verbs copy active list secondary list pointer-file edit-list itemlist* get-list sort-list cl fl list-lists compare-list |
| Example |
copy-list dm,pointer-file, temp.list (d
to:(prod,pointer-file, cust.list This copies a list called "temp.list" from the "pointer-file" in the "dm" account to the "pointer-file" in the "prod" account. After copying successfully, the list is deleted from the "dm,pointer-file," with the "d" option. Filepaths are provided in the source and destination files. This command is valid from any account. |
| Warnings | R83 does not support filepaths. |
| Compatibility | D3 7.0 AP R83 |
| copy | Index Level | copydos |