Hitachi

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


14.6 dcminst.exe (creating and executing jobs)

This section describes the dcminst command, which creates and executes jobs.

You can check the result of a job executed by this command in the Job Status window of the managing server.

Function

This command creates and executes the following jobs related to remote installation:

Format

dcminst.exe [processing-key] [/f] [/s]
            /i parameter-file-1 [parameter-file-2]
            /o output-file-name

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‒5: Correspondence between parameter file contents and command arguments (dcminst command)

Specification content of parameter file

Content

Whether to specify

Command argument

Tag

Parameter

JOB_DESTINATION

group

Host group name

Y#1

/g value

host_name

Host name

Y#1

/h value

JOB_DESTINATION_ID

destination_id

ID name

Y#1

/X value

PACKAGING_INFORMATION#2

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

Y/N

/KW or /KP

JOB_ATTRIBUTE

job_generator

Job name

Y/N#3

/j value

jobno

Job number

N

--

job_folder

Path name of job storage folder

Y/N

/l value

unsuspended

Whether to distribute during suspension

Y/N#4

/uns value

JOB_SCHEDULE

job_entry_date

Job registration date and time

Y/N

/jst value

job_execution_date

Job execution date and time

Y/N

/jsx value

job_expiration_date

Job expiration date

Y/N

/jsp value

JOB_SPLIT_DELIVERY#4

split_size

Split size

Y/N

/sds value

wait_time

Distribution interval

Y/N

/sdt value

JOB_CLIENT_CONTROL

client_wake_up

Whether to start the client

Y/N

/WWU

client_shutdown

Whether to shut down the client

Y/N

/WUS

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

You cannot specify the JOB_DESTINATION tag together with the JOB_DESTINATION_ID tag. Also, you cannot specify /g and /h together with /X. You must specify only either JOB_DESTINATION or JOB_DESTINATION_ID, or either /g and /h or /X.

Note that, when the processing key is NETM_STORE or NETM_DELETE, you cannot specify an ID.

#2

For this command, you cannot use a reserved word for any parameter in the PACKAGING_INFORMATION tag.

#3

When the job_generator parameter (or the argument /j) is omitted, processing key and job execution date and time is automatically set as the job name. Therefore, if multiple commands with the same processing key are executed concurrently, their job names might be duplicated, and their jobs might not be executed correctly. We recommend that, when executing multiple commands with the same processing key concurrently, you specify different job names for the commands by using job_generator (or /j).

#4

You cannot specify the unsuspended parameter of the JOB_ATTRIBUTE tag together with the JOB_SPLIT_DELIVERY tag.

Command format without using any parameter file

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

dcminst.exe [processing-key] [/f] [/s]
            {[/g host-group-name] [/h host-name]|/X ID-name}
              /p package-name /I package-ID
              /v version/revision /G generation-number
              /c cabinet-name /C cabinet-ID
            [{/KW|/KP}]
            [/j job-name] [/l path-name-of-job-storage-folder]
            [/uns whether-to-distribute-during-suspension]
            [/jst job-registration-date-and-time] [/jsx job-execution-date and-time]
            [/jsp job-expiration-date]
            [/sds split-size] [/sdt distribution-interval]
            [/WWU whether-to-start-the-client]
            [/WUS whether-to-shut-down-the-client]
             /o output-file-name

Return codes

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

Code

Meaning

Action to be taken

0

The managing server started the job.

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 cannot be opened.

Check the specification of the output file.

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.

Notes

Example

The following example shows use of this command to distribute software packaged under the name of Finance Data 2003 5 to the hosts dmp491 and dmp492, on which JP1/IT Desktop Management 2 - Agent (agent) is running.

Creating the parameter file

Specify the hosts and the attributes of the packages as shown below, and then save the parameter file under any name.

** dcminst Parameter File Sample
 
JOB_DESTINATION{
host_name=dmp491;dmp492
}
PACKAGING_INFORMATION
{
package_name=Finance Data 2003 5
package_id=FD200305
version_revision=000001
generation=0000
cabinet_name=FCAB01
cabinet_id=F1
package_code=P
}
Executing the command

To store the created parameter file as C:\Dmbat\dcminst.txt and acquire the output file as C:\Dmbat\out.txt, specify the command as follows:

dcminst.exe /i C:\Dmbat\dcminst.txt /o C:\Dmbat\out.txt /j overwrite installation /f
Checking the output file

When the command ends normally, the job name, job number, and path name of the job storage folder are output to the file C:\Dmbat\out.txt as follows:

JOB_ATTRIBUTE{
job_generator= NETM_INSTALL_2003_12_11_13_34_36
jobno= JB03121113315383
job_folder= \
}