NAME

      mxstm - add, remove, and list system type manager rules.


SYNOPSIS

      mxstm

	   mxstm -a -n <product name> -p snmp|dmi ( -x <attribute>=<value> )+

	   mxstm -r -n <product name>

	   mxstm -a -f <filespec>

	   mxstm -r -f <filespec>

	   mxstm -l [ -n <product name> ]

	   mxstm -l [ -p snmp|dmi [ -f <filespec> ] ]




DESCRIPTION

      The mxstm command allows the user to add, remove, and list system type
      manager rules for use with Systems Insight Manager.


OPTIONS

      mxstm recognizes the following options:

	   -a		  Add a new rule. Optionally use the -f option to
			  import one or more rules in XML format from a
			  file. The XML file must be encoded in UTF-8 and
			  must be declared with encoding="UTF-8".

	   -r		  Remove an existing rule. Optionally use the -f
			  option to delete one or more rules in XML format
			  from a file. The XML file must be encoded in UTF-8
			  and must be declared with encoding="UTF-8".

	   -l		  List rules. Use the -n option to provide a product
			  name and list rule details. Use the -f option to
			  output rules in XML format to a file. Optionally
			  specify a protocol to selectively output rules
			  matching the specified protocol. The XML file
			  output by this command is valid input for the -a
			  and -r options. This option can be used to create
			  an XML file that can be modified for use with the
			  -a and -r options. The XML file will be encoded in
			  UTF-8.

	   -x <attribute>[=<value>]
			  Attribute is the name of a protocol specific
			  attribute and value is the value to be assigned to
			  the attribute.

	   -n		  Product name.

	   -p		  Protocol. Should be snmp (snmp or dmi if the
			  central management server is hosted on a Microsoft
			  Windows operating system).

	   -x		  SNMP Required attributes: sysoid.


	   SNMP Optional attributes: url, urldesc, type, subtype, osname,
	   osvendor, osversion, sysoidrule, oid, oidval, oidrule, and
	   priority.


	   DMI Required attributes: comp1, group1, sgroup1, attrib1, val1,
	   and rule1.


	   DMI Optional attributes: url, type, subtype, comp2, group2,
	   sgroup2, attrib2, val2, rule2, comp3, group3, sgroup3, attrib3,
	   val3, rule3, and priority.


	   The "type" attribute can take values of Cluster, Complex,
	   Desktop, Enclosure, Env, Handheld, Hub, KVM, MgmtProc, Other,
	   PDU, Partition, Portable, PowerSupply, Printer, RAS, Rack,
	   Router, Server, Switch, UPS, Unknown, and Workstation. The
	   "subtype" attribute can take values of MSCS, NSCUW7, None, OVMS,
	   PowerEnc, RAC, ServerEnc, TCR_PS, and TruCluster. Attribute
	   values for "type" and "subtype" attributes are case sensitive.


	   Compare Rules: StartsWith|Contains|Match|EndsWith|AnyValue


	   Insufficient or invalid optional attributes will be replaced with
	   sensible defaults where possible.



RETURN VALUE

      Upon completion, mxstm returns:

	     0	The operation completed successfully.
	     >0 An error occured during operation.

AUTHOR

      mxstm was developed by the Hewlett-Packard Company.

SEE ALSO

      /opt/mx/dtd/stmrules.dtd