The task is used to define how an object is to be built on IBM i. It is included in the macrodefs.xml macro for an Enterprise Extensions (EE) language definition when appropriate by the Dependency Build process.

Attributes

The task supports Build Extensions Debugging Attributes and Build Extensions General Attributes, as well as, its own task specific attributes. Click on a link for more information on the common attributes.

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

Task Specific Attributes
Attribute Description Required
checkObject Specifies whether or not to check the state of the object on IBM i. For example, the object would need to be checked if different commands need to run depending on whether the object already exists. Valid values are true or false. The default is false. No
id Specifies the ID for the task. This is typically the translator name and suffix. Yes
includeteamlibs Specifies whether or not to include team libraries. Valid values are true or false. The default is false. This attribute will be set to true for personal builds when the "Append load and object libraries from the build definition" has been set in the build definition. No
needsintrospection Specifies whether or not to fetch the bindings of an ILE *PGM or *SRVPGM after building it. Valid values are true or false. The default is false. No
searchpath Specifies the search path that the build uses to create the library list, If none is specified, the iProject source and object libraries are used. No

Process Element

The process element is specified within the element. It is a container for command elements. Each process element describes an action to take based on the specified state.

The following table describes the valid process element attributes and their options:

Process Element Attributes
Attribute Description Required
state

Specifies the state for which the embedded command is executed. Valid values are:

State: Description:
*ABSENT Execute this command if the target object does not already exist. E.g. CRTSRVPGM.
*OUTOFDATE Execute this command if the target object exists, but needs to be rebuilt. E.g. UPDSRVPGM.
Yes
inherits Specifies whether or not to inherit the build commands from a parent in the IBM i build specification. Deprecated. Valid values are true or false. The default is false. No

Notes

Examples

example: 

<antp:tasks>
  <antp:translate
      checkObject="false"
      id="arod_RPGLE(Translator)"
      needsintrospection="false"
      searchpath="">
    <process state="*OUTOFDATE">
      <command commandString="CRTRPGMOD MODULE(*CURLIB/&O) SRCFILE(&L/&F) SRCMBR(&N) OPTION(*EVENTF)" description="" label="CRTRPGMOD"/>
    </process>
    <process inherits="false" state="*ABSENT">
      <command commandString="CRTRPGMOD MODULE(*CURLIB/&O) SRCFILE(&L/&F) SRCMBR(&N) OPTION(*EVENTF)" description="" label="CRTRPGMOD"/>
    </process>
  </antp:translate>
</antp:tasks>