product
IBM i Software Product & License Management
Query installed software products, licensing, and product health using SQL services from QSYS2.
Available Tools
The ibmi CLI is the primary tool for executing product queries. Set SKILL_DIR to this skill's installed location (the directory containing this SKILL.md file):
# SKILL_DIR = directory containing this SKILL.md
# Examples: ./skills/product, ~/.claude/skills/product
ibmi tools --tools "$SKILL_DIR/tools/" --toolset product_default
ibmi tool list_software_products --tools "$SKILL_DIR/tools/"
ibmi sql "SELECT * FROM QSYS2.SOFTWARE_PRODUCT_INFO WHERE INSTALLED = 'YES' AND LOAD_ERROR = 'YES'"
The ibmi-mcp-server also provides execute_sql and describe_sql_object for MCP-connected agents.
Service Selection Guide
Software Products
- QSYS2.SOFTWARE_PRODUCT_INFO -- Installed products with release, state, errors, compatibility
Licensing
- QSYS2.LICENSE_INFO -- License terms, usage limits, peak usage, expiration dates
Key Capabilities
Software Inventory
- Product Listing -- All installed products with release level and status
- Product Detail -- Deep dive into a specific product's options and loads
- Error Detection -- Find products with load errors or broken installations
- Compatibility Check -- Identify unsupported or incompatible products
License Management
- Usage Tracking -- Current usage count vs usage limit per product
- Peak Usage -- Historical peak usage for capacity planning
- Compliance -- Compliance type and violation logging status
- Expiration -- License expiration dates and grace periods
Common Use Cases
- Software inventory -- List all installed products and versions
- Product lookup -- Get details for a specific product ID (e.g., 5770SS1)
- Error detection -- Find products with load errors needing attention
- License audit -- Review license compliance and usage
- Upgrade planning -- Identify unsupported or incompatible products
- Capacity planning -- Check peak usage against license limits
Quick Examples
List installed products
ibmi tool list_software_products --tools "$SKILL_DIR/tools/"
Details for a specific product
ibmi tool get_software_product_detail --tools "$SKILL_DIR/tools/" --product-id 5770SS1
Products with errors
ibmi tool list_software_errors --tools "$SKILL_DIR/tools/"
License compliance
ibmi tool get_license_info --tools "$SKILL_DIR/tools/"
Unsupported products
ibmi tool list_unsupported_products --tools "$SKILL_DIR/tools/"
Pre-built Tools
The tools/product.yaml file provides 5 ready-to-use tools:
| Tool | Description |
|---|---|
list_software_products |
Installed software products with status and release |
get_software_product_detail |
Detailed product info by product ID |
list_software_errors |
Products with load errors |
get_license_info |
License compliance, usage, and expiration |
list_unsupported_products |
Unsupported, incompatible, or errored products |
ibmi tool <tool_name> --tools "$SKILL_DIR/tools/" # Execute
ibmi tool <tool_name> --tools "$SKILL_DIR/tools/" --dry-run # Preview SQL
ibmi tools show <tool_name> --tools "$SKILL_DIR/tools/" # View details
Reference Documentation
- Product Services Catalog -- Available SQL services
- Example SQL Patterns -- Working query examples
- IBM SOFTWARE_PRODUCT_INFO -- View documentation
- IBM LICENSE_INFO -- View documentation
More from ajshedivy/ibmi-agent-skills
work-management
Query, monitor, and analyze jobs on IBM i using SQL table functions via the ibmi CLI. Use when user asks about: (1) finding jobs by status, user, subsystem, or type, (2) monitoring active job performance (CPU, I/O, memory), (3) detecting long-running SQL statements, (4) analyzing lock contention, (5) checking job queues, (6) scheduled jobs, (7) job logs, (8) replacing WRKACTJOB, WRKUSRJOB, WRKSBSJOB, WRKSBMJOB commands, or (9) any IBM i work management task.
12system-health
Monitor IBM i system health including CPU, memory, disk, ASPs, system limits, and network status via SQL services. Use when user asks about: (1) CPU utilization or system status, (2) memory pool sizes or page faults, (3) disk capacity or ASP usage, (4) system limits approaching thresholds, (5) TCP/IP connections and network status, (6) system activity overview, (7) replacing WRKSYSSTS, WRKDSKSTS, WRKTCPSTS commands, or (8) any system health monitoring task.
4database-performance
Monitor IBM i database performance including index statistics, maintained temporary indexes (MTIs), database monitors, query supervisor thresholds, and materialized query tables. Use when user asks about: (1) index usage or unused indexes, (2) maintained temporary indexes and whether to create permanent indexes, (3) database monitor configuration, (4) query supervisor thresholds, (5) MQT statistics and refresh status, or (6) tables with high MTI overhead.
3template-skill
Replace with description of the skill and when Claude should use it.
3skill-creator
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
3ibmi
Core skill for working with IBM i systems via the ibmi CLI and ibmi-mcp-server. Provides text-to-SQL methodology, iterative querying best practices, schema discovery, and SQL validation patterns for Db2 for i. Use as the foundation for ANY IBM i task — install this skill first, then add domain-specific skills (ibmi-database, ibmi-system) as needed.
3