Job Management Partner 1/Automatic Job Management System 3 Operator's Guide

15.3.44 Tool Entry dialog box

In the Tool Entry dialog box, you can perform the following operations:

Assigning a name to a registered tool

Registering or changing the command associated with a tool

Setting whether to add a tool to the pop-up menu

The following figure shows the Tool Entry dialog box.

Figure 15-79 Tool Entry dialog box

The following explains the displayed items.

Entry name

Specify the name of a tool by using a character string no longer than 50 bytes. When you add a new tool, this field is blank by default. When you change the settings for an existing tool, the previous name is the default name. When you have set a tool to be available in the pop-up menu, the name specified here is displayed in the pop-up menu.

Spaces in a name are handled as shown below. In the following description, indicates a space.

If you place spaces between characters, the spaces are recognized as blanks.
Example: Tool1 --> Tool1

If you place spaces before or after a name, the spaces are ignored.
Example: Tool1 --> Tool1

If you specify only spaces, they are assumed to be a zero-byte string, which results in an error.
Example: -->

Add to pop-up menu

This check box allows for a tool to be available through the pop-up menu. When you register a tool with this check box selected, the tool is added to the pop-up menu that can be displayed in specific windows, so that the tool can be activated from the pop-up menu.

When you click the OK button in the dialog box with this check box selected, an asterisk (*) is displayed at the leftmost column of Tools list.

The pop-up menu can display a maximum of 10 items.

Command

Use a character string no longer than 2,048 bytes to specify the command that activates the tool. When you add a new tool, this field is blank by default. When you change the settings of an existing tool, the default command name is the previous command name. You can use the provided parameters that are dynamically replaced with specific entity names. You can also use relative path names. The following shows the current directory on which the relative path is based.

JP1/AJS3 - View installation folder

If you want to use a character string that includes spaces as an argument, enclose the character string in double quotation marks.

The handling of spaces specified in Command is the same as for Entry name.

... button

When you click the ... button beside the Command text field, the file selection dialog box provided by the OS appears. The following shows the directory that is initially opened in the dialog box.

JP1/AJS3 - View installation folder

When you select a file in the dialog box, the absolute path name of the file is set in Command.

Replace drop-down list and Insert button

You can insert a parameter at the cursor position in the Command text field, by selecting the parameter from the Replace drop-down list, and then clicking the Insert button.

The following table lists the items that can be selected from the Replace drop-down list, and the character strings inserted in the Command text field when the Insert button is clicked.

Item Character string to be inserted

Host name (HOST_NAME)

Service name (SERVICE_NAME)

Unit name (UNIT_NAME)

Character code (CHAR_CODE)

Supplementary note

After you close the dialog box by clicking the OK button, when you click the Close button in the Tool Settings dialog box, a KAVV386-Q message appears, regardless of whether or not the settings have been changed.

About parameters
At runtime, you can dynamically replace parameters with the actual host name, schedule service name, and full unit name. The parameter names are case sensitive. You can use the following parameters:

Parameter Description

(HOST_NAME) Connection-target host name

(SERVICE_NAME) Scheduler service name of the unit selected in the window

(UNIT_NAME) Full unit name of the unit selected in the window

(CHAR_CODE) Character code set for the scheduler service to which the unit selected in the window belongs (ASCII)

The following shows how parameters are replaced with entity names at runtime. In the following example, indicates a space.

Specified string

sample.exe(HOST_NAME)(SERVICE_NAME)(UNIT_NAME)

String after parameters are replaced

sample.exehost_AAJSROOT1/group/net/job

Whether the tool can be activated depends on the selection status of units. The following table describes the conditions when the tool can be activated.

Parameter Selection status of units in the window from which to activate the tool

No tools selected One tool selected More than one tool selected

(HOST_NAME) Y Y Y

(SERVICE_NAME) N^#1 Y Y

(UNIT_NAME) N^#1 Y^#2 N^#3

(CHAR_CODE) N^#1 Y Y

Legend:

Y: The tool can be activated.

N: The tool cannot be activated.

Note:

In the Daily Schedule window and Monthly Schedule window, if an item is selected in the tree area, the system assumes that a unit is selected, even when no units are selected in execution result list.

#1

The KAVV116-E error message appears.

#2

If a full path unit name includes any of the following characters, the KAVV389-E error message appears:

" (double quotation mark), &, ' (right single quotation mark), *, <, >, ?, [, \, ], ^, ' (left single quotation mark), {, |, }, and ~

#3

The KAVV145-E error message appears.

Activating a tool from the pop-up menu
When you register a tool with Add to pop-up menu selected, the tool is added to the pop-up menu that can be displayed in specific windows. You can activate the tool by choosing it from the pop-up menu. The following figure gives an overview of tool activation from the pop-up menu.

You can activate tools in the following windows:

JP1/AJS3 - View window (Main window)

JP1/AJS3 - View window (Summary Monitor window)

Jobnet Editor window

Jobnet Monitor window

Daily Schedule (Hierarchy) window

Daily Schedule (All Jobs) window

Monthly Schedule window

If the Options menu and its subordinate Set Tools menu are disabled, tools are not displayed in the pop-up menu.

Supplementary notes

To specify a full unit name including a scheduler service name, specify the following character string:
(SERVICE_NAME):(UNIT_NAME)

In Command, you can specify the same parameter more than once. The parameters that are identical are replaced with the same character string.

Example:

If you enter the command sample.exe(UNIT_NAME)(UNIT_NAME) when JOB1 is selected, the command name will be converted to sample.exe/group/net/JOB1/group/net/JOB1.

Supplementary note

When multiple units are selected in the window from which you want to activate a tool, if you execute a command with multiple (UNIT_NAME) parameters specified, a KAVV145-E error occurs. Multiple (UNIT_NAME) parameters are not replaced with different unit names.

When a parameter other than (UNIT_NAME) is specified more than once, the identical parameters are replaced with the same character string, regardless of whether more than one unit is selected.

Item	Character string to be inserted
Host name	(HOST_NAME)
Service name	(SERVICE_NAME)
Unit name	(UNIT_NAME)
Character code	(CHAR_CODE)

Parameter	Description
(HOST_NAME)	Connection-target host name
(SERVICE_NAME)	Scheduler service name of the unit selected in the window
(UNIT_NAME)	Full unit name of the unit selected in the window
(CHAR_CODE)	Character code set for the scheduler service to which the unit selected in the window belongs (ASCII)

Parameter	Selection status of units in the window from which to activate the tool
No tools selected	One tool selected	More than one tool selected
(HOST_NAME)	Y	Y	Y
(SERVICE_NAME)	N^#1	Y	Y
(UNIT_NAME)	N^#1	Y^#2	N^#3
(CHAR_CODE)	N^#1	Y	Y

[Contents][Back][Next]

[Trademarks]