. (Dot - TCL Stacker Recall Command)

The TCL Stacker Recall command allows you to recall a previously executed command for re-execution or modification. Commands are stored in a stack, with the last command executed on the top.

Command class

TCL Stacker Processor.

Syntax

.{command}

Syntax elements

.The character that runs the TCL Stacker Recall command. By default a dot (.) is used, but this can be changed to any printable ASCII character with the SET-STACK command.

commandOne of the TCL Stacker commands (described below) available in the current operating environment. If omitted, the TCL Stacker Recall command enters the line editor and displays the last TCL command executed.

Comments

Once editing the command stack, you can modify any command and enter new commands. On exit, you can choose to execute the currently selected command. Use of the editor with the TCL Stacker is described in Using the Editor below.

The TCL stack is cleared whenever you log off. However, you can save it with the editor FS command and subsequently restore commands using the editor ME command.

Configuration options

Commands

The commands available in the current operating environment depend on the MutliValue emulation mode selected with the DOT / TCL Stacker name environment setting in SSM Option 4 - Define Environment Settings.

For detailed descriptions, select the emulation you require from the drop down list below:

Using the Editor

Editor commands in the TCL Stacker execute as described in the Editor Reference, with the following exceptions.

FI Saves the TCL commands currently stacked and executes the current line of the stack.

If you change the sequence of commands by using a DE (Delete), I (Insert), ME (Merge), or SP (Split Line) command and then enter the FI command, the commands in the stack are saved, but no command is executed.

To execute a command after changing the sequence of commands in the stack, either:

  • Enter F  to update the buffer and then use FI  to execute the top stack command.
  • Enter the line number of the command to execute and then use FI.

FS Saves the TCL commands currently stacked and exits to TCL.

FS (file-name item-id
Saves the TCL commands currently stacked to the specified file. The file must already exist in the current account, but the specified item must not exist. The commands in the stack remain unchanged.

Note

All other forms of the FS command are invalid.

FD Not supported for editing the TCL Stacker lines.

All other Editor commands execute in the normal way. For example:

EX Exit the TCL Stacker without saving changes or executing a command.

L99 Lists the commands in the TCL stack.

Example 1

To edit the command on line '2' and save the edit:

:.2
002 LIST CUST BY NAME NAME ADDR
.R/LIST/SORT
002 SORT CUST BY NAME NAME ADDR
.FS

:

The last entry (FS) files the edited command. Note, however, that the edited command is not executed.

Example 2

To re-execute the last command executed:

:..
001 SORT MD

Note that the .. command is equivalent to .X, ..1 and .X1.

Example 3

To re-execute the command on line '2':

:..2
002 LIST MD

Note that .X2 produces the same result.

Example 4

The example that follows assumes that you have already entered the editor, by entering the TCL Stacker command at the TCL prompt.

To list the lines in the stack, type L at the dot prompt, followed by the number of lines to list. Having displayed line 1, you can display the remainder of the stack by entering:

.L99
002 SORT CUST BY NAME NAME ADDR
003 SORT MD WITH 2 = "35"
004 LISTFILES
005 WHO
006 CREATE-FILE STACK-TEST 3 1
EOI 006
.

To list lines 2 to 4, again assuming you have displayed line 1, enter:

.L3
002 SORT CUST BY NAME NAME ADDR
003 SORT MD WITH 2 = "35"
004 LISTFILES
.

To locate the line containing the text "STACK-TEST":

.L/STACK-TEST/
006 CREATE-FILE STACK-TEST 3 1
.