Action Descriptor
An action descriptor describes an executable function of the application. It can consist of a sequence of tools. AWM also supports an advanced tool processing logic using statements like If, Else, or Loop.
Actions can be executed at the following locations:
- In the context menus of the application entry and of elements, filters, file descriptors, and jobs. The context menus are modeled for each type using the relationship Has_Action.
- In the context menu of an Eclipse text editor modeled as a global action.
- In the IDEs main menu bar and in the context menu of a global action entry visible under the application's entry in the Application Explorer view if the action is defined as a global action.
- Determining/updating the property values of an element (the Get_All_Properties attribute of the element type).
- Creating/updating an element list or expanding a container element within a tree view.
- Saving/closing the editor during an editing procedure.
- Determining the permitted values for a property.
- Actions associated to Application Options can be executed automatically when the application is loaded or unloaded.
- Validate the values entered in an AWM modeled dialog.
| Attribute | Type | Description |
|---|---|---|
| ID * | ID * | The ID of the action descriptor. |
| Label [O] | String | The labeling of the action descriptor. The label of an action descriptor is mainly seen in the context menu. References to a property within the label are resolved to the current property value. |
| Execution Mode | Selection | Valid values are MODAL or MODELESS. The action is executed in the background if you are using the MODELESS option which means that the UI is not blocked until the action has finished. |
| Key Binding Context [O] | Selection | The binding context in which a set key binding sequence is active, see
Key Binding for more information.
The key binding context is ignored if no key binding sequence has been set. The default value is AWM Team Developer Element Views. |
| Key Binding Sequence [O] | Key Sequence | The keystroke combination to execute the action. See Key Binding for more information. |
| Mass Processing | Boolean | To be set if enabling mass processing for multi selections.
If set to true, the action executes only once, even if several elements are selected. Tools of the action must support mass processing to process the whole selection. See Mass Processing Overview for more information. The default value is false. |
| Related_Save_Action [O] | ActionDescriptor | To be set if dealing with an Edit action. The selected Save action executes when saving the editor. |
| Related_Close_Action [O] | ActionDescriptor | To be set if dealing with an Edit or Browse action. The selected Close action executes when closing the editor. |
| Show Progress Monitor | Boolean | Specifies whether to show a progress monitor dialog while the action is executing.
The default value is true. |
| Refresh_List | Boolean | If the action is executed on elements in the
Table Results view and this attribute is set to
true, the current element list is refreshed at the end of the action by executing the action that was used to create the list.
This attribute does not support refreshing element lists in the
Application Explorer view.
The default value is false. |
| Custom Error Message [O] | String | This attribute enables you to specify an alternative error message to the default error message displayed in the AWM
Error dialog box.
Note: Specifying a custom error message does not alter the text displayed when you click
Details.
|
| Relationship | Cardinality | Description |
|---|---|---|
| Has_Tool | 0..* | Relationship to a tool descriptor. |
| Has_If/Else | 0..* | Relationship to an if, else, or else if statement. |
| Has_Loop | 0..* | Relationship to a loop statement. |
| Has_Exit | 0..* | Relationship to an exit statement. |
| Has_Continue/Break Loop | 0..* | Relationship to a continue or break statement. |
| Has_CreateElementList | 0..* | Relationship to a step to create an element list (multiple relationships to a create element list step are only enabled under a conditional tool sequence). |
| Has_Icon | 0..* | Relationship to an icon associated with the action. |
Examples
Action Descriptor SCLM_ACT_DeleteLockEntry
| Attribute | Value | Description |
|---|---|---|
| Essential: | ||
| ID | SCLM_ACT_DeleteLockEntry | Unique identifier of the action in this model. |
| Key Binding | Not relevant as no short key is defined for the action. | |
| Optional: | ||
| Custom Error Message | No custom error message defined for this action. | |
| Execution Mode | Modal | Actions containing tools of type "Execute ISPF Command" should always be executed in modal mode. |
| Label | Delete Lock-Entry... | Label shown in the context menu for the action. |
| Mass Processing | false | The tools of this action are designed only to delete a single element per call. |
| Refresh List | false | The element list should not be refreshed after the execution of this action. |
| Show Progress Monitor | true | Show a progress monitor while executing the action. |
| Save/Close | Not relevant as the action is not an edit action. | |
Action Descriptor SCLM_ACT_DeleteMember
| Attribute | Value | Description |
|---|---|---|
| Essential: | ||
| ID | SCLM_ACT_DeleteMember | Unique identifier of the action in this model. |
| Key Binding | Not relevant as no short key is defined for the action. | |
| Optional: | ||
| Custom Error Message | No custom error message defined for this action. | |
| Execution Mode | Modal | Actions containing tools of type "Execute ISPF Command" must always be executed in modal mode. |
| Label | Delete member... | Label shown in the context menu for the action. |
| Mass Processing | true | The tools of this action are designed to support processing more than one element. The modelled MassProcessing input parameters
for all selected elements are passed to the tools of the action all at once.
If the tool is of type "Execute ISPF Command" the parameters are passed via the ISPF table TAUTOTIP. |
| Refresh List | false | The element list must not be refreshed after the execution of this action. |
| Show Progress Monitor | true | Show a progress monitor while executing the action. |
| Save/Close | Not relevant as the action is not an edit action. | |
Action Descriptor SCLM_ACT_FilterMemlist
| Attribute | Value | Description |
|---|---|---|
| Essential: | ||
| ID | SCLM_ACT_FilterMemlist | Unique identifier of the action in this model. |
| Key Binding | Not relevant as no short key is defined for the action. | |
| Optional: | ||
| Custom Error Message | No custom error message defined for this action. | |
| Execution Mode | Modal | Actions containing tools of type "Execute ISPF Command" must be executed in modal mode. |
| Label | Filter SCLM Members | Label shown in the context menu for the action. |
| Mass Processing | false | The tools of this action are not designed to support processing more than one element per call. Typically, an action generating an element list does not support mass processing. |
| Refresh List | false | The action itself produces an element list. |
| Show Progress Monitor | true | Show a progress monitor while executing the action. |
| Save/Close | Not relevant as the action is not an edit action. | |