The task is used to delete obsolete or unneeded data set definitions. The default behavior of this task is to delete all data set definitions unless at least one DsDefNameRule is specified as a nested element.
The following table describes the task specific attributes for the task:
| Task Specific Attributes | ||
| Attribute | Description | Required |
| preview |
If this attribute is set to true, the resources that match the criteria are displayed, but not deleted. When this attribute is set to false the resources that match the criteria are deleted. Valid values are true and false. The default is false.
|
No |
The DsDefNameRule element is specified within the element. The DsDefNameRule element is an optional element used to limit the scope of the system definitions to be deleted. Multiple DsDefNameRule elements may be specified. The following table describes the valid DsDefNameRule element attributes:
| DsDefNameRule Element Attributes | ||
| Attribute | Description | Required |
| match | Specifies a regular expression which is compared to the resource name, and if the pattern matches, the resource is deleted. | Yes |
The generic nameRule element is equivalent to the DsDefNameRule element and may be used in its place.
<target name="delete" description="Delete definitions">
<xt:deleteDsDefs>
<xt:dsDefNameRule match="^delete\.definition$"/>
</xt:deleteDsDefs>
</target>