tcl.copy-list Verb: Access/TCL

tcl.copy-list

Command tcl.copy-list Verb: Access/TCL
Applicable release versions: AP, R83
Category TCL (746)
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 AP, 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".
Syntax copy-list {{file.reference} {itemlist*} {(options}
to:{(file.reference} {itemlist}
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.
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.
Purpose
Related tcl.save-list
access.select
tcl.el
tcl.delete-list
tcl2.verbs
tcl.copy
active.list
secondary.list
filename.pointer-file
tcl.edit-list
tcl.itemlist*
tcl.get-list
tcl.sort-list
tcl.cl
tcl.fl
tcl.list-lists
tcl.compare-list