The COPY-LIST command copies a select-list. You can copy the select-list to the terminal screen, to another select-list, or to an item in a file. The COPY-LIST command can also be used to copy select-lists from other accounts.
Format
|
COPY-LIST [filename] list-name [list-name...] [(options) |
Parameter(s)
|
filename |
Specifies the file where the select-list is stored. If filename is not specified, the default is POINTER-FILE. |
|
|
list-name |
Name of the select-list. If list-name is not specified, the default is @. |
|
|
options |
The following options are supported: |
|
|
D |
Copies the select-list to another select-list or to a file item and then deletes the original select-list. This option can be used to change a select-list’s name. |
|
|
N |
Disables paging when copying the select-list to the terminal. |
|
|
P |
Copies the select-list to the printer. |
|
|
T |
Copies the select-list to the screen. |
|
|
X |
Copies the select-list to the printer or terminal in hexadecimal format. |
|
To print the copied select-list, use the P option; to display it on the terminal screen, use the T option. If neither option is specified, the system prompts:
|
TO: |
Press ENTER to copy the select-list to the screen. To copy the select-list to another select-list or to an item in a file, respond to the destination prompt using the following syntax:
Format
|
{dest-list | [(filename [item-ID])]} |
Parameter(s)
|
dest-list |
Name of the select-list to which the select-list copies. |
|
filename |
Name of the file. Each item in the select-list is stored as a separate attribute in the file item. |
|
item-ID |
Name of the new item that contains the copied select-list. |
Copying a Select-list to a New Select-list
The following example copies a previously saved select-list called LNAMES to a new select-list called JAN-LNAMES:
|
> COPY-LIST LNAMES (D) TO: JAN-LNAMES 1 LNAMES TO JAN-LNAMES |
After creating select-list JAN-LNAMES, the system deletes the original select-list LNAMES.
Copying a Select-list to a File Item
The following example copies a select-list called FEB-ORDERS to a file item of the same name in a file called ORDERS-WINTER:
|
> COPY-LIST FEB-ORDERS TO: (ORDERS-WINTER)
1 FEB-ORDERS |