Home > MultiValue Central > Online D3 Reference > TCL > tcl.copy-list

tcl.copy-list

Verb: Access/TCL, Releases: AP and R83

Copies previously saved lists.

Syntax

copy-list {{file.reference} {itemlist*} {(options} to:{(file.reference} {itemlist}

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'.

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.

See Also

Command Name Type Description
tcl.save-list Verb: Access Saves active list.
access.select Verb: Access Creates list of items meeting specific criteria.
tcl.el Verb: Access Edits saved list using Update processor.
tcl.delete-list Verb: Access Deletes previously saved lists.
tcl2.verbs Definition Description of TCL2 verbs.
tcl.copy Verb: Access Copies items to output devices or between files.
active.list Definition A list of strings delimited by attribute marks created by one of the list-generating processes.
secondary.list Definition A list of item-id's generated by one of the list-generating processes while an active list is present.
filename.pointer-file File Contains saved lists.
tcl.edit-list Verb: Access Edits saved list using line editor.
tcl.itemlist* Definition Specifies list of item-ids for TCL2 processes.
tcl.get-list Verb: Access Retrieves previously saved list.
tcl.sort-list Verb: Access Retrieves, sorts and rewrites previously saved list.
tcl.cl Verb: Access Invokes 'copy-list' command'
tcl.fl Verb: Access Forms single list from two lists.
tcl.list-lists Verb: Access Sorts saved-lists in 'pointer-file'.
tcl.compare-list Verb: Access Compares two lists for intersections.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.