Deletes a package from a cabinet for the managing server.

dcmpkrm.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 dcmpack command 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 dcmpkrm command. The contents of the parameter file used in this command cannot be specified by using command arguments.

Table 4-16 Contents of the parameter file (dcmpkrm command)

Parameter file specification contents		Description	Specification	Command argument
Tag	Parameter
PACKAGING_INFORMATION	package_name	Package name	X	--
	package_id	Package ID	R	--
	version_revision	Version/revision	R	--
	generation	Generation	R	--
	cabinet_name	Cabinet name	X	--
	cabinet_id	Cabinet ID	R	--
	package_code	Package code	R	--

Legend:

R: required.

X: not required (ignored if specified).

--: Cannot be specified in a command argument.

Note

In this command, a reserved word cannot be used as a parameter for the PACKAGING_INFORMATION tag.

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

Code	Meaning	Action
0	Normal termination.	None.
1	No parameter file or invalid file format.	Check the parameter file specification or coding format.
2	Invalid value in parameter file.	Check the values in the parameter file.
3	Error during connection to managing server.	Check the settings or communications environment for the PC on which the deletion of the package is executed.
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.