The BLDHLPCAT command in TURNOVER® for iSeries v100 is used to build or rebuild a help tree category a key part of the Wisedesk framework described in Chapter 9: Working with Projects and Tasks. This command automates the process of populating a help tree category with relevant tasks based on predefined search strings and filters.
Use this command to rebuild a help tree category if you've modified it. It's equivalent to selecting a help tree, category, or subcategory with option 14=Build. (The content of the tree and path fields depends on your selection.)
What BLDHLPCAT Does
It scans your project or task database and:
- Matches tasks to a help tree category using search strings (added via
ADDCATSTR) - Populates the category with those tasks
- Ensures the help tree stays up-to-date and relevant as new tasks are added or modified
This is particularly helpful when you update your search criteria and need the help tree to automatically reflect those changes, saving you from manually reassigning tasks.
Here’s a breakdown of the key fields:
| Parameter | Description |
|---|---|
TREE | The name of the help tree |
PATH | The category or subcategory path to rebuild |
PROJECT | Optional project ID to limit the scope |
RESOURCE | Optional resource ID (e.g., developer or team) |
REQUESTER | Optional requester ID |
SCOPE | Defines the scope of rebuild (*ALL, *PROJECT, *RESOURCE, etc.) |
REBUILDTYPE | Whether to rebuild all entries or only new ones (*FULL or *INCREMENTAL) |
How It Fits in Your Workflow
Let’s say you’ve added new search strings to your MODERNIZATION/APIs category to catch tasks mentioning “REST” or “JSON.” You’d run:
This refreshes the category so it includes all matching tasks—no manual sorting required.