.S Command

Sets the length of the stack. By default, the TCL Stacker stores 20 statements. The .S command assigns a different length to the stack for one or all processes. You must have SYS2 privileges to use this command.

Format

.Sn [(A | process)]

Parameter(s)

n	Specifies the maximum number of statements the TCL Stacker will store.
A	Changes stack length for all users on your system.
process	Changes stack length for the specified process.

If n is 0, there is no limit on the number of statements that the TCL Stacker can store. In this case, the stack will continue to expand until there is no more available disk drive space. Specifying a large number (such as 200 or 300) for n might cause a noticeable delay in system response, especially when saving and retrieving statements to and from the TCL Stacker.

When you log off, the system retains the current stack and automatically makes it available when you next log on.

NOTE	Do not confuse the .S command with the .L command. The .S command sets the number of TCL statements that are to be stored in the stack; the .L command, when used with a number argument (.Ln), sets the number of statements that are to be displayed, regardless of how many are stored.

Changing the Length of the Stack

This example changes the length of the stack from 15 statements to 2 statements:

>.L

001 SORT CUSTOMERS BY STATE ID-SUPP BREAK-ON STATE LAST-NAME FIRST-NAME STREET CITY STATE

002 SORT CUSTOMERS BY STATE ID-SUPP

003 SORT CUSTOMERS BY STATE ID-SUPP BREAK-ON STATE

004 SORT CUSTOMERS BY STATE

005 SORT CUSTOMERS BY LAST-NAME

006 LIST ORDERS REPORT

007 LIST ORDERS @INPUT

009 LIST ORDERS

010 LIST ONLY DICT ORDERS

011 LIST DICT ORDERS

012 CREATE-FILE BOOKS 1 9

013 LISTFILES

014 COPY DICT BOOK-CATALOG 2

015 CT DICT BOOK-CATALOG 1

>.S2

>TIME

16:44:39 dd mmm yyyy

>.L

001 TIME

002 SORT CUSTOMERS BY STATE ID-SUPP BREAK-ON STATE

LAST-NAME FIRST-NAME STREET CITY STATE

Now the TCL Stacker stores only 2 commands. When a new TCL statement is entered, that statement becomes statement 1, and the current statement 2 (SORT CUSTOMERS BY STATE ID-SUPP) is eliminated from the stack.