Specifying Tool Descriptors

The issue tracking system requires five tools:

  1. A tool to produce the first Application Explorer tree view level.
  2. A tool to produce the level below the tree view entry, 'Issues by Priority'.
  3. A tool to return the list of issues filtered by the priority.
  4. A tool to return the raiser of an issue.
  5. A tool to display the raiser of an issue.

Specifying the Create Issue Filter Level Tool

The tool Create Static Element List in the AWM function package enables you to return a list of fixed values within a file descriptor:

  1. Right-click Tool Descriptors, and then click New Child > AWM > Create Static Element List.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, type TUTORIAL_TOOL_AWM_CreateIssueFilterLevel.
  3. Right-click TUTORIAL_TOOL_AWM_CreateIssueFilterLevel, and then click New Child > Element.

    This adds the Element attribute to the TUTORIAL_TOOL_AWM_CreateIssueFilterLevel tool.

  4. Right-click Element, and then click Edit.

    This opens the Edit Properties dialog box.

  5. Double-click the Matchname value cell, and then type ISSUEFILTER.
  6. Click OK.
  7. Right-click Element [Matchname = ISSUEFILTER], and then click New Child > Property.
  8. Right-click Property, and then click Edit.

    This opens the Edit Properties dialog box.

  9. Double-click the Property Value value cell, and then type All Issues.
  10. Click OK.
  11. Repeat steps 3 through 10 to create another element and child property, this time in the Property Value value cell, type Issues by Priority.

    Your tool should look like:


    Tool: Create Issue Filter Level

Specifying the Create Static Priority Level Tool

You need to create another tool of the same type, Create Static Element List:

  1. Right-click Tool Descriptors, and then click New Child > AWM > Create Static Element List.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, type TUTORIAL_TOOL_AWM_CreateStaticPriorityLevel.
  3. Click OK.
  4. Right-click TUTORIAL_TOOL_AWM_CreateStaticPriorityLevel, and then click New Child > Element.

    This adds the Element attribute to the TUTORIAL_TOOL_AWM_CreateStaticPriorityLevel tool.

  5. Right-click Element, and then click Edit.

    This opens the Edit Properties dialog box.

  6. Double-click the Matchname value cell, and then type ISSUEPRIORITY.
  7. Click OK.
  8. Right-click Element [Matchname = ISSUEPRIORITY], and then click New Child > Property.
  9. Right-click Property, and then click Edit.

    This opens the Edit Properties dialog box.

  10. Double-click the Property Value value cell, and then type 0.
  11. Click OK
  12. Repeat steps 4 through 11 three more times replacing the Property Value with 1, 2, and 3 in each iteration.

    Your tool should look like:


    Tool: Create Styatic Priority Level

Specifying the List Issue Tool

The remaining two tools are linked to the COBOL programs GetIssues.cbl, and GetIssueRaiser.cbl, which should now have corresponding executable files (.exe). You can use an existing tool from the OS - Operating System function package to enable calls to an .exe in your local file system:

  1. Right-click Tool Descriptors, and then click New Child > OS - Operating System > Execute OS Command.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, type TUTORIAL_TOOL_CMD_ListIssues.
  3. Click OK.

    Your tool requires two input parameters:

    • Command string.
    • Issue priority filter.
  4. To add the first input parameter to this tool, right-click TUTORIAL_TOOL_CMD_ListIssues, and then click New Child > Input Parameter.

    This adds a string input parameter to the Execute OS Command tool.

  5. Right-click String Input Parameter, and then click Edit.

    This opens the Edit Properties dialog box.

  6. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_OSCommandString (String).
  7. Double-click the Static Value value cell, and then type the absolute path to the GetIssues.exe file in your project.
  8. Click OK.
  9. To add the second input parameter to this tool, right-click TUTORIAL_TOOL_CMD_ListIssues, and then click New Child > Input Parameter.

    This adds a string input parameter to the Execute OS Command tool.

  10. Right-click String Input Parameter, and then click Edit.

    This opens the Edit Properties dialog box.

  11. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_ELE_Priority (SelectValue).
  12. Click OK.

    Your tool should look like:


    Tool: List Issues

Specifying the Get Raiser Tool

This tool will get the raiser of an issue:

  1. Right-click Tool Descriptors, and then click New Child > OS - Operating System > Execute OS Command.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, type TUTORIAL_TOOL_CMD_GetRaiser.
  3. Click OK.

    Your tool requires two input parameters:

  4. To add the first input parameter to this tool, right-click TUTORIAL_TOOL_CMD_GetRaiser, and then click New Child > Input Parameter.

    This adds a string input parameter to the Execute OS Command tool.

  5. Right-click String Input Parameter, and then click Edit.

    This opens the Edit Properties dialog box.

  6. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_OSCommandString (String).
  7. Double-click the Static Value value cell, and then type the absolute path to the GetIssueRaiser.exe file in your project.
  8. Click OK.
  9. To add the second input parameter to this tool, right-click TUTORIAL_TOOL_CMD_GetRaiser, and then click New Child > Input Parameter.

    This adds a string input parameter to the Execute OS Command tool.

  10. Right-click String Input Parameter, and then click Edit.

    This opens the Edit Properties dialog box.

  11. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_ELE_TicketNumber (Numeric).
  12. Click OK.
  13. To add an output parameter to this tool, right-click TUTORIAL_TOOL_CMD_GetRaiser, and then click New Child > Output Parameter

    This adds a string output parameter to the Execute OS Command tool.

  14. Right-click String Output Parameter, and then click Edit.

    This opens the Edit Properties dialog box.

  15. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_ELE_Raiser (String).
  16. Double-click the To Output Dialog value cell, and click true.
  17. Click OK.

    Your tool should look like:


    Tool: Get Raiser

Specifying the Show Raiser Tool

The last tool you create will display the raiser of an issue. You can use the Open Modeled Dialog from the AWM function package:

  1. Right-click Tool Descriptors, and then click New Child > AWM > Open Modeled Dialog.

    This opens the Enter Object ID dialog box.

  2. In the New ID field, type TUTORIAL_TOOL_AWM_DIA_ShowRaiser.
  3. Click OK.
  4. Right-click TUTORIAL_TOOL_AWM_DIA_ShowRaiser, and then click Edit.

    This opens the Edit Properties dialog box.

  5. Double-click the Dialog Type value cell, and then click Output Dialog.
  6. Double-click the Title value cell, and then type Issue Tracking System.
  7. Double-click the Description value cell, and then type Raiser of ticket &TUTORIAL_PROP_ELE_TicketNumber.
  8. Click OK.

    Your tool should look like:


    Tool: DIA Show Raiser
Parent topic: Creating the Model
Previous topic: Specifying the ID Definitions
Next topic: Specifying File Descriptors