Home > MultiValue Central > Online D3 Reference > TCL > tcl.stack.definition

tcl.stack.definition

Definition/TCL, Releases: AP

Description of the TCL command stacker.

Description

describes the TCL command stacker.

In AP, every unique command that is typed at the ':' (TCL) prompt is saved in a file on the 'dm' account called 'tcl-stack'.

TCL stack entries may be recalled and edited using the Update processor edit commands. The UP commands listed below are valid when editing items in the TCL-stack file.

Changing any part of a TCL command in the stack causes that stack entry to be moved to the top of the stack. This feature tends to keep the stack compact. The fact that only 'unique' commands are saved also helps keep the stack compact. 'Unique', in this context, means that there are never any duplicated commands in the stack. For instance, even if the 'who' command had been used many times, it will only appear ONCE in the stack. Each time a command is found and re-executed, it is moved to the 'top' of the stack.

There is no limit to the number of TCL-stack items, or to the number of attributes in each item. These items continue to grow indefinitely. Therefore, from time to time, the stack should be pruned either from TCL or by using UP to modify the actual stack item (u dm,tcl-stack, user-id ).

A user's TCL-stack is not terminal dependent. It is user-id dependent. If a user leaves a terminal unattended, another user can use the terminal under the previous user's id. This causes the new user to 'step-on' the previous user's stack.

Since the TCL-stack is an updated file, it is frequently locked and updated by the system. If two users share the same user-id, then while the first user types a TCL command, the second user is 'locked-out' of the TCL stack, and their terminal will beep as long as the first user is still entering the command.

In AP release 5.2.5, the stacker was enhanced to allow new commands even if the stack item is locked by another port.

As of AP releases 5.2.5 and higher, it is now possible to cut and paste when editing the TCL command stack item.

In releases of AP 6.1.0 and higher, it is possible to stack data or additional commands under the TCL statement by using the <ctrl>-v command.

See Also

Command Name Type Description
up.r Command Toggles UP overtype/insert mode.
up.t Command Positions the cursor at the top of the item or document.
up.w Command Inserts a blank at current cursor position.
tcl.stack-off Verb: Access Invokes 'stack' command with an 'f' option.
up.y Command In data-entry mode, searches backward on a remote index or moves cursor backward one word in text-entry mode.
up.z Command Initiates several separate UP commands.
filename.tcl-stack File Description of the TCL command stack.
tcl.stack Verb: Access Toggles TCL command stack on or off.
tcl.stack-on Verb: Access Invokes 'stack' command with an 'n' option.
line.continuation.character Definition Extends command line another 140 characters.
tcl.introduction Introductory Description of TCL.
tcl.edit.commands Command TCL stacker commands.
up.g Command Positions the cursor to the end of the paragraph or 'zooms' to related file.
up.m Command Alternate to the or keys.
up.n Command Move the cursor down one line from the current cursor position.
up.o Command Deletes a word.
up.e Command Deletes text.
up.i Command Moves cursor to the next tab position.
up.k Command Positions the cursor right one character.
up.l Command Deletes a character.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.