jpciniupdate
- Organization of this page
Format
jpciniupdate -i update-target-definition-file-name -u update-contents-file-name
Function
The jpciniupdate command updates the values of the settings in a definition file. You can create a file in advance that contains the values of the updates to the settings, and then execute the jpciniupdate command to apply the updates to the settings in the specified definition file.
If the definition file to be updated and the file containing the updates have the same section names and label names, this command updates the values of the settings in the definition file. If section names and label names are not found in the definition file, they are added and the values are set. Caution is required because the updates are performed as specified, regardless of whether the new values of the settings are valid.
Hosts that can execute the command
-
PFM - Manager
-
PFM - Agent
-
PFM - RM
Execution permission
- In Windows:
-
User with Administrators permissions
- In UNIX:
-
User with root user permissions
Installation directory
- In Windows:
-
installation-folder\tools\
- In UNIX:
-
/opt/jp1pc/tools/
Definition files that can be updated
The following definition files can be specified as update targets:
-
jpccomm.ini
-
jpcsto.ini
You can update the setting values of the modifiable labels in the above definition files by editing the files. For details about the types of labels that can be updated, see the description of the individual definition files in Chapter 4. Definition Files.
Format for specifying the update contents
Specify the section names, label names, and values to be updated using the format shown below. You can specify multiple setting values in the same file, but only the ones that need to be updated should be specified.
No. |
Format |
Explanation |
---|---|---|
1 |
[section-name] |
Specify up to 79 bytes of single-byte alphanumeric characters and single-byte spaces, including the square brackets ([]). |
2 |
label-name=value |
Specify the label name and value as follows. White spaces before and after the equals sign (=) are ignored.
|
Notes:
-
The same section name cannot appear more than once in a file. If you want to specify multiple labels from the same section, list the labels within a single section.
-
Lines cannot exceed 592 bytes. If a line exceeds 592 bytes, the 593rd and subsequent bytes are treated as part of the next line.
-
The following types of lines are ignored:
• Sections or lines that do not follow the above format
• Lines that begin with a #, ;, or single-byte space
• Empty lines
Specification example
The following example updates the value of the Multiple Alarm Table Bind label in [Common Section] to 1:
[Common Section] Multiple Alarm Table Bind=1
Arguments
-i update-target-definition-file-name
Specifies the path of the definition file to be updated.
-u update-contents-file-name
Specifies the path of the file that contains the update contents.
- Note the following points when specifying these two file names:
-
-
In UNIX, file names that include single-byte spaces must be enclosed in double quotation marks ("), and symbols must be escaped as necessary.
-
Specify a path of from 1 to 255 bytes that points to a file that exists. Wildcard characters are not permitted.
-
You can specify absolute or relative file path names. In the case of a relative file path, specify the path from the current directory at the time of command execution.
-
Notes
-
If command execution is interrupted by pressing the Ctrl + C keys or by a signal, a predefined return value is not returned. Therefore, you should ignore the return value when the command was interrupted by the Ctrl + C keys or by a signal.
-
When specifying the update contents in a UNIX environment, before using double-byte characters, make sure the language environment (LANG environment variable) matches the language environment in which Performance Management is running.
Return values
0 |
The command terminated normally. |
1 |
The command terminated abnormally. |
Usage example
This example updates jpccomm.ini on a physical host in a UNIX environment.
# ./jpciniupdate -i /opt/jp1pc/jpccomm.ini -u /tmp/jpccomm.ini.update KAVE05850-I The update processing of the files ended normally.