This command restores a package from its backup file and stores the restored package in the specified cabinet.

dcmpkput.exe [/C cabinet-ID] /i input-directory
              [/of input-file-name] [/f] [/LC {ON|OFF}]

• /C
  In cabinet-ID, specify the identifier of the cabinet for storing the package restored from its backup. If the specified cabinet does not exist, the command automatically creates it. If you do not specify a cabinet ID, the command stores the restored package in the same cabinet as the cabinet in which the original package was stored.
  
• /i
  In input-directory, specify the full pathname of the output directory specified in the dcmpkget command. You cannot specify a network drive as the input directory.
  
• /of
  In input-file-name, specify the name of a backup file created by the dcmpkget command. You can use a wildcard (*) in this argument. The default is any backup file beginning with dcmpkget.
  If the directory specified in the /i argument contains more than one backup file, you can specify all the backup files in the directory by using the following command format:
  dcmpkput.exe /i C:\temp\pkg /of *
  
• /f
  If the output directory already contains a package that has the same name as the package you want to restore, the command overwrites it. If you do not specify this argument, the command returns the code 5, without overwriting the existing package.
  
• /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 following explains the return codes that the dcmpkput command may return:

Code	Meaning	Action
0	The package(s) were successfully restored.	None.
1	The command cannot open the output file generated by the dcmpkget command. Alternatively, the format of the output file is incorrect.	Check the pathname or format of the output file.
2	An invalid value is specified in a command argument.	Check the values of command arguments.
3	Error during connection to managing server.	Check the version of the managing server.
4	The specified backup file does not exist.	Check the pathname of the backup file.
5	A package with the same name as the package you attempted to restore exists. Alternatively, the cabinet cannot contain more packages.	Check the names of the packages or the number of packages in the cabinet.
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.

• If the dcmpkput command has more than one package specified and fails during processing, the command cancels restoring the packages and returns a code indicating an error.
• To restore from a backup of a UNIX version of a package, you must specify as the registration target an existing cabinet whose type is WS. Restoration from a backup is not possible when the cabinet type is PC or the specified cabinet does not exist.
• When restoring the backup for a UNIX package, specify an existing WS-type cabinet as a destination. Such a backup cannot be restored to a new cabinet or PC-type cabinet.

The following is an example of restoring the package from the backup file made with the dcmpkget command.

To restore all the backup files saved to C:\Dmbat\backup to the cabinet whose cabinet ID is 01, specify the following command:

dcmpkput.exe /C 01 /i C:\Dmbat\backup /of *