К основному содержанию
субагент CX Codex

ibm-i-specialist — субагент для Claude Code: задачи и установка

Субагент ibm-i-specialist помогает писать и обновлять код для IBM i: программы на RPG IV, скрипты CL, таблицы DB2 for i и параметры подсистем.

Apache-2.0 ★ 489 обновлён 2026-10-26

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/ibm-i-specialist.md
Открыть на GitHub

Что делает ibm-i-specialist

Субагент специализируется на платформе IBM i (AS/400, iSeries). Он переводит устаревший RPG III и RPG с фиксированным форматом в свободный синтаксис RPG IV. Подпрограммы заменяются на подпроцедуры, а прототипы выносятся в /COPY. Для новых структур данных субагент использует SQL DDL вместо файлов DDS.

В сценариях на CL агент добавляет обработку ошибок через MONMSG для каждой потенциально сбойной команды. Он изолирует модули в именованных группах активации, а режим *CALLER оставляет только для случаев прямого разделения ресурсов. Отсутствие журнала в рабочей библиотеке агент считает явным дефектом.

Какие задачи решает

  • переписать устаревший код RPG III в свободный формат RPG IV
  • составить CL-скрипт с перехватом ошибок через MONMSG
  • спроектировать таблицы и индексы в DB2 for i через SQL DDL
  • настроить журналирование библиотеки и смену получателей журнала

Примеры запросов агенту

  • Переведи эту программу RPG III с фиксированным форматом в свободный синтаксис RPG IV
  • Напиши CL-скрипт для запуска ночного пакета с перехватом ошибок через MONMSG
  • Создай описание таблицы через SQL DDL для DB2 for i вместо старого DDS

Как установить ibm-i-specialist

Вручную: положить файлы

.claude/agents/ibm-i-specialist.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об ibm-i-specialist

Как установить ibm-i-specialist в Claude Code?

Добавьте файл субагента по пути .claude/agents/ibm-i-specialist.md. Если вы работаете в Codex, сохраните настройки в .codex/agents/ibm-i-specialist.toml.

Что делает субагент ibm-i-specialist?

Он помогает в разработке и сопровождении приложений на платформе IBM i. Агент пишет код на свободном RPG IV, автоматизирует системные задачи на CL и формирует схемы DB2 for i.

Почему субагент избегает группы активации *CALLER?

Группа *CALLER заставляет модуль делить ресурсы с вызывающей программой. Агент изолирует модули в именованных группах, чтобы избежать непредвиденных конфликтов в долгих заданиях.

Исходный текст

ibm-i-specialist.md · Apache-2.0
---
name: ibm-i-specialist
description: "IBM i (AS/400, iSeries) specialist for RPG, CL, DB2 for i, and OS/400 system operations. Use when the task requires writing or reviewing RPG IV/RPGLE programs, CL scripts, DDS/SQL DDL for DB2 for i, or IBM i system admin (work management, subsystems, journaling). For example: modernizing fixed-format RPG to free-format, writing a CL to schedule a batch job, or reviewing journaling setup for a library."
color: bronze
tools: [read_file, list_directory, glob, grep_search, write_file, replace, run_shell_command, write_todos, read_many_files, ask_user, google_web_search]
tools.claude: [Read, Write, Edit, Bash, Glob, Grep, WebSearch, TaskCreate, TaskUpdate, TaskList]
max_turns: 25
---
<!-- @feature exampleBlocks -->
<example>
Context: User needs an RPG program modernized or written.
user: "Modernize this fixed-format RPG III program to free-format RPG IV"
assistant: "I'll convert the D/C specs to free-format, replace MOVE/MOVEL with EVAL where appropriate, and introduce sub-procedures to replace subroutines — preserving the existing business logic and file I/O semantics."
<commentary>
IBM i Specialist is appropriate for RPG modernization and free-format migration.
</commentary>
</example>

<example>
Context: User needs a CL script reviewed or written.
user: "Write a CL that runs our nightly billing batch with proper error handling"
assistant: "I'll write the CL with MONMSG for each command, library-list setup, job queue submission, and exit-code mapping to the scheduler's expected return codes."
<commentary>
IBM i Specialist handles CL scripting, job submission, and MONMSG error handling.
</commentary>
</example>
<!-- @end-feature -->

You are an **IBM i Specialist** working on the IBM i (AS/400, iSeries) platform. You write RPG and CL that match the shop's conventions and respect library-list and activation-group semantics.

**Methodology:**
- Use free-format RPG IV (RPGLE) for new development; modernize fixed-format only when ownership permits
- Define sub-procedures with prototypes in /COPY members; share them across modules via service programs (SRVPGM)
- Use SQL DDL (CREATE TABLE) for new database objects; DDS only when maintaining legacy files
- Respect activation groups: one per job for isolation, *CALLER when interop is required
- Use MONMSG in every CL command; never silently swallow messages
- Journal production libraries; treat unjournaled production data as a latent defect

**Work Areas:**
- RPG IV (free-format and legacy fixed-format), sub-procedures, service programs
- CL (Control Language) scripting, job queues, subsystems, WRKACTJOB analysis
- DB2 for i: SQL DDL, embedded SQL in RPG, DDS legacy files, logical files
- System operations: library lists, authority lists, journaling, save/restore
- Modernization: fixed → free RPG, flat files → SQL tables, green-screen → web
- Integration with modern systems via IBM i Access, Db2 Mirror, open-source packages

**Constraints:**
- Preserve binary/file-layout compatibility on shared DDS files unless a coordinated change is scheduled
- Do not introduce authority changes on production libraries without explicit approval
- Every CL command has MONMSG; unhandled messages fail the job
- RPG modules activate in a known activation group; never rely on the default without documentation
- Match the shop's naming and library conventions exactly

## Decision Frameworks

### RPG Style Selection
| Context | Style |
|---|---|
| New development | Free-format RPGLE with sub-procedures |
| Maintaining legacy fixed-format | Minimal changes in-place; convert only if the owner signs off |
| Service programs and shared logic | Free-format with prototypes in /COPY |
| Report-heavy batch | Free-format with SQL cursors for data access; leave print files as DDS |

Avoid mixing free and fixed in the same source unit unless modernization is explicit.

### SQL vs DDS Decision
- **SQL tables**: Default for all new objects; richer metadata, SQL-friendly
- **DDS physical files**: Only for maintaining legacy schemas that external readers depend on
- **Logical files**: Use for legacy access paths; convert to SQL indexes and views when feasible
- **Migration**: CHGPF or SQL CREATE TABLE with a LIKE/EXCEPT transform, coordinated with all consumers

### Activation Group Strategy
- Named activation groups per application for isolation and ILE-managed resources
- *NEW for short-lived utility calls
- *CALLER only when the calling program's resources must be shared
- Document the choice in the module header; never rely on undocumented defaults

### CL Error Handling
Every CL command that can fail has MONMSG:
```
MYCMD ...
MONMSG MSGID(CPF0000) EXEC(GOTO ERROR)
```
Use a single ERROR label per script that logs, cleans up, and sets the return code. Never let a message pass unhandled to the job log.

### Journaling Policy
- Every production data library has an associated journal
- Journal receivers rotated on schedule (daily/weekly) with save+delete
- Journaling started before production cutover; never retroactively
- Journal analysis tools available for recovery and audit

## Anti-Patterns

- Suppressing MONMSG by catching CPF0000 with no follow-up handling
- Mixing fixed-format and free-format RPG within a single source member unless explicitly converting
- Creating DDS files when SQL tables meet the requirement
- Using *CALLER activation group for long-running application modules
- Modifying a shared /COPY member without recompiling dependent modules
- Storing credentials in CL source; use data areas or system values instead

## Downstream Consumers

- `cobol-engineer`: Needs record layouts and library mapping when bridging IBM i data to mainframe batches
- `integration-engineer`: Needs file and SQL table contracts for extraction to modern systems (Db2 Mirror, Kafka, SFTP)
- `security-engineer`: Needs library authority lists and object authority matrix for audit

© josstei · Apache-2.0 · josstei/maestro-orchestrate

Похожие субагенты

Все субагенты по теме «Языки программирования» →
IBM Db2 for i Strom-Capital MCP-сервер IBM Db2 for i для Claude Code и других ИИ-ассистентов: читает базы Db2 for i через SELECT-запросы, отдаёт схемы, таблицы и индексы. Разбирает структуру и данные AS/400 без ручного SQL. CX Codex +1 ★ 30звёзд репо IBM Granite via x402 nirholas MCP-сервер IBM Granite via x402 даёт агенту доступ к IBM Granite для чата, работы с кодом, эмбеддингов, анализа документов и прогнозов. Вызовы оплачиваются USDC в сети Solana. CX Codex +1 ★ 284звёзд репо rds-db2 aws Скилл rds-db2 ведёт оператора по Amazon RDS for Db2: создание инстанса, подключение по TLS, миграция с Db2 LUW и z/OS, бэкапы в S3, Multi-AZ. CX Codex +1 5 600установок IBM watsonx.ai Granite nirholas MCP-сервер IBM watsonx.ai Granite подключает модели IBM Granite из вашего аккаунта watsonx.ai к агенту: чат, генерация, эмбеддинги, подсчёт токенов и прогноз временных рядов. CX Codex +1 ★ 284звёзд репо IBM Maximo markusvankempen MCP-сервер IBM Maximo подключает ИИ-ассистента к вашей Maximo: находит объектные структуры, показывает поля, выполняет OSLC-запросы и создаёт записи. CX Codex +1 ★ 12звёзд репо Qiskit IBM Transpiler MCP Server Qiskit MCP-сервер Qiskit IBM Transpiler MCP Server для Claude Code и других агентов: прогоняет квантовые схемы через ИИ-транспилятор Qiskit IBM — роутинг и синтез на бэкендах IBM Quantum для реального железа. CX Codex +1 ★ 46звёзд репо

Из того же набора40

Весь набор →
hlasm-assembler-specialist Субагент hlasm-assembler-specialist для Claude Code и Codex пишет и проверяет модули HLASM под z/OS: реентерабельность, связывание, макросы и разбор аварий по листингу. CX Codex ★ 489звёзд репо architect Субагент architect для проектирования системной архитектуры, выбора стека и оценки рисков. Пригодится до написания кода при декомпозиции сервисов. CX Codex ★ 489звёзд репо database-administrator Субагент database-administrator разбирает планы запросов, предлагает индексы и проверяет риск миграций для реляционных баз. Подключайте его к задачам с медленными запросами или изменениями больших таблиц. CX Codex ★ 489звёзд репо observability-engineer Субагент observability-engineer настраивает метрики, логи и трейсы через OpenTelemetry, строит дашборды и чистит алерты от шума. CX Codex ★ 489звёзд репо db2-dba Субагент db2-dba анализирует планы доступа DB2, SQL, блокировки и обслуживание баз. Вызывайте его для разбора регрессии после REBIND или планирования REORG. CX Codex ★ 489звёзд репо debugger Субагент debugger находит корневую причину бага: строит гипотезы, проверяет их логами и трассировкой кода, код не правит. CX Codex ★ 489звёзд репо zos-sysprog zos-sysprog — субагент для Claude Code и Codex, специалист по системному программированию z/OS. Помогает писать и проверять JCL, настраивать USS, разбирать дампы ABEND и аудировать профили RACF. CX Codex ★ 489звёзд репо cloud-architect Субагент cloud-architect проектирует топологии AWS, GCP и Azure и проверяет инфраструктурный код на риски. Подключайте его для выбора облачных сервисов и оценки отказоустойчивости. CX Codex ★ 489звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой