Hitachi

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


ssocolstop

Organization of this page

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

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.