Chapter 22 Further Reading

IBM Documentation

z/OS Connect Enterprise Edition

  • z/OS Connect EE V3.0 Documentation — IBM Knowledge Center. The definitive reference for exposing COBOL programs as REST APIs. Pay particular attention to the service archive (SAR) creation process, JSON schema generation from COBOL copybooks, and the interceptor framework for logging and security.
  • URL: https://www.ibm.com/docs/en/zos-connect-ee

Connect:Direct

  • IBM Sterling Connect:Direct for z/OS Administration Guide — Covers process syntax, checkpoint/restart configuration, compression options, and scheduling. The chapter on process automation is especially relevant for building the multi-step transfer workflows described in section 22.2.
  • IBM Sterling Connect:Direct for z/OS Configuration Guide — Network configuration, security setup, and performance tuning. Read the sections on TCP/IP buffer sizing and parallel session configuration if you're dealing with large file transfers.

IBM MQ

  • IBM MQ for z/OS Programming Guide — Covers the MQPUT, MQGET, and MQOPEN calls used in the COBOL examples in section 22.3. The chapters on publish/subscribe and message properties are essential for implementing content-based routing and topic hierarchies.
  • IBM MQ for z/OS System Administration — Queue manager configuration, channel setup, dead-letter queue processing, and triggered program management.

GDG Management

  • z/OS DFSMS Access Method Services for Catalogs — IDCAMS documentation for DEFINE GDG, including LIMIT, EMPTY/NOEMPTY, and SCRATCH/NOSCRATCH parameters. Section on relative generation numbering clarifies the (+1), (0), (-1) behavior.

Books

Enterprise Integration Patterns

  • Hohpe, G. and Woolf, B. (2003). Enterprise Integration Patterns: Designing, Building, and Deploying Messaging Solutions. Addison-Wesley.
  • The foundational reference for message-based integration. The patterns described — content-based router, message translator, canonical data model, dead letter channel, idempotent receiver — are directly applicable to mainframe MQ integration. Despite its age, this book remains the definitive catalog of integration patterns. Every pattern in section 22.3 of this chapter traces back to this book.

Data Integration

  • Linthicum, D.S. (2000). Enterprise Application Integration. Addison-Wesley.

  • Broader coverage of EAI patterns including file-based, message-based, and database-level integration. The chapter on data transformation and the discussion of hub-and-spoke versus bus architectures provide useful context for the canonical data model approach.

  • Kimball, R. and Caserta, J. (2004). The Data Warehouse ETL Toolkit. Wiley.

  • While focused on ETL for data warehousing, the chapters on extraction from mainframe sources, character encoding challenges, and data quality validation are directly relevant to file-based integration design. The discussion of slowly changing dimensions informs CDC strategy.

Mainframe Integration

  • Haines, B. et al. (2019). IBM z/OS Connect Enterprise Edition V3.0. IBM Redbooks.

  • IBM Redbook providing practical guidance on implementing z/OS Connect. Includes step-by-step examples of wrapping CICS programs and IMS transactions as REST APIs, with detailed coverage of the JSON-to-COBOL mapping process. The performance tuning chapter is invaluable.

  • IBM Redbooks. Batch Modernization on z/OS. SG24-7779.

  • Covers modernization of batch workloads including file-based integration optimization, parallel processing techniques, and integration with distributed scheduling systems. The chapter on GDG management patterns is particularly useful.

Technical Articles and White Papers

Data Format Challenges

  • IBM. "Character Conversion in z/OS Communications Server" — Technical reference for EBCDIC-to-ASCII conversion, code page selection, and handling of unmappable characters. Essential reading if you're implementing custom format conversion utilities.

  • IBM. "z/OS Unicode Services" — Documentation for z/OS Unicode conversion services, including support for UTF-8, UTF-16, and various EBCDIC code pages. Relevant for modern API-based integration where UTF-8 is the standard.

Change Data Capture

  • IBM. "IBM InfoSphere Data Replication for z/OS" — Product documentation for IBM's log-based CDC solution. Covers DB2 log reading, change capture configuration, and replication topology options (unidirectional, bidirectional, fan-out).

  • Kleppmann, M. "Using Logs for Data Integration." (2015). — Conference talk and blog post explaining the theoretical foundations of log-based CDC. While not mainframe-specific, the concepts of the log as the source of truth and derived data systems apply directly to mainframe CDC design.

API Design for Mainframes

  • IBM. "API Economy on z/OS" white paper. — Strategic overview of exposing mainframe capabilities as APIs, including business case analysis, architecture patterns, and implementation approaches. Useful for making the case to management.

  • Fielding, R.T. (2000). "Architectural Styles and the Design of Network-based Software Architectures." Doctoral dissertation, UC Irvine. — The original REST dissertation. Understanding REST constraints helps you design better mainframe APIs, particularly the discussion of statelessness, cacheability, and uniform interface.

Industry Standards

Data Exchange Formats

  • ISO 8601: Date and Time Format — The standard your APIs and file exports should use for date representation. Eliminates the ambiguity of MMDDYYYY versus DDMMYYYY versus YYYYMMDD.

  • OpenAPI Specification 3.0 — The standard for documenting REST APIs. z/OS Connect generates OpenAPI specs automatically, but understanding the specification helps you design better APIs.

  • JSON Schema — Standard for defining JSON document structure. Useful for formalizing your canonical data model and validating API request/response payloads.

File Transfer

  • RFC 959: File Transfer Protocol (FTP) — The foundational FTP specification. Understanding the protocol helps diagnose transfer issues, particularly around ASCII/binary modes and SITE commands for mainframe-specific behaviors.

  • RFC 4253: SSH Transport Layer Protocol — The security foundation for SFTP. Understanding SSH key exchange and encryption helps with troubleshooting SFTP connectivity issues.

Online Resources

Community and Forums

  • IBM Z and LinuxONE Community (community.ibm.com) — Active forums for z/OS Connect, MQ, and Connect:Direct. Search for specific error codes and configuration questions.

  • Planet Mainframe (planetmainframe.com) — Industry news and technical articles about mainframe modernization, including integration topics.

Tools and Utilities

  • IBM Data Studio — Free IDE for working with DB2 on z/OS, including stored procedure development for API-based data access.

  • Zowe CLI — Open-source CLI for z/OS that supports file transfer, job submission, and dataset management from distributed systems. Useful for scripting integration workflows.

  • Chapter 4: z/OS Datasets and File Processing — Foundation for understanding sequential datasets, VSAM, GDGs, and the file I/O operations used in file-based integration.
  • Chapter 19: IBM MQ and Message-Oriented Middleware — MQ fundamentals including queue managers, channels, persistent messaging, and the COBOL MQ API calls used throughout section 22.3.
  • Chapter 20: Event-Driven Architecture on z/OS — Event patterns and CDC as a source of events, directly building on the CDC discussion in section 22.6.
  • Chapter 21: CICS Web Services — SOAP and REST service exposure from CICS, complementing the z/OS Connect API discussion in section 22.4.
  • Chapter 23: Integration Monitoring and Observability — Monitoring the integration architecture designed in this chapter, including alert design, SLA tracking, and incident response.