Variable References

Some string attributes in the AWM model support the use of variable references. Referenced variables can be defined dynamically as part of a string and can reference AWM properties, environment properties and certain static variables. See the table below for more information. If AWM properties are referenced, values are resolved at runtime and preferably taken from the “previous tool” execution context pool, if available.

Variable references are only resolved by the following attributes:

Application Option "EXITPARM". See Application Options for more information.
Attributes "Static Value" and "Default Value" of the relationship "Tool has Input Parameter". See Relationship: Tool Has Input Parameter for more information.
Attribute "New Static Value" of the relationship "Parameter Override". See Parameter Override for more information.
Attribute "Name Physical" in "File Descriptor". See File Descriptor for more information.
Attribute "Value" in "Simple Enabled Condition". See Enabled/Visible Condition for more information.
Attribute "Value" of the relationship "Application Option Have Specific Attribute" for the attributes SYSLIB, COMPOPT, AUTO_PARSE, and INITIAL_PARSE. See Relationship: Application Options Have Specific Attributes for more information.
Attribute "Label" of an Action Descriptor. See Action Descriptor for more information.
Attribute "Parmfile" used in the Master Configuration file. See Master Configuration for more information.
Attribute "Table View Id" in Action Descriptor and Element List Structure. See Action Descriptor and Element List Structure for more information.
Attribute "Table View Label" in Action Descriptor and Element List Structure.
Attribute "Default Value" in Property. See Property for more information.
Attributes "Title", "Description" and "Help Text" of modeled dialogs. See Open Modeled Dialog in the AWM function package for more information.
Open Modeled Dialogs Attributes "UI Category", "UI Form", "UI Help Text", "Label", "UI Tab", "UI Tool Tip" in modeled input dialogs. See Input Dialog in the AWM function package and Tool Has Input Parameter for more information.

References can be defined by using the Start Reference and End Reference symbols (default "&" and ".") which are defined in the application options. See Application Options for more information. It is possible to define a value containing several references as well as static characters. The following table shows the syntax of all variables that are available:

Variable/Syntax	Description	Example
%<env-var>	Reference to an environment variable on the client’s local operating system	&%PUBLIC. = C:\Users\Public
<property ID>	Reference to a property in the execution context	&PROP_WorkspaceFilename. = /MyProject/MyFile.txt
userid	Client’s user ID on the z/OS system. This variable can only be resolved if a connection to the mainframe has been established.	&userid. = USER123
wspath	Path of the active Eclipse Workspace on the client’s local machine	&wspath. = C:\workspaces\workspace1

Examples

The following examples show the definition of a dynamic file path:

Attribute value of "Name_Physical" (File Descriptor):

Reference	Resolved Value
&%PUBLIC.\MyCache\&PROP_FileName.	C:\Users\Public\MyCache\MyFile.txt
&userid..SOURCE(&PROP_Membername.)	USER123.SOURCE(MEMXYZ)