Please enable JavaScript to view this site.

Navigation: TCC > Commands

XHISTORY

 Scroll Prev Top Next More
Purpose:Display or modify the Extended History list

 

Format:XHISTORY [/= OFF | ON][/D/ F"..." | /M"..." | /Nf | /Nh | /Q]

 

OFF        Disable Extended Command History                

ON        Enable Extended Command History

 

/D(ialog        /Nf (no footer)

/F"..."        /Nh (no header)

/M"..."        /Q(uiet)

 

See also Extended Command History and HISTORY.

 

Usage:

 

The Extended History displays and saves more information about the command than the original command history:

 

Timestamp - Date and time the command was executed

Run time - The elapsed  time (in seconds.milliseconds format)

Return - The integer value returned by the command

CWD - The current working directory when the command was executed

Command - The original command line (before alias & variable expansion)

 

Extended history does not replace the existing command history, but provides more details about the command context when you have a large / complex history. XHISTORY can either display / modify the extended history from the command line, or in a scrollable popup window that allows you select the command to re-execute or modify from those displayed in the window. The extended directory history window includes a toolbar with buttons for editing and deleting lines.

 

To activate the command history popup window, press Ctrl-Shift- PgUp or Ctrl-Shift- PgDn at the command line. (The hotkey can be redefined by changing XHistWinOpen in the OPTION / Keyboard / History dialog.) A popup window will appear, with the command you most recently executed marked with a highlight. (If you just finished re-executing a command from the history, then the next command in sequence will be highlighted.)

 

Extended History can also  be enabled / disabled from the OPTION / Command Line / Command History dialog.

 

Options:

 

/=Display the RESTOREPOINT command dialog to help you set the command line options. The /= option can be anywhere on the line; additional options will set the appropriate fields in the command dialog.

 

OFFDisable extended history

 

ONEnable extended history (extended history can also be enabled / disabled in the OPTION dialog on the Command Line page)

 

/DDisplay the XHistory dialog. You can view, edit, delete, or (re)execute commands.

 

/F"..." Delete matching lines in the directory history. Matching supports extended TCC wildcards and regular expressions. You can search on any field:

 

/F"ts=..."Delete lines with a matching time stamp (yyyy-mm-dd hh:mm:ss)

 

/F"rt=..."Delete lines with a matching run time (in seconds.milliseconds format)

 

/F"ret=n"Delete lines with a matching return code (0 - 256)

 

/F"cwd=..."Delete lines with a matching current working directory

 

/F"cmd=..."Delete lines with a matching command line (default)

 

/M"..."Find matching lines in the directory history. Matching supports extended TCC wildcards and regular expressions. You can search on any field:

 

/M"ts=..."Match time stamp (yyyy-mm-dd hh:mm:ss)

 

/M"rt=..."Match run time (in seconds.milliseconds format)

 

/M"ret=n"Match return code (0 - 256)

 

/M"cwd=..."Match current working directory

 

/M"cmd=..."Match command line (default)

 

/NhDon't display the header.

 

/NfDon't display the footer.

 

/QDon't display matching extended history entries for /D and /F.