jbsrt_sync
- Organization of this page
Function
The jbsrt_sync command is executed on a manager host (i.e. host on which JP1/IM - Manager is installed).
This command collects configuration definition information from lower-level hosts, and then updates the configuration definition in the system. This command is executed after the system configuration definition is divided and defined.
Format
jbsrt_sync [-f] [-h logical-host-name]
Required execution permission
In Windows: Administrators (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
In UNIX: Superuser or JP1/Base administrator permission
Command directory
- In Windows:
-
installation-folder\bin\
- In UNIX:
-
/opt/jp1base/bin/
Arguments
-f
Specify this argument if you do not want a message confirming command execution (a message asking you to enter Y or N) to be output. If you specify this option, the message confirming command execution is omitted, the value Y is assumed, and processing continues. If you omit this option, a message confirming command execution will be displayed.
-h logical-host-name
When using JP1/Base in a cluster system, specify the logical host for which you will execute the command. If you omit this option, the host name set in the environment variable JP1_HOSTNAME is assumed. If the environment variable JP1_HOSTNAME is not set, the physical host name is assumed. There is no need to specify this argument unless you are running a cluster system.
Environment variables
JBSRT_CMDRCD_EXTEND
This environment variable expands the set of values that can be returned by the command. To use the expanded set of return values, specify 1. To use the original (unexpanded) set of return values, specify 0. If you omit this environment variable, the command will return a value from the original set of return values.
Notes
If your JP1/IM - Manager version is 11-01 or earlier, do not set the JBSRT_CMDRCD_EXTEND environment variable as a system environment variable or a user environment variable. If you do, you might not be able to use IM Configuration Management to configure the system hierarchy. Instead, use the command prompt or a batch file to set the JBSRT_CMDRCD_EXTEND environment variable.
-
When operating under a system hierarchical configuration with three or more levels, the processes of hosts under a submanager may take too much time and fail to properly return a response. Hence, the jbsrt_sync command may result in timeout. For details, see 2.6.3 (5) Reviewing the communication timeout value.
Return values (original set)
0 |
Normal end |
1 |
Abnormal end |
Return values (expanded set)
0 |
Normal end |
1 |
Synchronization of configuration definition information failed on some hosts. |
2 |
Configuration management server processing is being performed. |
3 |
The command timed out. |
10 |
Invalid argument |
11 |
Permission error |
12 |
There is no configuration definition information. |
13 |
A configuration definition information access error occurred, or the configuration definition information is corrupted. |
16 |
An error occurred during communication with the configuration management server. |
20 |
Insufficient memory |
128 |
Other error |
Example
The examples below show the command with the -f option specified and the command with the -f option omitted.
- With the -f is specified:
# jbsrt_sync -f Sending the synchronization request... KAVB3112-I The synchronization command terminated normally.
- With the -f option is omitted:
# jbsrt_sync Do you want to execute the synchronous command? [Y/N] y Sending the synchronization request... KAVB3112-I The synchronization command terminated normally.
The following example shows how to expand the set of values returned by the command:
# set JBSRT_CMDRCD_EXTEND=1 # jbsrt_sync