migrate-while-active
IBM i Migrate While Active Monitoring
Monitor Migrate While Active environments including migration manager state, library and IFS tracking, compression, and synchronization estimates using QSYS2 SQL services.
Available Tools
The ibmi CLI is the primary tool for migration monitoring. 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/migrate-while-active, ~/.claude/skills/migrate-while-active
ibmi tools --tools "$SKILL_DIR/tools/" --toolset migrate_while_active_default
ibmi tool get_migration_manager_info --tools "$SKILL_DIR/tools/"
ibmi sql "SELECT * FROM QSYS2.MIGRATION_MANAGER_INFO"
Service Selection Guide
Migration Status
- QSYS2.MIGRATION_MANAGER_INFO -- Overall migration state, phase, and node info
- QSYS2.LIBRARY_MIGRATION_LIST -- Library objects being tracked for migration
- QSYS2.IFS_MIGRATION_LIST -- IFS objects being tracked for migration
Completed Migrations
- QSYS2.MIGRATED_LIBRARY -- Successfully migrated library objects
- QSYS2.MIGRATED_IFS -- Successfully migrated IFS objects
Planning & Estimation
- SYSIBMADM.DATA_COMPRESSION_FACTOR -- Compression ratios for data types
- QSYS2.ESTIMATE_FINAL_SYNCHRONIZATION_TIME -- Final sync time estimate
- QSYS2.MIGRATION_NETWORK_BANDWIDTH -- Network bandwidth measurements
Key Capabilities
Migration Tracking
- Manager Status -- Current migration phase, stage, and node states
- Library Migration -- Track library-based object migration progress
- IFS Migration -- Track IFS object migration progress
- Failure Detection -- Identify objects that failed to migrate
Completion Monitoring
- Migrated Libraries -- Verify library objects completed migration
- Migrated IFS -- Verify IFS objects completed migration
- Time-based Filtering -- Show objects migrated within recent hours
Cutover Planning
- Compression Analysis -- Understand data compression ratios
- Sync Time Estimate -- Predict final synchronization duration
- Bandwidth Testing -- Measure network throughput to copy node
Common Use Cases
- Check migration status -- Get overall migration phase and progress
- Monitor library progress -- Track which libraries are migrating
- Identify failures -- Find objects that failed to migrate
- Verify completion -- Confirm objects successfully migrated
- Plan cutover -- Estimate final sync time and bandwidth
- Troubleshoot -- Investigate migration failures and bottlenecks
Quick Examples
Check overall migration status
ibmi tool get_migration_manager_info --tools "$SKILL_DIR/tools/"
List objects being migrated
ibmi tool list_library_migration --tools "$SKILL_DIR/tools/"
Find migration failures
ibmi tool list_migration_failures --tools "$SKILL_DIR/tools/"
Estimate final sync time
ibmi tool estimate_final_sync_time --tools "$SKILL_DIR/tools/"
Pre-built Tools
The tools/migrate-while-active.yaml file provides 9 ready-to-use tools:
| Tool | Description |
|---|---|
get_migration_manager_info |
Overall migration state, phase, and nodes |
list_library_migration |
Library objects being tracked for migration |
list_ifs_migration |
IFS objects being tracked for migration |
list_migrated_libraries |
Successfully migrated library objects |
list_migrated_ifs |
Successfully migrated IFS objects |
list_migration_failures |
Library migration objects with failures |
get_data_compression_factor |
Compression ratios by type |
estimate_final_sync_time |
Final synchronization time estimate |
check_migration_network_bandwidth |
Network bandwidth to copy node |
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
- Migration Services Catalog -- Available SQL services
- Example SQL Patterns -- Working query examples
- IBM MIGRATION_MANAGER_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