COPY-LIST

Copies a saved list to another list in POINTER-FILE or to another file.

Syntax

COPY-LIST list-name1 {account-name1} {(options}

Destination Prompt

TO:

At the destination prompt, you can use one of two formats:

1. Copy the list to a different list-name and optionally to another account-name within POINTER-FILE with the following syntax:

   list-name2 {account-name2}

   If the account you specify has a local POINTER-FILE, the list will be copied into that file; otherwise, it will be saved in the global POINTER-FILE and associated  with the specified account.

2. Copy the list to another file on the current account with the following syntax:

   (file-specifier {item-id}

   Note: The syntax for copying to another file requires an opening parenthesis.

Syntax Elements

list-name1 specifies the name of the source list.

account-name1 specifies the name of the source account. If you do not specify account-name, the current account is assumed.

list-name2 specifies the name of the destination list.

account-name2 specifies the destination account. If you do not specify account-name, the current account is assumed.

file-specifier specifies the destination file.

item-id specifies the destination item-id.

Options

D Deletes the item from the source file after copying it (not valid with option P or T).

L Suppresses line numbers (valid only with P or T).

N Suppresses auto paging (valid only with T).

O Overwrites the existing list or item.

P Sends the list to the printer assigned to your port.

T Sends the list to the screen.

X Outputs in hexadecimal notation (valid only with T or P).

Examples

:COPY-LIST ROOMS-AVAIL (O

TO:ROOMS-AVAIL-FEB

[241] 'ROOMS-AVAIL-FEB' CATALOGED 1 FRAMES USED

The command copies a previously saved list, overwriting an existing list in POINTER-FILE.

:COPY-LIST ROOMS-AVAIL

TO:ROOMS-AVAIL-FEB EC

[241] 'ROOMS-AVAIL-FEB' CATALOGED 1 FRAMES USED

The command copies a previously saved list to another list, specifying a different account name (EC) in POINTER-FILE.

:COPY-LIST ROOMS-AVAIL

TO:(BOOKINGS ROOMS-AVAIL-FEB 1 ITEMS COPIED

A previously saved list is copied to the item 'ROOMS-AVAIL-FEB' in the file 'BOOKINGS.'