User's Reference > General > TCL and General User Commands > Command Reference > C > CP

Comment on this topic

Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

RealityV15.1Online Documentation (MoTW) Revision 7

CP (TCL) (m604806+cp.htm)

To

Reality

Version

Topic

Submitted by

Company

Location

Email address

Comment

 

 

CP

Copies all or selected items in a file to a printer.

Command Class

TCL-II command.

Syntax

CP file-specifier item-list {(options}

Syntax Elements

file-specifier Specifies the file containing items to be copied.

item-list The list of items to be copied. This can be one or more item-ids separated by spaces, a list generated by a list-generating command, or an asterisk (*) to specify all items (but see Prompt below).

Options

A Formats assembly language source items the same way as MLIST (a command provided with the Assembler).

F Outputs a new page before each item.

L Suppresses line numbers.

X Specifies a hexadecimal dump.

Prompt

If you enter the command without specifying an item-list, the processor prompts:

ITEM ID:

Type the item-list and press RETURN.

Note: This behaviour can be changed by setting the DEFAULT.TO.ALL environment option.

Error Messages

If you enter the CP command without specifying the file-name, the following message is displayed:

[200] FILE NAME?

Control returns to TCL.

If you press only RETURN at the ITEM ID: prompt, the following message is displayed:

[203] ITEM NAME?

Control returns to TCL.

Example 1

:CP GUESTS 121

The following report is sent to the printer:

     121
001  John Smith
002  1234 W.  Main Street
003  Los Angeles, CA

Example 2

:CP INVOICES
ITEM ID: 13245 17701

In this example, copies of the items 13245 and 17701 are sent to the printer.

Example 3

:CP TESTS
ITEM ID: *

In this example, all items in the TESTS file are sent to the printer.

Example 4

:CP TESTS,TEST1 *

In this example, all items in the data section TEST1 are sent to the printer.

RealityV15.1 (MoTW) Revision 7Comment on this topic