CT

Copies all or selected items in a file to the terminal at which the command is entered.

Command Class

TCL-II command.

Syntax

CT file-specifier item-list {(options}

Syntax Elements

file-specifier The file containing items to be copied.

item-list The 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.

N Suppresses automatic paging.

P Sends output to the printer.

X Specifies a hexadecimal dump.

Prompt

If you enter the command without specifying an item-list, the following prompt displays:

ITEM ID:

Enter the item-id(s) or an asterisk for all items.

Note

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

Error Messages

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

[200] FILE NAME?

The TCL prompt is displayed.

If you enter the command with a non-existent file-name or enter an item-list without specifying the file, the following message is displayed:

[201] 'file-name' IS NOT A FILE NAME

The TCL prompt redisplays.

Examples

In this example, the item 'A' in the file 'CW' is displayed.

:CT GUESTS 121

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

In this example, all items in the TESTS file are displayed.

:CT TESTS
ITEM ID: *

In this example, items 13245 and 17701 are displayed.

:CT INVOICES
ITEM ID: 13245 17701

In this example, all items in the data file TEST1 are displayed.

:CT TESTS,TEST1 *