Function

The hdsagtopt command changes settings of the Datareplicator agent on the machine subject to monitoring. When you execute the hdsagtopt command, a message is output to the system log and event log indicating that the Datareplicator agent options have been changed. Note that if a percent sign (%) is specified, it will not be output to the system log or event log.

Only the superuser can execute the hdsagtopt command.

Format

Changing the monitoring interval

hdsagtopt -t interval

Changing the symbol display method

hdsagtopt -d tree | notree

Changing the symbol mode

hdsagtopt -m { e|j|u }

Specifying a custom symbol name

hdsagtopt -ss source-symbol-name|-ts target-symbol-name

Options

Changing the monitoring interval

hdsagtopt -t interval

Changes the status monitoring interval. The specifiable value range is 1 to 3600 (seconds). The initial value is 300 (5 minutes). When this command is executed, Datareplicator uses the existing monitoring interval once, and then begins using the new interval.

If the monitoring interval is too small, a lock error might occur during execution of a Datareplicator command.

Changing the symbol display method

hdsagtopt -d tree|notree

Changes the symbol display method. Specify one of the following arguments:

tree

Display as a hierarchical structure. This setting is applicable to JP1/Cm2/Network Node Manager's SNMP agent version 05-00 or later.

notree

Displays as a non-hierarchical structure. This setting is applicable to JP1/Cm2/Network Node Manager's SNMP agent versions earlier than 05-00.

Changing the symbol mode

hdsagtopt -m { e|j|u }

Changes the first characters of symbol names. When this command is executed, Datareplicator deletes the existing symbols and creates new symbols. The initial setting is e. When you specify u, you are then able to specify your own, custom symbol names.

Option	Source symbol name	Target symbol name
e	Datareplicator_source	Datareplicator_target
u	hde (initial value)	hds (initial value)

Specifying a custom symbol name

hdsagtopt -ss source-symbol-name|-ts target-symbol-name

Specify a user-specific symbol name. Specify this option in the format hdsagent -ss source-symbol-name or hdsagent -ts target-symbol-name. A custom symbol name can consist of up to 50 double-byte characters or 100 single-byte characters.

The source-symbol-name and the target-symbol-name cannot be the same; if they are, the KFRB06105-E error results.

When you execute this command while the symbol mode is u, Datareplicator deletes the existing symbols and creates new symbols.