Hitachi

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


6.7.2 Linkage processing settings

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

Figure 6‒9: 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:

Organization of this subsection

(1) Execution start processing

(a) 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.2 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

(b) 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

(c) 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 8.2.5 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.

(2) 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.

(a) 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.2 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

(b) 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

(c) 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 8.2.5 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) 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.

(a) 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.2 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

(b) 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

(c) 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 8.2.5 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.

(4) 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.

(a) 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.2 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

(b) 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 8.2.5 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.