Hitachi

JP1 Version 12 JP1/Performance Management Reference


jp1pfmSuggestionGetHostName

Organization of this page

Description

This function gets the name of a monitoring host recognized by Performance Management on the host to which a specified IM management node belongs.

Prerequisite version

How to specify the function in the suggestion definition file

Specify necessary values for the members of the following objects to be specified in suggestion activation criteria and response action:

The following table lists and describes the values you specify.

Table 5‒11: Values specified for the members of the key and params objects

No.

Member name

Data type

Optional

Description

1

sid

string

No

Specify the tree ID of the IM management node of Performance Management.

For details on how to specify the tree ID, see Suggestion definition file settings (imdd_suggestion_arbitrary-character-string.conf).

2

method

string

No

Specify "jp1pfmSuggestionGetHostName".

3

args

object

No

Specify {} (an empty object).

What value is contained in the suggestion member in the response

If the processing is successful, the host name of the host to which the specified IM management node belongs is stored.

Error case

If an error occurs, the args.setError() function is called to store its message.

The following table describes causes of errors and message IDs of messages to be stored.

Cause of error

Message ID

The configuration information of JP1/IM2 was changed during the processing.

KAJY24105-E

Note

None.

Example of how to specify in the suggestion definition file

For an example of the suggestion definition file that contains this function, see Example of suspending monitoring while a host is being maintained in Examples of suggestion definition file (imdd_suggestion_arbitrary-character-string.conf).