ssocolset
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
-
The following example changes the collection conditions for a server (vr260) to the contents of /tmp/ssocol.conf:
ssocolset -S vr260 -s /tmp/ssocol.conf
-
The following example deletes all collection conditions for a server (vr260):
ssocolset -S vr260 -d
-
The following example deletes collection conditions for resource IDs 1, 2, and 4 set for the server's netmda11 and netmda22 from the collection conditions for a server (vr260):
ssocolset -S vr260 -ds netmda11,netmda22 -dr 1,2,4
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
-
You cannot execute this command while the Resource Configuration window is active. Furthermore, you cannot activate the Resource Configuration window while this command is executing.
-
If you execute this command, do not cancel it before processing finishes.
-
You cannot change a collection period definition contained in a collection conditions definition file for a resource whose collection status is Collecting, Postponing, or Standing By.
-
If the disk becomes full while the collection conditions are being output as specified by the -p option, only part of the data is saved in the file (no error message is output). Before outputting the collection conditions to a file, verify that the disk has sufficient free space.
-
Suppose that when collecting a resource, you specify the Ping response time resource in the Network resource group as a collection target. In such a case, you cannot add or change the collection conditions in a collection conditions definition file that contains an instance name of the collection target that is not specified by using the ssocolset command.