| name | ibm-mainframe |
| description | Provides comprehensive IBM Mainframe administration, development, and modernization guidance including z/OS operations, JCL scripting, COBOL/PL/I programming, CICS/IMS configuration, DB2 administration, TSO/ISPF usage, system programming, batch processing, and mainframe-to-cloud migration strategies. Covers mainframe security (RACF, ACF2), performance tuning, capacity planning, disaster recovery, and DevOps integration. Use when working with mainframe systems, z/OS, JES2/JES3, VTAM, USS, or when users mention "mainframe", "z/OS", "MVS", "TSO", "ISPF", "JCL", "CICS", "IMS", "DB2 mainframe", "VSAM", "RACF", "mainframe modernization", "legacy mainframe", or "IBM z Systems". |
IBM Mainframe
Overview
Comprehensive guidance for IBM Mainframe (z/OS) administration, development, operations, and modernization. Covers system programming, application development, middleware configuration, database management, and migration strategies for mainframe environments.
Quick Start Guide
Choose your task and load the appropriate reference:
- z/OS System Administration → Load zos-administration.md for system operations, address spaces, JES2/JES3, TSO/ISPF commands, dataset management, and USS
- JCL Development & Batch Processing → Load jcl-batch-processing.md for JCL syntax, utilities (IEBGENER, SORT, IDCAMS), procedures, GDG management, and job scheduling
- COBOL Programming → Load cobol-programming.md for COBOL structure, file handling, DB2/CICS integration, compile/link procedures, and debugging
- Mainframe Modernization → Load mainframe-modernization.md for migration strategies, assessment, rehost/replatform/refactor approaches, and cloud integration
Core Mainframe Concepts
z/OS Operating System
- MVS (Multiple Virtual Storage): Core OS components
- JES2/JES3: Job Entry Subsystems for batch processing
- TSO/ISPF: Time Sharing Option / Interactive System Productivity Facility
- USS: Unix System Services (POSIX environment on z/OS)
- Address Spaces: Isolated execution environments (ASID)
Key Subsystems
- CICS: Customer Information Control System (transaction processing)
- IMS: Information Management System (hierarchical DB + transaction manager)
- DB2: Relational database management system
- MQ: Message queuing middleware
- WebSphere: Application server for Java applications
Data Management
- VSAM: Virtual Storage Access Method (indexed, sequential, relative record)
- Sequential Files: PS (Physical Sequential), PDS (Partitioned Data Set), PDSE
- GDG: Generation Data Group (versioned datasets)
- SMS: Storage Management Subsystem (automated data management)
Security Systems
- RACF: Resource Access Control Facility (IBM)
- ACF2: Access Control Facility 2 (CA Technologies)
- Top Secret: Security system (CA Technologies)
Common Mainframe Tasks
For detailed syntax, examples, and procedures, load the appropriate reference file:
Administration & Operations
Application Development
System Management
Mainframe Development Workflow
For complete development procedures, compile JCL, version control integration, and testing strategies, load cobol-programming.md.
Typical development cycle:
- Edit source code (ISPF or modern IDE)
- Compile and link programs
- Test in development environment
- Version control and promotion
- Deploy to production
Modern development approaches:
- Git integration via USS (Unix System Services)
- Zowe CLI for remote access and CI/CD
- DBB (Dependency Based Build) for automated builds
- Eclipse/VS Code with mainframe extensions
Mainframe Modernization Strategies
For comprehensive migration guidance, assessment procedures, and specific migration patterns, load mainframe-modernization.md.
Key approaches:
- Rehost (Lift & Shift): Mainframe emulators on x86/cloud (fastest, minimal changes)
- Replatform: Migrate to modern languages (Java, C#) with automated conversion
- Refactor: Redesign as microservices with modern architecture patterns
- Retire/Replace: Replace with COTS or modern SaaS alternatives
Integration options:
- z/OS Connect for RESTful APIs
- IBM MQ for messaging
- CDC (Change Data Capture) for data replication
- DevOps integration with Zowe, Jenkins, Git
Best Practices
Development
- Use structured programming (avoid ALTER, computed GO TO)
- Modular design with focused paragraphs/sections
- Comprehensive error handling (EXEC CICS HANDLE, SQL SQLCODE checks)
- Clear documentation with meaningful variable names
- Performance optimization (minimize I/O, efficient SQL, proper indexing)
Operations
- Automation with JCL procedures, REXX scripts, automation tools
- Proactive monitoring with alerts and performance baselines
- Regular backup & recovery with DR testing
- Capacity planning to monitor trends and forecast growth
- Security with least privilege, regular audits, compliance
Migration
- Phased approach to reduce risk incrementally
- Data integrity validation before and after migration
- Parallel running of old and new systems
- Maintain rollback plans
- Extensive documentation and team training
For detailed procedures, load the appropriate reference file.
Tooling Ecosystem
IBM Native Tools
- ISPF: Primary development interface
- SDSF: Job and output management
- RMF/SMF: Performance monitoring and system logging
- OMVS: Unix shell environment on z/OS
Modern Mainframe Tools
- Zowe: Open-source framework for mainframe modernization
- DBB: Dependency Based Build for DevOps
- IBM Wazi: Cloud-native development environment
- Topaz/IBM Developer for z/OS: Modern IDEs
Migration Tools
- Micro Focus Enterprise Suite: Rehost solution
- LzLabs/AWS Mainframe Modernization: Cloud migration platforms
- IBM Rational/CAST: Application analysis tools
For detailed tool usage, configuration, and examples, load the appropriate reference file.
Common Issues & Solutions
Job Failures
- S0C7 (Data exception): Invalid numeric data, uninitialized variables, data conversion errors
- S806 (Program not found): Missing STEPLIB/JOBLIB, linking issues, wrong load library
- S322 (Time out): Infinite loop, long-running query, insufficient TIME parameter
- S013/S213/S413 (OPEN failure): Dataset allocation issues, DISP conflicts, missing dataset
Performance Issues
- High CPU: Inefficient code, missing indexes, excessive I/O
- Long response time: Network latency, database contention, poor SQL
- Memory constraints: Virtual storage shortage, insufficient region size
Security Issues
- Access denied: Check RACF permissions and group memberships
- Unauthorized program: Not in APF library or not properly authorized
- Dataset protection: Review UACC and specific permits
For detailed troubleshooting procedures, load the appropriate reference file.
Key Concepts Glossary
- DASD: Direct Access Storage Device (disk storage)
- ABEND: Abnormal End (program crash)
- IPL: Initial Program Load (system boot)
- LPAR: Logical Partition (virtual machine)
- SYSPLEX: System Complex (cluster of z/OS systems)
- Coupling Facility: High-speed memory for parallel sysplex
- HCD/HCM: Hardware Configuration Dialog/Manager
- SMP/E: System Modification Program/Extended (maintenance)
- ISPF: Interactive System Productivity Facility
- REXX: Restructured Extended Executor (scripting language)
Critical Considerations
Data Integrity
- VSAM files require proper SHAREOPTIONS
- DB2 locking and isolation levels must be configured correctly
- GDG generation management for versioned datasets
- Always backup before changes
System Performance
- Batch window constraints (limited time for batch jobs)
- Online transaction response time requirements (sub-second)
- Resource contention management (CPU, I/O, memory)
- Capacity planning for growth
Security & Compliance
- RACF/ACF2 configuration and maintenance
- Audit trails and compliance requirements (SOX, PCI-DSS, GDPR)
- Separation of duties enforcement
High Availability
- Parallel Sysplex for redundancy
- GDPS (Geographically Dispersed Parallel Sysplex) for disaster recovery
- Continuous availability requirements
Output Requirements
When analyzing or documenting mainframe systems, provide:
- System inventory: Operating system version, middleware, applications
- Architecture diagram: LPAR layout, subsystems, connectivity
- Dependency mapping: Job dependencies, program CALL trees, data flows
- Security assessment: User access, dataset protection, compliance gaps
- Performance baseline: CPU, I/O, response times, throughput
- Modernization roadmap: Assessment results, approach, timeline, risks (load mainframe-modernization.md)
- Migration plan: Phased approach, cutover strategy, rollback procedures
- Documentation: Technical specifications, runbooks, operational procedures
For specific output formats and templates, load the appropriate reference file.
Next Steps
For specific tasks, load the relevant reference file from the Quick Start Guide above. Each reference provides detailed procedures, commands, examples, and troubleshooting guidance for that specific area of mainframe operations.
