Working with Custom Commands

A Custom Command is a command that users can run when they select a field or a row in a table in the TLC Console.

To create, edit, or delete Custom Commands:

1. From the menu bar, select Options >SettingsSettings.
2. In the side bar of the Settings dialog, click User Settings > Custom Commands.
3. To create a Custom Command:
a. In the workspace of the Settings dialog, clickAddAdd.
b. Complete the Custom Command dialog (see Table 67).
c. To test the command on the IP address of a system in your TLC environment, click Test.
d. If the test is successful, click Save.

To change the properties of a Custom Command:

a. In the workspace of the Settings dialog, double-click the command.
b. Make your changes in the Custom Command dialog (see Table 67).
c. To test the command on the IP address of a system in your TLC environment, click Test.
d. If the test is successful, click Save.

To enable a disabled command, select the command in the workspace and click EnableEnable.

To disable a command, select the command and click DisableDisable.

To delete a command, select the line for the command in the workspace and clickDeleteDelete.

If DOS Command is selected in a Custom Command's Output field (see Table 67), the command runs an executable file saved in the Scripts folder of the local system's TLC Console installation directory. In the workspace table, TLC will highlight such a Custom Command if: 

The local Scripts directory does not contain the executable file assigned to the command, or

The executable file differs from the last version of the file approved for use by TLC; for example, if the file has been changed (or replaced) in the Scripts folder of the local system or another TLC Console.

If a Custom Command is highlighted, TLC will not run the command until the executable file's integrity is verified.

To verify the integrity of a changed executable file, click EnableVerify File Change and follow the on-screen instructions.

Table 67. Fields in the Custom Command dialog

Field

Description

Name

The name of the Custom Command.

Enabled

Enables the command for use by TLC users.

Data type

Indicates if the Custom Command is available when a user selects an IP address, a port number, or either (Multi-Value).

Output

Determines how TLC will run the command.

Default Browser. Runs a command specified by the URL field in the user's default Web browser (e.g., Internet Explorer or Firefox).

Internal Browser. Runs a command specified by the URL field in a browser window opened in the user's TLC Console.

DOS Command. Runs an executable file specified by the Command field.

URL

Note: This field is only enabled if Default Browser or Internal Browser is selected from the Output drop-down.

Defines a URL command beginning with http: or https:. As needed, you can append the following options to the end of the URL:

<ip> passes an IP address to the command.

<port> passes a port number to the command.

For example, this URL passes an IP address to the specified website: 

http://whatismyipaddress.com/ip/<ip>

Command

Note: This field is only enabled if DOS Command is selected from the Output drop-down.

Specifies an executable file (i.e., a BAT, EXE, or CMD file) stored in the Scripts folder of your TLC Console installation directory.

Note: If the Custom Command is intended for use by multiple TLC Consoles, the executable file must be copied to the Scripts folder on each TLC Console host system.

Options

Note: This field is only enabled if DOS Command is selected from the Output drop-down.

(Optional) Specifies command-line options for the executable file specified in the Command field. For example, <ip> passes an IP address, and <port> passes a port number.