13.12 dcmpkrm.exe (deleting a package)
This section describes the dcmpkrm command, which deletes a package.
Function
This command deletes a specified package from a specified cabinet in the managing server.
Format
dcmpkrm.exe /i parameter-file-name [/LC {ON|OFF}]
Arguments
-
/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 dcmpack command as the parameter file.
-
/LC
In the argument /LC, write ON or OFF to specify whether to continue command processing even if you log off from Windows while executing this command as a background service by using the Task Scheduler or JP1/AJS.
-
ON
Continues command processing even when you log off from Windows.
-
OFF
Forcibly ends command processing when you log off from Windows.
This argument is effective when this command is executed from a service on the following OS:
-
Windows Server 2003
When you enter this command from the command prompt, this command is executed as a foreground program. Therefore, in such a case, do not specify /LC ON.
You can also use a registry to set whether to continue command processing even if you log off from Windows.
Note that the command operation differs depending on the combination of the specification of the argument /LC and the setting in the registry. For details, see 13.20 Command operation at logoff according to registry setting and logoff option.
-
Specification contents of parameter file
The table below shows the specification contents of the parameter file for the dcmpkrm 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 |
|||
package_name |
Package name |
N |
-- |
|
package_id |
Package ID |
Y |
-- |
|
version_revision |
Version/revision |
Y |
-- |
|
generation |
Generation number |
Y |
-- |
|
cabinet_name |
Cabinet name |
N |
-- |
|
cabinet_id |
Cabinet ID |
Y |
-- |
|
package_code |
Code type |
Y |
-- |
- Legend:
-
Y: The parameter must be specified.
N: The parameter is not necessary (is ignored even when specified).
--: The content cannot be specified by using a command argument.
- Note
-
For this command, you cannot use a reserved word for any parameter in the PACKAGING_INFORMATION tag.
Return codes
The following table lists the return codes that are output when the dcmpkrm command is executed:
Code |
Meaning |
Action to be taken |
---|---|---|
0 |
The command ended normally. |
None |
1 |
The parameter file was not found, or its 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. |
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. |