Hitachi

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


ssocolset

Organization of this page

Format

To add or change a collection condition:
ssocolset [-S connection-destination-server-name]
          {-s collection-conditions-definition-file-name
          | -sn collection-conditions-definition-file-name}
To delete all collection conditions:
ssocolset [-S connection-destination-server-name] -d
To partially delete collection conditions:

(a) When you specify a server (either -ds or -dsf is needed)

ssocolset [-S connection-destination-server-name]
          {-ds server-name,... | -dsf group-definition-file, group-name}
          [-dr resource-ID,... 
          | -drf group-definition-file, group-name]

(b) When you specify a resource (either -dr or -drf is needed)

ssocolset [-S connection-destination-server-name]
          [-ds server-name,... | -dsf group-definition-file, group-name]
          {-dr resource-ID,... 
          | -drf group-definition-file, group-name}
To output collection conditions to a file:
ssocolset [-S connection-destination-server-name] -p output-file-name
To output the command usage:
ssocolset -h

Function

The ssocolset command adds, changes, or deletes the collection conditions for a resource. When it adds or changes collection conditions, it updates the collection conditions configuration file with the contents of the created collection conditions definition file.

Options

-S connection-destination-server-name

Specifies the server name of the monitoring manager whose collection conditions are to be changed. Specify the host name or IP address in 255 bytes or less. If you omit this option, the command changes the collection conditions for the server on which you execute the command.

-s collection-conditions-definition-file-name

Completely changes the collection conditions configuration file to the contents of the specified collection conditions definition file.

If an item defined in the collection conditions definition file exists in the collection conditions configuration file, the command replaces the set value. It also deletes from the collection conditions configuration file any item that is not defined in the collection conditions definition file.

Specify the collection conditions definition file name in 512 bytes or less, including the path name.

-sn collection-conditions-definition-file-name

Changes the collection conditions to the contents defined in the file specified in the collection conditions definition file name.

If an item defined in the collection conditions definition file exists in the collection conditions configuration file, the command replaces the set value. It retains the contents of the collection conditions configuration file for any items not defined in the collection conditions definition file.

Specify the collection conditions definition file name in 512 bytes or less, including the path name.

-d

Deletes all collection conditions contained in the collection conditions configuration file.

-ds server-name,...

Deletes only the collection conditions for the specified server. To specify multiple server names, delimit the names with a comma (,).

You can specify this option together with the -dr or -drf option. If you do not specify the -dr or -drf option, the command deletes the collection conditions for all resources of the specified server.

-dsf group-definition-file, group-name

Deletes only the collection conditions for the servers defined in the specified group.

You can specify this option together with the -dr or -drf option. If you do not specify the -dr or -drf option, the command deletes the collection conditions for all resources of the servers.

Specify the group definition file in 512 bytes or less, including the path name. For details about group definition files, see 6.3.5 Group definition file.

-dr resource-ID,...

Deletes only the collection conditions for the specified resource. To specify multiple resource IDs, delimit the IDs with a comma (,).

You can specify this option together with the -ds or -dsf option. If you do not specify the -ds or -dsf option, the command deletes the collection conditions for the specified resource from the collection conditions for all servers set in the collection conditions configuration file.

For details about resource IDs, see E. Resource IDs.

-drf group-definition-file, group-name

Deletes only the collection conditions for the resources defined in the specified group.

You can specify this option together with the -ds or -dsf option. If you do not specify the -ds or -dsf option, the command deletes the collection conditions for the resource IDs defined in the group from the collection conditions for all servers set in the collection conditions configuration file.

Specify the group definition file in 512 bytes or less, including the path name. For details about group definition files, see 6.3.5 Group definition file. For details about resource IDs, see E. Resource IDs.

-p output-file-name

Outputs the collection conditions contained in the collection conditions configuration file to the specified file. Specify the output file name in 512 bytes or less, including the path name.

-h

Outputs the command usage. This option cannot be specified together with other options.

Examples

Return values

0

Normal termination. If the -s option was specified and the definition file contains an invalid definition, the command outputs a message to the standard output.

-1

Execution error such as incorrect arguments

Notes