Hitachi

JP1 Version 12 JP1/Base User's Guide


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.

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