TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-191
#HISTORY Built-In Function
#HISTORY Built-In Function
Use #HISTORY to display and manipulate the commands saved in the history buffer.
option
is an option that specifies the action to perform on the commands in the history
buffer; it can be any of these:
CLEARLAST
deletes the most recent command line from the history buffer. For example, the
TACL LOGON routine uses #HISTORY /CLEARLAST/ to erase the last line
from the history buffer if the password is entered on the same line as the user
ID. This action keeps the password confidential.
When entered from the IN file of a TACL process, #HISTORY /CLEARLAST/
removes itself from the history buffer. If included in a TACL program,
#HISTORY /CLEARLAST/ removes the line entered from the IN file that
caused the #HISTORY /CLEARLAST/ function to be executed.
RESET
deletes all command lines from the history buffer. The history number for the
next TACL prompt is set to 1.
SHOW num
displays the last num command lines in the history buffer.
Result
#HISTORY with the CLEARLAST or RESET options returns nothing. #HISTORY with
the SHOW option returns the last num commands. #HISTORY with no options returns
all previous command lines that are still in the history buffer.
Considerations
•
The history buffer is 1000 characters long; it contains zero or more lines. Each line
stored in the history buffer requires as many bytes as the line contains, plus one
extra byte.
•
#HISTORY within a TACL macro or routine shows the lines in the history buffer
that lead to the invocation. The result does not include the lines in the macro itself.
#HISTORY [ / option [ , option ] ... / ]