FLMLRBLD macro

The FLMLRBLD macro causes members with a particular language to be rebuilt whenever they are promoted into particular groups. Rebuilding is often necessary when processing changes due to FLMTOPTS or FLMTCOND. The FLMLRBLD macro is only valid within a language definition; it must follow an FLMLANGL.

During the promotion of a member whose language requests a rebuild with the FLMLRBLD macro for that particular group, the build map is not copied during the promote. After the promote completes, the build function is invoked using the 'to group'. The build is conditional and is invoked against the same member that was promoted. Because the build maps will be missing for members having that language, those members, and any dependent members, will be rebuilt. All other members will have the build maps copied, and will not be rebuilt during the conditional build.

If the Promote Copy succeeds, then the build will take place.

Note:

There can be multiple FLMLRBLD macros for each language.
FLMLRBLD is supported against buildable types. The exception to this rule is Linkage Editor translators such as FLM@L370. Due to special processing that occurs within a Linkage Edit Control translator, FLMLRBLD is not supported, and is ignored.

Macro format


>>-FLMLRBLD--+------------------+------------------------------><
             '-GROUP=group_list-'

Parameters

GROUP=group_list

This parameter specifies the groups at which promoted members will be rebuilt. After a member with the language given on the previous FLMLANGL macro is promoted to one of the listed groups, the member is conditionally rebuilt.

The group list must be enclosed in parentheses or single quotes, with a comma and no spaces between the group names. The list of groups is not checked for validity when the project definition is assembled or during build. This allows alternate project definitions to function without requiring that all groups be defined in the alternate project definition.

If the GROUP= parameter is omitted, no groups are rebuilt on promotion.

Example 3

This example shows a part of a language definition of a language that changes translator options at group TEST. The FLMLRBLD macro specifies that members with language COMPLANG will automatically be rebuilt after a promotion.

     FLMLANGL LANG=COMPLANG,VERSION=1.0,ALCSYSLB=Y
     FLMLRBLD  GROUP=(PROD)
     FLMTRNSL CALLNAM='Compile',                               X
     FUNCTN=BUILD,                                             X
     COMPILE=EXAMPLE,                                          X
     OPTIONS='ANSI'

     FLMTOPTS OPTIONS='ANSI,NODEBUG,OPTIMIZE',                 X
     GROUP=(PROD),ACTION=REPLACE