Example Scenarios for the Usage of AWM Tool Types

Example: Browse local file

This is an example from the standard Enterprise Developer Project model which is an integral part of the Enterprise Developer installation.

The action OFFL_ACT_CONT_Browse_LocalOSFile is used to browse a dependent source element in this model, for example, a COBOL copybook.

The action consists of two tools from the AWM function package:

  • Create Temporary File
  • Edit Local File

Local browse action

The action is related to a close action, specified as:


Browse action properties

The AWM tool 'Create Temporary File' creates a temporary workspace file depending on the selected element with the fix suffix 'cpy' and the read-only flag set to true:


Create temporary file tool

The input file descriptor points to a local OS file. The file descriptor has the following properties:


Properties for a file descriptor that points to a local OS file

The output file points to a workspace file with the following properties:



The output parameter of the 'Create Temporary File' tool is used by the 'Edit Local File' tool as an input parameter:


Create temporary file tool

In the related close action the AWM tool 'Cleanup Edit Session' is called. This gets the newly created workspace file as an input parameter to remove it when the editor is closed:


Browse clean up action

Edit clean up tool

Example: Merge structured files

This example is based on the standard Enterprise Developer Project model.

The AWM tool 'Merge Structured Files' is used in this model to merge the dependent elements of a local project. The children of a local project are a mix of folder, files or categories. In this case, IMTK categories.

The action OFFL_ACT_ELIST_GetEclipseChildren is defined as a 'Get Children' action of the element type Eclipse project:


Get children action of the element type Eclipse project

The action OFFL_ACT_ELIST_GetEclipseChildren consists of three tools:

  • A tool to get the IMTK categories belonging to the selected project.
  • A tool to get the children folder and files of the selected project.
  • A tool to merge the result files of the two preceding tools.

Get Eclipse children action

Get IMTK categories tool

Get resource children tool

Merge structured files tool

The output file descriptors of the first two tools are modeled as follows:


Output file descriptor

File descriptor resource children

The file descriptor returned by the tool 'Merge Structured Files' has the following structure:


File descriptor resource category merge

This file descriptor is used to display the children of a local project in the Application Explorer view.