13.14 dcmrtry.exe (re-executing a job)
This section describes the dcmrtry command, which re-executes a job.
Function
This command re-executes a job specified in the parameter file on the managing server.
Format
dcmrtry.exe [retry-key] /i parameter-file-name /o output-file-name
Arguments
-
retry-key
In this argument, specify the status of the job to be re-executed. Specify a retry key immediately after the command name. You can also specify retry keys, such as ERROR, WAIT, and PENDING, in any combination. When specifying multiple keys in a combination, separate them by a space. The default of the retry key is ERROR.
-
ERROR
Re-executes a job that has resulted in an error.
-
WAIT
Re-executes a job that is waiting for execution.
-
PENDING
Re-executes a job that has temporarily caused a communication error.
-
-
/i
In the argument /i, specify the full path name of the parameter file to be used.
You can use also the output file output by the dcmcoll command (without /s specified), dcminst command (without /s specified), dcmjexe command, or dcmsusp command (without /s specified) as the parameter file.
-
/o
In the argument /o, specify the full path name of the output file. When this command ends normally, the data that is the same as the contents of the specified parameter file is output to the specified output file.
Specification contents of parameter file
The table below shows the specification contents of the parameter file for the dcmrtry command. The contents of the parameter file for this command cannot be specified by using command arguments.
Specification content of parameter file |
Content |
Whether to specify |
Command argument |
|
---|---|---|---|---|
Tag |
Parameter |
|||
job_generator |
Job name |
N |
-- |
|
jobno |
Job number |
Y |
-- |
|
job_folder |
Path name of job storage folder |
N |
-- |
|
unsuspended |
Whether to distribute during suspension |
N |
-- |
Return codes
The following table lists the return codes that are output when the dcmrtry command is executed:
Code |
Meaning |
Action to be taken |
---|---|---|
0 |
Re-execution of a job started. |
None |
1 |
The parameter file cannot be opened, or the file format is incorrect. |
Check the specification of the parameter file or its description format. |
2 |
An invalid value was specified in the parameter file. |
Check the values specified in the parameter file. |
3 |
Connection to the database failed. |
Check database settings in the setup of the managing server. |
4 |
The output file cannot be opened. |
Check the specification of the output file. |
5 |
Connection to the JP1/IT Desktop Management 2 service failed. |
Check whether the service of JP1/IT Desktop Management 2 - Manager has started. |
12 |
Restoration of one or more archive files failed. |
Reference the event log. |
Notes
-
In the parameter file, specify the job number that was output to the output file by the dcmcoll command (without /s specified), dcminst command (without /s specified), dcmjexe command, or dcmsusp command (without /s specified).
-
If the job number of the job to be re-executed is unknown, you cannot execute the dcmrtry command. In such a case, in the Job Status window of the managing server, re-execute the job that has the job name of the job to be deleted.
Example
The following example shows use of this command to re-execute those jobs executed by the dcminst command which have been waiting for execution or resulted in an error.
- Creating the parameter file
-
Specify the job number output to the output file by the dcminst command in the parameter file as shown below.
If the output file output by the dcminst command has been stored, you can specify the stored file as the parameter file.
JOB_ATTRIBUTE{ job_generator= NETM_INSTALL_2003_12_11_13_34_36 jobno= JB03121113315383 job_folder= \ }
- Executing the command
-
When the output file output by the dcminst command is stored as the file C:\Dmbat\out.txt, specify the command as follows:
dcmrtry.exe WAIT ERROR /i C:\Dmbat\out.txt /o C:\temp\retryout.txt