Hitachi

JP1 Version 13 JP1/Automatic Job Management System 3 for Cloud Service Applications


7.1.8 Execution definitions window

In the Execution definitions window, you can view and edit execution definitions in detail.

Figure 7‒9: Execution definitions window

[Figure]

The following shows the display items and input restrictions for the Execution definitions window:

Definition name

Enter the definition name of the execution definition information. It is saved in the format of /definition-name. It cannot be changed when editing.

Comment

Display the comment of the execution definition information.

JP1 resource group

Display the JP1 resource group of the execution definition information.

Outline tab

This tab shows the outline of the items in the right-hand definition area in a tree format. Clicking an item in the outline jumps to its corresponding item in the right-hand definition area.

Cautionary note

With an item hidden in the right-hand definition area, clicking the corresponding item in the outline does not jump to the item. Show in advance the hidden item in the right-hand definition area.

Variable information tab

Displays the variable information defined by each item in the definition area on the right side and the variable information that is reserved by the system and available by default.

Export button

Clicking this button outputs the execution information being displayed as the execution definition file (slexecdefExport.txt). This file will be output to the download folder set by the Web browser.

For details about an execution definitions file, see F.2 Execution definition file.

Note

Even during input of execution definitions, an execution definition file can be exported.

Import button

Click this button to display the Open dialog allowing you to select an execution definition file to be reflected to the screen. Select an execution definition file. It will be reflected on the Execution definitions screen.

For details about the format of an execution definition file, see F.2 Execution definition file.

Note

Even during input of execution definitions, an execution definition file can be imported.

Register button

Click this button to register the execution definitions, which have been input on the Execution definitions screen with JP1/AJS3 for Cloud Service Applications. When registration is successfully completed, the Home window is displayed. If an error occurs, the item with the error is highlighted.

Back button

Go to the Home window without doing anything.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Definition name

Text box

Character string of 1 to 30 bytes.

Single-byte alphanumeric characters, - (hyphen), and _ (underscore) are available.

Required

None

2

Comment

Text box

Character string within 243 bytes.

Not required

None

3

JP1 resource group

Text box

Character string within 63 bytes.

Single-byte alphanumeric characters and _ (underscores) are available.

Not required

JP1_CSA

Organization of this subsection

(1) Variable settings

This section explains about Variable settings in the Execution definitions window.

Figure 7‒10: Variable settings in the Execution definitions window

[Figure]

The following shows the display items for Variable settings:

AJS3 - View custom input items

Display added variables and the list of AJS3 - View label name.

Add button

Click this button to open the Setting variables dialog box. Up to 15 variables can be added. For details about this dialog, see 7.1.8(4) Setting variables dialog box.

Delete button

Click this button to delete the variable for the selected row.

Edit button

Click this button to open the Setting variables dialog box with the variable for the selected row. For details about this dialog, see 7.1.8(4) Setting variables dialog box.

↑ button

Move the variable in the selected row one row up.

↓ button

Move the variable in the selected row one row down.

Environment variables for the execution host

Display added variables and list of environment variables.

Add button

Click this button to open the Setting variables dialog box. Up to 32 variables can be added. For details about this dialog, see 7.1.8(4) Setting variables dialog box.

Delete button

Click this button to delete the variable for the selected row.

Edit button

Click this button to open the Setting variables dialog box with the variable for the selected row. For details about this dialog, see 7.1.8(4) Setting variables dialog box.

↑ button

Move the variable in the selected row one row up.

↓ button

Move the variable in the selected row one row down.

(2) Linkage processing settings

This section explains about Linkage processing settings in the Execution definitions window.

Figure 7‒11: Linkage processing settings in the Execution definitions window

[Figure]

[Figure]

[Figure]

[Figure]

The following shows the display items and input restrictions for the Linkage processing settings window:

(a) Execution start processing

■ Execution command settings

Command line

Enter the command line to run.

Environment variable at time of command execution

Enter an environment variable to be used for command line execution in the environment-variable-name=environment-variable-value format. When specifying multiple variables, enter a line break for each one.

Storing the standard output - Variable for storing the standard output

Enter a variable name in the ?CSAExxxx? format where the standard output details are stored for passing. Replace xxxx with a value.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Command line

Text box

Character string within 1,023 bytes.

A tab character can also be specified.

You can specify a variable in this input item.

Also, specify "@CSA(characters-to-escape)ASC@" at locations where escaping is required. For details, see section 4.3.3 Escaping a command line for cloud service linkage information.

Required

None

2

Environment variables at time of command execution

Text box

Character string of 20,479 bytes or less.

No line break is counted as part of the character string above.

A tab character can also be specified.

Up to 27,304 characters can be entered.

You can specify a variable in this input item.

Not required

None

3

Variable for storing the standard output

Text box

Character string of 58 bytes or less.

A to Z (uppercase alphabetical letters) and 0 to 9 (Arabic numbers) are available.

Not required

None

■ Execution result judgment

Return code judgment - Command end judgment

Select operation at the end of a command from either of the following.

  • Judge based on the end condition

    Judge the execution result as normal or abnormal based on the return code.

  • Always normal

    Judge the execution result always as normal regardless of the return code. When this item is selected, Abnormal end condition and Settings for abnormal end are hidden.

Abnormal end condition

Enter an abnormal end condition of the return code of the execution command.

Settings for abnormal end

Set operation when the abnormal end condition is met.

Job return code

Enter the return code of the job.

Execute post-processing (abnormal end)

Select this item when executing the processing set for Post-processing (abnormal end) before the end of the job.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Conditions for Abnormal end condition

List box

Select from the following.

Equal to (=), not equal to (!=), less than (<), more than (>), equal to or less than (<=), equal to or more than (>=)

Required

None

2

Value for Abnormal end condition

Text box

A numerical value between 0 and 2,147,483,647.

Required

None

3

Job return code

Text box

A numerical value between 1 and 50.

Required

None

Judgment of the output content (standard output) - Command end judgment

Select operation at the end of a command from either of the following.

  • Judge based on the end condition

    Judge the execution result as normal or abnormal based on the standard output details output by the command.

  • Always normal

    Judge the execution result always as normal regardless of the standard output details. When this item is selected, Processing normal end condition and Settings for abnormal end are hidden.

Processing normal end condition

Set the variable and its values for judging the normal end condition.

Variable

Enter a variable for judging the normal end condition in the ?CSAxxxxxx[YYYY]? or ?CSAxxxxx? format. Specify the YYYY with a value one less than the number of rows you want to use for judgment of the standard output. Even in the case of only one row, the YYYY needs to be specified (0 should be specified in such a case).

Value

Enter up to 10 values that match the value of the specified variable. Multiple values can be specified by entering a line break for each one. When the value matches the value stored in the specified variable, the processing is judged as normal end.

Settings for abnormal end

Set the operation when the processing normal end condition is not satisfied.

Job return code

Enter the return code of the job.

Execute post-processing (abnormal end)

Select this item when executing the processing set for Post-processing (abnormal end) before the end of the job.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Variable

Text box

Character string of 70 bytes or less.

The variable can be specified in the ?CSAxxxxxx[YYYY]? or ?CSAxxxxx? format. The characters that can be specified for xxxxxx and YYYY are as follows.

xxxxxx:

A to Z (uppercase alphabetical letters) and 0 to 9 (Arabic numbers)

YYYY: 0 to 9 (Arabic numbers)

Required

None

2

Value

Text box

Character string within 1,023 bytes.

No line break is counted as part of the character string above.

A tab character can also be specified.

Up to 1,032 characters can be entered.

You can specify a variable in this input item.

Required

None

3

Job return code

Text box

A numerical value between 1 and 50.

Required

None

■ Trace information settings

Log output settings

Configure settings for output to the service linkage job log file. For details about service linkage job log, see 9.2.6 Service Linkage Job Log.

Output the executed command line

Select whether to output the executed command line to the log.

Output the standard output

Select whether to output the standard output of executed commands to the log.

Output the standard error output

Select whether to output the standard error output of executed commands to the log.

Standard error output settings

Sets the output to the standard error output.

Output the executed command line

Select whether to output the executed command line to the standard error output.

Output the standard output

Select whether to output the standard output of the executed command to the standard error output.

Output the standard error output

Select whether to output the standard error output of the executed command to the standard error output.

(b) End confirmation processing

To perform the end confirmation processing of the service executed for the execution start processing, select Yes and set the items below. If No is selected, the items below are not shown.

■ Status check command settings

Command line

Enter the command line to run.

Environment variable at time of command execution

Enter an environment variable to be used for command line execution in the environment-variable-name=environment-variable-value format. When specifying multiple variables, enter a line break for each one.

Storing the standard output - Variable for storing the standard output

Enter a variable name in the ?CSAExxxx? format where the standard output details are stored for passing. Replace xxxx with a value.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Command line

Text box

Character string within 1,023 bytes.

A tab character can also be specified.

You can specify a variable in this input item.

Also, specify "@CSA(characters-to-escape)ASC@" at locations where escaping is required. For details, see section 4.3.3 Escaping a command line for cloud service linkage information.

Required

None

2

Environment variables at time of command execution

Text box

Character string of 20,479 bytes or less.

No line break is counted as part of the character string above.

A tab character can also be specified.

Up to 27,304 characters can be entered.

You can specify a variable in this input item.

Not required

None

3

Variable for storing the standard output

Text box

Character string of 58 bytes or less.

A to Z (uppercase alphabetical letters) and 0 to 9 (Arabic numbers) are available.

Not required

None

■ Execution result judgment

Return code judgment - Command end judgment

Select operation at the end of a command from either of the following.

  • Judge based on the end condition

    Judge the execution result as normal or abnormal based on the return code.

  • Always normal

    Judge the execution result always as normal regardless of the return code. When this item is selected, Abnormal end condition and Settings for abnormal end are hidden.

Abnormal end condition

Enter an abnormal end condition of the return code of the status check command.

Settings for abnormal end

Set operation when the abnormal end condition is met.

Job return code

Enter the return code of the job.

Execute post-processing (abnormal end)

Select this item when executing the processing set for Post-processing (abnormal end) before the end of the job.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Conditions for Abnormal end condition

List box

Select from the following.

Equal to (=), not equal to (!=), less than (<), more than (>), equal to or less than (<=), equal to or more than (>=)

Required

None

2

Value for Abnormal end condition

Text box

A numerical value between 0 and 2,147,483,647.

Required

None

3

Job return code

Text box

A numerical value between 1 and 50.

Required

None

Judgment of the output content (standard output) - Command end judgment

Select operation at the end of a command from either of the following.

  • Judge based on the end condition

    Judge the execution result as normal or abnormal and whether to retry the processing based on the standard output details output by the command.

  • Always normal

    Judge the execution result always as normal regardless of the standard output details. When this item is selected, the following are hidden: Processing normal end condition, Retry settings, and Settings for abnormal end.

Processing normal end condition

Set the variables and their values for judging the normal end condition and processing continuity condition.

Variable

Enter a variable name for judging the normal end condition and processing continuity condition in the ?CSAxxxxxx[YYYY]? or ?CSAxxxxx? format. Specify the YYYY with a value one less than the number of rows you want to use for judgment of the standard output. Even in the case of only one row, the YYYY needs to be specified (0 in such a case).

Value

Enter up to 10 values that match the value of the specified variable. Multiple values can be specified by entering a line break for each one. When the value matches the value stored in the specified variable, the processing is judged as normal end.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Variable for processing normal end condition

Text box

Character string of 70 bytes or less.

The variable can be specified in the ?CSAxxxxxx[YYYY]? or ?CSAxxxxx? format. The characters that can be specified for xxxxxx and YYYY are as follows.

xxxxxx:

A to Z (uppercase alphabetical letters) and 0 to 9 (Arabic numbers)

YYYY: 0 to 9 (Arabic numbers)

Required

None

2

Value for processing normal end condition

Text box

Character string within 1,023 bytes.

No line break is counted as part of the character string above.

A tab character can also be specified.

Up to 1,032 characters can be entered.

You can specify a variable in this input item.

Required

None

Retry settings

Select whether to retry the processing based on the standard output details of the command. To retry the processing, select Yes and set the Processing continuation conditions. If No is selected, the Processing continuation conditions is not shown.

Processing continuation conditions

Enter conditions for the continuing operation.

Value of the retry condition

Enter up to 10 values that match the value of the variable of the specified normal end condition. Multiple values can be specified by entering a line break for each one. When the value matches the value stored in the specified variable, re-execute the status check command after the Repeat interval.

Repeat interval

Enter an interval for repeated execution.

Number of times to repeat

Enter the number of times of repeated execution.

Total time

This item displays the total time to be taken for the retry of the end confirmation processing based on the Repeat interval and Number of times to repeat. For a value outside the range of input restriction, - is shown.

Note that the total time includes neither the execution time of the status check command nor any other processing time.

Settings at end of repeat - Job return code

Enter the return code of the job when the processing has been performed for the specified number of times.

Settings at end of repeat - Execute post-processing (abnormal end)

Select this item when executing the processing set for Post-processing (abnormal end) before the end of the job in the case where the processing has been performed for the specified number of times.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Value of the retry condition

Text box

Character string within 1,023 bytes.

No line break is counted as part of the character string above.

A tab character can also be specified.

Up to 1,032 characters can be entered.

You can specify a variable in this input item.

Required

None

2

Repeat interval

Text box

A numerical value between 0 and 10.

The unit is minutes.

Required

None

3

Number of times to repeat

Text box

A numerical value between 1 and 2,880.

Required

None

4

Total time

--

A numerical value between 1 and 2,880.

The unit is minutes.

This item displays the value of the product of the repeat interval and the repeat count.

Required

None

5

Job return code

Text box

A numerical value between 1 and 50.

Required

None

Settings for abnormal end

Set the operation when neither the normal end condition nor the processing continuity condition is met.

Job return code

Enter the return code of the job.

Execute post-processing (abnormal end)

Select this item when executing the processing set for Post-processing (abnormal end) before the end of the job.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Job return code

Text box

A numerical value between 1 and 50.

Required

None

■ Trace information settings

Log output settings

Configure settings for output to the service linkage job log file. For details about service linkage job log, see 9.2.6 Service Linkage Job Log.

Output the executed command line

Select whether to output the executed command line to the log.

Output the standard output

Select whether to output the standard output of executed commands to the log.

Output the standard error output

Select whether to output the standard error output of executed commands to the log.

Standard error output settings

Sets the output to the standard error output.

Output the executed command line

Select whether to output the executed command line to the standard error output.

Output the standard output

Select whether to output the standard output of the executed command to the standard error output.

Output the standard error output

Select whether to output the standard error output of the executed command to the standard error output.

(c) Post-processing (normal end)

To perform post-processing after normal termination, select Yes and set the following items. If No is selected, the items below are not shown.

■ Command settings

Command line

Enter the command line to run.

Environment variable at time of command execution

Enter an environment variable to be used for command line execution in the environment-variable-name=environment-variable-value format. When specifying multiple variables, enter a line break for each one.

Storing the standard output - Variable for storing the standard output

Enter a variable name in the ?CSAExxxx? format where the standard output details are stored for passing. Replace xxxx with a value.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Command line

Text box

Character string within 1,023 bytes.

A tab character can also be specified.

You can specify a variable in this input item.

Also, specify "@CSA(characters-to-escape)ASC@" at locations where escaping is required. For details, see section 4.3.3 Escaping a command line for cloud service linkage information.

Required

None

2

Environment variables at time of command execution

Text box

Character string of 20,479 bytes or less.

No line break is counted as part of the character string above.

A tab character can also be specified.

Up to 27,304 characters can be entered.

You can specify a variable in this input item.

Not required

None

3

Variable for storing the standard output

Text box

Character string of 58 bytes or less.

A to Z (uppercase alphabetical letters) and 0 to 9 (Arabic numbers) are available.

Not required

None

■ Execution result judgment

Return code judgment - Command end judgment

Select operation at the end of a command from either of the following.

  • Judge based on the end condition

    Judge the execution result as normal or abnormal based on the return code.

  • Always normal

    Judge the execution result always as normal regardless of the return code. When this item is selected, Abnormal end condition and Settings for abnormal end are hidden.

Abnormal end condition

Enter an abnormal end condition of the return code of the status check command.

Settings for abnormal end

Set operation when the abnormal end condition is met.

Job return code

Enter the return code of the job.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Conditions for Abnormal end condition

List box

Select from the following.

Equal to (=), not equal to (!=), less than (<), more than (>), equal to or less than (<=), equal to or more than (>=)

Required

None

2

Value for Abnormal end condition

Text box

A numerical value between 0 and 2,147,483,647.

Required

None

3

Job return code

Text box

A numerical value between 1 and 50.

Required

None

■ Trace information settings

Log output settings

Configure settings for output to the service linkage job log file. For details about service linkage job log, see 9.2.6 Service Linkage Job Log.

Output the executed command line

Select whether to output the executed command line to the log.

Output the standard output

Select whether to output the standard output of executed commands to the log.

Output the standard error output

Select whether to output the standard error output of executed commands to the log.

Standard error output settings

Sets the output to the standard error output.

Output the executed command line

Select whether to output the executed command line to the standard error output.

Output the standard output

Select whether to output the standard output of the executed command to the standard error output.

Output the standard error output

Select whether to output the standard error output of the executed command to the standard error output.

(d) Post-processing (abnormal end)

To perform post-processing after abnormal termination, select Yes and set the following items. If No is selected, the items below are not shown.

■ Command settings

Command line

Enter the command line to run.

Environment variable at time of command execution

Enter an environment variable to be used for command line execution in the environment-variable-name=environment-variable-value format. When specifying multiple variables, enter a line break for each one.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Command line

Text box

Character string within 1,023 bytes.

A tab character can also be specified.

You can specify a variable in this input item.

Also, specify "@CSA(characters-to-escape)ASC@" at locations where escaping is required. For details, see section 4.3.3 Escaping a command line for cloud service linkage information.

Required

None

2

Environment variables at time of command execution

Text box

Character string of 20,479 bytes or less.

No line break is counted as part of the character string above.

A tab character can also be specified.

Up to 27,304 characters can be entered.

You can specify a variable in this input item.

Not required

None

■ Trace information settings

Log output settings

Configure settings for output to the service linkage job log file. For details about service linkage job log, see 9.2.6 Service Linkage Job Log.

Output the executed command line

Select whether to output the executed command line to the log.

Output the standard output

Select whether to output the standard output of executed commands to the log.

Output the standard error output

Select whether to output the standard error output of executed commands to the log.

Standard error output settings

Sets the output to the standard error output.

Output the executed command line

Select whether to output the executed command line to the standard error output.

Output the standard output

Select whether to output the standard output of the executed command to the standard error output.

Output the standard error output

Select whether to output the standard error output of the executed command to the standard error output.

(3) Job output processing

This section explains about Job output processing in the Execution definitions window.

Figure 7‒12: Job output processing in the Execution definitions window

[Figure]

The following shows the display items and input restrictions for the Job output processing window:

Job standard output settings

Enter the contents to be output to the standard output as the job execution result.

Job standard error output settings

Enter the contents to be output to the standard error output as the job execution result.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Job standard output settings

Text box

Character string within 1,023 bytes.

Line breaks are also counted in the above string.

A tab character can also be specified.

You can specify a variable in this input item.

Not required

None

2

Job standard error output settings

Text box

Character string within 1,023 bytes.

Line breaks are also counted in the above string.

You can specify a variable in this input item.

Not required

None

(4) Setting variables dialog box

The Setting variables dialog is displayed for adding a new variable by pressing Add or editing an existing variable by pressing Edit in the AJS3 - View custom input items or Environment variables for the execution host.

Figure 7‒13: Setting variables dialog box for the AJS3 - View custom input items

[Figure]

Figure 7‒14: Setting variables dialog box for the Environment variables for the execution host

[Figure]

The following shows the display items and input restrictions for the Setting variables dialog box:

Variable name

When the system is started with the AJS3 - View custom input items, enter a variable name in the ?CSAExxxx? format with xxxx replaced with the desired value. This variable stores the standard output details entered on the details definition screen of the service linkage job of JP1/AJS3 - View and sets information to be passed. When the system is started with the Environment variables for the execution host, enter the name of the variable that stores the value of the environment variable set on the execution host and sets the information to be passed.

AJS3 - View custom input items

This item is displayed only when you click the Add or Edit button in AJS3 - View custom input items.

Label

Enter the label name of the input item on the detailed definition screen of the service linkage job of JP1/AJS3 - View.

String length

Enter the input string length in the detail definition screen of the service linkage job of JP1/AJS3 - View.

Prohibited characters

Enter characters with a regular expression that are to be prohibited to input on the details definition screen of service linkage jobs of JP1/AJS3 - View.

Available regular expressions are those that can be used in the .NET Framework. For details, see the related documents provided by Microsoft Corporation.

Environment variable name

This item is displayed only when Add or Edit is pressed in Environment variables for the execution host.

Enter an environment variable name to be stored in the variable.

OK button

Click this button to register the variable with the entered information.

Cancel button

Closes the Setting variable dialog box without doing anything.

No.

Display item

Input format

Input restriction

Required/Not required

Assumed value

1

Variable name

Text box

Character string within 58 bytes.

A to Z (uppercase alphabetical letters) and 0 to 9 (Arabic numbers) are available.

Required

None

2

Label

Text box

Character string within 60 bytes.

Required

None

3

String length

Text box

A numerical value between 1 and 19,500.

Required

None

4

Prohibited characters

Text box

Character string within 95 bytes.

Not required

None

5

Environment variable name

Text box

Character string within 64 bytes.

Required

None