Relationship: Tool Has Input Parameter

The Tool has Input Parameter relationship describes exactly one input parameter of a tool. The reference of the relationship is a property whose property value can be passed as parameter to the tool at run time.

The Parameter From attribute determines where the value of the parameters should be obtained from. There are three ways of determining the origin of parameters:

Parameter From = Context: The context includes all property values that are available at the start of the execution of an action, and does not change during the tool sequence. For example, if you execute an action on an element, all the property values of the element, the element list in which it is located and the resources where it is found (such as filter, element) are available. The Properties view at run time is a good way of obtaining an overview of the available property values of a selected resource.
Parameter From = Previous_Tool: This setting is intended for the transfer of parameters between tools that are temporarily managed in a parameter memory. No property values from this memory are available to the first tool in a tool sequence. As soon as a tool creates an output, the output properties and their values are available for subsequent tools. In the parameter memory, only one property value is saved for a property. See Relationship: Tool Has Output Parameter for more information.
A tool that outputs a property value for a property that already exists in the memory replaces this value, see the figure below.
Parameter From = User_Input: User_Input means that the parameter should be entered by the user during the execution of the tool. This is used in tools with a user interface, such as the Input dialog box. In this case, the parameter value is transferred to the tool.

The Parameter Memory is the temporary storage area for output tool parameters. The values 123, ABC and XYZ are the concrete outputs of the respective tools and are saved as property values. The illustration shows how the property PROP_2 has been referenced for two tools as an output parameter. The second output (XYZ) overwrites the first (ABC).

Attributes of tool input parameters:

Attribute	Type	Description
TargetIDFile[D]	File Descriptor	Reference to a file descriptor. Only visible if the type attribute has been set to File.
TargetIDParm[D]	Property	Reference to a property. Only visible if the type attribute has been set to String.
Label [O]	String	Label of the parameter in dialog boxes.
Parameter From [M]	Selection	Determines from where the property value of the parameter property should be obtained. Valid values include: Context (default) Previous_Tool User_Input
Mass Processing	Boolean	If set to false, the input is expected from a single context. If set to true, the input is expected from a mass context.
StaticValue [O]	String (multi line)	Sets a fixed value for the parameter. This can only be overwritten via parameter override. Only visible if the type attribute has been set to String. See Parameter Override for more information.
DefaultValue [O]	String (multi line)	The standard value of the parameter. This value is only used if no other property value can be found for the referenced property. Only visible if the type attribute has been set to String. Initializes a field in an Input dialog box.
Type [M]	Selection	The type of the parameter. A property or a file descriptor must be referenced on the basis of this attribute. Valid values include: File String The default value is `String`.

Tool input parameters of deprecated tools created before Visual COBOL 5.0 have the following attributes:

Attribute	Type	Description
TargetIDFile[D]	File Descriptor	Reference to a file descriptor. Only important if the type attribute has been set to File.
TargetIDParm[D]	Property	Reference to a property. Only important if the type attribute has been set to Mass Processing or String.
DefaultValue [O]	String (multi line)	The standard value of the parameter. This value is only used if no other property value can be found for the referenced property. Has no meaning for file parameters. Initializes a field in an Input dialog box.
Label [O]	String	Label of the parameter in dialog boxes.
Parameter From	Selection	Determines from where the property value of the parameter property should be obtained. Valid values include: Context (default) Previous_Tool User_Input
StaticValue [O]	String (multi line)	Sets a fixed value for the parameter. This can only be overwritten via parameter override. See Parameter Override for more information.
Type	Selection	The type of the parameter. A property or a file descriptor must be referenced on the basis of this attribute. Valid values include: MassProcessing(+ TargetIDParm) File(+ TargetIDFile) String(+ TargetIDParm) The default value is `String`.
Ui Category [O]	String	Categorizes the parameter in dialogs. Categorized parameters are enclosed in a labeled frame. Successive parameters with the same category are enclosed by the same frame and ordered by sequence number. See The "UI Category" Attribute for more information.
Ui Tab [O]	String	Allows the assignment of parameters to tabs. Tabs are individual dialog pages which are activated by clicking the tab label at the top of the dialog. Successive parameters with the same tab are displayed in the same tab page. This works only for Input dialog boxes. See The "UI Category" Attribute for more information.
Ui Editable	Boolean	Indicates whether the parameter can be edited in input dialog boxes. Fields are never editable in an output dialog box. The default value is `true`.
Ui GenericAllowed	Boolean	Indicates whether wildcard characters are permitted as user input. If false, the input dialog box cannot be confirmed if wildcard characters are present in the input field. See Application Options for more information. The default value is `false`.
Ui Mandatory	Boolean	Indicates whether the field is mandatory in Input dialog boxes. If true, the dialog box cannot be confirmed when the field contains no values. Mandatory fields are marked with an asterisk *. The default value is `true`.
Ui Form [O]	String	Specifies formatting information for the field in Input dialog boxes. Valid values include: BOLD, HIDDEN, RED, GREEN, YELLOW, BLUE, GRAY.
Ui HelpText [O]	String (multi line)	Specifies help text for the field in input dialog boxes which is displayed when the question mark button beside the field is clicked or the F1 key is clicked in the field. Clicking in the input field of the attribute opens a dialog box where the help text can be entered in a formatted way.
Ui MultiSelection	Boolean	Specifies whether multiple items can be selected. For structured file input parameters only. If set to true, a check box table is created. The default value is `false`.
Ui Resizable	Boolean	Specifies whether a dialog field can be resized or not. Properties of types Boolean, TextArea and TextArray cannot be set to be resizable. The default value is `true`.
Ui ToolTip [O]	String (multi line)	Specifies a tool tip for the field in Input dialog boxes.
Visible Condition [O]	Visible_Condition	This complex attribute is only relevant for a modeled dialog. It allows you to define rules when the input parameter should be shown in the dialog. See Enabled/Visible Condition for details of how to define an enabled or visible condition.
Enabled Condition [O]	Enabled_Condition	This complex attribute is only relevant for a modeled dialog. It allows you to define rules when the input parameter should be enabled in the dialog. See Enabled/Visible Condition for details of how to define an enabled or visible condition.