COPY-LIST

Man Page Index


Copies a saved list to another list or to another file.

 

SYNTAX

COPY-LIST {from_listname} {from_accountname} {(options} TO: {to_spec}

 

SYNTAX ELEMENTS

from_listname specifies the source list. If you do not specify from_listname, the default list will be used.

from_accountname specifies the source account if different to the current account.

to_spec specifies the destination list. Can be:

{to_listname} {to_accountname}
or
({DICT }to_filename {to_record_key}

Use the first variant if you want to copy the list or change the account it's attached to. Use the second variant if you want to copy the list to a data file Each key becomes a separate field in the list record. Note use of the left parenthesis before to_filename.

If you do not specify to_spec, the list will be copied to the default list.

Option Description
O overwrite destination list or record if it already exists
D delete source list after successfully copying it
L synonymous with S option
N suppresses auto paging. Only used with T
P sends the list to the printer
S suppresses line numbers. Only used with T or P.
T sends the list to the screen.
X outputs in hexadecimal notation; only used with T or P

 

NOTES

Also see the information on list storage.

 

EXAMPLE 1

:COPY-LIST A.SALES (O
TO: B.SALES
List "A.SALES" copied to "B.SALES"

Copies A.SALES (a previously saved list) to B.SALES, and overwrites if
necessary.

 

EXAMPLE 2

:COPY-LIST A.SALES
TO: A.SALES ACCOUNTS
List "A.SALES" copied to "A.SALES ACCOUNTS"

Copies A.SALES (a previously saved list belonging to the current account) to A.SALES, and marks it as belonging to the ACCOUNTS account.

 

EXAMPLE 3

:COPY-LIST A.SALES
TO: (SALES.LISTS APRIL.SALES
List "A.SALES" written to record "APRIL.SALES" in file "SALES.LISTS"

Copies A.SALES (a previously saved list) to record APRIL.SALES, in file SALES.LISTS.


LIST