ibm-mainframe
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
- JCL job submission & monitoring: Load jcl-batch-processing.md
- Dataset management: Load zos-administration.md
- VSAM file operations: Load jcl-batch-processing.md
Application Development
- COBOL programming: Load cobol-programming.md
- CICS transaction management: Load cobol-programming.md
- DB2 operations: Load cobol-programming.md
System Management
- Security (RACF/ACF2): Load zos-administration.md
- Performance monitoring: Load zos-administration.md
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.
More from dauquangthanh/hanoi-rainbow
frontend-design-review
Conducts comprehensive frontend design reviews covering UI/UX design quality, design system validation, accessibility compliance, responsive design patterns, component library architecture, and visual design consistency. Evaluates design specifications, Figma/Sketch files, design tokens, interaction patterns, and user experience flows. Identifies usability issues, accessibility violations, design system deviations, and provides actionable recommendations for improvement. Produces detailed design review reports with severity-rated findings, visual examples, and implementation guidelines. Use when reviewing frontend designs, validating design systems, ensuring accessibility compliance, evaluating component libraries, assessing responsive designs, or when users mention design review, UI/UX review, Figma review, design system validation, accessibility audit, or frontend design quality.
276frontend-ui-ux-design
Creates comprehensive frontend UI/UX designs including user interfaces, design systems, component libraries, responsive layouts, and accessibility implementations. Produces wireframes, mockups, design specifications, and implementation guidelines. Use when designing user interfaces, creating design systems, building component libraries, implementing responsive designs, ensuring accessibility compliance, or when users mention UI design, UX design, interface design, design systems, user experience, or frontend design patterns.
169keycloak-administration
Provides comprehensive KeyCloak administration guidance including realm management, user/group administration, client configuration, authentication flows, identity brokering, authorization policies, security hardening, and troubleshooting. Covers SSO configuration, SAML/OIDC setup, role-based access control (RBAC), user federation (LDAP/AD), social login integration, multi-factor authentication (MFA), and high availability deployments. Use when configuring KeyCloak, setting up SSO, managing realms and clients, troubleshooting authentication issues, implementing RBAC, or when users mention "KeyCloak", "SSO", "OIDC", "SAML", "identity provider", "IAM", "authentication flow", "user federation", "realm configuration", or "access management".
166oracle-cloud
Provides comprehensive Oracle Cloud Infrastructure (OCI) guidance including compute instances, networking (VCN, load balancers, VPN), storage (block, object, file), database services (Autonomous Database, MySQL, NoSQL), container orchestration (OKE), identity and access management (IAM), resource management, cost optimization, and infrastructure as code (Terraform OCI provider, Resource Manager). Produces infrastructure code, deployment scripts, configuration guides, and architectural diagrams. Use when designing OCI architecture, provisioning cloud resources, migrating to Oracle Cloud, implementing OCI security, setting up OCI databases, deploying containerized applications on OKE, managing OCI resources, or when users mention "Oracle Cloud", "OCI", "Autonomous Database", "VCN", "OKE", "OCI Terraform", "Resource Manager", "Oracle Cloud Infrastructure", or "OCI migration".
83backend-design
Designs comprehensive backend systems including RESTful APIs, microservices, database architecture, authentication/authorization, caching strategies, message queues, and scalability patterns. Produces API specifications, database schemas, architecture diagrams, and implementation guides. Use when designing backend services, APIs, data models, distributed systems, authentication flows, or when users mention backend architecture, API design, database design, microservices, or server-side development.
55requirement-review
Conducts comprehensive requirements review including completeness validation, clarity assessment, consistency checking, testability evaluation, and standards compliance. Produces detailed review reports with findings, gaps, conflicts, and improvement recommendations. Use when reviewing requirements documents (BRD, SRS, user stories), validating acceptance criteria, assessing requirements quality, identifying gaps and conflicts, or ensuring standards compliance (IEEE 830, INVEST criteria). Trigger when users mention "review requirements", "validate requirements", "check requirements quality", "find requirement issues", or "assess BRD/SRS quality".
52