Version 23
Contents
Take Command 23.0:
Installer:
Take Command is using new version of Advanced Installer.
Take Command:
Version 23 is using a new version of the GUI framework library.
Version 23 is using a new version of Scintilla.
TCMD has a macro recorder that will record and play back keystrokes and mouse actions. You can control the macro recorder several ways:
1.Win-F11 - Start / stop macro recording
2.Win-F12 - Start / stop macro playback
3.Record & Playback buttons on the Quick Access toolbar
4.Record & Playback buttons on the Take Command Tools menu
5.The new TCC RECORDER internal command
The Command Input window now supports syntax coloring for command line input, using the same colors and keywords as the IDE / batch debugger.
The "Restarted Elevated" option in the Home menu will detach the tabs, start a new elevated Take Command session, and reattach the tabs in that session.
If you select "Attach Tabs" from the tab context menu, and (1) there is only one unattached console window, and (2) it is visible, it will automatically be attached without having to select it from the dialog.
The status bar has a new "Screen buffer size (Rows)" field.
The tab window context menu (right click) has three new options:
Read-only Tabs - Disable keyboard input in this tab.
New Horizontal Tab Group - move the current tab window into a new vertical tab group.
New Vertical Tab Group - move the current tab window into a new horizontal tab group.
Take Command has a number of screen drawing improvements related to custom font sizes and DPI scaling.
TCMDHere.btm now automatically restarts itself elevated if necessary, and has a /U option to remove the "TCMD prompt here" entry from the Windows Explorer context menu.
TCCTabHere.btm now automatically restarts itself elevated if necessary, and has a /U option to remove the "TCC tab window here" entry from the Windows Explorer context menu.
TCC:
Version 23 is using a new version of the Onigmo regular expression library.
TCC now supports syntax coloring on the command line (similar to the syntax coloring in the IDE / batch debugger). You set the option and the colors to use in the OPTION / Windows dialog. You can define both foreground and background using any of the 16 Windows console colors. TCC will colorize:
Default - any text that doesn't match a syntax option
Commands - internal TCC commands
Aliases - command aliases defined with the TCC ALIAS command.
Comments - lines beginning with rem or ::
Labels - labels for a GOTO or GOSUB
Operators - | < > && || etc.
Batch / Local Vars - %1 - %n, %*, %~... etc.
Environment Vars - environment variables
Internal Vars - internal TCC variables and variable functions
Regexes - regular expressions
TCCHere.btm now automatically restarts itself elevated if necessary, and has a /U option to remove the "TCC prompt here" entry from the Windows Explorer context menu.
IDE / Batch Debugger:
Version 23 is using a new version of the GUI framework library.
Version 23 is using a new version of Scintilla.
The Tabs context menu (right click on a tab header) has three new options:
Open Containing Folder (opens a File Explorer window in the batch file's directory)
Close
Close All But This
If you are editing a variable name in the Watch window, the Delete (X) button will delete marked text in the edit control. Otherwise, X will delete the currently selected line in the watch list.
"Run to Cursor" is a new option in the Debug menu. If you click on a line in the debugger window, and then select "Run to Cursor", the debugger will run the batch file (ignoring any breakpoints) until it reaches the selected line.
Help:
The v23 help is built with a new version of the help compiler (Help & Manual).
The help has been expanded with more examples, tutorials, and key words.
TMCD.INI Directives:
MacroRecorder=YES|no - Enable or disable the Take Command macro recorder. This directive goes in the [TakeCommand] section.
Command Line Editing:
See "Syntax Coloring" in the new TCC features above.
Variables:
You can return the result of a command with %(command). This is the same as @EXEC[command] but a little easier to write.
%@ will return the batch file arguments (like %*), but they will all be double quoted.
Numeric variable expressions - %((...)) will evaluate and substitute the expression. For example:
echo %((3+5)) is the answer.
Conditional expressions - %[[...]] will evaluate the conditional expression, and return 0 if the exit status is true; 1 if it is not. For example:
echo %[[5 == 6]]
Updated Variable Functions:
@COMPARE - added support for HTTP & HTTPS.
@CRC32 - has three new optional parameters:
@CRC32[s f b,]file[,start[,length]]
| b | Use binary buffer (pass the handle returned by @BALLOC as the file parameter) |
| start | Start position in binary buffer or file in bytes (defaults to 0) |
| length | Length of buffer to hash in bytes (defaults to size of binary buffer or file) |
@FILES - added support for exclusion ranges (i.e., @files[/!notthis.file] *.file])
@IF has new conditional tests:
ISLIBRARY - returns 1 if the name is a library function
ISSYMLINK - returns 1 if the filename is a symlink.
ISREADABLE - returns 1 if the file is readable.
ISWRITEABLE - returns 1 if the file is writeable.
@MD5 - has three new optional parameters:
@MD5[s f b,]file[,start[,length]]
| b | Use binary buffer (pass the handle returned by @BALLOC as the file parameter) |
| start | Start position in binary buffer or file in bytes (defaults to 0) |
| length | Length of buffer to hash in bytes (defaults to size of binary buffer or file) |
@PING - now also supports IPv6 addresses. (In Windows 7, this will only work in an elevated session.)
@SEARCH - added support for regular expressions in the program name. @SEARCH will also now add double quotes to the returned filename if it contains whitespace or special characters.
@SHA1, @SHA256, @SHA384, @SHA512 - have three new optional parameters:
@SHA1[s f b,]file[,start[,length]]
| b | Use binary buffer (pass the handle returned by @BALLOC as the file parameter) |
| start | Start position in binary buffer or file in bytes (defaults to 0) |
| length | Length of buffer to hash in bytes (defaults to size of binary buffer or file) |
New Variable Functions:
@BSIZE - Returns the size of a binary buffer. The syntax is:
@BSIZE[handle]
| handle | Handle returned by @BALLOC |
@SERIALHW - Returns the serial number of a physical drive. The syntax is:
@SERIALHW[drive]
| drive | The drive letter associated with the physical drive. |
Returns a string with the drive letter, or an error if the drive doesn't exist or have a serial number.
@UNQCLOSE - Close a UnQLite database opened by @UNQOPEN. The syntax is:
@UNQCLOSE[filename]
Returns 0 if successful, or the error text if not.
@UNQDELETE - Delete a key/value pair from a UnQLite database. The syntax is:
@UNQDELETE[[u,]filename, key]
| u | Optional flag that the key is Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to delete |
Returns 0 if successful, or the error text if not.
@UNQKVB- Add a key / binary blob value pair to a UnQLite database. The syntax is:
@UNQKVB[[u,]filename, "key", handle, length]
| u | Optional flag that the key and value are Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to add or replace |
| handle | Handle to binary buffer (returned by @BALLOC) |
| length | Length of buffer to write (or -1 for the entire buffer) |
Returns 0 if successful, or the error text if not.
@UNQKVBA - Append to the value of an existing key / binary blob value pair. The syntax is:
@UNQKVBA[[u,]filename, "key", handle, length]
| u | Optional flag that the key and value are Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to update |
| handle | Handle to binary buffer (returned by @BALLOC) |
| length | Length of buffer to write (or -1 for the entire buffer) |
Returns 0 if successful, or the error text if not.
@UNQKVF - Add a key / file value pair to a UnQLite database. The syntax is:
@UNQKVF[[u,]filename, "key", file, length]
| u | Optional flag that the key and value are Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to add or replace |
| file | Name of the file to save to the key |
| length | Length of the file to write (or -1 for the entire file) |
Returns 0 if successful, or the error text if not.
@UNQKVFA - Append to the value of an existing key / file value pair. The syntax is:
@UNQKVFA[[u,]filename, "key", file, length]
| u | Optional flag that the key and value are Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to update |
| file | Name of the file to save to the key |
| length | Length of the file to write (or -1 for the entire file) |
Returns 0 if successful, or the error text if not.
@UNQKVS - Add a key / string value pair to a UnQLite database. The syntax is:
@UNQKVS[[u,]filename, "key", "value"]
| u | Optional flag that the key and value are Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to add or replace |
| value | Value to add |
Returns 0 if successful, or the error text if not.
@UNQKVSA - Append to the value of an existing key/value pair. The syntax is:
@UNQKVSA[[u,]filename, "key", "value"]
| u | Optional flag that the key and value are Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to update |
| value | Value to append to the existing value |
Returns 0 if successful, or the error text if not.
@UNQOPEN - Open a UnQLite database, specifying a database name that is used by other @UNQ... functions. The syntax is:
@UNQOPEN[mode, filename]
The possible values for mode are:
| RWC | Open a database with read+write privileges. The database is created if it doesn't exist. |
| RW | Open the database with read+write privileges. If the database does not exist, an error is returned. |
| RO | Open the database in read-only mode. If the database does not exist, an error is returned. |
| MM | A read-only memory-mapped view of the database. |
If filename is ":mem:", then a private in-memory database is created. The in-memory database will be discarded when the database is closed.
Returns 0 if successful, or an error if not.
@UNQREADB - Read a binary value from an existing key in a UnQLite database. The syntax is:
@UNQREADB[[u,]filename, "key", handle, length]
| u | Optional flag that the key is Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to read |
| handle | A binary handle returned by @BALLOC |
Returns 0 if successful, or an error if not.
@UNQREADF - Read a value from an existing key in a UnQLite database and save it to a file. The syntax is:
@UNQREADF[[u,]filename, "key", outputname, length]
| u | Optional flag that the key is Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to read |
| outputname | Output file that will contain the value |
Returns 0 if successful, or an error if not.
@UNQREADS - Read a string value from an existing key in a UnQLite database. The syntax is:
@UNQREADS[[u,]filename, "key"]
| u | Optional flag that the key is Unicode (UTF16) |
| filename | Database opened by @UNQOPEN |
| key | Key to read |
Returns the value as a string, or the error text.
Updated Commands:
/H - Convert duplicate files to hard links to the first file.
/M - number the lines when displaying the directory history list.
/M - number the lines when display the DIRS list.
/P - pause after displaying each page.
ISLIBRARY - returns 1 if the name is a library function
ISSYMLINK - returns 1 if the filename is a symlink.
ISREADABLE - returns 1 if the file is readable.
ISWRITEABLE - returns 1 if the file is writeable.
/B - edit batch variables (1 - n).
/Q(uiet) - don't display any output, but set the FFIND internal variables.
FFIND now supports @filelists.
/M - number the lines when displaying the history list.
ISLIBRARY - returns 1 if the name is a library function
ISSYMLINK - returns 1 if the filename is a symlink.
ISREADABLE - returns 1 if the file is readable.
ISWRITEABLE - returns 1 if the file is writeable.
/IPv6 - use IPv6 instead of IPv4.
If you don't specify a target or any options, MKLINK will display information on the link (including OpenAFS reparse points).
ON ERROR
Now sets _SYSERR.
/(K) - Display the CKSUM hash.
/T will now display the time for the top level key in addition to the subkeys.
/IPv6 - use IPv6 instead of IPv4.
/IPv6 - use IPv6 instead of IPv4.
/C - Move the cursor to the specified position after writing the string.
/U - Move the cursor to the end of the string.
/IPv6 - use IPv6 instead of IPv4.
/IPv6 - use IPv6 instead of IPv4.
/B - change batch variables (1 - n).
/Z - resize an existing array. For example:
setarray myarray[5,2]
...
setarray /z myarray[8,3]
/IPv6 - use IPv6 instead of IPv4.
/IPv6 - use IPv6 instead of IPv4.
Now supports regular expressions for the CASE argument(s).
/AF"details" - Like /A, but TASKDIALOG will show the details at the bottom of the dialog's footer area instead of immediately after the contents.
/AX"details" - Like /A, but TASKDIALOG will show the expanded details by default.
/DB:xx - Default button. This can either be a number (1000-n for custom buttons, or a defined button type:
OK
Yes
No
Cancel
Retry
Close
/DR:n - The default radio button (only valid when used with /R).
/T:n - Timeout after n seconds. Returns the Cancel / Close button value (12).
/L0 - Don't number blank lines.
Now supports regular expressions for the alias name.
Now supports regular expressions for the function name.
Now supports regular expressions for the variable name.
/C - Move the cursor to the specified position after writing the string.
/U - Move the cursor to the end of the string.
/IPv6 - use IPv6 instead of IPv4.
/IPv6 - use IPv6 instead of IPv4.
Now supports regular expressions for alias names.
New Commands:
Display or change monitor capabilities, including:
Technology type
Color temperature
Contrast
Display area position
Display area size
RGB drive
RGB gain
Brightness
Reset factory color defaults
Reset factory defaults
Save to nonvolatile storage
Not all settings are supported by all monitors. If you don't enter any arguments, MONITOR will display the current configuration of all physical monitors. Depending on the options and the monitor hardware, MONITOR can take several hundred milliseconds to return. The MONITOR command will fail if the monitor does not support DDC/CI.
The options are:
/N:n - change settings on physical monitor n. The default is 0.
/FD - restores the factory default settings
/FC - restores the factory default color settings
/B:n - set the brightness
/C:n - set the contrast
/T:n - change the color temperature. n can be one of the following:
4000
5000
6500
7500
8200
9300
10000
11500
/D:Color:n - Sets a monitor's red, green, or blue drive value. Drive settings are used to adjust the monitor's white point (drive is also called black level). Color is either RED, GREEN, or BLUE; n is the drive value (usually 0-100). You can have multiple /Drive arguments in a single MONITOR command.
/G:Color:n - Sets a monitor's red, green, or blue gain value. Gain settings are generally used to adjust the monitor's white point. Color is either RED, GREEN, or BLUE; n is the gain value (usually 0-100). Changing the gain settings can change the color temperature. You can have multiple /Gain arguments in a single MONITOR command.
/AP:x:y - Set the horizontal (x=0) or vertical (x=1) position of the monitor's display area. y is the new width or height. Increasing the horizontal position moves the display area to the right; decreasing it moves the display area to the left. Increasing the vertical position moves the display area up, decreasing it moves the display area down.
/AS:x:y - Set the display area width (x=0) or height (x=1). y is the new width or height.
/S - save settings to the display's nonvolatile storage
Mount a VHD or VHDX image. You must be running an elevated session. The format is:
MOUNTVHD [d:\ | d:\path] image
| d: | Optional drive letter |
| d:\path | Optional mount path |
| image | VHD or VHDX file to mount |
Record and play back mouse & keyboard input. The syntax is:
RECORDER [/C /K /L:n /M /P /R filename /S /W filename]
| /C | Clear the macro queue |
| /K | Keyboard events only (ignore mouse events) |
| /L:n | Play back the current macro n times |
| /M | Start recording a macro |
| /P | Play back the current macro |
| /R name | Load a macro file (previously saved with /S) |
| /S name | Save the current macro recording to a file |
| /W | Wait for the macro playback to finish |
| /X | Stop recording or playing |
Unmount a VHD or VHDX image previously mounted with MOUNTVHD. You must be running an elevated session. The format is:
| UNMOUNTVHD [d:\ | d:\path\] |
| d:\ | Optional drive letter. |
| d:\path\ | Optional mount path |
UnQLite is an embedded NoSQL (Key/Value store and Document-store) database engine. UnQLite reads and writes directly to ordinary disk files. The complete database with multiple collections is contained in a single disk file.
The syntax is:
unqlite [/RWC [/RO [/MM] /RW /TEMP /MM] filename] [/DB:"database"] [/C filename] [/D key] [/R key] [/KVS "key" "value"] [/KVSA "key" "string"] [/KVB "key" handle length] [/KVBA "key" handle length] [/KVF "key" filename length] [/KVFA "key" filename length]
| /C | Close a database. If you omit the name, UNQLITE will close the most recently opened database. |
| /RWC | Open a database with read+write privileges. The database is created if it doesn't exist. |
| /RW | Open the database with read+write privileges. If the database does not exist, an error is returned. |
| /RO | Open the database in read-only mode. If the database does not exist, an error is returned. |
| /TEMP | A private, temporary on-disk database will be created. The database will be deleted when the database is closed. |
| /MM | A read-only memory-mapped view of the database. Only valid when used with /RO. |
| filename | The name of the database file. If filename is ":mem:", then a private in-memory database is created. The in-memory database will be discarded when the database is closed. |
| /DB:name | Open an existing database for a read / write / delete operation. The database name should be quoted. |
| /D | Delete the specified key |
| /R | Read the specified key and display the string (or file) value. |
| /KVS | Create a key / value pair. If the key exists, it will be overwritten with the new value. |
| /KVSA | Append a string to the value of an existing key. |
| /KVF | Create a key / file value pair. If the key exists, it will be overwritten with the new value. length is the length of the file to write (or -1 for the entire file). |
| /KVFA | Append a file to the value of an existing key. length is the length of the file to write (or -1 for the entire file). |
| /KVB | Create a key / binary blob value. If the key exists, it will be overwritten with the new value. handle is a handle returned by @BALLOC; length is the length to write (or -1 for the entire buffer). |
| /KVBA | Append a binary blob to the value of an existing key. handle is a handle returned by @BALLOC; length is the length to write (or -1 for the entire buffer). |