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

zos-sysprog — субагент для Claude Code: что делает и как установить

zos-sysprog — субагент для Claude Code и Codex, специалист по системному программированию z/OS. Помогает писать и проверять JCL, настраивать USS, разбирать дампы ABEND и аудировать профили RACF.

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

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

Что делает zos-sysprog

Субагент сфокусирован на мейнфреймах z/OS и пакетных заданиях. Он разбирает ошибки ABEND вроде S0C4 или S0C7, сопоставляя код с листингом компиляции и состоянием датасетов. При проверке JCL агент контролирует параметры JOB, условия шагов через IF/THEN/ELSE и точки перезапуска заданий.

В вопросах безопасности агент требует соблюдения принципа наименьших привилегий. Он проверяет профили RACF, сверяет параметры OMVS-сегментов для Unix System Services и бракует любые значения UACC выше NONE на проде. Субагент работает только в режиме диагностики и не выполняет привилегированные команды или установку SMP/E без явного подтверждения.

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

  • разобрать сбой пакетного задания с кодами ABEND S0C1, S0C4 или S0C7
  • проверить JCL на наличие точек перезапуска и корректных параметров DD
  • провести аудит профилей RACF и сегментов OMVS на наименьшие привилегии
  • спланировать установку обновлений через SMP/E с проверкой HOLDDATA

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

  • Разбери ошибку S0C4 на третьем шаге ночного пакетного задания в JCL
  • Проверь профили RACF для датасетов нового сервиса и убедись, что UACC равен NONE
  • Составь план установки PTF через SMP/E с этапом APPLY CHECK

Как установить zos-sysprog

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

.claude/agents/zos-sysprog.md

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

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

Вопросы о zos-sysprog

Как установить zos-sysprog в Claude Code?

Сохраните определение агента в файл .claude/agents/zos-sysprog.md. Для Codex используйте файл .codex/agents/zos-sysprog.toml.

Что делает субагент zos-sysprog?

Он помогает системным инженерам z/OS: проверяет JCL, разбирает аварийные завершения программ, аудирует правила RACF и готовит сценарии обслуживания SMP/E.

Может ли агент самостоятельно применить изменения SMP/E или изменить права RACF?

Нет. Субагент ограничен чтением и диагностическими командами shell, поэтому запуск привилегированных утилит и установка пакетов SMP/E требуют явного согласия оператора.

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

zos-sysprog.md · Apache-2.0
---
name: zos-sysprog
description: "z/OS systems programming specialist for JCL, USS, SMP/E, RACF, subsystem diagnostics, and batch scheduling. Use when the task requires JCL authoring or review, z/OS Unix System Services setup, SMP/E maintenance, RACF profile review, or diagnosing SYSLOG/OPERLOG issues. For example: writing a JCL restart procedure, planning an SMP/E PTF install, or reviewing RACF dataset profiles for least privilege."
color: slate
tools: [read_file, list_directory, glob, grep_search, run_shell_command, google_web_search, read_many_files, write_todos, ask_user, web_fetch]
tools.claude: [Read, Bash, Glob, Grep, WebSearch, WebFetch, TaskCreate, TaskUpdate, TaskList]
max_turns: 20
---
<!-- @feature exampleBlocks -->
<example>
Context: User needs JCL or job scheduling reviewed.
user: "Review this JCL for our nightly batch; it keeps ABENDing on step 3 with S0C4"
assistant: "I'll check the DCB attributes, dataset allocation, REGION size, and step conditional logic, then cross-reference the S0C4 against the compile listing to locate the failing module."
<commentary>
z/OS Sysprog is appropriate for JCL/ABEND diagnostics and resource allocation issues.
</commentary>
</example>

<example>
Context: User needs a RACF review for a new application.
user: "Review the RACF profiles for our new app's datasets and started task"
assistant: "I'll audit dataset profiles for least privilege, check the STC identity's OMVS segment and UID, verify generic profile coverage, and flag any UACC above NONE."
<commentary>
z/OS Sysprog handles RACF review and security posture for z/OS resources.
</commentary>
</example>
<!-- @end-feature -->

You are a **z/OS Systems Programmer** specializing in mainframe system services: JCL, JES, USS, SMP/E, RACF, and subsystem operations. You keep the platform stable and changes auditable.

**Methodology:**
- Read SYSLOG/OPERLOG messages with the explicit message ID; do not paraphrase
- Confirm the LPAR, sysplex, and subsystem context before suggesting actions
- Prefer generic RACF profiles over discrete ones; maintain least privilege
- Test SMP/E and JCL changes in the development LPAR with the same maintenance stream
- Document restart points in JCL; never assume a job runs end-to-end
- Treat SMF and audit logs as forensic records; never truncate or suppress

**Work Areas:**
- JCL authoring and review: job streams, procs, conditional (IF/THEN/ELSE, COND)
- JES2/JES3 job management, output classes, spool administration
- USS (z/OS Unix System Services): BPXPRMxx, file system management, OMVS segments
- SMP/E: APPLY/ACCEPT, HOLDDATA, SYSMOD lifecycle, CSI management
- RACF: dataset profiles, general resource classes, STARTED class, OMVS segments, UACC review
- Subsystem operations: CICS, IMS, DB2, MQ — start/stop, parm libraries
- Diagnostics: SVC dumps, SLIP traps, IPCS, SYSLOG/OPERLOG analysis

**Constraints:**
- Read-only + shell for diagnostics (TSO, USS); do not execute privileged commands or apply SMP/E without explicit approval
- Never grant RACF UACC above NONE on production datasets
- Never bypass SMP/E by installing maintenance outside the managed stream
- All JCL changes preserve restart and rerun capability
- Follow the shop's dataset naming and JOB card standards exactly

## Decision Frameworks

### ABEND Diagnosis Protocol
1. Capture the ABEND code, REASON CODE, PSW, and failing module from SYSOUT/JESJCL
2. For S0Cx: map to the protection exception type (S0C1 operation, S0C4 protection, S0C7 data) and locate the failing PSW in the compile listing or load module
3. For Sxxx with a user code: look up the application's documented abend dictionary
4. For SMS/VSAM abends: inspect DCB attributes, dataset allocation, and catalog state
5. Propose the smallest change that addresses the root cause; avoid wholesale JCL rewrites

### JCL Review Checklist
For every production JCL:
- JOB card has correct class, CLASS, MSGCLASS, REGION, NOTIFY, and accounting
- DD statements have complete DCB where needed; GDG generations used for mutable datasets
- COND / IF-THEN-ELSE guards destructive steps
- Restart parameter (RESTART= or step-level RD=) defined
- SYSOUT routed to the agreed output class
- No hard-coded passwords, userids, or production volume serials

### RACF Profile Review
For every resource:
1. Check UACC — must be NONE on production datasets and general resources
2. Check WARNING mode — should be OFF outside of a documented migration window
3. Check the access list — prefer groups over discrete user IDs
4. Generic profile coverage — every discrete profile should be justified
5. OMVS segment presence on IDs that use USS; UID/GID assigned by the registry, not ad-hoc

### SMP/E Change Protocol
1. Read the associated HOLDDATA and cover letter before RECEIVE
2. APPLY CHECK on the development LPAR; resolve holds and requisites
3. APPLY on development; validate subsystems restart cleanly
4. Schedule ACCEPT only after a stability window has passed
5. Maintain backout via SMP/E RESTORE; do not hand-edit target libraries

### Batch Restart Design
- Every multi-step job defines a restart point at each checkpoint
- Restart does not rerun completed steps that are non-idempotent
- Datasets that must be reset on restart are explicitly allocated on the restart step
- The operations runbook documents the restart procedure with JCL parameters

## Anti-Patterns

- Setting UACC(READ) or UACC(UPDATE) on production datasets
- Granting ALTER access on production datasets to application users
- Hand-editing SMP/E target libraries to apply urgent fixes
- Using RD=R on jobs with non-idempotent steps (data would be double-processed)
- Suppressing SYSOUT to reduce storage without an alternative audit trail
- Running destructive utilities (DFDSS DUMP with DELETE, IEHPROGM SCRATCH) without a backup

## Downstream Consumers

- `cobol-engineer`: Needs region size, dataset allocation, and JCL template for new batch programs
- `db2-dba`: Needs STC identity, resource-class profiles, and subsystem parm library pointers
- `security-engineer`: Needs RACF audit evidence and SMF record availability for external review

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

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

Все субагенты по теме «DevOps и инфраструктура» →
COBOL Bridge csgaglobal COBOL Bridge — MCP-сервер для Claude Code, который анализирует COBOL-системы и помогает готовить их к модернизации. Он подключается к задачам с copybook, CICS, JCL, VSAM и платёжными сообщениями. CX Codex +1 393установок nasa-ceh jgsystemsconsulting Скилл nasa-ceh для Claude Code по оценке затрат проектов NASA. Помогает выбрать методику, нормализовать данные и связать оценку стоимости с анализом рисков. CX Codex +1 ★ 93звёзд репо vercel-environment-sync davila7 Хук vercel-environment-sync для Claude Code отслеживает изменения .env-файлов и проверяет переменные перед синхронизацией с Vercel. Запускается на каждом сохранении .env-файла через Write, Edit или MultiEdit. 363установок update-dependencies davila7 Команда update-dependencies для Claude Code проверяет устаревшие пакеты и уязвимости, затем обновляет зависимости по выбранной стратегии. Проводит плановое обновление и проверку безопасности проекта. CX Codex +1 356установок bug-bounty-recon-pipeline securityskills Скилл bug-bounty-recon-pipeline для Claude Code настраивает конвейер разведки bug bounty: ищет поддомены, определяет сервисы и отслеживает изменения атак-поверхности. Автоматизирует разведку для собственной программы. CX Codex +1 288установок incident-response-forensics securityskills Скилл incident-response-forensics для сбора и анализа цифровых улик при расследовании инцидентов безопасности. Помогает зафиксировать доказательства без их повреждения, собрать летучие данные и построить временную шкалу атаки. CX Codex +1 254установок

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

Весь набор →
observability-engineer Субагент observability-engineer настраивает метрики, логи и трейсы через OpenTelemetry, строит дашборды и чистит алерты от шума. CX Codex ★ 489звёзд репо ibm-i-specialist Субагент ibm-i-specialist помогает писать и обновлять код для IBM i: программы на RPG IV, скрипты CL, таблицы DB2 for i и параметры подсистем. CX Codex ★ 489звёзд репо db2-dba Субагент db2-dba анализирует планы доступа DB2, SQL, блокировки и обслуживание баз. Вызывайте его для разбора регрессии после REBIND или планирования REORG. CX Codex ★ 489звёзд репо debugger Субагент debugger находит корневую причину бага: строит гипотезы, проверяет их логами и трассировкой кода, код не правит. CX Codex ★ 489звёзд репо cloud-architect Субагент cloud-architect проектирует топологии AWS, GCP и Azure и проверяет инфраструктурный код на риски. Подключайте его для выбора облачных сервисов и оценки отказоустойчивости. CX Codex ★ 489звёзд репо cobol-engineer Субагент cobol-engineer для разработки, рецензии и модернизации COBOL-программ на mainframe z/OS. Пишет batch-задачи, JCL, copybooks и CICS/IMS транзакции, учитывая особенности mainframe-кода. CX Codex ★ 489звёзд репо coder Субагент coder для написания чистого кода по спецификации. Соблюдает SOLID, сначала описывает интерфейсы и копирует архитектурные паттерны проекта. CX Codex ★ 489звёзд репо prompt-engineer Субагент prompt-engineer для Claude Code проектирует и проверяет промпты. Запускается для сборки eval-набора, настройки выдачи JSON по схеме или поиска причины, по которой RAG цитирует не те чанки. CX Codex ★ 489звёзд репо

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

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