The task is used to create an Enterprise Extensions system definition for a language.

Attributes

The following table describes the task specific attributes for the task:

Task Specific Attributes

Attribute Description Required

calculateImpacts Specifies whether or not to calculate impacted files when performing dependency analysis for this language. Valid values are true and false. The default is true. No

conditions A comma-separated list of conditions that correspond to the translators attribute. If a translator does not have a condition, its entry in the comma-separated list should be set to blank. If no translators have conditions, there is no need to specify this attribute. No

consolidateLogs Specifies whether or not to consolidate log files into a single file. Valid values are true and false. The default is true. Log files are identified by the translator definition publishing options. No

defaultPatterns A comma-delimited list of file extensions to associate with this language. No

defaultScanner Specifies whether or not to use the default scanner. Valid values are true and false. The default is true. No

description A free-form textual description for the language definition. No

languageCode

The language of the files associated with this language definition. Valid values are:

Code:	Description:
`ASM`	Assembler
`BIN`	Binary
`BND`	Bind
`C`	C
`CPP`	C++
`EASY`	CA Easytrieve
`COB`	COBOL
`JCL`	Job Control Language
`LNK`	Link-edit
`PLI`	PL/I
`OTH`	Other

name A unique name for the language definition. Yes

nonImpacting Specifies that changes to this system definition do not force Enterprise Extensions dependency build request processing to use full analysis instead of change set analysis. Valid values are true and false. The default is false. No

stepNames A comma-delimited list of names that correspond to the translators attribute. No

translators A comma-delimited list of translator names assigned to this language. A build property name may also be specified. When a build property name is specified, ensure that that property is defined in any dependency build that will process this language. No

dependencyType Element

The dependencyType element is specified within the element. Each dependencyType element is used to specify a dependency type that this language definition supports. The following table describes the valid dependencyType attribute values:

dependencyType Element Attributes

Attribute Description Required

name

The name of the dependency type. Valid values are:

Type:	Description:
`COPY`	COBOL COPY statements and PL/I %INCLUDE statements
`DTLGML`	DTL GML file
`DTLINC`	DTL include
`++INCLUDE`	CA Easytrieve ++INCLUDE and -INC statements
`SQL INCLUDE`	EXEC SQL INCLUDE statements
`MACRO`	Assembler MACRO calls
`MACRO_DEF`	Assembler MACRO definition
`PROC`	JCL PROC invocations
`ZUNITINC`	Zunit include

Yes

translators A comma-separated list of translators that resolve this dependency type. If this list is omitted, all translators will be associated with this dependency type. If a zero-length string ("") is specified, no translators will be associated with this dependency type. No

scanner Element

The scanner element is specified within the element. Each scanner element defines a scanner to run against the source code associated with this language. The following table describes the valid scanner attribute values:

scanner Element Attributes

Attribute Description Required

Name

Name of the scanner to be used. Valid values are:

Name:	Description:
`com.ibm.teamz.metadata.scanner.default`	Default Scanner for System z
`com.ibm.teamz.metadata.previous.scanner.default`	Previous Default Scanner for System z
`com.ibm.teamz.scanner.dtlscanner.id`	DTL Scanner for System z
com.ibm.team.enterprise.scanner.zUnitScanner.id	ZUnit config file Scanner
`com.ibm.team.enterprise.scanner.registration.scanner`	Source Code Data Registration Scanner

Yes

scopedProperty Element

The scopedProperty element is specified within the element. The scopedProperty element is optional used to define scoped build properties for the language. Specify a unique scopedProperty element for each scoped build property defined to the language. The following table describes the valid scopedProperty element attributes:

scopedProperty Element Attributes
Attribute	Description	Required
condition	The Ant condition string, written in escaped XML, that must evaluate to true for the property to be available at runtime.	No
name	The name of the property.	Yes
value	The value of the property.	No

Notes

When the defaultScanner attribute is set to true, all specified dependencyType elements are ignored; no additional dependency types will be added to the generated language definition based on dependencyType elements.
When the defaultScanner attribute is set to false, dependency types will be added to the generated language definition based on dependencyType elements.
When a dependency build is executed and the language is processed and a build property has been specified in the translator list, that property must be defined in the build and contain the name of a valid translator.
The task supports externally defined independent extensions based on the ILanguageExtensionType interface. Each of these extensions has there own element which is specified within the element. The following is a partial list of extensions:
- Language Element

Examples

Create language definition:

<target description="Create language definition" name="langdefs">
  
  <xt:langDef
      defaultScanner="false"
      defaultPatterns="asm"
      languageCode="ASM"
      name="ASM"
      nonImpacting="true">
    <xt:scanner name="com.ibm.teamz.metadata.scanner.default"/>
    <xt:dependencyType name="COPY"/>
    <xt:dependencyType name="++INCLUDE"/>
    <xt:dependencyType name="SQL INCLUDE"/>
    <xt:dependencyType name="MACRO"/>
    <xt:dependencyType name="PROC"/>
  </xt:langDef>
  
</target>

getTaskNameHdr()

Attributes

dependencyType Element

scanner Element

scopedProperty Element

Notes

Examples