4.2.3 Repeated execution plug-in
Function
This plug-in enables repeated execution of a flow. You can execute a service with a value specified in the Input Properties (inputProperties) for each iteration of the flow. This is useful, for example, when you want to execute the same processing on different servers.
Note that the execution methods for a flow include concurrent execution that executes flows in parallel, and sequential execution that executes the next flow when the current flow has finished executing.
Cautionary notes
-
When the execution of a task is stopped, the repeated flow being executed stops as soon as the plug-in finishes. In the case of a user-response wait plug-in, the flow stops without waiting for the plug-in to finish. Because unexecuted parts of the repeated flow are not executed, false is stored in the outputResult property.
-
When you forcibly terminate a task while a plug-in is executing, the processing being executed is immediately forcibly terminated and the task enters the Failed status. A return code of -1 appears for the step in the Task Details dialog box. The return code output to the task log depends on the timing with which the task was forcibly terminated.
-
If parallel is specified in the foreachMode property, the values of service properties referenced or updated in the context of a repeated task is only valid for the same repeated task (the nth flow). The value of the service property cannot be shared with concurrently processed repeated tasks (except for the nth flow).
-
When you use the Retry the Task From the Failed Step command with a repeated execution plug-in, processing restarts from the first step under the repeated execution plug-in. You cannot retry the task if the status of the step is Failed and the Completed status was set as a condition in the Subsequent-step Execution Condition area of the Create Step dialog box when the step was created.
-
When you use the Retry the Task From the Step After the Failed Step command with a repeated execution plug-in, JP1/AO executes the next step in the plug-in. In this case, the step enters the Completed status. However, the status remain unchanged for steps under the repeated execution plug-in that have already been executed.
Version
01.00.00
Category
Hitachi/Basic
Return codes
Return code |
Description |
---|---|
-1 |
The task was forcibly terminated while the plug-in was executing. -1 appears as the return code of the step in the Task Details dialog box. |
0 |
Ended normally. |
1 |
Some of the repeated processing failed. |
2 |
All of the repeated processing failed. |
65 |
The connection with the JP1/AO server failed. For example, the JP1/AO server might have stopped while the plug-in was executing. |
66 |
The following user is mapped to the JP1 user:
|
68 |
There is no information about the target job execution ID. |
69 |
An environment variable of the task-processing engine could not be acquired. |
80 |
Task execution has stopped. |
81 |
The plug-in was called in an invalid status. |
82 |
The request message from the task-processing engine could not be correctly parsed. |
83 |
The environment of the JP1/AO server is corrupted. |
84 |
Information about the specified plug-in could not be obtained. |
86 |
The specified property value is invalid. |
127 |
Another error has occurred. |
Property list
The following table describes the properties.
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
---|---|---|---|---|---|
inputProperties #1 |
Input Properties |
Specify an input property value for each repetition of the flow, using no more than 1,024 characters. You can specify a different property for each repetition. Use a comma to separate properties. Commas can only be used as delimiting characters. The maximum number of repetitions is 99. You cannot specify 100 or more comma-separated values. |
-- |
Input |
R |
outputProperties #2 |
Output Properties |
Outputs the value of the output property for the number of repetitions. The total output is 1,024 characters or less. At each repetition, one property value is output separated by a comma in the order specified in the inputProperties property. Use a comma as the delimiting character. |
-- |
Output |
O |
outputResult |
Results |
The execution result of each flow is output, separated by commas.
|
-- |
Output |
O |
foreachMode |
Mode |
Specify the execution method for the repeated flow.
|
parallel |
Input |
R |
- #1
-
The values specified in the inputProperties property are stored in the reserved.loop.input reserved property used in repeated flows. Because a different value is stored in the reserved.loop.input reserved property for each iteration of the repeated flow, specify the property in the ?dna_reserved.loop.input? format.
- #2
-
The outputProperties property stores the value of the reserved.loop.output reserved property used in the repeated flow.
Related topics
-
Property file (config_user.properties) in the Job Management Partner 1/Automatic Operation Configuration Guide
-
List of reserved properties in the Job Management Partner 1/Automatic Operation Service Template Development Guide