Variables

Variables are used in command set definitions. Values for these variables are defined for the project on the Overview Page, for the individual builder in the builder's properties, or associated with a command set when it is used inside a particular builder definition.

Command sets can have substitution variables defined in them. You provide values for these variables by defining the values for the project on the Overview Page, in the builder's properties when defining a builder, or when using the command set inside of a builder. You supply values for variables in a variables table at any of these levels. The variables table for a command set is shown when you select a command set reference while editing a builder. In the variables table, you can set a variable to a specific value or to the name of an input list.

If you set a variable to an input list then that list of resources can be used inside a command. The list is formatted according to the format used for the list in the variable table. Currently the only format that is supported is a qualified name format which formats the list of objects as fully qualified object names. This allows object lists to be used inside commands that such as CRTSRVPGM.

Predefined Variables

There are four special substitution variables that you can use when defining a command in the processing section of a command set: &F, &N, &L, and &X. If these variables are used then you must specify one input as a source input in order to provide values for these variables. These substitution variables have the same meanings as they do when defining a Compile Command in Remote System Explorer.
&N
This is replaced by the name of the source member if iterating over a list of members or by the name of the object if iterating over a list of objects.
&F
This is replaced by the name of the source file if you are iterating over a list of members. If the resource list is a list of objects then this is the empty string.
&L
This is replaced by the name of the library containing the member or object.
&X
This is replaced by the text description of the member or object. If there is no text description then this is the empty string.

There is one more special variable in addition to these. The variable &SP defines the library search path for the build. You can use this variable when defining output objects for a builder. It is set to the subset of the library list that should be searched for dependencies and output objects. Other libraries in the library list are not searched if you use this when defining output objects.

Please refer to Jazz™.net for more information.


Feedback