ssocolstop
Format
- To stop collection based on all collection condition:
ssocolstop [-S connection-destination-server-name] -all
- To specify a server or resource and stop collection:
-
(a) When you specify a server (either -s or -sf is needed)
ssocolstop [-S connection-destination-server-name] {-s server-name,... | -sf group-definition-file-name,group-name} [-r resource-ID,... | -rf group-definition-file-name,group-name]
(b) When you specify a resource (either -r or -rf is needed)
ssocolstop [-S connection-destination-server-name] [-s server-name,... | -sf group-definition-file-name,group-name] {-r resource-ID,... | -rf group-definition-file-name,group-name}
- To specify the name of a collection status definition file and stop collection:
ssocolstop [-S connection-destination-server-name] -i collection-status-definition-file-name
- To output the command usage:
ssocolstop -h
Function
The ssocolstop command stops collection of resources.
This command is effective for collection conditions whose collection status is Collecting, Standing By, or Postponing. It is ineffective for collection conditions having any other collection status.
Options
-S connection-destination-server-name
Specifies the monitoring manager on which you want to stop collection. Specify the host name or IP address in 255 bytes or less. If you omit this option, the command stops collection on the server on which you executed the command.
-all
Stops collection based on all collection conditions in the collection conditions configuration file.
-s server-name,...
Stops collection on the specified server. Specify the host name or IP address in 255 bytes or less. If the collection conditions configuration file contains no collection conditions for the specified server, the command takes no action. To specify multiple server names, delimit the names with a comma (,).
You can specify this option together with the -r or -rf option. If you do not specify the -r or -rf option, the command stops collection of all resources of the specified server.
-sf group-definition-file-name, group-name
Stops collection on the servers defined in the specified group. If the collection conditions configuration file contains no collection conditions for the defined servers, the command takes no action.
You can specify this option together with the -r or -rf option. If you do not specify the -r or -rf option, the command stops collection of all resources of the servers defined in the group.
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.
-r resource-ID,...
Stops collection of the resource having the specified resource ID. If the collection conditions configuration file contains no collection conditions for the specified resource ID, the command takes no action. To specify multiple resource IDs, delimit the IDs with a comma (,).
You can specify this option together with the -s or -sf option. If you do not specify the -s or -sf option, the command stops collection of the specified resource on all servers set in the collection conditions configuration file.
For details about resource IDs, see E. Resource IDs.
-rf group-definition-file-name,group-name
Stops collection of the resources defined in the specified group. If the collection conditions configuration file contains no collection conditions for the defined resource IDs, the command takes no action.
You can specify this option together with the -s or -sf option. If you do not specify the -s or -sf option, the command stops collection of the resources defined in the group on 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.
-i collection-status-definition-file-name
Reads the collection status definition file specified in this option, and then stops collection as specified in the file.
For details on how to define the collection definition file, see 6.3.17 Collecting condition definition file.
Collection start time, collection end time, and collection period settings for the collection status definition file are ignored.
-h
Outputs the command usage. This option cannot be specified together with other options.
Examples
-
The following command stops collection based on all set collection conditions on a server (vr260):
ssocolstop -S vr260 -all
-
The following command stops collection of resource IDs 1 and 2 from the set collection conditions on a server (vr260):
ssocolstop -S vr260 -r 1,2
-
The following command stops collection of the group RSC contained in a group definition file (/tmp/file.grp) from the set collection conditions on a server (vr260):
ssocolstop -S vr260 -rf /tmp/file.grp,RSC
-
The following example stops collection according to the collection status definition file (/tmp/file.col) from the set collection conditions on a server (vr260):
ssocolstop -S vr260 -i /tmp/file.col
Return values
0 |
Normal termination |
-1 |
Execution error such as incorrect arguments |
Note
If you execute this command, do not cancel it before processing finishes.