cpajobrun
- Organization of this page
Function
Reruns a finished job.
Format
cpajobrun -r -i job-name [-o job-execution-ID-in-ended-state] {-t|-l|-n}
Permission for execution
None
Arguments
- -r
-
Reruns a job that is in an Ended state. This option is allowed only for jobs executed on time.
- -i job-name
-
Specify the job name of the job to rerun.
A job name can include multibyte characters, alphanumeric characters, and underscores (_) and the length must be from 1 to 45 bytes.
- -o job-execution-ID-in-ended-state
-
Specify the ID of the job execution unit you want to rerun. Omitting this option causes the system to rerun the last job execution unit.
A job execution ID can include alphanumeric characters and hyphens (-) and the length must be from 1 to 40 bytes. You can use the cpareport command to see job execution IDs. For details, see the description in cpareport.
- -t
-
Reruns the job from the top.
- -l
-
Reruns the job from the action with the status of Ended abnormally or Ended abnormally (Cancel).
- -n
-
Changes the action with the status of Ended abnormally or Ended abnormally (Cancel) to the Ended normally status and reruns the job from the next action.
Return values
0 |
Succeeded |
11 |
Nothing is done because the specified job is stopped. |
40 |
Insufficient resources |
45 |
System error (temporary exclusion error) |
50 |
Not allowed to access the system settings file (config.xml). |
52 |
There is no appropriate privilege for the executable file. |
58 |
Syntax error in arguments |
65 |
Cannot rerun the specified job because it is a job executed on event. |
67 |
The specified job or job execution ID does not exist. |
79 |
Could not rerun the job because it was not in an Ended state. |
80 |
Tried to rerun the job when it was already rerunning. |
94 |
The system settings file (config.xml) is invalid. |
96 |
The job or item is invalid. |
109 |
The system settings file (config.xml) does not exist. |
111 |
System error (file open error) |
119 |
System error (Too many connections were attempted for the message communication service.) |
124 |
System error (I/O error) |
125 |
System error or other error |
126 |
Program error |
Environment requirements
This command can run only when the job execution service is running.
Command stored in:
install-path\bin
Note that the command is stored in the following folder by default.
- In a 32-bit operating system:
-
%ProgramFiles%\Hitachi\JP1CPA\bin
- In a 64-bit operating system:
-
%ProgramFiles(x86)%\Hitachi\JP1CPA\bin
Notes
This rerun command uses the original job definition created when the job was registered. To rerun a job with a different job definition, you must register the job again or register a new job.