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:
`COBOL`	COBOL
`RPG ILE`	Report Program Generator - Integrated Language Environment®
`RPG OPM`	Report Program Generator - Original Program Model
`CL ILE`	CL - Integrated Language Environment®
`CL OPM`	CL - Original Program Model
`DSPF`	Display file
`PF`	Physical file
`LF`	Logical file
`PRTF`	Printer device file
`PGM`	Program
`SRVPGM`	Service program
`Other`	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:
`++INCLUDE`	CA Easytrieve ++INCLUDE and -INC statements
`COPY`	COBOL COPY statements and PL/I %INCLUDE statements
`DSPF External file`	DSPF External file
`ILE CL External file`	ILE CL External file
`LF External file`	LF External file
`OPM CL External file`	OPM CL External file
`PF External file`	PF External file
`PGM External file`	PGM External file
`PRTF External file`	PRTF External file
`RPG COPY`	RPG /COPY or /INCLUDE statements
`RPG External Data`	RPG External Data
`RPG External File`	RPG External File
`RPG SQL INLCUDE`	EXEC SQL INCLUDE statements
`RPGLE COPY`	RPG /COPY or /INCLUDE statements
`RPGLE SQL INLCUDE`	EXEC SQL INCLUDE statements
`SQL INCLUDE`	EXEC SQL INCLUDE statements
`SRVPGM Export file`	SRVPGM Export file
`SRVPGM External file`	SRVPGM External file

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`	IBM i Default Scanner
`com.ibm.teamp.ibmi.metadata.scanner.ILECL`	IBM i CL ILE Scanner
`com.ibm.teamp.ibmi.metadata.scanner.OPMCL`	IBM i CL OPM Scanner
`com.ibm.teamp.ibmi.metadata.scanner.PGM`	IBM i PGM Scanner
`com.ibm.teamp.ibmi.metadata.scanner.RPGLE`	IBM i RPG ILE Scanner
`com.ibm.teamp.ibmi.metadata.scanner.RPG`	IBM i RPG OPM Scanner
`com.ibm.teamp.ibmi.metadata.scanner.RPGLE_OldILE`	IBM i RPG OPM Scanner (without free-format declaration)
`com.ibm.teamp.ibmi.metadata.scanner.SRVPGM`	IBM i SRVPGM 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.

Examples

Create language definition:

<target description="Create language definition" name="langdefs">
  
  <xt:langDef
      defaultScanner="false"
      languageCode="RPGLE"
      name="ORT_Build_RPG_Modules"
      translators="ORT_RPGLE">
    <xt:scanner name="com.ibm.teamp.ibmi.metadata.scanner.RPGLE"/>
    <xt:dependencytype name="RPGLE COPY" translators="ORT_RPGLE"/>
    <xt:dependencytype name="RPG External File" translators="ORT_RPGLE"/>
    <xt:dependencytype name="RPG External Data" translators="ORT_RPGLE"/>
    <xt:dependencytype name="RPGLE SQL INCLUDE" translators="ORT_RPGLE"/>
    <xt:dependencytype name="RPG COPY" translators="ORT_RPGLE"/>
    <xt:dependencytype name="RPG SQL INCLUDE" translators="ORT_RPGLE"/>
  </xt:langDef>
  
</target>

getTaskNameHdr()

Attributes

dependencyType Element

scanner Element

scopedProperty Element

Notes

Examples