<!-- ************************************************************** -->
<!-- This DTD defines the XML for Identity Manager configuration    -->
<!-- files as supported by Identity Manager for Seafang.            -->
<!--                                                                -->
<!-- Configuration files that adhere to this DTD will only be       -->
<!-- importable by the Identity Manager 3.5 plug-ins for            -->
<!-- iManager 2.5.                                                  -->
<!--                                                                -->
<!-- DTD Version:  10.2.20060927                                    -->
<!-- Copyright 2002-2006 Novell, Inc.  All rights reserved.         -->
<!-- Creation Date:  05/21/2002                                     -->
<!-- ************************************************************** -->

<!ENTITY % Boolean		"true   | false"                      >
<!ENTITY % CompareMode	"equals | not-equals"                 >
<!ENTITY % ContentType  "xml    | text     | base64-encoded"  >
<!ENTITY % DNFormat		"dot    | slash    | ldap"            >
<!ENTITY % PromptType	"ipa    | password | normal | hidden" >
<!ENTITY % RopeInMode	"equals | not-equals"                 >
<!ENTITY % VariablePart	"ipa    | port     | full"            >
<!ENTITY % YesNo		"yes    | no"                         >
<!ENTITY % BuiltIn
	"System.DriverDN"   |
	"System.DriverName" |
	"System.DSetDN"     |
	"System.DSetName"   |
	"System.ServerDN"   |
	"System.ServerName" |
	"System.TreeName">


<!-- ************************************************************** -->
<!-- The driver-set-configuration element contains one or more      -->
<!-- driver-configuration elements.  It is logically equivalent to  -->
<!-- an eDirectory DirXML-DriverSet object.                         -->
<!-- ************************************************************** -->
<!ELEMENT driver-set-configuration(
	attributes(ds)?,
	children(ds)?,
	driver-configuration*)>


<!-- ************************************************************** -->
<!-- The driver-configuration element contains a fully qualified    -->
<!-- description of a DirXML driver and its contents.  It is        -->
<!-- logically equivalent to an eDirectory DirXML-Driver object.    -->
<!-- ************************************************************** -->
<!ELEMENT driver-configuration(
	attributes?,
	children?,
	ds-object*,
	xsl-modify?
	configuration-values?,
    variable-decl*)>
<!ATTLIST driver-configuration
	description		CDATA #IMPLIED		<!-- Used as a 'short' human readable name for the driver.                    -->
	dn				CDATA #REQUIRED		<!-- DN of the exported driver used to create this driver configuration file. -->
	driver-set-dn	CDATA #REQUIRED		<!-- DN of the driver set containing the exported driver.                     -->
	name			CDATA #REQUIRED		<!-- The name of the exported driver.                                         -->
	policy-library  (%Boolean) "false"	<!-- true -> This is a policy library only configuration.  false -> It's not. -->
	set-security	(%YesNo)   "yes"	<!-- No implies don't ask for security equivalences or exclusions.            -->
	debug-dump      (%Boolean) "false"	<!-- true -> Dump XML file at various stages of import processing.            -->
	<!-- The following were used by the ConsoleOne snapins to   -->
	<!-- support the direct importing of a driver configuration -->
	<!-- file from the command line.  They should no longer be  -->
	<!-- used.                                                  -->
	target-tree				CDATA #IMPLIED
	target-server-dn		CDATA #IMPLIED
	target-driver-set-dn	CDATA #IMPLIED
	target-exit				CDATA #IMPLIED
>


<!-- *********************************************************** -->
<!-- The variable-decl element contains definitions of variables -->
<!-- whose values can be prompted for and referred to throughout -->
<!-- the driver configuration file.                              -->
<!-- *********************************************************** -->
<!ELEMENT variable-decl(
	node-var*,
	text-var*)>
<!ATTLIST variable-decl
	<!-- The following are used in the support of flexible -->
	<!-- prompting.                                        -->
	use-when-var	CDATA #IMPLIED
	use-when-value	CDATA #IMPLIED
	use-when-mode	(%CompareMode) "equals"
>


<!-- ************************************************************** -->
<!-- The node-var element defines a variable containing XML that    -->
<!-- gets expanded into references to the variable.                 -->
<!-- ************************************************************** -->
<!ELEMENT node-var ((arbitrary-nodes | variable-ref)*)>	<!-- All content passed through. -->
<!ATTLIST node-var
	var-name			CDATA #REQUIRED
	node-name			CDATA #REQUIRED
	attr-name			CDATA #REQUIRED	<!-- Not required (and is ignored) if node-name is "#text". -->
	description			CDATA #IMPLIED
	highlight			CDATA #IMPLIED
	prompt				CDATA #IMPLIED
	prompt-size			CDATA #IMPLIED
	prompt-mandatory	(%Boolean) "false"
	prompt-required		(%Boolean) "false"
	default-value		CDATA #IMPLIED
>


<!-- ************************************************************** -->
<!-- The text-var element defines a variable containing text that   -->
<!-- gets expanded as specified by references to the variable.      -->
<!-- ************************************************************** -->
<!ELEMENT text-var(
	(#PCDATA) |
	(dropdown | checkboxset)?)>
<!ATTLIST text-var
	var-name			CDATA #REQUIRED
	prompt				CDATA #IMPLIED
	prompt-type			(%PromptType) "normal"
	prompt-size			CDATA #IMPLIED
	prompt-mandatory	(%Boolean) "false"
	prompt-required		(%Boolean) "false"
	description			CDATA #IMPLIED
	highlight			CDATA #IMPLIED
	browse				(%YesNo) "no"
>

<!-- Provides a dropdown selection list for text-var's. -->
<!ELEMENT dropdown	value*>
<!ELEMENT value		(#PCDATA)>
<!ATTLIST value
	display CDATA #IMPLIED
>

<!-- Provides a set of checkboxes for text-var's. -->
<!ELEMENT checkboxset	checkbox*>
<!ELEMENT checkbox      EMPTY>
<!ATTLIST checkbox
	cb-name		CDATA #REQUIRED
	display 	CDATA #REQUIRED
	checked		(%Boolean) "false"
	onchecked	CDATA #IMPLIED	<!-- Value to render if the checkbox is   checked.  Defaults to "true".  -->
	onunchecked	CDATA #IMPLIED	<!-- Value to render if the checkbox is unchecked.  Defaults to "false". -->
>


<!-- ************************************************************** -->
<!-- A variable-ref element defines a reference to a variable       -->
<!-- declared in a variable-decl element or a reference to a        -->
<!-- built-in variable.                                             -->
<!-- ************************************************************** -->
<!ELEMENT variable-ref>
<!ATTLIST variable-ref
	var-name	CDATA #REQUIRED			<!-- May be a BuiltIn ENTITY reference.                                              -->
	cb-name		CDATA #IMPLIED			<!-- Required if the variable being referenced is a checkboxset.  Ignored otherwise. -->
	attr-name	CDATA #IMPLIED
	dn-format	(%DNFormat)		"slash"
	xsl-literal	(%Boolean)		"false"
	part		(%VariablePart)	"full"	<!-- Ignored if the variable being referenced is not prompt-type="ipa". -->
>


<!-- ************************************************************* -->
<!-- The attributes element contains information that is stored as -->
<!-- eDirectory attributes on the DirXML-Driver object created by  -->
<!-- importing this driver configuration file.                     -->
<!-- ************************************************************* -->
<!ELEMENT attributes(
	application-schema?,
	config-manifest?,
	configuration-manifest?,
	configuration-values?,
	driver-filter-xml?,
	driver-image?,
	driver-trace-level?,
	global-config-values?,
	global-engine-values?,
	input-transform?,
	java-module?,
	log-events?,
	log-limit?,
	mapping-rule?,
	native-module?,
	output-transform?,
	trace-file?,
	trace-level?,
	trace-name?,
	trace-size-limit?,
	policy-linkage?,
	driver-start-option?,
	driver-cache-limit?,
	shim-auth-id?,
	shim-auth-server?,
	shim-config-info-xml?,
	(named-password-query     | named-password)*,
	(driver-password-query    | driver-password)?,
	(shim-auth-password-query | shim-auth-password?),
	(arbitrary-nodes          | variable-ref)*)>

<!ELEMENT application-schema     ((arbitrary-nodes | variable-ref)*)>
<!ELEMENT config-manifest        ((arbitrary-nodes | variable-ref)*)>
<!ELEMENT configuration-manifest ((arbitrary-nodes | variable-ref)*)>
<!ELEMENT configuration-values   ((arbitrary-nodes | variable-ref)*)>
<!ELEMENT global-config-values   ((arbitrary-nodes | variable-ref)*)>
<!ELEMENT global-engine-values   ((arbitrary-nodes | variable-ref)*)>
<!ELEMENT driver-filter-xml      ((arbitrary-nodes | variable-ref)*)>

<!ELEMENT driver-image (#PCDATA)>

<!ELEMENT driver-trace-level variable-ref*>
<!ATTLIST driver-trace-level
	value CDATA #IMPLIED
>

<!ELEMENT input-transform variable-ref*>
<!ATTLIST input-transform
	dn CDATA #IMPLIED
>

<!ELEMENT java-module variable-ref*>
<!ATTLIST java-module
	value CDATA #IMPLIED
>

<!ELEMENT log-events value(le)*, variable-ref*>
<!ELEMENT value(le) variable-ref*>
<!ATTLIST value(le)
	value CDATA #IMPLIED
>

<!ELEMENT log-limit variable-ref*>
<!ATTLIST log-limit
	value CDATA #IMPLIED
>

<!ELEMENT mapping-rule variable-ref*>
<!ATTLIST mapping-rule
	dn CDATA #IMPLIED
>

<!ELEMENT native-module variable-ref*>
<!ATTLIST native-module
	value CDATA #IMPLIED
>

<!ELEMENT output-transform variable-ref*>
<!ATTLIST output-transform
	dn CDATA #IMPLIED
>

<!ELEMENT trace-file variable-ref*>
<!ATTLIST trace-file
	value CDATA #IMPLIED
>

<!ELEMENT trace-level variable-ref*>
<!ATTLIST trace-level
	value CDATA #IMPLIED
>

<!ELEMENT trace-name variable-ref*>
<!ATTLIST trace-name
	value CDATA #IMPLIED
>

<!ELEMENT trace-size-limit variable-ref*>
<!ATTLIST trace-size-limit
	value CDATA #IMPLIED
>

<!ELEMENT policy-linkage (linkage-item*, variable-ref*)>

<!ELEMENT linkage-item variable-ref*>
<!ATTLIST linkage-item
	dn				CDATA #REQUIRED
	order			CDATA #REQUIRED
	policy-set		CDATA #REQUIRED
	policy-set-name	CDATA #IMPLIED	<!-- Used for readability only. -->
>

<!ELEMENT driver-start-option variable-ref*>
<!ATTLIST driver-start-option
	value CDATA #IMPLIED
>

<!ELEMENT driver-cache-limit variable-ref*>
<!ATTLIST driver-cache-limit
	value CDATA #IMPLIED
>

<!ELEMENT shim-auth-id variable-ref*>
<!ATTLIST shim-auth-id
	value CDATA #IMPLIED
>

<!ELEMENT shim-auth-server variable-ref*>
<!ATTLIST shim-auth-server
	value CDATA #IMPLIED
>

<!ELEMENT shim-config-info-xml ((arbitrary-nodes | variable-ref)*)>

<!ELEMENT named-password-query variable-ref*>
<!ATTLIST named-password-query
	name         CDATA #REQUIRED
	display-name CDATA #IMPLIED
	prompt       CDATA #IMPLIED
	prompt-size  CDATA #IMPLIED
>

<!ELEMENT named-password variable-ref*>
<!ATTLIST named-password
	password CDATA #IMPLIED
>

<!ELEMENT driver-password-query variable-ref*>
<!ATTLIST driver-password-query
	prompt		CDATA #IMPLIED
	prompt-size	CDATA #IMPLIED
>

<!ELEMENT driver-password variable-ref*>
<!ATTLIST driver-password
	password CDATA #IMPLIED
>

<!ELEMENT shim-auth-password-query variable-ref*>
<!ATTLIST shim-auth-password-query
	prompt		CDATA #IMPLIED
	prompt-size	CDATA #IMPLIED
>

<!ELEMENT shim-auth-password variable-ref*>
<!ATTLIST shim-auth-password
	password CDATA #IMPLIED
>


<!-- *********************************************************** -->
<!-- The children element contains information that is stored as -->
<!-- contained eDirectory objects in the DirXML-Driver object    -->
<!-- created by importing this driver configuration file.        -->
<!-- *********************************************************** -->
<!ELEMENT children(
	publisher?,
	subscriber?,
 	provisioning?,
 	jobs?,
	rule*,
	stylesheet*,
	resource*,
	policy-library*,
	entitlement-definition*,
	(arbitrary-nodes | variable-ref)*)>

<!ELEMENT rule ((arbitrary-nodes | variable-ref)*)>
<!ATTLIST rule
	name CDATA #IMPLIED
>

<!ELEMENT stylesheet ((arbitrary-nodes | variable-ref)*)>
<!ATTLIST stylesheet
	name CDATA #IMPLIED
>

<!ELEMENT resource (
	(descriptions?, named-passwords?, content), variable-ref*)>
<!ATTLIST resource
	name         CDATA #REQUIRED
	content-type CDATA #REQUIRED
>


<!-- ************************************************ -->
<!-- Used for description values in both resource and -->
<!-- policy-library Elements.                         -->
<!-- ************************************************ -->
<!ELEMENT descriptions (
	(description | variable-ref)*)>

<!ELEMENT description variable-ref*>
<!ATTLIST description
	value CDATA #REQUIRED
>


<!-- *********************************************************** -->
<!-- Used to store the content of a resource.                    -->
<!-- If contains is xml:              Content is an XML Element. -->
<!-- If contains is text:             Content is simple text.    -->
<!-- If contians is based64-encoded:  Content is base64 encoded  -->
<!--                                  data.                      -->
<!-- *********************************************************** -->
<!ELEMENT content (
	(#PCDATA | ((arbitrary-nodes | variable-ref)*))>
<!ATTLIST content
	contains (%ContentType) #REQUIRED
>


<!-- **************************************************** -->
<!-- Used to store a list of named passwords on resource. -->
<!-- **************************************************** -->
<!ELEMENT named-passwords
	((named-password-query | variable-ref)*)>


<!-- ************************************************************** -->
<!-- The publisher and subscriber elements contain information      -->
<!-- about the publisher and subscriber channels of a DirXML        -->
<!-- driver.  They are logically equivalent to eDirectory           -->
<!-- DirXML-Publisher and DirXML-Subscriber objects.                -->
<!-- ************************************************************** -->
<!ELEMENT publisher(
	attributes(channel)?,
	children(channel)?,
	variable-ref*)>
<!ATTLIST publisher
	name CDATA #IMPLIED
>

<!ELEMENT subscriber(
	attributes(channel)?,
	children(channel)?,
	variable-ref*)>
<!ATTLIST subscriber
	name CDATA #IMPLIED
>


<!-- ************************************************************** -->
<!-- The provisioning element contains information for creating     -->
<!-- provisioning configuration objects within the containing       -->
<!-- DirXML-Driver.                                                 -->
<!-- ************************************************************** -->
<!ELEMENT provisioning (ds-object*)>


<!-- ************************************************************* -->
<!-- The jobs element contains information for creating DirXML-Job -->
<!-- and nspmPasswordPolicy objects within the containing          -->
<!-- DirXML-Driver or DirXML-DriverSet.                            -->
<!-- ************************************************************* -->
<!ELEMENT jobs (ds-object*)>


<!-- *************************************************************** -->
<!-- Creates an object of ds-object-class named ds-object-name       -->
<!-- in the container object.  The ds-object element describes an    -->
<!-- object hierarchy that is to be created in eDirectory as part of -->
<!-- importing the driver configuration file.                        -->
<!--                                                                 -->
<!-- When contained in a provisioning Element, the object is created -->
<!-- in the DirXML-Driver object.  When nested in another ds-object  -->
<!-- Element, the object is created in that object.  (Note:  The     -->
<!-- containing ds-object must specify an eDirectory container class -->
<!-- that can contain an object of the specified class.)  When       -->
<!-- contained in a driver-configuration Element, the object is      -->
<!-- created at the root of the tree.                                -->
<!--                                                                 -->
<!-- Note that if the object already exists, the attributes are      -->
<!-- ignored but any nested ds-object's will be processed.           -->
<!-- *************************************************************** -->
<!ELEMENT ds-object(				<!--                                                             -->
	ds-object*,						<!--                                                             -->
	ds-attributes*,					<!-- Use ds-attributes(job) when ds-object-class="DirXML-Job".   -->
	variable-ref*)>					<!--                                                             -->
<!ATTLIST ds-object					<!--                                                             -->
	ds-object-class	CDATA #REQUIRED	<!-- The eDirectory class name of the object to create.          -->
	ds-object-name	CDATA #REQUIRED <!-- The name of the eDirectory object to create of that class.  -->
	...other DS attributes...		<!-- Deprecated:  Other eDirectory attributes.                   -->
>

<!-- Contains attributes to be stored on the containing ds-object. -->
<!ELEMENT ds-attributes (ds-attribute*)>


<!-- When used within a ds-object defining a job, contains      -->
<!-- attributes to be stored on the job as well as job specific -->
<!-- values and queries.                                        -->
<!ELEMENT ds-attributes(job)(
	job-email-server-query,
	job-scope-query,
	job-servers-query,
	(named-password | named-password-query)*,
	(ds-attribute (job-reference-dn | job-reference-dn-query)*)*)>


<!-- Contains an attribute and value(s) to be stored on the        -->
<!-- containing ds-object.  If there are multiple ds-value's, the  -->
<!-- attribute named by ds-attr-name must be defined in eDirectory -->
<!-- to contain multiple values.                                   -->
<!--                                                               -->
<!-- At import time, the syntax of the attribute specified by      -->
<!-- ds-attr-name is checked and must be one of the following      -->
<!-- supported syntaxes:                                           -->
<!--    SYN_BOOLEAN                                                -->
<!--    SYN_CE_STRING                                              -->
<!--    SYN_CI_STRING                                              -->
<!--    SYN_DIST_NAME                                              -->
<!--    SYN_INTEGER                                                -->
<!--    SYN_INTERVAL                                               -->
<!--    SYN_PATH                                                   -->
<!--    SYN_STREAM                                                 -->
<!--    SYN_TIME                                                   -->
<!--    SYN_TYPED_NAME                                             -->
<!ELEMENT ds-attribute (ds-value*)>
<!ATTLIST ds-attribute
	ds-attr-name CDATA #REQUIRED
>

<!-- Contains individual attribute values for an attribute.  The   -->
<!-- contents are based on the syntax of the attribute.  Note that -->
<!-- stream attributes are stored as base64 encoded strings.       -->
<!--                                                               -->
<!-- The supported syntaxes are handled as follows:                -->
<!--    SYN_BOOLEAN:  Text value containing true or false.         -->
<!--    SYN_CE_STRING and                                          -->
<!--    SYN_CI_STRING:  CDATA containing the string.               -->
<!--    SYN_DIST_NAME:  CDATA containing the DN in dot format.     -->
<!--    SYN_INTEGER:  Text value containing the integer.           -->
<!--    SYN_INTERVAL:  Text value containing the integer.          -->
<!--    SYN_PATH:  Path component values.                          -->
<!--    SYN_STREAM:  CDATA containing the base64 encoded stream.   -->
<!--    SYN_TIME:  Text value of the time in milli-seconds.        -->
<!--    SYN_TYPED_NAME:  Typed name component values.              -->
<!ELEMENT ds-value(
	(path path-type path-volume)                             |
	(typed-name-interval typed-name-level typed-name-object) |
	#PCDATA)>


<!-- Text values contain the components of a SYN_PATH value. -->
<!ELEMENT path 			(#PCDATA)>
<!ELEMENT path-type		(#PCDATA)>
<!ELEMENT path-volume	(#PCDATA)>


<!-- Text values contain the components of a SYN_TYPED_NAME value. -->
<!ELEMENT typed-name-interval	(#PCDATA)>
<!ELEMENT typed-name-level		(#PCDATA)>
<!ELEMENT typed-name-object		(#PCDATA)>


<!-- Causes the user to be prompted for the email server to         -->
<!-- be associated with the containing DirXML-Job.  When the prompt -->
<!-- is satisfied, this is replaced by a ds-attribute for the       -->
<!-- selected email server.                                         -->
<!--                                                                -->
<!-- job-name         - The CN of the containing DirXML-Job.        -->
<!-- job-display-name - The display name of the job extracted from  -->
<!--                    from the exported job's XmlData.  If not    -->
<!--                    supplied, the job-name will be used.        -->
<!--                                                                -->
<!-- (Note:  This will only be recognized in the ds-attributes of a -->
<!-- ds-object for a DirXML-Job object.                             -->
<!ELEMENT job-email-server-query>
<!ATTLIST job-email-server-query
	job-name         CDATA #REQUIRED
	job-display-name CDATA #IMPLIED
>


<!-- Causes the user to be prompted for the scope for the job.  When -->
<!-- the prompt is satisfied, this is replaced by a ds-attribute for -->
<!-- the scoping information.                                        -->
<!--                                                                 -->
<!-- job-name         - The CN of the containing DirXML-Job.         -->
<!-- job-display-name - The display name of the job extracted from   -->
<!--                    from the exported job's XmlData.  If not     -->
<!--                    supplied, the job-name will be used.         -->
<!--                                                                 -->
<!-- (Note:  This will only be recognized in the ds-attributes of a  -->
<!-- ds-object for a DirXML-Job object.                              -->
<!ELEMENT job-scope-query>
<!ATTLIST job-scope-query
	job-name         CDATA #REQUIRED
	job-display-name CDATA #IMPLIED
>


<!-- Causes the user to be prompted for the servers to be associated -->
<!-- with the job.  When the prompt is satisfied, this is replaced   -->
<!-- by a ds-attribute for the selected servers.                     -->
<!--                                                                 -->
<!-- job-name         - The CN of the containing DirXML-Job.         -->
<!-- job-display-name - The display name of the job extracted from   -->
<!--                    from the exported job's XmlData.  If not     -->
<!--                    supplied, the job-name will be used.         -->
<!--                                                                 -->
<!-- (Note:  This will only be recognized in the ds-attributes of a  -->
<!-- ds-object for a DirXML-Job object.                              -->
<!ELEMENT job-servers-query>
<!ATTLIST job-servers-query
	job-name         CDATA #REQUIRED
	job-display-name CDATA #IMPLIED
>


<!-- Causes the user to be prompted for a job reference DN for the  -->
<!-- job.  The number and content of these is based on the content  -->
<!-- of the exported job's XmlData.  When the prompt is satisfied,  -->
<!-- this is replaced by a job-reference-dn for the selected        -->
<!-- reference DN.                                                  -->
<!--                                                                -->
<!-- job-name               - The CN of the containing DirXML-Job.  -->
<!-- job-display-name       - The display name of the job extracted -->
<!--                          from the exported job's XmlData.  If  -->
<!--                          not supplied, the job-name will be    -->
<!--                          used.                                 -->
<!-- attr-name              - The name of the attribute this        -->
<!--                          reference DN is for.  Extracted from  -->
<!--                          the job's XmlData on export.          -->
<!-- aux-class-name         - If supplied the auxclass attr-name is -->
<!--                          defined in.  If not supplied, the     -->
<!--                          is assumed to already be defined on   -->
<!--                          DirXML-Job.                           -->
<!-- reference-name         - The name of the reference extracted   -->
<!--                          from the job's XmlData on export.     -->
<!-- reference-display-name - If supplied, the display name of the  -->
<!--                          reference extracted from the job's    -->
<!--                          XmlData on export.  If not supplied,  -->
<!--                          the reference-name will be used.      -->
<!-- target-class-filter    - If supplied, contains the             -->
<!--                          target-class information extracted    -->
<!--                          from the job's XmlData.  This must be -->
<!--                          a comma seperated list of the class   -->
<!--                          names suitable for use by iManager's  -->
<!--                          object selected.  If not supplied,    -->
<!--                          "*" will be used (i.e., all classes   -->
<!--                          will be accepted.)                    -->
<!--                                                                -->
<!-- (Note:  This will only be recognized in the ds-attributes of a -->
<!-- ds-object for a DirXML-Job object.                             -->
<!ELEMENT job-reference-dn-query>
<!ATTLIST job-reference-dn-query
	job-name				CDATA #REQUIRED
	job-display-name		CDATA #IMPLIED
	attr-name				CDATA #REQUIRED
	aux-class-name			CDATA #IMPLIED
	reference-name			CDATA #REQUIRED
	reference-display-name	CDATA #IMPLIED
	target-class-filter		CDATA #IMPLIED
>


<!-- Specifies a job reference DN for a job.  See                   -->
<!-- job-reference-dn-query for more information.                   -->
<!--                                                                -->
<!-- job-name               - The CN of the containing DirXML-Job.  -->
<!-- job-display-name       - The display name of the job extracted -->
<!--                          from the exported job's XmlData.  If  -->
<!--                          not supplied, the job-name will be    -->
<!--                          used.                                 -->
<!-- dn                     - The DN of the of the referenced       -->
<!--                          object.  During import, this will be  -->
<!--                          translated into the target driver's   -->
<!--                          namespace.                            -->
<!-- attr-name              - The name of the attribute this        -->
<!--                          reference DN is for.  Extracted from  -->
<!--                          the job's XmlData on export.          -->
<!-- aux-class-name         - If supplied the auxclass attr-name is -->
<!--                          defined in.  If not supplied, the     -->
<!--                          is assumed to already be defined on   -->
<!--                          DirXML-Job.                           -->
<!-- reference-name         - The name of the reference extracted   -->
<!--                          from the job's XmlData on export.     -->
<!-- reference-display-name - If supplied, the display name of the  -->
<!--                          reference extracted from the job's    -->
<!--                          XmlData on export.  If not supplied,  -->
<!--                          the reference-name will be used.      -->
<!-- target-class-filter    - If supplied, contains the             -->
<!--                          target-class information extracted    -->
<!--                          from the job's XmlData.  This must be -->
<!--                          a comma seperated list of the class   -->
<!--                          names suitable for use by iManager's  -->
<!--                          object selected.  If not supplied,    -->
<!--                          "*" will be used (i.e., all classes   -->
<!--                          will be accepted.)                    -->
<!--                                                                -->
<!-- (Note:  This will only be recognized in the ds-attributes of a -->
<!-- ds-object for a DirXML-Job object.                             -->
<!ELEMENT job-reference-dn>
<!ATTLIST job-reference-dn
	job-name				CDATA #REQUIRED
	job-display-name		CDATA #IMPLIED
	dn						CDATA #REQUIRED
	attr-name				CDATA #REQUIRED
	aux-class-name			CDATA #IMPLIED
	reference-display-name	CDATA #IMPLIED
	reference-name			CDATA #REQUIRED
	target-class-filter		CDATA #IMPLIED
>


<!-- ************************************************************ -->
<!-- The attributes(channel) element contains information that is -->
<!-- stored as eDirectory attributes of a DirXML-Publisher or     -->
<!-- DirXML-Subscriber object.                                    -->
<!--                                                              -->
<!-- (Note:  The actual name of this element is attributes, the   -->
<!-- channel reference is to remove conflicts with the driver set -->
<!-- and driver attributes element.)                              -->
<!-- ************************************************************ -->
<!ELEMENT attributes(channel)(
	(driver-filter-xml | driver-filter)?,
	command-transformation-rule?,
	create-rule?,
	event-transformation-rule?,
	matching-rule?,
	placement-rule?,
	variable-ref*)>

<!ELEMENT driver-filter (#PCDATA)>									<!-- Based 64 encoded driver filter content. -->
<!ELEMENT driver-filter-xml ((arbitrary-nodes | variable-ref)*)>	<!-- XML based        driver filter content. -->

<!ELEMENT command-transformation-rule variable-ref*>
<!ATTLIST command-transformation-rule
	dn CDATA #IMPLIED
>

<!ELEMENT create-rule variable-ref*>
<!ATTLIST create-rule
	dn CDATA #IMPLIED
>

<!ELEMENT event-transformation-rule variable-ref*>
<!ATTLIST event-transformation-rule
	dn CDATA #IMPLIED
>

<!ELEMENT matching-rule variable-ref*>
<!ATTLIST matching-rule
	dn CDATA #IMPLIED
>

<!ELEMENT placement-rule variable-ref*>
<!ATTLIST placement-rule
	dn CDATA #IMPLIED
>


<!-- ************************************************************ -->
<!-- The children(channel) element contains information that is   -->
<!-- stored as contained child objects of a a DirXML-Publisher or -->
<!-- DirXML-Subscriber eDirectory object.                         -->
<!--                                                              -->
<!-- (Note:  The actual name of this element is children, the     -->
<!-- channel reference is to remove conflicts with the driver set -->
<!-- and driver children elements.)                               -->
<!-- ************************************************************ -->
<!ELEMENT children(channel)(
	rule*,
	stylesheet*,
	resource*,
	variable-ref*)>


<!-- *************************************************************** -->
<!-- The attributes(ds) element contains information that is stored  -->
<!-- as eDirectory attributes of a DirXML-DriverSetobject.           -->
<!--                                                                 -->
<!-- (Note:  The actual name of this element is attributes, the ds   -->
<!-- reference is to remove confusion with the driver, publisher and -->
<!-- subscriber attributes element.)                                 -->
<!-- *************************************************************** -->
<!ELEMENT attributes(ds)(
	driver-trace-level?,
	java-debug-port?,
	java-trace-file?,
	log-events?,
	log-limit?,
	trace-size-limit?,
	variable-ref*)>

<!ELEMENT java-debug-port variable-ref*>
<!ATTLIST java-debug-port
	value CDATA #IMPLIED
>

<!ELEMENT java-trace-file variable-ref*>
<!ATTLIST java-trace-file
	value CDATA #IMPLIED
>


<!-- ************************************************************* -->
<!-- The children(ds) element contains information that is stored  -->
<!-- as contained child objects of a a DirXML-DriverSet eDirectory -->
<!-- object.                                                       -->
<!--                                                               -->
<!-- (Note:  The actual name of this element is children, the ds   -->
<!-- reference is to remove conflicts with the driver, publisher   -->
<!-- and subscriber children elements.)                            -->
<!-- ************************************************************* -->
<!ELEMENT children(ds)(
	attributes(ds)?,
	jobs?,
	global-config-values?,
	policy-library*,
	variable-ref*)>


<!-- *************************************************************** -->
<!-- The policy-library element contains objects exported from a     -->
<!-- DirXML-Libary container.                                        -->
<!--                                                                 -->
<!-- name         - Name of the DirXML-Library object.               -->
<!-- base-dn      - DN of the exported library.  This is used during -->
<!--                an import to translate DN references into this   -->
<!--                library.                                         -->
<!-- container-dn - DN of where the library was located.  If not     -->
<!--                supplied, the DN of the driver set being         -->
<!--                imported into is used.                           -->
<!--                                                                 -->
<!-- (Note:  The container attribute will only be used if the        -->
<!-- corresponding DirXML-Library object exists outside of an IDM    -->
<!-- configuration object.  policy-library elements of this form may -->
<!-- be found within the children element of both                    -->
<!-- driver-set-configuration and driver-configuration elements.)    -->
<!-- *************************************************************** -->
<!ELEMENT policy-library(
	descriptions?,
	rule*,
	stylesheet*,
	resource*,
	variable-ref*)>
<!ATTLIST policy-library
	name         CDATA #REQUIRED
	base-dn      CDATA #REQUIRED
	container-dn CDATA #IMPLIED
>


<!-- ************************************************************** -->
<!-- The xsl-modify element contains an XSL stylesheet template     -->
<!-- that is applied to the driver configuration file AFTER all     -->
<!-- variable references have been processed and immediately before -->
<!-- the driver configuration file gets imported.                   -->
<!--                                                                -->
<!-- It is intended to provide driver writers with a way to perform -->
<!-- arbitrary modifications to a driver configuration file that    -->
<!-- that cannot be performed using other mechanisms (variables,    -->
<!-- ...)                                                           -->
<!-- ************************************************************** -->
<!ELEMENT xsl-modify     (xsl-stylesheet)>
<!ELEMENT xsl-stylesheet ((arbitrary-nodes | variable-ref)*)>
<!ATTLIST xsl-stylesheet
	...XSL stylesheet specific attributes...
>

<!ELEMENT xsl-stylesheet-nodes(
	xsl-stylesheet-nodes*)>
<!ATTLIST xsl-stylesheet-nodes
	...XSL stylesheet specific attributes...
>


<!-- *********************************************************** -->
<!-- The arbitrary-nodes element defines any XML content that is -->
<!-- not otherwise defined in the scope of this DTD.             -->
<!--                                                             -->
<!-- It is included here for completenes as well as providing a  -->
<!-- connection to arbitrary variable references throughout the  -->
<!-- driver configuration file.                                  -->
<!-- *********************************************************** -->
<!ELEMENT arbitrary-nodes(
	(arbitrary-nodes | variable-ref)*)>
<!ATTLIST arbitrary-nodes
	rope-in       CDATA #IMPLIED
	rope-in-mode  (%RopeInMode) "equals"
	rope-in-value CDATA #IMPLIED "true"
	...other arbitrary node specific attributes...
>


<!-- *************************************************************** -->
<!-- The configuration-nodes element defines any XML content that is -->
<!-- defined in the scope of this DTD.                               -->
<!--                                                                 -->
<!-- It is included here as a short cut for documenting that any     -->
<!-- node within the configuration file can be subject to rope-in    -->
<!-- processing.                                                     -->
<!-- *************************************************************** -->
<!ELEMENT configuration-nodes(
	(configuration-nodes | arbitrary-nodes | variable-ref)*)>
<!ATTLIST configuration-nodes
	rope-in       CDATA #IMPLIED
	rope-in-mode  (%RopeInMode) "equals"
	rope-in-value CDATA #IMPLIED "true"
	...other configuration node specific attributes...
>


						 <!-- *********** -->
						 <!-- End of File -->
						 <!-- *********** -->