Hitachi

JP1 Version 12 JP1/Integrated Management 2 - Manager Command, Definition File and API Reference


System profile of Central Scope (jcs_sysprofile_xxx.def)

Organization of this page

Format

DESC_VERSION=1#1
[SystemProfile]
  FrameVisible={true | false}
  Movable={true | false}
[DisplayColor]
    :
  [ColorItem]#2
    Status=monitoring-node-status-identifier
    Name=monitoring-node-status-name
    [Label]
      R=value
      G=value
      B=value
      A=value
    [END]
    [TEXT]
      R=value
      G=value
      B=value
    [End]
  [End]
      :
[End]
[DisplayLamp]
  Status=monitoring-node-status-identifier
[End]
[End]

#1: Do not change DESC_VERSION=1.

#2: Do not change the values of Status and Name between [ColorItem] and [End].

File

For the system profile of Central Scope (jcs_sysprofile_xxx.def), the file to edit varies depending on the language in which JP1/IM runs. The following table explains the relation between the language code where JP1/IM runs and the system profile of Central Scope to edit.

Table 2‒82: Language codes where JP1/IM runs and the system profile of Central Scope

OS

Language type

Language encoding supported by JP1/IM

Definition file

Windows

Japanese

jcs_sysprofile_sjis.def (System profile (Central Scope))

jcs_sysprofile_sjis.def.model (Model file for the system profile (Central Scope))

English

jcs_sysprofile.def (System profile (Central Scope))

jcs_sysprofile.def.model (Model file for the system profile (Central Scope))

Chinese

jcs_sysprofile_GB18030.def (System profile (Central Scope))

jcs_sysprofile_GB18030.def.model (Model file for the system profile (Central Scope))

UNIX#

Japanese

Shift-JIS encoding

jcs_sysprofile_sjis.def (System profile (Central Scope))

jcs_sysprofile_sjis.def.model (Model file for the system profile (Central Scope))

EUC encoding

jcs_sysprofile_euc.def (System profile (Central Scope))

jcs_sysprofile_euc.def.model (Model file for the system profile (Central Scope))

UTF-8 encoding

jcs_sysprofile_UTF-8.def (System profile (Central Scope))

jcs_sysprofile_UTF-8.def.model (Model file for the system profile (Central Scope))

English

jcs_sysprofile.def (System profile (Central Scope))

jcs_sysprofile.def.model (Model file for the system profile (Central Scope))

Chinese

GB18030 encoding

jcs_sysprofile_GB18030.def (System profile (Central Scope))

jcs_sysprofile_GB18030.def.model (Model file for the system profile (Central Scope))

#

Only files of languages supported by the OS are included.

Use the system profile of Central Scope corresponding to the language code (jcs_sysprofile_xxx.def).

Storage directory

In Windows
For a physical host:

Scope-path\conf

For a logical host:

shared-folder\jp1scope\conf

In UNIX
For a physical host:

/etc/opt/jp1scope/conf

For a logical host:

shared-directory/jp1scope/conf

Description

Common definition information for the Central Scope viewer. The contents of this definition file are applied to the following windows:

When the definitions are applied

When you log in to Central Console, the definition takes effect. However, if you log in to Central Scope from the Event Console window, you must restart the Event Console window after editing the definition file, and then log in to Central Scope.

Information that is specified

DESC_VERSION=1

Indicates the system profile format version.

Do not change this value. If you do so, Central Scope Viewer might not operate correctly.

[SystemProfile] to [End]

Indicates the definition start tag and definition end tag for the system profile.

FrameVisible={true | false}

Specifies whether to display the monitoring node name and the space around an icon. You can specify either true or false. The value is not case sensitive. Write this parameter between SystemProfile and End.

If you specify true, the monitoring node name and the space around an icon are displayed. If you specify false, they are not displayed.

If you omit this parameter, or specify a value other than true or false, true is assumed.

If you upgrade JP1/IM - Manager from version 10-10 or earlier, this parameter is not set for the system profile of the logical host. To specify this parameter, add the description.

Movable={true | false}

Specifies whether to allow drag and drop operations for the monitoring node icon in the map display of the Monitoring Tree window, and the Visual Monitoring window. You can specify either true or false. The value is not case sensitive. Write this parameter between SystemProfile and End.

If you specify true, you can move the monitoring node icon. If you specify false, you cannot move it.

If you omit this parameter, or specify a value other than true or false, true is assumed.

If you upgrade JP1/IM - Manager from version 10-10 or earlier, this parameter is not set for the system profile of the logical host. To specify this parameter, add the description.

[DisplayColor] to [End]

Write a definition block to define the monitoring node status between DisplayColor and End. Write only one definition block between SystemProfile and End.

[ColorItem] to [End]

Write the status identifier, status name, and parameter to define the status color, and definition block between [ColorItem] and [End]. Write this definition block between [DisplayColor] and [End] for each status.

Status=monitoring-node-status-identifier

Specify the status identifier. Write this parameter between [ColorItem] and [End]. Do not change this value. If you do so, Central Scope Viewer might not operate correctly.

Name=monitoring-node-status-name

Specify the status name. Write this parameter between [ColorItem] and [End]. Do not change this value. If you do so, Central Scope Viewer might not operate correctly.

[Label] to [End]

Write parameters to specify the monitoring node status color, and whether to make the monitoring node color transparent between [Label] and [End]. When the monitoring node status changes, the color changes to the one corresponding to the new status specified between [Label] and [End]. Write this definition block only once between [ColorItem] and [End].

R=value, G=value, B=value

Specifies the status color of the monitoring node by using the RGB value. Write this parameter between [Label] and [End]. You can specify an integer from 0 to 255.

If you omit this parameter, specify an integer less than 0, or specify a value other than an integer, 0 is assumed. If you specify a value greater than 255, 255 is assumed.

A=value

Specify whether to make the monitoring node status color transparent. Write this parameter between [Label] and [End]. If the FrameVisible parameter is not specified, and true is specified for the FrameVisible parameter, the status color cannot be transparent regardless the value specified for A. You can specify an integer from 0 to 255. The smaller the value you specify, the higher the transparent ratio is. If you specify 0, the status color is completely transparent. If you specify 255, the status color is not transparent.

If you omit this parameter, or specify a value that cannot be specified, 255 is assumed.

[TEXT] to [End]

Write parameters to specify the text color of the monitoring node name between [TEXT] and [End]. When the monitoring node status changes, the monitoring node name text color changes to the one corresponding to the new status specified between [TEXT] and [End]. Write this definition block only once between [ColorItem] and [End].

R=value, G=value, B=value

Specifies the monitoring node name text color by using the RGB values. Write these parameters between [TEXT] and [End]. You can specify an integer from 0 to 255.

If you omit this parameter, specify a value less than 0, or specify a non-integer value, 0 is assumed. If you specify a value greater than 255, 255 is assumed. In the initial status after installation, 0 is specified for all of R, G, and B values.

[DisplayLamp] to [End]

Specify parameters used to specify the status when an alarm lamp turns on. When the highest monitoring node status changes, if the status identifier specified for the new status is greater than the value specified between [DisplayLamp] and [End], the applicable alarm lamp turns on. You must write this definition block between [SystemProfile] and [End].

Status=monitoring-node-status-identifier

Specify the status when an alarm lamp turns on. Write this parameter between [DisplayLamp] and [End]. You can specify a decimal integer from -2,147,483,648 to 2,147,483,647.

If you omit this parameter, or specify a value that cannot be specified, 0 is assumed. If the status indicator specified for the highest monitoring node status is greater than the value specified for this parameter, an alarm lump turns on. The following table explains the correspondences between the values specified for this parameter and the statuses when the alarm lamp turns on.

Table 2‒83: Correspondence between the specified values and the statuses when the alarm lamp turns on

Specified value

Status when the alarm lump turns on

-2,147,483,648 to 100

Initial, debug, normal, warning, error, critical, alert, and emergency

101 to 200

Debug, normal, warning, error, critical, alert, and emergency

201 to 300

Normal, warning, error, critical, alert, and emergency

301 to 400

Warning, error, critical, alert, and emergency

401 to 500

Error, critical, alert, and emergency

501 to 600

Critical, alert, and emergency

601 to 700

Alert, and emergency

701 to 800

Emergency

801 to 2,147,483,648

Does not turn on

We recommend you specify 200, 300, 400, 500, 600, 700, or 800.

Notes