9.7 jslmmgrconnect (connecting SLM - Manager)

Function

Implements a connection request from the master instance of SLM - Manager to the slave instance of SLM - Manager targeted for the connection.

When the master instance of SLM - Manager has been abnormally terminated and the link between the master instance of SLM - Manager and a slave instance of SLM - Manager has been released, executing this command reestablishes the link.

This command is to be executed upon satisfying the following conditions:

• The following services of SLM - Manager have been started.

  • SLM - Manager DB Service (service name: HiRDBEmbeddedEdition_JL0)

  • SLM - Manager Service (service name: JP1_ITSLM_MGR_Service)

Execute the command with the active server in the case of a cluster system. If the command is executed on the standby server, an error will result.

When using the master/slave configuration of SLM – Manager, execute this command in relation to the master instance of SLM - Manager. If the command is executed with a slave instance of SLM - Manager, an error will result. Executing this command in SLM - Manager when using a single-manager configuration will also result in an error.

The indicator "jslmmgrconnect" is configured to messages output to the message log by this command.

For details about the message log, see 7.2.4 Message logs.

For details about the messages that are output when commands are executed, see 11.3 Messages.

Format

jslmmgrconnect -a IP-address-or-host-name[ -p port-number]

Execution permission

User account that belongs to the OS's Administrators group

Storage folder

SLM-Manager-installation-folder\mgr\bin\

Arguments

-a IP-address-or-host-name

Specifies the IP address or the host name of the slave instance of SLM - Manager subject to connection.

The IP address or host name is specified in the following format:

• ASCII codes 0x20 to 0x7e (excluding control characters)

• A length of 1 to 256 bytes (permitted number of bytes depends on Windows)

Characters that are not permitted in host names in Windows cannot be specified.

None of the following addresses can be specified:

• 0.0.0.0

• 127.0.0.1

• 255.255.255.255

An error will occur if the specified connection destination is an instance of SLM - Manager in the single-manager configuration or the master instance of SLM - Manager in the master/slave configuration.

-p port-number

Specifies the port number of the slave instance of SLM - Manager subject to connection.

Specify the port number as a number in the range from 5001 to 65535. "20904" is specified as the port number when this option is omitted.

Not specifying an IP address or host name with the -a option will result in an error.

Notes

• This command and the following operations are mutually exclusive:

  • Registering and deleting monitored services

  • Registering and deleting Web transactions

  • Editing Web transactions (including re-sort)

  • Adding, editing, copying, and deleting report templates

  • Updating configuration information

  • Saving monitoring item settings for system performance

  • Setting up service performance monitoring

  • Setting up system performance monitoring

  • Setting up availability monitoring

  If this command is executed while a mutually exclusive process is already being executed, the command results in an error and the processing thereof will interrupt. Similarly, if an attempt is made to start a mutually exclusive process while this command is being executed, such process will result in an error and be interrupted.

• Do not execute commands other than the jslmminfoget command or the jslmreport command while this command is being executed.

• Do not interrupt the execution of this command with the action to close the command prompt executing the command or by pressing Ctrl+C on the keyboard.

• As the processing of a rollback of the database is executed after the execution of a command is interrupted, executing a command that is mutually exclusive with this command or a window operation during the rollback process generates a database error. If a database error is generated upon execution of a command or window operation following an interruption of the execution of a command, try to execute the command again after waiting a while.

Return values

Return values	Description
0	Connection of SLM - Manager has been normally terminated.
1	Connection of SLM - Manager has failed.
130	The process has been interrupted with Ctrl+C on the keyboard.

Usage examples

C:\Program Files\HITACHI\JP1ITSLM\mgr\bin\jslmmgrconnect -a 172.172.172.172 -p 20904