8.13 checkitdmhost (checking the format of the file for connection destinations)
This section describes the checkitdmhost command, which checks whether the file for connection destinations (itdmhost.conf) used for automatically setting connection destinations of agents conforms to the required file format.
Functionality
This command checks whether the file format requirements of the file for connection destinations (itdmhost.conf) are satisfied.
When you execute this command, the file for connection destinations specified in the argument is checked line by line. The line number of a line with invalid syntax is output in a message. Even if invalid syntax is found, the command continues to check the next line. The command stops checking after the last line. However, if the number of lines with invalid syntax exceeds 100, the command displays a syntax error and stops checking. Note that if another error occurs during the check, the command stops checking to display the error.
In the file for connection destinations, the syntax of a line is determined to be invalid in the following cases:
-
A required item is omitted.
-
An invalid IP address is specified.
-
The value specified for connection-destination exceeds the maximum number of characters that can be entered.
-
A value other than netmdm or netmdmw is specified for connection-type in the DM section.
-
An invalid value is specified for multicast-distribution-address in the DM section.
-
An item other than the items that can be specified for the line is specified.
-
An invalid value is specified for the section name.
-
The same section is specified more than once.
In this case, the items in the duplicate sections are still checked.
-
No section is specified.
-
Either the ITDM section or the DM section is specified, but not both.
A line specified as follows is not handled as invalid, but all or part of the line is ignored:
-
Any text following a semicolon
Such text is handled as a comment.
-
A line containing only a line break
-
Single-byte spaces at the beginning or end of an item
Execute this command on the management server.
Format
checkitdmhostΔ-iΔinput-file-name
Argument
- -i
-
Use an absolute path of 200 bytes or less to specify the file for connection destinations (itdmhost.conf) whose format you want to check.
Storage location
JP1/IT Desktop Management 2-installation-folder\mgr\bin\
If you use the command prompt provided by JP1/IT Desktop Management 2, you can execute this command without having to specify where the executable file is stored.
Return values
The following table shows the return values of the checkitdmhost command.
|
Return value |
Description |
|---|---|
|
0 |
The command finished normally. |
|
11 |
The command argument syntax is invalid. |
|
12 |
An access error for the specified file for connection destinations occurred. |
|
13 |
The name of the specified file for connection destinations is invalid. |
|
80 |
The format of the specified file for connection destinations is invalid. |
|
101 |
Command execution failed due to insufficient memory. |
|
150 |
Command execution was interrupted due to some other error. |
Example
In the following example, the command is being used to check the format of the file for connection destinations in C:\work1\.
checkitdmhost -i C:\work1\itdmhost.conf