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, next to Create Static Element List field, type TUTORIAL_TOOL_AWM_CreateIssueFilterLevel, then click OK.
  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, next to Create Static Element List 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, next to Execute OS Command field, type TUTORIAL_TOOL_CMD_ListIssues.
  3. Click OK.

    One input parameter is generated with the tool.

  4. Right-click this String Input Parameter, and then click Edit.

    This opens the Edit Properties dialog box.

  5. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_OSCommandString (String).
  6. Double-click the Static Value value cell, and then type the absolute path to the GetIssues.exe file in your project.
  7. Click OK.
  8. To add an additional 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.

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

    This opens the Edit Properties dialog box.

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

    Your tool should look like or be similar to:


    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, next to Execute OS Command field, type TUTORIAL_TOOL_CMD_GetRaiser.
  3. Click OK.

    One input parameter is generated with the tool.

  4. Right-click this String Input Parameter, and then click Edit.

    This opens the Edit Properties dialog box.

  5. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_OSCommandString (String).
  6. Double-click the Static Value value cell, and then type the absolute path to the GetIssueRaiser.exe file in your project.
  7. Click OK.
  8. To add an additional 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.

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

    This opens the Edit Properties dialog box.

  10. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_ELE_TicketNumber (Numeric).
  11. Click OK.
  12. 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.

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

    This opens the Edit Properties dialog box.

  14. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_ELE_Raiser (String).
  15. Click OK.

    Your tool should look like or similar to:


    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, next to Open Modeled Dialog 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 Title value cell, and then type Issue Tracking System.
  6. Double-click the Description value cell, and then type Raiser of ticket &TUTORIAL_PROP_ELE_TicketNumber.
  7. Click OK.
  8. Right-click TUTORIAL_TOOL_AWM_DIA_ShowRaiser, and then click New Child > Dialog Field.
  9. Right-click the String Input Parameter, and then click Edit.

    This opens the Edit Properties dialog box.

  10. Double-click the Target ID Parm value cell, and then click TUTORIAL_PROP_ELE_Raiser (String).
  11. Double-click the Parameter From value cell, and select Previous_Tool.
  12. Click OK.
    Your tool should look like:


    Tool: DIA Show Raiser
  13. Click File > Save.