Purpose:Modify or display TCC configuration

 

Formats:Invoking the OPTION dialog:

OPTION

 

Check for updates:

OPTION /U

 

Temporarily changing an option:

OPTION //directive=value ...

 

Temporarily changing a list of options:

OPTION @filename

 

Displaying the current value of an option:

OPTION directive

 

directiveName of a directive to set, modify, or display.
valueA new value for that directive.
filenameA file containing directives to be immediately activated.

 

See also: .INI file, SETDOS

 

Usage:

 

Invoking the OPTION Dialog

 

OPTION without parameters displays a property sheet which allows you to modify most of the configuration options stored in the INI file.

 

When you exit from the property sheet, you can select Save to save your changes in the .INI file for use in the current session and all future sessions, or select Cancel to discard the changes. See Configuration Dialogs for more information.

 

In some cases, changes you make in the Startup section of the OPTION dialogs will only take effect when you restart TCC. Other changes take effect as soon as you exit the dialogs with Apply or OK. However, not all option changes will appear immediately, even if they have taken effect. For example, some color changes will only appear after a CLS command.

 

OPTION handles most standard directives, including key mapping. The Advanced Directives cannot be modified with the OPTION dialogs. These settings must be manually edited in the .INI file.

 

OPTION does not preserve inline comments when saving modified settings in the .INI file. To be sure .INI file comments are preserved, put them on separate lines in the file.

 

Check for Updates

 

The /U option will invoke the updater to check https://jpsoft.com for updates to Take Command / TCC.

 

Setting Individual Options Temporarily

 

If you follow the OPTION command with one or more sequences of a double slash mark //, each followed by a new directive=value, the new settings will take effect immediately, and will be in effect for the current session only. This example turns off batch file echo and changes the input colors to bright cyan on black:

 

option //BatchEcho=No //InputColors=bri cya on bla

 

Option values may contain white space. However, you cannot enter an option value that contains the // string. If you do not specify a value, OPTION will reset the value for that directive to the default.

 

This feature is most useful for testing settings quickly, and in aliases or batch files that depend on certain options being in effect.

 

Changes made with // are temporary. They will not be saved in the .INI file.

 

Setting Many Options Temporarily

 

The command OPTION @filename allows you to temporarily modify multiple directive settings. The file specified by filename must be in the same format as an .INI file. Changes made with @filename are temporary. They will not be saved in the .INI file.

 

Displaying an option value

 

Specifying an option name alone will display the value of that option; e.g.:

 

option localHistory

localHistory=Yes

 

See also: the @OPTION function.