(file) Return to cimsub.1 CVS log (file) (dir) Up to [Pegasus] / pegasus / rpm / manLinux / man1.Z

File: [Pegasus] / pegasus / rpm / manLinux / man1.Z / cimsub.1 (download)
Revision: 1.2, Wed Nov 29 21:02:46 2006 UTC (17 years, 7 months ago) by w.otsuka
Branch: MAIN
CVS Tags: TASK_PEP328_SOLARIS_NEVADA_PORT, TASK-PEP328_SOLARIS_NEVADA_PORT_v2-root, TASK-PEP328_SOLARIS_NEVADA_PORT_v2-branch, TASK-PEP328_SOLARIS_NEVADA_PORT-root, TASK-PEP328_SOLARIS_NEVADA_PORT-branch, TASK-PEP328_SOLARIS_IX86_CC_PORT-root, TASK-PEP328_SOLARIS_IX86_CC_PORT-branch-v2, TASK-PEP328_SOLARIS_IX86_CC_PORT-branch, TASK-PEP305_VXWORKS-root, TASK-PEP305_VXWORKS-branch-pre-solaris-port, TASK-PEP305_VXWORKS-branch-post-solaris-port, TASK-PEP305_VXWORKS-branch-beta2, TASK-PEP305_VXWORKS-branch, TASK-PEP305_VXWORKS-2008-10-23, TASK-PEP291_IPV6-root, TASK-PEP291_IPV6-branch, TASK-PEP286_PRIVILEGE_SEPARATION-root, TASK-PEP286_PRIVILEGE_SEPARATION-branch, TASK-PEP274_dacim-root, TASK-PEP274_dacim-merged_out_to_branch, TASK-PEP274_dacim-merged_out_from_trunk, TASK-PEP274_dacim-merged_in_to_trunk, TASK-PEP274_dacim-merged_in_from_branch, TASK-PEP274_dacim-branch, TASK-Bug2102_RCMPIWindows-root, TASK-Bug2102_RCMPIWindows-merged_out_to_branch, TASK-Bug2102_RCMPIWindows-merged_out_from_trunk, TASK-Bug2102_RCMPIWindows-merged_in_to_trunk, TASK-Bug2102_RCMPIWindows-merged_in_from_branch, TASK-Bug2102_RCMPIWindows-branch, TASK-Bug2102Final-root, TASK-Bug2102Final-merged_out_to_branch, TASK-Bug2102Final-merged_out_from_trunk, TASK-Bug2102Final-merged_in_to_trunk, TASK-Bug2102Final-merged_in_from_branch, TASK-Bug2102Final-branch, TASK-BUG7240-root, TASK-BUG7240-branch, TASK-BUG7146_SqlRepositoryPrototype-root, TASK-BUG7146_SqlRepositoryPrototype-merged_out_to_branch, TASK-BUG7146_SqlRepositoryPrototype-merged_out_from_trunk, TASK-BUG7146_SqlRepositoryPrototype-merged_in_to_trunk, TASK-BUG7146_SqlRepositoryPrototype-merged_in_from_branch, TASK-BUG7146_SqlRepositoryPrototype-branch, RELEASE_2_8_2-RC1, RELEASE_2_8_2, RELEASE_2_8_1-RC1, RELEASE_2_8_1, RELEASE_2_8_0_BETA, RELEASE_2_8_0-RC2, RELEASE_2_8_0-RC1, RELEASE_2_8_0-FC, RELEASE_2_8_0, RELEASE_2_8-root, RELEASE_2_8-branch, RELEASE_2_7_3-RC1, RELEASE_2_7_3, RELEASE_2_7_2-RC1, RELEASE_2_7_2, RELEASE_2_7_1-RC1, RELEASE_2_7_1, RELEASE_2_7_0-RC1, RELEASE_2_7_0-BETA, RELEASE_2_7_0, RELEASE_2_7-root, RELEASE_2_7-branch, RELEASE_2_6_3-RC2, RELEASE_2_6_3-RC1, RELEASE_2_6_3, RELEASE_2_6_2-RC1, RELEASE_2_6_2, RELEASE_2_6_1-RC1, RELEASE_2_6_1, RELEASE_2_6_0-RC1, RELEASE_2_6_0, RELEASE_2_6-root, RELEASE_2_6-branch-clean, RELEASE_2_6-branch, PEP286_PRIVILEGE_SEPARATION_ROOT, PEP286_PRIVILEGE_SEPARATION_CODE_FREEZE, PEP286_PRIVILEGE_SEPARATION_BRANCH, PEP286_PRIVILEGE_SEPARATION_1, Makefile
Changes since 1.1: +3 -3 lines
BUG#: 5898
TITLE: cimsub man page does not match help

DESCRIPTION: Modified cimsub man page enable and disable to require -H and -F options.

.\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man1.Z/cimsub.1,v 1.2 2006/11/29 21:02:46 w.otsuka Exp $
.\" .TA c \" lowercase initial letter of .TH name
.TH "cimsub" "1" "" "" ""
.SH "NAME"
cimsub \- list, enable, disable, or remove CIM indication subscriptions
.SH "SYNOPSIS"

\fBcimsub\fP \fB\-l\fP \fBs\fP|\fBf\fP|\f\h\fP [\fB\-v\fP][\fB\-n\fP namespace][\fB\-F\fP [fnamespace:]filtername][\fB\-H\fP [hnamespace:][hclassname.]handlername]

\fBcimsub\fP \fB\-e\fP [\fB\-n\fP namespace] \fB\-F\fP [fnamespace:]filtername \fB\-H\fP [hnamespace:][hclassname.]handlername

\fBcimsub\fP \fB\-d\fP [\fB\-n\fP namespace] \fB\-F\fP [fnamespace:]filtername \fB\-H\fP [hnamespace:][hclassname.]handlername

\fBcimsub\fP \fB\-r\fP \fBs\fP|\fBf\fP|\f\h\fP|\fBa\fP [\fB\-n\fP namespace][\fB\-F\fP [fnamespace:]filtername][\fB\-H\fP [hnamespace:][hclassname.]handlername]

\fBcimsub\fP \fB\-\-help\fP

\fBcimsub\fP \fB\-\-version\fP

.SH "DESCRIPTION"
The 
.B cimsub 
command provides a command line interface to manage CIM indication subscriptions on the local CIM Server.
.PP 
The first form of 
.B cimsub 
lists all or selected indication subscriptions, filters, or handlers, and displays the requested information about the instance(s). 
.PP 
The second form of 
.B cimsub 
enables the specified subscription, i.e. the subscription instance is modified to set the value of the SubscriptionState property to Enabled. When a subscription is enabled, the CIM Server attempts to process the subscription if at least one provider is available to serve the subscription. 
.PP 
The third form of 
.B cimsub 
disables the specified subscription, i.e. the subscription instance is modified to set the value of the SubscriptionState property to Disabled. When a subscription is disabled, the CIM Server does not attempt to process the subscription, regardless of whether any providers are available to serve the subscription. 
.PP 
The fourth form of 
.B cimsub 
removes the specified subscription, filter, handler, or subscription and its referenced filter and handler, i.e. each instance is deleted from the repository, and the CIM Server will no longer have any information about the instance(s). A filter or handler may not be removed if it is referenced by any other subscription. 
.SS Options
The 
.B cimsub 
command recognizes the following options:
.RS
.TP 15
.B \-l
List and display information about all or selected indication subscriptions ("s"), filters ("f"), or handlers ("h"). It is an error to specify the -F option with -lh. It is an error to specify the -H option with -lf. With the -lf or -lh option, fnamespace or hnamespace takes precedence over the -n namespace option if both are specified. 
.TP 
.B \-e
Enable the specified subscription (set the SubscriptionState to Enabled).
.TP 
.B \-d
Disable the specified subscription (set the SubscriptionState to Disabled).
.TP 
.B \-r
Remove the specified subscription ("s"), filter ("f"), handler ("h"), or subscription and its referenced filter and handler ("a") (delete the instance(s) from the repository). The -F and -H options are required with -rs or -ra. It is an error to specify the -F option with -rh. It is an error to specify the -H option with -rf. With the -rf or -rh option, fnamespace or hnamespace takes precedence over the -n namespace option if both are specified. 
.TP 
.B \-v
Include verbose information in the information displayed for each listed instance.
.TP 
.B \-n \fInamespace\fP
Specify the namespace. For the -l forms of the command, if no namespace is specified, instances in all namespaces are listed. For all other forms of the command, if no namespace is specified, the command operates on an instance in the namespace root/PG_InterOp. 
.TP 
.B \-F \fI[fnamespace:]filtername\fP
Specify the Filter Name. Omission of the filter namespace specifies that it is the same as that of the subscription. 
.TP 
.B \-H \fI[hnamespace:][classname.]handlername\fP
Specify the Handler Name. Omission of the handler namespace specifies that it is the same as that of the subscription. Omission of the handler classname specifies that it is CIM_ListenerDestinationCIMXML. 
.TP 
.B \-\-help
Display command usage information.
.TP 
.B \-\-version
Display the CIM Server version.
.SH "EXIT STATUS"
.PP 
When an error occurs, an error message is written to stderr and an
error value is returned.  The following return values are returned:
.RS
.TP 
.B 0
Successful completion
.PD 0
.TP 
.B 1
General error
.PD 0
.TP 
.B 2
Connection failed
.PD 0
.TP 
.B 3
Connection timed out
.PD 0
.TP 
.B 4
Access was denied
.PD 0
.TP 
.B 5
Namespace does not exist
.PD 0
.TP 
.B 6
Object could not be found
.PD 0
.TP 
.B 7
Operation is not supported  
.PD
.RE
.SH "USAGE NOTES"
.PP 
The 
.B cimsub 
command requires the CIM Server to be running.
.PP 
If the enableSubscriptionsForNonprivilegedUsers configuration property is set to false, only a privileged user may list, enable, disable, or remove a subscription, filter, or handler. If the enableSubscriptionsForNonprivilegedUsers configuration property is set to true, only a privileged user or the instance creator may enable, disable, or remove a subscription, filter or handler.
.PP
Caution should be used when specifying the -r option, since subscriptions, filters or handlers removed may not be easily re-created, and may not be re-created using this command. 
.SH "EXAMPLES "
.PP 
List all indication subscriptions in all namespaces on the local CIM Server: 
.IP 
.B cimsub \-ls
.PP 
List all indication subscriptions referencing the Filter with Name 'TestFilter' in all namespaces on the local CIM Server: 
.IP 
.B cimsub \-ls \-F TestFilter
.PP
List all indication subscriptions referencing the CIM_ListenerDestinationCIMXML Handler with Name 'TestHandler' in all namespaces on the local CIM Server: 
.IP
.B cimsub \-ls \-H TestHandler
.PP 
List all indication subscriptions in the root/cimv2 namespace on the local CIM Server, including subscription state, filter query and handler destination (verbose listing output): 
.IP 
.B cimsub \-ls \-v \-n root/cimv2
.PP
Display information about the subscription referencing Filter with Name 'TestFilter' and referencing CIM_ListenerDestinationCIMXML Handler with Name 'TestHandler' (all in namespace root/PG_InterOp), including subscription state, filter query and handler destination (verbose listing output): 
.IP 
.B cimsub \-ls \-v \-n root/PG_InterOp \-F TestFilter \-H TestHandler 
.PP 
Display information about the Filter with Name 'TestFilter' in the root/cimv2 namespace (verbose listing output): 
.IP 
.B cimsub \-lf \-v \-F root/cimv2:TestFilter
.PP
List all handlers in all namespaces on the local CIM Server:
.IP 
.B cimsub \-lh
.PP 
Enable the subscription referencing Filter with Name 'TestFilter' and referencing CIM_ListenerDestinationCIMXML Handler with Name 'TestHandler' (all in namespace root/PG_InterOp): 
.IP 
.B cimsub \-e \-F TestFilter \-H TestHandler
.PP
Disable the subscription in namespace root/cimv2, referencing Filter with Name 'TestFilter' in namespace test1/cimv2, and referencing PG_ListenerDestinationSystemLog Handler with Name 'TestHandler' in namespace test2/cimv2:
.IP 
.B cimsub \-d \-n root/cimv2 \-F test1/cimv2:TestFilter \-H test2/cimv2:PG_ListenerDestinationSystemLog.TestHandler
.PP
Remove the subscription referencing Filter with Name 'TestFilter', and referencing CIM_ListenerDestinationCIMXML Handler with Name 'TestHandler' (all in namespace root/cimv2), also removing the filter and handler instances (if not referenced by any other subscription): 
.IP
.B cimsub \-ra \-n root/cimv2 \-F TestFilter \-H TestHandler 
.SH "SEE ALSO"
.PP 
cimserver(1), cimconfig(1M).

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2