NAME

      mxwbemsub

      mxwbemsub - add, remove, list, or move WBEM event subscriptions from
      nodes in Systems Insight Manager


SYNOPSIS

      mxwbemsub -a [destination] ( ( -n <nodenames> ) | ( -f <filename> ) )
      mxwbemsub -r [destination] ( ( -n <nodenames> ) | ( -f <filename> ) )
      mxwbemsub -l [destination] ( ( -n <nodenames> ) | ( -f <filename> ) )
      mxwbemsub -m [currentdestination] <newdestination> ( ( -n <nodenames> )
      | ( -f <filename> ) )


DESCRIPTION

      The mxwbemsub command allows a Systems Insight Manager Central
      Management Server (CMS) user to add, list, delete, or move WBEM event
      subscriptions from nodes being managed by the CMS.  This command needs
      to access a file which only allows privileged user access.

      The mxwbemsub add option allows a user to create WBEM subscriptions on
      a set of nodes.  This option can specify the destination of the
      subscriptions. If the destination is not included, then the CMS on
      which the command is being run is used as the destination.

      The mxwbemsub remove option allows a user to delete WBEM subscriptions
      from a set of nodes.  This option can delete subscriptions to another
      CMS. If a CMS is not specified then subscriptions to the CMS on which
      the command is being run are deleted.

      The mxwbemsub list option allows a user to list WBEM subscriptions
      from a set of nodes.  This option can list subscriptions to another
      CMS. If a CMS is not specified then subscriptions to the CMS on which
      the command is being run are listed.

      The mxwbemsub move option allows a user to move WBEM subscriptions
      from one CMS to another CMS, for a set of nodes. If only one CMS is
      entered then that is used as the new destination for subscriptions.
      This option can be run with one CMS in the argument list, then the
      subscriptions to the CMS on which the command is being run are moved
      to a new CMS.

      Each option requires a list of node names on which the option will be
      executed. The node names can be entered through the commandline or
      from a file.  Each node name, entered on the command line or from a
      file, can be the IP address or the hostname or the fully qualified
      name of the node.

    Options
      mxwbemsub recognizes the following options:


	   -a		  Add WBEM subscriptions for the CMS specified. If
			  the destination CMS is not specified then the
			  default is the CMS on which it is being run.

	   -r		  Delete WBEM subscriptions for the CMS specified.
			  If the destination CMS is not specified then the
			  default is the CMS on which it is being run.

	   -l		  List the WBEM subscriptions for the CMS specified.
			  If the destination CMS is not specified then the
			  default is the CMS on which it is being run.

	   -m		  Moves WBEM subscriptions from one CMS to another
			  CMS. If the current CMS is not specified then the
			  default is the CMS on which it is being run, the
			  new destination CMS is required.

	   -n nodenames	  Used to specify a list of node names.	 This option
			  is used in conjunction with -a, -r, -l and -m

	   -f filename	  Used to specify a list of node names through a
			  file. Each node name is entered in a separate line
			  in filename. This option is used in conjunction
			  with -a, -r, -l and -m



EXAMPLES

      This command creates WBEM event subscriptions from the node
      mycomputer.ak.hp.com. The destination will be the CMS on which this
      command is running on.

	   mxwbemsub -a -n mycomputer.ak.hp.com

      This command creates WBEM subscriptions for the node
      mycomputer.ak.hp.com. The destination will be
      destinationcms.ak.hp.com.

	   mxwbemsub -a destinationcms.ak.hp.com -n mycomputer.ak.hp.com

      This command removes WBEM event subscriptions from the node
      mycomputer.ak.hp.com. This command only removes subscriptions whose
      destination is the CMS on which this command is running on.

	   mxwbemsub -r -n mycomputer.ak.hp.com

      This command removes subscriptions from the node mycomputer.ak.hp.com.
      This command only removes subscriptions whose destination is
      destinationcms.ak.hp.com.

	   mxwbemsub -r destinationcms.ak.hp.com -n mycomputer.ak.hp.com

      This command will list WBEM event subscriptions from the nodes
      mycomputer, and yourcomputer. This command only lists subscriptions
      whose destination is the CMS on which this command is running on.

	   mxwbemsub -l -n mycomputer yourcomputer

      This command will list subscriptions from the nodes mycomputer, and
      yourcomputer. This command only lists subscriptions whose destination
      is the destinationcms.

	   mxwbemsub -l destinationcms -n mycomputer.ak.hp.com
	   yourcomputer.ak.hp.com

      This command moves WBEM event subscriptions from the nodes
      mycomputer.ak.hp.com, and yourcomputer.ak.hp.com, from the default CMS
      to newcms.ak.hp.com. This command only moves subscriptions whose
      destination is the CMS on which this command is running on.

	   mxwbemsub -m newcms.ak.hp.com -n mycomputer.ak.hp.com
	   yourcomputer.ak.hp.com

      This command moves subscriptions from the nodes mycomputer.ak.hp.com,
      and yourcomputer.ak.hp.com, from currentcms.ak.hp.com to
      newcms.ak.hp.com. This command only moves subscriptions whose
      destination is currentcms.ak.hp.com.

	   mxwbemsub -m currentcms.ak.hp.com newcms.ak.hp.com -n
	   mycomputer.ak.hp.com

      This command will list the subscriptions from the nodes in the file
      /home/user1/defs/filename.txt.  This command only lists subscriptions
      whose destination is the CMS on which this command is running on.

	   mxwbemsub -l -f /home/user1/defs/filename.txt

      This command will list the subscriptions from the nodes in the file
      /home/user1/defs/filename.txt.  This command only lists subscriptions
      whose destination is destinationcms.

	   mxwbemsub -l destinationcms -f /home/user1/defs/filename.txt


LIMITATIONS

      This command has to be run on a CMS.


FILE PROCESSING

      If CMS detects an error while processing an input file, CMS will
      interrupt processing and issue an error message describing the error.


RETURN VALUE

      Always return 0.


AUTHOR

      Developed by the Hewlett-Packard Company.


SEE ALSO for HP-UX

      mxnodesecurity(1M).


SEE ALSO for Linux

      mxnodesecurity(8).