Policy XML reference
This chapter describes the XML elements, sub-elements, and attributes that are supported for System Automation for Multiplatforms automation policies.
The following table shows in which version of System Automation for Multiplatforms particular XML elements became available.
| XML element | First supported in System Automation for Multiplatforms version |
|---|---|
| <recoveryPolicy> as Attribute of <Members> | 3.2.2 |
| <Options> as sub-element of <IBM.AgFileSystemAttributes> | 3.2.1.3 |
| <ConcurrentGroup> | 3.1.0.5 |
| <CleanupCommand> as sub-element of <IBM.ApplicationAttributes> | 3.1.0.5 |
| <CleanupCommandTimeout> as sub-element of <IBM.ApplicationAttributes> | 3.1.0.5 |
| <CleanupNodeList> as sub-element of <IBM.ApplicationAttributes> | 3.1.0.5 |
| <CleanupNode> as sub-element of <IBM.ApplicationAttributes> | 3.1.0.5 |
| <ProcessCommandString> as sub-element of <IBM.ApplicationAttributes> | 3.1.0.5 |
| <MonitorUserName> as sub-element of <IBM.ApplicationAttributes> | 3.1.0.5 |
| <NetPrefix> as sub-element of <IBM.ServiceIPAttributes> | 3.1.0.1 |
| <AutomationPolicyTemplate>, <var>, and <include> | 2.3 |
| <IBM.AgFileSystemAttributes> | 2.2.0.1 |
IBM.AgFileSystem as class value |
2.2.0.1 |
| <ClassAttributesReference> as sub-element of <ConstituentResource> | 2.2.0.1 |
| All other tags | 2.1 |
- Name
- The name and a short description of the element.
- Examples
- One or more examples showing how the element is used.
- Attributes
- Descriptions of the element's attributes.
- Contexts
- Children: a list of elements the element can contain.
- Occurrence
- The possible number occurrences of the element.
When you create an XML file, it is recommended to use the official
XML policy file template SAMTemplate.xml located in the /usr/sbin/rsct/samples/policy directory.
To use the template, copy the file to your working directory and rename
it according to your file naming conventions.
When you create an XML template file, used for template processing,
it is recommended to use the official XML policy file template SAMTopLevelTemplate.xml located
in the /usr/sbin/rsct/samples/policy directory. To use
the template, copy the file to your working directory and rename it
according to your file naming conventions.
To create an XML policy file, you can use any commercial, shareware, or free-ware XML or ASCII editor that allows you to save the file in UTF-8 format. XML files in any other format will be rejected by the policy checker.
If you use an XML editor to create the XML policy file, the editor will create the basic XML
policy template for you. Additionally, most XML editors have a validation function that
ensures that your XML code conforms to the relevant schema. When you want to use these
functions, you must ensure that the XML editor knows where to find the relevant schema. The
schema for the System Automation for Multiplatforms
policy is defined in the files SAMPolicy.xsd and
SAMSimpleTypes.xsd. They are located in the directory
/usr/sbin/rsct/samples/policy. The schema for the System Automation for Multiplatforms policy template is defined
in the files SAMPolicyTemplate.xsd and SAMSimpleTypes.xsd.
They are located in the directory /usr/sbin/rsct/samples/policy.