NAME

      mxngroup - Systems Insight Manager System Group file format


SYNOPSIS

      mxngroup


DESCRIPTION

      The mxngroup command supports reading and writing system group
      information in the eXtensible Markup Language (XML) format. You may
      use this capability to add, modify, or remove multiple system groups
      in the Systems Insight Manager environment.  Each file may contain the
      definitions of one or more system groups.

    Document Type Definition
      The Document Type Definition (DTD) file defines the constraints for an
      XML file. These constraints include the valid element tags,
      attributes, and the cardinality of elements in an XML file. The user
      DTD file is named userlist.dtd and is included in the following
      paragraph. Note that due to man page formatting, the DTD contents may
      not appear the same as in the file.

      <?xml version="1.0" encoding="UTF-8" ?>

      <!-- READ THIS FIRST! This file is intentionally formatted with a
	   right margin set at 70. This allows the DTD file to be pasted
	   directly into the mxngroup(4) man page file. Please respect this
	   constraint when editing this file. After edits are final for
	   a given release, please paste the final DTD version in the
	   mxngroup(4) man page to keep the documentation current. -->

      <!-- The node-group-list element consists of 0 or more node group
	   elements. -->
      <!ELEMENT node-group-list ( node-group )* >

      <!-- The node-group element has the following attributes: -->
      <!-- The name attribute specifies the nodegroup name and is required.
	   -->
      <!-- The guid attribute specifies the nodegroup GUID and is optional.
	   -->
      <!-- The node-group element is composed of the following elements: -->
      <!-- The description element may optionally appear once and specifies
	   the node group description. -->
      <!-- The member-node element may appear zero or more times and
	   specifies the node group's member nodes. -->
      <!-- The attribute element may appear zero or more times and specifies
	   the node group's client attributes. -->
      <!ELEMENT node-group ( description?, member-node*, attribute* ) >
      <!ATTLIST node-group name CDATA #REQUIRED
			   guid NMTOKEN #IMPLIED >

      <!ELEMENT description ( #PCDATA ) >
      <!-- The member-node element is an empty element with one attribute.
	   The value attribute specifies the node name and is required. -->
      <!ELEMENT member-node EMPTY >
      <!ATTLIST member-node value CDATA #REQUIRED >

      <!-- The attribute element specifies the name value pairs that
	   comprise client attributes. The client attribute name is
	   specified using the name attribute and the client attribute value
	   is specified as the PCDATA of the element. -->
      <!ELEMENT attribute ( #PCDATA ) >
      <!ATTLIST attribute name CDATA #REQUIRED >

    Elements
      As defined in the DTD, the user XML file may contain the following
      elements.

      The first line of a system group XML file should be in the following
      format:

      <?xml version="1.0" encoding="encoding-value" ?>

      where the user substitutes a recognized encoding value for the
      encoding-value parameter.	 The recognized encoding values may be found
      at the following web site:

      http://www.iana.org/assignments/character-sets

      If no XML header line is specified, the system defaults encoding to
      "UTF-8".

      The "node-group-list" element must appear once in a user XML file and
      wraps the list of system group information. The "node-group-list"
      element may contain zero or more "node-group" elements. Note that if
      the "node-group-list" element contains no "node-group" elements, the
      associated  mxngroup command will have no effect.

      The "node-group" element must appear one or more times in a node-group
      XML file. The "node-group" element has three attributes.
      The "node-group" attribute is mandatory and specifies the system group
      name.
      The "guid" attribute is optional and specifies the globally unique
      identifier of the system group. Because this value is assigned by the
      system, the system ignores this attribute when adding a new node-
      group.

      The "node" element may contain a number of optional elements. The
      "description" element may only appear once in each "node" element. The
      "member-node" and the "attribute" element which may appear zero or
      more times. Each element must appear in the order they are defined in
      the DTD.

      The "description" element specifies a description of the system group.

      The "member-node" element is an empty element with a required "value"
      attribute.  The "value" attribute specifies the system name of a
      member of the system group.

      The "attribute" element specifies a set of client attributes to be
      associated with the system group. Each "attribute" element contains a
      "name" attribute which identifies the client attribute and a "value"
      element which specifies the client attribute value.

    Commenting
      Comments may be included in XML files.  The comment must begin with
      the characters "<!--" and end with the characters "-->". Comments may
      span multiple lines within the beginning and ending character tags.

    Examples
      This section contains some examples of system group XML files.

      This example shows a file containing a system group with a
      description, but no members.

      <?xml version="1.0" encoding="UTF-8"?>
      <node-group-list>
	  <node-group name="group1">
	      <description>An empty system group.</description>
	  </node-group>
      </node-group-list>

      This example shows a file containing 2 system groups. The first system
      group contains a description with no members. The second system group
      contains a description with one member.

      <?xml version="1.0" encoding="UTF-8"?>
      <node-group-list>
	  <node-group name="group1">
	      <description>An empty system group.</description>
	  </node-group>
	  <node-group name="group2">
	      <description>A group with one system.</description>
	      <member-node value="node.dom1.corp.com" />
	  </node-group>
      </node-group-list>


LIMITATIONS

      This command may only be run on the CMS.


AUTHOR

      mxngroup was developed by the Hewlett-Packard Company.



SEE ALSO for HP-UX

      mxngroup(1M)


SEE ALSO for Linux

      mxngroup(8)