Hitachi

JP1 Version 12 JP1/SNMP System Observer Description, Operator's Guide and Reference


6.3.17 Collecting condition definition file

The collecting condition definition file contains definitions of the resource collection status.

Organization of this subsection

(1) Format

The following shows the format of the collecting condition definition file.

[Figure]

(2) Details of the collection target server definition

Write as many definitions as the number of collection target servers. This definition requires one or more definitions for the collected resource.

The following table shows the contents of the definition for the collection target server.

Key name

Explanation

server

Enter the collection target server name.

Specify a server name, host name or IP address within 255 bytes.

If you specify an IP address, use the IPv4 address or IPv6 address format.

(3) Details of the collected resource definition

After the collection target server definition, write as many collected resource definitions as the number of resources to be collected by target server. You must write fields in the definition file in the order in which they are listed in the table below.

The following table shows the contents of the definition regarding collected resources.

Key name

Explanation

rscid

Specify the collection target resource ID.

For details of the resource ID, see E. Resource IDs.

stime

Specify the collection start time for the resource. Specify this in the same format as the -stime option of the ssocolstart command.

When the specification is omitted, or the specified collection start time has already passed, the collection will be started when the command is executed.

ptime

Specify the collection end time for the resource. Specify this in the same format as the -ptime option of the ssocolstart command.

When both this key and the period key are omitted, this indicates that the resource collection condition will be collected indefinitely. Also, this key cannot be specified at the same time as the period key.

period

Specifies the resource collection end time, by the amount of time passed since the collection start time. Specify this in the same format as the -period option of the ssocolset command.

When both this key and the ptime key are omitted, this indicates that the resource collection conditions will be collected indefinitely. Also, this key cannot be specified at the same time as the period key.

stat_term_id

<<1>> ((1 to 10))

Specify the time zone ID of the time zone for which to calculate the initial value of the statistical threshold. When collection starts, an initial value is calculated for the same time zone ID as that of regular calculation. For other time zone IDs, an initial value is calculated for a specific time zone ID when the time zone ID of regular calculation is switched to the same one as that of the specific time zone ID. Specify this definition item for each resource ID.

stat_dbname

Specify the name of a master database or collection database.

stat_logfile

Specify an absolute path as the file name.#

stat_masterlog

Specify the key name when you specify the master database on the local host.

stat_stime

((1980.01.01.00.00.00 to 2099.12.31.23.59.59))

Specify the start time of the statistical period. When this key is omitted, the start time is the same as the start time specified for the collection database. You cannot specify the same time as that specified in stat_ptime.

stat_ptime

((1980.01.01.00.00.00 to 2099.12.31.23.59.59))

Specify the end time of the statistical period. You cannot specify the same time as or an earlier time than the time specified in stat_ptime.

stat_time_zone

start time ((00:00:00 to 23:59:59))

end time ((00:00:01 to 24:00:00))

Specify the start time and end time of the time zone. Delimit each value with a semicolon (;). You can specify the start and end times for up to five time zones. When this key is omitted, no time zone is set and data will be extracted regardless of the time.

An error occurs in the following cases:

  • Overlapping time zones are specified.

  • The time zone start time is the same as the time zone end time.

#: An error occurs if no collection database exists when the defined time zone ID is the same as the time zone ID defined in the collection conditions definition file.

Note the following for the definition concerning the initial value of the statistical threshold:

(4) Example

The following shows an example of a collecting condition definition file.

Example of collection conditions definition file (defining the initial value calculation for a statistical threshold)

[Figure]