NAME

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

SYNOPSIS

      mxstm

	   mxstm -a -n <product name> -p snmp ( ( -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 [ -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 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.


	   The "type" attribute can take values of Application, Cluster,
	   Complex, Desktop, Enclosure, Env, Handheld, Hub, KVM, MgmtProc,
	   Other, PDU, Partition, Portable, PowerSupply, Printer, RAS, Rack,
	   RESPAR, Router, Server, SRC, Storage, Switch, TapeLibrary, UPS,
	   Unknown, and Workstation, or other values as defined in the
	   nodeTypesEnum table.


	   The "subtype" attribute can take values of Blade, BladeSystem,
	   BS-BMP, BS-SMC, c-Class, Dell, e-Class, gWLMResPar,
	   HighAvailabilityArray, HighAvailabilityCluster, HP Serviceguard,
	   HP9000, HP9000Superdome, HPAlphaServer, HPAlphaStation,
	   HPDeskpro, HPEvo, HPIntegrity, HPIntegrityServer,
	   HPIntegrityWorkStation, HPKayak, HPNetServer, HPNonStop,
	   HPOmnibook, HPProLiant, HPServer, HPSGCMember, HPSuperdome,
	   HPUNCFG, HPVectra, HPVisualize, HPVMGuest, HPVMHost,
	   HPWorkstation, ILO, ILO2, LO100, MP-MPS, MP-PBE-IA, MP-SPS, MSCS,
	   None, nPar, NSCUW7, OA, OVMS, p-Class, PowerEnc, PRMResPar, RAC,
	   RILOE, RILOE2, ServerEnc, SMI, Storage, StorageEssentials,
	   TCR_PS, TruCluster, TT-RCC, VMGuest, VMHost, vPar, vParMonitor,
	   WLMResPar or other values as defined in the nodeSubTypesEnum
	   table.


	   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.
	     2	A command-line syntax error was encountered.
	     >0 An error occurred during operation.

AUTHOR

      mxstm was developed by the Hewlett-Packard Company.

SEE ALSO

      /opt/mx/dtd/stmrules.dtd