In the Agent Manager window you can expand an item by double clicking on it. If you double click on an agent, however, the Agent Manager window establishes connection to the agent. Also, if you double click on a network, the Agent Manager searches the network. In these cases, you can prevent erroneous operations if you use the General page in the Options dialog box to suppress the actions that should be triggered by double clicking the mouse. In the General page you can also specify the action that should be taken by the Search Agents dialog box when the search finishes. In the General page you can also make settings on connections using paths to agents.

To suppress actions triggered by double clicking:

1. Select an agent, network or request server. Next, choose Tools and then Options.
   The Options dialog box appears.
   

   Figure 4-56 Options dialog box

   

   Connect by double-click

   Specifies whether to connect to an agent by double clicking on it. By default, this check box is selected.

   When no connection option is specified on an agent, manage the connection history by IP address

   Specifies whether to record in the connection history the address of an agent for which no connection options are specified when connecting to the agent. By default, this check box is selected.

   Clear this check box to record the agent path in the connection history list when connecting to an agent.

   Search by double-click

   Specifies whether you want to search the network by double clicking on it. By default, this check box is selected.

   Close the Search Agents dialog box when search is completed

   Specifies whether to close the Search Agents dialog box automatically when the search of the network finishes in the Agent Manager. By default, this check box is selected.

   Start/stop by double-click

   Specifies whether or not double-clicking the request server will start or stop it. By default, this check box is selected.

2. Make necessary settings in the General page and then click OK.
   The Options dialog box is closed. The settings that you made will affect operations on agents, networks or request server.
   If you change the settings for the Search Agents dialog box, the settings in the Search Agents dialog box are also changed.
   

If you register executable files such as .EXE files and .BAT files (shell) as commands, you can execute them from the Agent Manager window. For example, you can run the Remote Control Manager from the Tools menu of the Remote Agent Manager if you register the executable file for the Remote Control Manager.

(a) Registering executable files as commands

To register an executable file as a command:

1. Choose Tools and then Options.
   The Options dialog box appears.
   
2. Click Add in the Tool page.
   The Add Tools dialog box appears.
   

   Figure 4-57 Add Tools dialog box

   

3. Specify the name of the executable file that you want to register, and then click OK.
   The Add Tools dialog box is closed. The Tool page displays the path to and the name of the specified executable file.
   

   Figure 4-58 Tool page

   

   Registration list

   Displays a list of registered commands. The names set in Menu are displayed.

   To add a command, click the Add button. To remove a command, click the Delete button. To change the sort order of the commands, select a command and then click the Shift Upward or Shift Downward button.

   Menu (required)

   Specify the command name to be displayed in the menu of the Agent Manager window. Use up to 260 characters for the command name. By default, the name of the executable file (except for the file extension) specified in the Add Tools dialog box is displayed. To use a character as an accelerator, add an ampersand (&) before the character.

   For example, if you want to assign R as an accelerator to the Remote Control menu, add (&R) after the menu name as shown below.

   Figure 4-59 Example of specifying the menu name (when setting an accelerator)

   
   

   File (required)

   Specify the name of the file to be executed with up to 260 characters. If the specified file does not exist or is not accessible, an error occurs when the tool starts. By default, the full pathname of the executable file specified in the Add Tools dialog box is displayed.

   Argument

   Specify the arguments to be passed to the command with up to 260 characters.

   The arguments can be information which is set for an item such as an agent or a network. Arguments for information about each item are defined as JP1/Remote Control reserved words. You can specify these arguments in the format of $(String). The arguments will be expanded when the command is executed. Therefore, the arguments that are defined as reserved words cannot be specified as command arguments. The table below lists the arguments defined as JP1/Remote Control reserved words.

   Table 4-6 Arguments defined as JP1/Remote Control reserved words

   Argument	Meaning
   $(Name)	name of an item
   $(Address)	address of an item
   $(Description)	(entire) description about an item
   $(Description-1)	first line of the description about an item
   $(Description-2)	second line of the description about an item
   $(Description-3)	third line of the description about an item
   $(Description-4)	fourth line of the description about an item
   $(Description-5)	fifth line of the description about an item
   $(Description-6)	sixth line of the description about an item
   $(Description-7)	seventh line of the description about an item
   $(Description-8)	eighth line of the description about an item
   $(Description-9)	ninth line of the description about an item

   You can specify item information arguments by selecting them from the pull-down list that is displayed by clicking the arrow next to the Argument field.

   Directory

   Specify the work directory for the command. If you omit this, the directory for the executable file is assumed.

   Agent

   Select this check box if you want to validate the registered command when an agent, a found agent, or a history agent is selected. This check box is selected by default.

   Network

   Select this check box if you want to validate the registered command when a network is selected. This check box is selected by default.

   Others

   Select this check box if you want to validate the registered command when a folder or a separator is selected. This check box is selected by default.

4. Specify the command name, the argument, items in the Valid item box and other necessary items and click OK.
   The specified executable file is registered as a command. The registered command name appears in the Tools menu.
   

(b) Checking commands

To check if the registered command runs successfully:

1. Select the object that you want to run the command on. Next, choose the registered command from the Tools menu.
   The command is executed. Note that you must re-register the command with the correct settings if an error message is displayed and execution is canceled in the following cases:
   
   • the arguments were not expanded correctly
   • the specified executable file does not exist or cannot be accessed