Hitachi

JP1 Version 12 JP1/IT Desktop Management 2 Distribution Function Administration Guide

14.9 dcmpack.exe (executing packaging)

This section describes the dcmpack command, which packages user data and user programs.

Function

This command packages user data and user programs in the managing server (JP1/IT Desktop Management 2 - Manager).

This command cannot package program products.

Format

dcmpack.exe /k password
            /i parameter-file-name [/o output-file-name]
            [/split /tempdir temporary-folder-name [/splitfilesize size-of-files-after-split]]

Arguments

Correspondence between the specification contents of parameter file and command arguments

The contents of the parameter file for this command can also be specified in command arguments. The following table shows the specification contents of the parameter file and the command arguments corresponding to them.

Table 14‒8: Correspondence between parameter file contents and command arguments (dcmpack command)

Specification content of parameter file

Content

Whether to specify

Command argument

Tag

Parameter

PACKAGING_SOURCE

file_path

Name of packaging-target file

Y/N

/P value

base_fullpath

Path name of packaging base directory

Y

/B value

PACKAGING_INFORMATION

package_name

Package name

Y

/p value

package_id

Package ID

Y

/I value

version_revision

Version/revision

Y

/v value

generation

Generation number

Y

/G value

cabinet_name

Cabinet name

Y

/c value

cabinet_id

Cabinet ID

Y

/C value

package_code

Code type

N

--

SYSTEM_CONDITIONS

directory

Installation-target directory

Y/N

/D value

condition

System condition

Y/N#1, #2

/O value

SOFTWARE_CONDITIONS

condition

Package condition

Y/N#1, #2

/l value

INSTALLSOFTWARE_CONDITIONS

condition

Software condition

Y/N#3

--

FILE_PROPERTIES

permission

Restoration of file access permission

Y/N

/qY or /qN#4

SCHEDULE

expiration_date

Expiration date of package storage on relay computer

Y/N

/x value

expiration_days

The relay computer holds relayed packages for

Y/N

/ed value

installation_date_and_time

Installation date and time

Y/N

/d value

installation_timing

Execution timing

Y/N

/tS or /tN

INSTALLATION_METHOD

installation_mode

Installation mode

Y/N

/mB or /mG

OPTION

compress

Whether to compress

Y/N

/uY or /uN

compress_type

Compression mode

Y/N

/ctN or /ctH#5

restore

Whether to restore at upgrading

Y/N

/RY or /RN

reboot

Computer restart after installation

Y/N

/reboot

processing_dialog

Whether to display processing message during installation

Y/N#2

/procS, /procY, or /procN

USER_PROGRAM_INSTALLATION_CONDITIONS

external_program_executed_before_installation#6

External program to be started before installation

Y/N

/b value

external_program_executed_after_installation

External program to be started after installation

Y/N

/a value

external_program_error_handler#7

External program to be started at installation error

Y/N

/e value

external_program_handler

External program to be started

N

--

exit#7

How to report the processing result of external program

Y/N

/rbR, /rbM, /raR, /raM, /reR, or /reM

action#7

Action to take when processing result is error

Y/N

/ybC, /ybS, /yaC, or /yaS

wait#7

Monitoring method

Y/N

/wbU, /wbT, /wbG, /waU, /waT, /waG, /weU, or /weY

timeout

Monitoring time

Y/N#8

/n value

wait_code

Monitoring code

N

--
Legend:

Y: The parameter must be specified.

Y/N: The parameter can be omitted.

N: The parameter is not necessary (is ignored even when specified).

--: The content cannot be specified by using a command argument.

#1

If multiple sets of system condition and package condition are specified, the package is installed when all the system conditions are met and at least one of the package conditions is met. When using command arguments to specify system and package conditions, you can specify a total of 10 arguments /O and /l.

#2

You cannot specify this parameter for packages to be distributed to UNIX computers.

#3

If multiple software conditions are specified, the package is installed when at least one of the specified conditions is met.

#4

Specify /qN for packages to be distributed to UNIX computers.

#5

Specify /ctN for packages to be distributed to UNIX computers.

#6

For packages to be distributed to UNIX computers, this parameter is ignored if you specify the installation_date_and_time parameter for the SCHEDULE tag at the same time.

#7

For packages to be distributed to UNIX computers, this parameter is ignored even if it is specified.

#8

When U is specified in the wait parameter (or when /wbU, /waU, or /weU is specified as a command argument), the timeout parameter is ignored even if specified.

Command format without using any parameter file

The following shows the command format to be used when you specify only command arguments without using a parameter file:

dcmpack.exe /k password
            [/P name-of-packaging-target-file]
             /B path-name-of-packaging-base-directory
             /p package-name /I package-ID
             /v version/revision /G generation-number
             /c cabinet-name /C cabinet-ID
            [/D installation-target-directory]
            [/O system-condition] [/l package-condition]
            [{/qY|/qN}] [/x expiration-date-of-package-storage-on-relay-computer]
            [/ed the-relay-computer-holds-relayed-packages-for]
            [/d installation-date-and-time] [{/tS|/tN}] [{/mB|/mG}]
            [{/uY|/uN}] [{/ctH|/ctN}] [{/RY|/RN}]
            [/reboot] [{/procS|/procY|/procN}]
            [/b external-program-to-be-started-before-installation [{/rbR|/rbM}]
            [{/ybC|/ybS}] [{/wbU|/wbT|/wbG}] [/n monitoring-time]]
            [/a external-program-to-be-started-after-installation [{/raR|/raM}]
            [{/yaC|/yaS}] [{/waU|/waT|/waG}] [/n monitoring-time]]
            [/e external-program-to-be-started-at-installation-error
            [{/reR|/reM}] [{/weU|/weY}] [/n monitoring-time]]
            [/o output-file-name]
            [/split /tempdir temporary-folder-name [/splitfilesize size-of-files-after-split]]

Return codes

The following table lists the return codes that are output when the dcmpack command is executed:

Code

Meaning

Action to be taken

0

The command ended normally.

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 a command argument or the parameter file.

Check the values specified in command arguments and the parameter file.

3

Connection to the database failed.

Check database settings in the setup of the managing server.

4

The output file could not be created, or automatic incrementing of the version/revision and generation numbers for which reserved words were used failed. The package, however, was registered successfully.

Check the specified path names of the files to be packaged.

5

Connection to the JP1/IT Desktop Management 2 service failed.

Check whether the service of JP1/IT Desktop Management 2 - Manager has started.

6

Data communication with the managing server failed.

Check the communication environment.

7

This code means one of the following:

  • No packaging-target file or directory was found.

  • Number of packaging-target files or directories exceeded the maximum limit.

  • Check the specified path names of the files or directories to be packaged.

  • Reduce the number of the files or directories to be packaged.

9

The packaging-target file has already been packaged.

Change the value of one of the following parameters, and then retry packaging.

  • Cabinet ID

  • Package ID

  • Version number

  • Generation number

12

Restoration of one or more archive files failed.

Reference the event log.

13

The password is invalid.

Check the specified password.

14

Package registration failed because incrementing of the version/revision or generation number exceeded the maximum allowable number of digits.

Check the settings of reserved words for version/revision and generation numbers.

32

An error occurred when the split file was output.

Check the existence of the folder specified by the /tempdir argument, the access permissions to that folder, and the free space of the folder.

Notes

Example

The following example shows use of this command to package the files stored under the directory C:\Finance\data0401, by using the package name and cabinet name described below.

Creating the parameter file

Create the following parameter file:

** dcmpack Parameter File Sample
 
PACKAGING_SOURCE{
file_path=FD200304.dat
base_fullpath= C:\Finance\data0401
}
PACKAGING_INFORMATION
{
package_name=Finance Data 2003 4
package_id=FD200304
version_revision=000001
generation=0000
cabinet_name=FCAB01
cabinet_id=F1
package_code=P
}
SYSTEM_CONDITIONS{
condition=H:c>=300
directory=C:\Finance
}
USER_PROGRAM_INSTALLATION_CONDITIONS
{
external_program_executed_after_installation = C:\Dmbat\app\normal_exit.exe
}
Executing the command

When the created parameter file is stored as C:\Dmbat\para.txt, specify the command as follows: 

dcmpack.exe /i C:\Dmbat\para.txt

To Page Top

Copyright (C) 2019, 2022, Hitachi, Ltd.

Copyright (C) 2019, 2022, Hitachi Solutions, Ltd.

Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated.