The ADDPWLITM command in TURNOVER® for iSeries v100 is used to add an item to a Programmer Worklist (PWL)—a central feature in TURNOVER’s Programmer WorkList Manager (PWM). This command is a powerhouse for developers managing change requests, object promotions, or task assignments in IBM i environments.
Include an item, such as an object or source member name, in a programmer's worklist during the early stages of a project task.
When you specify the *ACTIVE value for the List parameter, the item is added to the active worklist. If there isn’t an active worklist, it’s added to the most recently active worklist instead.
ADDPWLITM lets you programmatically insert a new object or task into an existing worklist. This is the command-line equivalent of manually adding an item via the STRPWM interface. It’s especially useful when automating workflows or integrating TURNOVER with external tools like PDM, Pathfinder, or Abstract/Probe+.
Here’s a breakdown of the typical fields you’ll use:
| Parameter | Description |
|---|---|
PWLNAME | Name of the Programmer Worklist you're adding to |
OBJNAME | Name of the object being added |
OBJTYPE | Type of object (e.g., *PGM, *FILE, *MODULE) |
LIBRARY | Library where the object resides |
ACTION | What you plan to do with the object (e.g., *CHANGE, *CREATE, *DELETE) |
DESCRIPTION | Optional description of the item |
TASKID | Optional task identifier to link the item to a specific project or request |
SEQUENCE | Optional sequence number for ordering items in the worklist |
How It Fits in Your Workflow
Let’s say you’re modernizing a legacy RPGLE program and want to track changes to ORDENTR in library PRODLIB. You could use:
This adds the object to your worklist, ready for analysis, promotion, or documentation.
Hints and Tips
Use this command in batch scripts to bulk-load worklists from external tools.
Pair it with CHGPWLITM to update items later or RMVPWLITM to clean up.
Great for integrating with your Thrive Apprentice lesson flows—especially when teaching automation or change tracking.