Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/IT Service Level Management Description, User's Guide, Reference and Operator's Guide


5.6.2 Editable definitions

Editing definitions is optional in ITSLM.

This subsection explains the definitions that can be edited in ITSLM.

Organization of this subsection

(1) List of definitions that can be edited in ITSLM

The following table explains the definitions that can be edited when it is necessary to do so.

Table 5‒7: List of definitions that can be edited in ITSLM

No.

Property

Trgt

Spec

Description

Specification range

Default

Error handling

1

accessLogFilePath

U

O

Specifies the destination file path for the files in which access logs are recorded.

Absolute path of the folder, including the drive letter#1

None

T

2

announceRetryCount

U

O

Specifies the number of retries when a communication error occurs when start or termination is reported from ITSLM - UR to ITSLM - Manager.

Integer from 1 to 20

(count)

3

T

3

announceRetryInterval

U

O

Specifies the retry interval when a communication error occurs when start or termination is reported from ITSLM - UR to ITSLM - Manager.

Integer from 1 to 1000

(seconds)

10

T

4

announceRetryMessage

U

O

Specifies whether the retry message (KNAS03016-W) is to be output to message logs when a communication error occurs when start or termination is reported from ITSLM - UR to ITSLM - Manager.

true (output) or false (do not output)#2

false

T

5

communicationRetryCount

M, U

O

Specifies the number of retries when a communication error occurs between ITSLM - UR and ITSLM - Manager.

Integer from 1 to 20

(count)

3

T

6

communicationRetryInterval

M, U

O

Specifies the retry interval when a communication error occurs between ITSLM - UR and ITSLM - Manager.

Integer from 1 to 1000

(seconds)

10

T

7

communicationRetryMessage

M, U

O

Specifies whether the retry message (KNAS03016-W) is to be output to message logs when a communication error occurs between ITSLM - UR and ITSLM - Manager.

true (output) or false (do not output)#2

false

T

8

dashboardChartPlotInterval

M

O

Specifies in minutes the maximum interval between dots for drawing a straight line on a performance chart for system performance.

Integer from 1 to 1440

5

T

9

dashboardEventListRecentViewSize

M

O

Specifies the maximum number of events that can be displayed at the same time when events of multiple services are listed in an ITSLM window.

The specified number of the most recent events are displayed.

Integer from 1 to 8192

1000

T

10

dashboardPrioritizeSystem

M

O

Changes the default display for the following windows according to the monitoring configuration:

true (default display for a system monitoring configuration) or false (default display for a service monitoring configuration)

false

T

11

dashboardPropagateSystemStatus

M

O

Specifies whether the system performance monitoring status is to be propagated to the service status.

true (propagate) or false (do not propagate)

false

T

12

jbsHostName

M

O

Specifies the local host name of JP1/Base.

Specification of this property is required when JP1/Base is run with a cluster configuration.

Character string with a length of 1 to 196 bytes (permitted characters include alphanumeric characters and hyphen (-))

None

T

13

JP1Event

M

O

Specifies whether issuance of JP1 events is to be enabled.

Specification of this property is required when ITSLM is linked with JP1/IM.

For details about linking with JP1/IM, see 5.5.1 Linking with JP1/IM.

true (issue) or false (do not issue)#2

false

D

14

JP1EventForSystem

M

O

Specifies whether JP1 events for system performance are to be issued when the JP1Event property is set to true and ITSLM is linked to Performance Management.

true (issue JP1 events) or false (do not issue JP1 events)

false

T

15

loggerCommandMessageFileCount

M

O

Specifies the maximum number of message log files for commands.

Integer from 2 to 16

3

D

16

loggerCommandMessageMaxFileSize

M

O

Specifies the maximum size of a message log file for commands.

Integer from 4096 to 16777216

(bytes)

1048576 (1 MB)

D

17

loggerDaoMessageFileCount

M

O

Specifies the maximum number of message log files that are used by the ITSLM function to access the database.

Integer from 2 to 16

3

D

18

loggerDaoMessageMaxFileSize

M

O

Specifies the maximum size of a message log file that is used by the ITSLM function to access the database.

Integer from 4096 to 2147483647

(bytes)

1048576 (1 MB)

D

19

loggerInputAdaptorCtrlMessageFileCount

M

O

Specifies the maximum number of message log files that are used by the ITSLM function to receive performance data from external programs.

Integer from 2 to 16

3

D

20

loggerInputAdaptorCtrlMessageMaxFileSize

M

O

Specifies the maximum size of a message log file that is used by the ITSLM function to receive performance data from external programs.

Integer from 4096 to 2147483647

(bytes)

1048576 (1 MB)

D

21

loggerIntegrationLogLevel

M, U

O

Specifies the log output level for integrated trace logs.

A small value decreases the amount of output information, and a large value increases the amount of output information increases.

0, 10, 20, or 30

10

D

22

loggerMessageLogLevel

M, U

O

Specifies the log output level for message log files.

A small value decreases the amount of output information, and a large value increases the amount of output information increases.

0, 10, 20, or 30

10

D

23

loggerPerfCollectorMessageFileCount

M

O

Specifies the maximum number of message log files for the performance analysis manager.

Integer from 2 to 16

3

D

24

loggerPerfCollectorMessageMaxFileSize

M

O

Specifies the maximum size of a message log file for the performance analysis manager.

Integer from 4096 to 2147483647

(bytes)

1048576 (1 MB)

D

25

loggerProcessCtrlMessageFileCount

M, U

O

Specifies the maximum number of message log files for process control.

Integer from 2 to 10

3

D

26

loggerProcessCtrlMessageMaxFileSize

M, U

O

Specifies the maximum size of a message log file for process control.

Integer from 4096 to 16777216

(bytes)

1048576 (1 MB)

D

27

loggerRmiServerMessageFileCount

M, U

O

Specifies the maximum number of message log files for the RMI server.

Integer from 2 to 16

3

D

28

loggerRmiServerMessageMaxFileSize

M, U

O

Specifies the maximum size of a message log file for the RMI server.

Integer from 4096 to 2147483647

(bytes)

1048576 (1 MB)

D

29

loggerUserResponseMessageFileCount

M, U

O

Specifies the maximum number of message log files for UR control.

Integer from 2 to 16

3

D

30

loggerUserResponseMessageMaxFileSize

M, U

O

Specifies the maximum size of a message log file for UR control.

Integer from 4096 to 2147483647

(bytes)

1048576 (1 MB)

D

31

loggerViewMessageFileCount

M

O

Specifies the maximum number of message log files for a servlet.

Integer from 2 to 16

3

D

32

loggerViewMessageMaxFileSize

M

O

Specifies the maximum size of a message log file for a servlet.

Integer from 4096 to 2147483647

(bytes)

1048576 (1 MB)

D

33

loggerWebSystemAnalysisMessageFileCount

U

O

Specifies the maximum number of message log files for the Web system analysis process and service detection process.

Integer from 2 to 16

3

D

34

loggerWebSystemAnalysisMessageMaxFileSize

U

O

Specifies the maximum size of a message log file for the Web system analysis process and service detection process.

Integer from 4096 to 2147483647

(bytes)

1048576 (1 MB)

T

35

loginFailedLimit

M

O

Specifies the number of retries allowed in ITSLM's login window. Once the specified number of retries have been used, the window is locked.

If 0 is specified, the window will not be locked.

Integer from 0 to 30

3

T

36

managerHost

M, U

R

Specifies the host name of ITSLM - Manager.

If ITSLM is linked with Performance Management, an IP address cannot be specified (you must specify the host name).

ASCII codes 0x20 to 0x7e (excluding control characters) and 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

None

T

37

managerStartMode

M

O

Specifies the start mode for restarting the Windows service in ITSLM - Manager.

normal (starting the Windows service with monitoring stopped) or restart (starting the Windows service with restart of the monitoring that was running before the Windows service stopped)#2

normal

T

38

monitoringItemNameMaxLength

M

O

Specifies the length of a monitoring item name. Specify the number of bytes obtained after UTF-8 conversion.

Integer from 1 to 1024

(bytes)

300

T

39

outlierRate

M

O

Specifies the percentage of performance data in the monitoring range that has to result in an out-of-range value before an event is reported during predictive error detection.

Integer from 1 to 100

(%)

10

T

40

pfmLoggingData

M

O

Specifies whether Performance Management's monitoring agents are to store performance data in the Store database.

true (store in the Store database) or false (do not store in the Store database)#2

false

T

41

pfmManagerHost

M

O

Specifies the host name of the PFM - Manager that is to be linked with ITSLM. If the specified host name is invalid, communication with Performance Management will fail.

ASCII codes 0x20 to 0x7e (excluding control characters) with 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

None

T

42

pfmManagerPort

M

O

Specifies the port number of PFM - Manager that is to be linked with ITSLM.

If the specified port number is invalid, communication with Performance Management will fail.

1024 to 65535

22286

T

43

pfmReceivePort

M

O

Specifies the port number used by ITSLM - Manager to receive performance data sent from Performance Management.

1024 to 65535

20905

T

44

pfmWebConsoleURL

M

O

Specifies the URL of the target PFM - Web Console.

Specify the URL without the URL encoding (percent encoding).

The following shows an example:

http://host:port/PFMWebConsole/login.do

host: Host name or IP address

port: Port number

The value specified for URL must be in RFC 2396-compliant format.

Character string with a length of 0 to 1024 (characters)

None

T

45

rdbPort

M

O

Specifies the listen port number of the embedded database.

5001 to 65535

20903

T

46

rmiManagerPort

M, U

O

Specifies the RMI communication port number of ITSLM - Manager.

5001 to 65535

20904

T

47

rmiUrPort

U

O

Specifies the RMI communication port number of ITSLM - UR.

5001 to 65535

20910

T

48

serviceBaselineExclusion

M

O

Specifies whether out-of-range value detection events that are opposite to the threshold direction are to be excluded during predictive error detection for service performance.

true (exclude) or false (do not exclude)

false

T

49

sloThresholdRate

M

O

Specifies the percentage of performance data in the monitoring range that has to result in an overage of a threshold before an event is reported by threshold value monitoring.

Integer from 1 to 100

(%)

10

T

50

systemBaselineExclusion

M

O

Specifies whether out-of-range value detection events that are opposite to the threshold direction are to be excluded for the threshold type that is received from Performance Management during predictive error detection for system performance.

For example, if the threshold type received from Performance Management is the upper limit, this property specifies whether lower-limit events are to be excluded in out-of-range value detection.

true (exclude) or false (do not exclude)

false

T

51

urHost

U

R

Specifies the host name of ITSLM - UR.

ASCII codes 0x20 to 0x7e (excluding control characters) and 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

None

T

52

urNetworkInterfaceNumber

U

R

Specifies the network interface number assigned by the capture module.

If you have changed the network interface configuration on the host on which ITSLM - UR is installed, make sure that you use the jslmuripls command to check and, if necessary, revise the specified value.

For details about the jslmuripls command, see jslmuripls (displays network interface number and IP address) in 9. Commands.

Integer from 1 to 60.

An error results if the specified network interface number does not exist in the jslmuripls command execution results.

None

Legend:

Trgt: Target

Spec: Specification

M: ITSLM - Manager

U: ITSLM - UR

R: Specification is required

O: Specification is optional

D: If there is an error in the setting, ITSLM - Manager or ITSLM - UR assumes the default value upon startup.

T: If there is an error in the setting, ITSLM - Manager or ITSLM - UR terminates.

#1

If you want to run ITSLM - UR in a cluster configuration, make sure the path points to a shared disk so the access log will be switched over when node switching occurs.

#2

The value is not case sensitive.

(2) Supplementary information