The ADDHLPCAT command in TURNOVER® for iSeries v100 is part of the Wisedesk functionality described in Chapter 9: Working with Projects and Tasks. It’s used to add a new category or subcategory to a help tree, which is TURNOVER’s way of organizing and guiding developers through project tasks.
This command lets you add a category or subcategory to a help tree directly from the command line.
You can also refer to the online Help for more information about this command.
What Is a Help Tree?
A help tree is a hierarchical structure that organizes tasks, documentation, and guidance for developers. Think of it like a dynamic, searchable roadmap for your project especially useful when managing large IBM i modernization efforts or multi-phase development.
ADDHLPCAT command lets you:
- Create a new category or subcategory in a help tree
- Define its position in the hierarchy
- Assign a description and task selection criteria
- Control how tasks are filtered and displayed within that category
It’s the command-line equivalent of using option 1=Add on the Work with Help Tree Categories panel.
Here’s a breakdown of the key fields:
| Parameter | Description |
|---|---|
TREE | The name of the help tree you're adding to |
PATH | The hierarchical path (e.g., PROJECT/API) where the category will reside |
DESCRIPTION | A short label for the category |
TYPE | Whether it's a category (*CATEGORY) or subcategory (*SUBCAT) |
SEQUENCE | The display order within its parent category |
TASKFILTER | Optional filter criteria to auto-select relevant tasks |
VISIBLE | Whether the category is visible to users (*YES or *NO) |
Let’s say you’re building a help tree for your RPGLE modernization course. You could use ADDHLPCAT to create categories like:
-
MODERNIZATION/VSCode MODERNIZATION/APIsMODERNIZATION/MetroMirror
Each category could then have search strings and filters added via ADDCATSTR, so tasks containing keywords like “Metro Mirror” or “VS Code” are automatically grouped.