8.14 checkitdmigw (checking the format of the Internet gateway file for connection destinations)
This section describes the checkitdmigw command, which checks whether the Internet gateway file for connection destinations (itdmigw.conf) used for automatically setting connection destinations of agents conforms to the required file format, and obfuscate the Internet gateway file for connection destinations (itdmigw.conf).
Functionality
This command checks whether the file format requirements of the Internet gateway file for connection destinations (itdmigw.conf) are satisfied, and outputs an obfuscated Internet Gateway connection destination configuration file.
When you execute this command, the Internet gateway 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 Internet gateway 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.
-
An item other than the items that can be specified for the line is specified.
-
An item other than an item that can be specified for one 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.
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 or the agent.
Format
checkitdmigw∆-i∆input-file-name∆-o∆output-folder
Argument
- -i
-
Specify the Internet gateway file for connection destinations (itdmigw.conf) whose format is to be checked as an absolute path of 200 bytes or less. If the path contains any single-byte spaces, enclose the entire path in ".
The filename must be itdmigw.conf.
- -o
-
Specify the output folder of the obfuscated Internet gateway file for connection destinations (itdmigw.conf) after the format check in an absolute path of no more than 200 bytes. If the path contains any single-byte spaces, enclose the entire path in ".
The same folder as the input file specified with the -i option cannot be specified.
Return values
The following table shows the return values of the checkitdmigw command.
|
Return value |
Description |
|---|---|
|
0 |
The command finished normally. |
|
11 |
The command argument syntax is invalid. |
|
12 |
An access error for the specified Internet gateway file for connection destinations occurred. |
|
13 |
The name of the specified Internet gateway file for connection destinations is invalid. |
|
15 |
A file access error occurred when outputting the file, or the disk does not have sufficient capacity. |
|
80 |
The format of the specified Internet gateway 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 for checking the format of the Internet gateway file for connection destinations created in C:\work1\ and outputting the obfuscated Internet gateway file for connection destinations to C:\work2\.
checkitdmigw -i C:¥work1¥itdmigw.conf -o C:¥work2¥