Executing dcmadsync.exe (directory information acquisition command)

Function

This command provides the following functions:

Imports the display names defined in the map file
Performs code conversion on the passwords specified in the parameter file
Imports directory information according to the parameter file
Deletes the imported directory information

You must execute the dcmadsync.exe command separately for each function. For example, to import the display names defined in the map file and to perform code conversion on the passwords specified in the parameter file, you must execute the dcmadsync.exe command twice.

This command also enables you to re-assign system configuration for the imported directory information and check the assigned information.

Format

For importing the display names defined in the map file:

dcmadsync.exe /m map-file [/h host-name-at-connection-destination] [/u administrator's-user-ID] [/p password]

For performing code conversion on the passwords specified in the parameter file:

dcmadsync.exe /e parameter-file

For importing directory information according to the parameter file:

dcmadsync.exe [/a] /i parameter-file [/h host-name-at-connection-destination] [/u administrator's-user-ID] [/p password] [/s] [/r] [/c]

For performing re-assignment and checking the assigned information:

dcmadsync.exe [/s] [/r] [/c] [/h host-name-at-connection-destination] [/u administrator's-user-ID] [/p password]

For deleting imported directory information:

dcmadsync.exe /d [/h host-name-at-connection-destination] [/u administrator's-user-ID] [/p password]

Arguments

/m
Imports display names for the collection items specified in the map file. Specify the map file as a full path.
Specify this option during the initial import or when the collection items are to be changed.
If import processing is executed without this option specified and the corresponding display names have never been imported, the collection items will not be displayed in windows.
If the map file is changed for a reason such as a change in the collection items and then the display names are imported again, information about the display names that has already been imported is deleted. Therefore, the items that were not imported will no longer be displayed.
The only other options that can be specified when this option is specified are /h, /u, and /p.
/e
Performs code conversion on the passwords specified in the PASS tag in the parameter file. Specify the parameter file as a full path.
Although code conversion is optional, it is recommended that you perform it for security reasons.
Specify the parameter file converted by this option in the /i option when you acquire the directory information.
This option cannot be specified together with any other options.
/h
Specifies the host name of the JP1/Software Distribution database server. If this option is omitted, Localhost is set. If you use named instances in Microsoft SQL Server, specify the host name in the following format:
host-name-of-database-server\instance-name
The /h and /e options are mutually exclusive.
/a
For the second and subsequent import processing, the command imports only the changed information. However, if this option is specified, the command acquires all directory information including the unchanged information. If this option is omitted, the command acquires all directory information only during the first import processing, and acquires only the differential information thereafter.
This option cannot be specified together with the /m or /e option. However, this option can be specified together with the /r and /c options if the /i option is also specified.
/i
Specifies the full path of the parameter file that is to be used.
This option cannot be specified together with the/m or /e option.
/u
Specifies the administrator's user ID for the database that stores the imported data, as a maximum of 30 characters.
If this option is omitted, the administrator's user ID specified on the Database Environment page in the Server Setup dialog box is set.
The /u and /e options are mutually exclusive.
/p
Specifies the password for the database that stores the imported data, as a maximum of 30 characters. This option can be omitted if no password has been set.
The /p and /e options are mutually exclusive.
/s
Specifies that the processing progress status normally output to the standard output is to be suppressed.
If this option is omitted, the processing progress status is output to the standard output each time 100 objects are processed.
This option cannot be specified together with the /m or /e option.
/r
Re-assigns the imported directory information for a computer to which system configuration information has not been assigned.
If this option is specified together with the /i option, the command executes re-assignment as an extension of updated information import processing. If only the /r option is specified, the command executes only re-assignment.
This option is ignored when the /a option is specified as well as during the initial import processing.
If this option is specified together with the /c option, the /c option's processing is performed first.
/c
Checks the assigned information for the assigned computers for errors. If there is any change, the command updates the information.
If this option is specified together with the /i option, the command checks information as an extension of update information import processing. If only the /c option is specified, the command executes only checking.
This option is ignored when the /a option is specified as well as during the initial import processing.
If this option is specified together with the /r option, this option's processing is performed first.
/d
Deletes all the imported directory information.
This option cannot be specified together with any option other than /h, /u, or /p.

The following table shows the combinations of options that can be specified together.

Table 3-5 Combinations of options that can be specified together

Option	Options that can be specified together
Option	/m	/e	/h	/a	/i	/u	/p	/s	/r	/c	/d
/m	N	N	Y	N	N	Y	Y	N	N	N	N
/e	N	N	N	N	N	N	N	N	N	N	N
/h	Y	N	N	Y	Y	Y	Y	Y	Y	Y	Y
/a	N	N	Y	N	Y	Y	Y	Y	I	I	N
/i	N	N	Y	Y	N	Y	Y	Y	Y	Y	N
/u	Y	N	Y	Y	Y	N	Y	Y	Y	Y	Y
/p	Y	N	Y	Y	Y	Y	N	Y	Y	Y	Y
/s	N	N	Y	Y	Y	Y	Y	N	Y	Y	N
/r	N	N	Y	I	Y	Y	Y	Y	N	Y	N
/c	N	N	Y	I	Y	Y	Y	Y	Y	N	N
/d	N	N	Y	N	N	Y	Y	N	N	N	N

Legend:: Y: Can be specified together.; I: Can be specified only when the /i option is also specified.; N: Cannot be specified together (if specified, an error results).

Return codes

The following table lists and describes the return codes that can be set as a result of execution of the dcmadsync command:

Code	Description	Action
0	Import processing from Active Directory terminated normally. Map file import processing terminated normally. Conversion processing on the parameter file terminated normally. The command terminated normally.	None
1	A file open error occurred on the parameter file or map file, or the file format is invalid.	Check the specification and format of the parameter file or map file.
2	An invalid value is specified in the command arguments or parameter file.	Check the values specified in the command parameters or parameter file.
5	Another process is currently performing import processing.	Wait a while and then re-execute the command.
12	Another error occurred.	Check the event log.
21	Processing was cancelled because the Active Directory was not set to be linked.	Check the settings specified during setup.
22	A map file import error occurred.	Check the event log.
23	A parameter file conversion error occurred.	Check the event log.
24	Import from one or more Active Directories resulted in an error.	Check the event log.

If JP1/Software Distribution users are managed in linkage with JP1/Base, also see 1.3.3 Setting for executing commands in the manual Administrator's Guide Volume 2.

Notes

If the Active Directory administrator has created a unique OU, group, computer, user, and InetOrgPerson without using the provided standard GUI, set at least one of the OU, group, computer, user, or InetOrgPerson classes in the Active Directory object class. If the set class is not OU, group, computer, user, or InetOrgPerson, the information will not be imported.
Only one instance of this command can be executed at a time.
If a specified attribute name is misspelled, the intended item is not imported, but processing terminates normally. If importing of a specific item fails, check first for a typographical error.
When the command converts passwords in the parameter file, it first creates a temporary file whose extension is .dcmadsync, deletes the original file, and then renames the temporary file to the name of the original file. If any existing file has the same name as the temporary file, that file will be overwritten.
If renaming of the temporary file fails, re-execute the command using the file retained as original-file-name .dcmadsync because the original file has been deleted.
If OU information has been changed in the Active Directory, it may take a while to import the directory information.

Execution examples

The following shows examples of importing directory information using the sample map file and parameter file.

Importing the display names using the sample map file
dcmadsync.exe /m "c:\Program Files\HITACHI\NETMDM\SAMPLE\dcmadsync\samplemap.txt"
Performing code conversion on the passwords in the sample parameter file
dcmadsync.exe /e "c:\Program Files\HITACHI\NETMDM\SAMPLE\dcmadsync\sampleparameter.txt"
Importing the directory information using the parameter file on which password code conversion is to be performed (storage destination: DBHOST, user ID: sa, password: password)
dcmadsync.exe /i "c:\Program Files\HITACHI\NETMDM\SAMPLE\dcmadsync\sampleparameter.txt" /h DBHOST /u sa /p password
Deleting all acquired directory information from the database (storage destination: DBHOST, user ID: sa, password: password)
dcmadsync.exe /d /h DBHOST /u sa /p password

All Rights Reserved. Copyright (C) 2009, 2013, Hitachi, Ltd.
Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated.

3.4.5 Executing dcmadsync.exe (directory information acquisition command)