Some attributes in the AWM model support the use of variable references. In most cases, references are not specified manually, as the Model Editor can automatically generate the references from a selection list. Manual referencing of properties and system variables is only possible for special attributes:
- Application Option "EXITPARM" (see
Application Options).
- Attributes "Static Value" and "Default Value" of the relationship "Tool has Input Parameter" (see
Relationship: Tool Has Input Parameter).
- Attribute "New Static Value" of the relationship "Parameter Override" (see
Parameter Override).
- Attribute "Name Physical" in "File Descriptor" (see
File Descriptor).
- Attribute "Value" in "Simple Enabled Condition" (see
Enabled Condition).
- 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).
- Attribute "Parmfile" used in the Master Configuration file (see
Master Configuration).
- Attribute "Table View Id" in Action Descriptor and Element List Structure (see
Action Descriptor and
Element List Structure).
- Attribute "Table View Label" in Action Descriptor and Element List Structure.
- Attribute "Default Value" in Property if the property is used in an modeled input dialog (see
Property).
- 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).
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). 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
|
Meaning
|
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_Membername. =
MEMXYZ
|
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
|
The following example shows the definition of a dynamic file path:
Attribute value of "Name_Physical" (File Descriptor):
&userid..SOURCE(&PROP_Membername.)
Resolved value:
USER123.SOURCE(MEMXYZ)