14.7 dcmjbrm.exe (deleting a job)
This section describes the dcmjbrm command, which deletes an executed job.
Function
This command deletes, on the managing server, an executed job specified in the parameter file.
Format
dcmjbrm.exe /i parameter-file-name
Arguments
-
/i
In the argument /i, specify the full path name of the parameter file to be used.
You can also use the output file output by the dcmcoll command (without /s specified), the dcminst command (without /s specified), the dcmjexe command, or the dcmsusp command (without /s specified) as the parameter file.
Specification contents of parameter file
The table below shows the specification contents of the parameter file for the dcmjbrm 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 dcmjbrm command is executed:
Code |
Meaning |
Action to be taken |
---|---|---|
0 |
The specified job was set to the Now being deleted state, or was not found. |
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 the database settings in the setup of the managing server. |
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), the dcminst command (without /s specified), the dcmjexe command, or the dcmsusp command (without /s specified).
-
If the job number of the job to be deleted is unknown, you cannot execute the dcmjbrm command. In such cases, in the Job Status window of the managing server, delete the job that has the job name of the job to be deleted.
Example
The following example shows use of this command to delete the Collect-slip-file-0001 job executed by the dcmjexe command.
- Creating the parameter file
-
In the parameter file, specify the job number output to the output file by the dcmjexe command as shown below.
If the output file output by the dcmjexe command has been stored, you can specify the stored file as the parameter file.
** dcmjexe output->dcmjbrm input JOB_ATTRIBUTE{ job_generator= Collect-slip-file-0001 jobno= JB03121113315383 job_folder= \batch-definition }
- Executing the command
-
When the output file output by the dcmjexe command is stored as the file C:\Dmbat\out.txt, specify the command as follows:
dcmjbrm.exe /i C:\Dmbat\out.txt