Requesting user builds
A user build is a build request that generates JCL statements to build a program with IBM® Engineering Workflow Management system definitions. The user build submits the build request outside of the IBM Engineering Workflow Management build infrastructure. The user build provides an alternative to the IBM Engineering Workflow Management personal build.
Before you begin
The COBOL, PL/I , or C/C++ program must be assigned to a language definition that is associated with at least one translator. The build steps are defined in the language definition and all the required information to generate the JCL statements is in the translator.
If you want to add error feedback support to a user build, see Adding error feedback support to user builds.
About this task
- A zComponent project in Engineering Workflow Management.
- A z/OS® project in IBM Developer for z/OS .
- Whether the condition is understandable or translatable:
- If it refers to a step return code, it will be translated into JCL.
- If it is understandable, it will be resolved during the User Build generation time.
The following table describes ant conditions that are supported.- equals
- isfalse
- isgreaterthan
- islessthan
- isset
- istrue
- If the condition is neither understandable or translatable. it is not supported. Hence any
non-supported condition will be ignored. In this case, relational logic conditions, such as
and
,or
,xor
, andnot
, are not supported.
- Language Definition Properties
Condition determines whether a property is considered in the language definition and translator of the property.
- Translators
Condition determines the final list of translators that are used for building a program assigned by the language definition.
- DD Concatenations or DD Allocations
Condition defines the final list of data set definitions that the translator uses.
Starting from IBM Developer for z Systems V14.0 and the corresponding RTC integration with CLM V6.0.5, User Build supports definition of a DD Allocation as in-stream data as part of a Engineering Workflow Management build definition. You can define contents of a Data Set Definition entry as instream DD and specify the textual entries that makes up the data content. User Build generated build, such as generated JCL, considers when a Data Set Definition entry in a translator has been defined as in-stream data, the resulting JCL translates it and generates JCL compliant in-stream Data Set Definition entry contents.
After an initial successful user build, you have the option to save time by reusing the generated JCL from a previous build. When you start a build, you are prompted to indicate if you want to use the previously generated JCL. If yes is selected, the previously generated JCL for the file is used and a progress status is displayed. After the job completes, the User Build Job ID is displayed. During the build, data sets for recording error feedback information are created, these files are deleted after the job completes.