This command specifies an executed job in a parameter file and deletes it from the managing server.

dcmjbrm.exe /i parameter-file-name [/LC {ON|OFF}]

• /i
  Specify the full path for the parameter file to be used.
  You can also use the output file from the dcminst command (without the /s specification), the dcmcoll command (without the /s specification), the dcmjexe command, or the dcmsusp command (without the /s specification) as a parameter file.
  
• /LC
  Specify ON or OFF to indicate whether the command's processing is to continue after logging off from Windows when Task Scheduler or JP1/AJS is used to execute commands in the background.
  
  • ON
    Continues command processing even after logging off from Windows.
    
  • OFF
    Forcibly terminates command processing once Windows is logged off.
    
  This argument is effective when the command is executed from a service under any of the following OSs:
  
  • Windows NT 4.0
  • Windows 2000
  • Windows XP
  • Windows Server 2003 (excluding Windows Server 2003 (IPF))
  Do not specify /LC ON when you execute the command from the command prompt, because in this case the command is executed as a foreground program.
  You can use a registry setting to specify whether command processing is to continue after Windows is logged off. For details about the registry setting, see the following sections:
  
  • Executing the command in JP1/Software Distribution Manager
    4.6 Registry settings (JP1/Software Distribution Manager) in the manual Setup Guide
    
  • Executing the command in JP1/Software Distribution Client (relay system)
    5.4 Registry settings (JP1/Software Distribution Client (relay system)) in the manual Setup Guide
    
  Note that operation may differ depending on the combination of the /LC specification and the registry setting. For details, see 4.28 Command operation at logoff that depends on a registry setting and logoff option.
  

The table below shows the contents of the parameter file for the dcmjbrm command. The contents of the parameter file used in this command cannot be specified by using a command argument.

Table 4-12 Contents of the parameter file (dcmjbrm command)

Parameter file specification contents		Description	Specification	Command argument
Tag	Parameter
JOB_ATTRIBUTE	job_generator	Job name	X	--
	jobno	Job number	R	--
	job_folder	Job folder path	X	--
	unsuspended	Whether a distribution being suspended exists	X	--

Legend:

R: required.

X: not required (ignored if specified).

--: Cannot be specified in a command argument.

The following explains the return codes that the dcmjbrm command may return:

Code	Meaning	Action
0	Either job was deleted or specified job is not found.	None.
1	Unable to open parameter file. Invalid file format.	Check the parameter file specification or coding format.
2	Invalid value in command argument or parameter file.	Check the values in the parameter file.
3	Error during connection to managing server.	Check the version of the managing server.
5	Communication failure between client and managing server system.	Check the communications settings in the setup for the managing server.
12	Other errors occurred.	Check the event log.

If JP1/Base is linked to manage JP1/Software Distribution users, see 1.3.3 Setting for executing commands.

• In a parameter file, specify the job number that was output to an output file by the dcmcoll (no /s specification), dcminst (no /s specification), dcmjexe, or dcmsusp (no /s specification) command.
• The dcmjbrm command cannot be executed if there is an unknown job number for the job to be deleted. In this case, you should verify the job status of the job in the Job Status window of the managing server.

The following is an example of deleting the invoice-file-0001-collection job that was executed in the dcmjexe command.

(a) Creating a parameter file

In the parameter file, specify the job number that was output to the output file for the dcmjexe command as follows:

If the output file for the dcmjexe command has been saved, you can specify that file as a parameter file.

** dcmjexe output->dcmjbrm input
 
JOB_ATTRIBUTE{
job_generator= invoice-file-0001-collection
jobno= JB03121113315383
job_folder= \batch-definition
}

(b) Command execution

If the output file for the dcmjexe command has been saved in C:\Dmbat\out.txt, code the command as follows:

dcmjbrm.exe /i C:\Dmbat\out.txt