To register a tool in the Start Tool menu:

1. From the Option menu in the System Configuration, Destination or Directory Information window, select Start Tool and then Register Tool.
   The Tool Registration dialog box appears.
   You can also display the Tool Registration dialog box using one of the following methods:
   
   • Right-click a host displayed in the System Configuration, Destination or Directory Information window, select Start Tool, and then Register Tool.
   • Right-click a host displayed in the Find dialog box, select Start Tool, and then Register Tool.
     

     Figure C-1 Tool Registration dialog box

     

2. Specify the individual items.
   These items are explained as follows.
   

   Menu name (required)

   Use up to 255 characters to specify the menu name to be displayed in the Start Tool menu. Each menu name must be unique.

   To specify a shortcut key for the menu name being registered, use the menu-name(&X) format. The character specified for X becomes the shortcut key. For example, to register the R key as the shortcut key for a menu called Connection Check Tool, specify Connection Check Tool(&R).

   Path name of the tool (required)

   Use up to 260 characters to specify the full path name of the tool to be registered. In the dialog box that is displayed when the Browse button is clicked, you can specify the full path name of the selected tool. For Path name of the tool, you can also specify a host on the network or the reserved words shown in Table C-1.

   For Path name of the tool, specify an executable file, such as an EXE file, BAT file, and CMD file. The tool cannot start if a TXT file is specified. If a nonexistent or inaccessible file name is specified, an error occurs during the tool startup.

   Argument

   Use up to 260 characters to specify the value to be passed as the argument during the tool startup. To pass the system configuration information of the host selected by Remote Installation Manager as the argument, specify a reserved word. For details on how to specify a reserved word, see (2) Specifying reserved words.

3. Click Registration.
   The specified content is added to Menu list. You can register up to 10 tools.
   
4. Click OK.
   The Tool Registration dialog box closes and the tools displayed in Menu list are registered in the Start tool menu. If Cancel is clicked, no tool is registered.
   

To specify a reserved word:

• From the menu displayed when Argument is clicked, select the desired system configuration information.
• Enter a text string directly into the text box.

The following table shows the types of system configuration information that can be passed as arguments and their corresponding reserved words.

Table C-1 System configuration information and corresponding reserved words

System configuration information	Reserved word	Format to be passed to a tool
Operation ID Key	$(KEY)	When a host name is used: host-name When an IP address is used: XXX.XXX.XXX.XXX
Host Name	$(NAME)	host-name
IP Address	$(ADDRESS)	XXX.XXX.XXX.XXX
Host ID	$(HOSTID)	#host-id
MAC Address	$(MACADDRESS)	MAC-address
Route	$(ROUTE)	\route#1
Host Type	$(TYPE)	For a central manager or relay manager: MANAGER For a relay system: MASTER For a client: CLIENT
Update Date & Time	$(UPDATE)	YYYYMMDD.hhmmss
Creation Date & Time#2	$(CRTDATE)	YYYYMMDD.hhmmss
Comment	$(COMMENT)	comment

#1: ! is used as the delimiter for the system configuration information route. However, in the format to be passed to a tool, \ is used as the delimiter. For a host directly under the route, only \ is passed to the tool.

#2: Can be specified only for JP1/Software Distribution Manager.

Notes

• When directly entering a reserved word, you must use uppercase letters. For example, $(name) is not recognized as a reserved word.
• If the system configuration information contains no value, no value is entered in the specified reserved word.

In the following argument specification example, reserved words are specified to pass a host name, a host ID, and a MAC address as arguments to a tool.

/n $(NAME) /id $(HOSTID) /mac $(MACADDRESS)

When arguments are specified in this way, the following is executed when the tool is started:

This section explains how to change the menu name, path name of the tool, and argument registered in the Start Tool menu. Note that you cannot change the registered contents of multiple tools at the same time.

To change the registered content:

1. From Menu list in the Tool Registration dialog box, select the menu containing the registration content you want to change.
   The content registered in Menu name, Path name of the tool, and Argument are displayed.
   
2. Change the registration content.
3. Click Registration.
   The change is reflected in Menu list.
   
4. Click OK.
   The Tool Registration dialog box closes and the content of Menu list is reflected in the Start Tool menu. If you click Cancel, the change is not reflected in the Start Tool menu.
   

This section explains how to delete a tool that has been registered in the Start Tool menu. You can also select multiple tools and delete them all at once.

To delete a registered tool:

1. From Menu list in the Tool Registration dialog box, select the tool you want to delete.
2. Click Delete.
   The selected tool is deleted from Menu list.
   
3. Click OK.
   The Tool Registration dialog box closes and the content of Menu list is reflected in the Start Tool menu. If you click Cancel, the tool is not deleted.