IBM z/OS Connect 20 Laboratórios Práticos para um Padawan COBOL

 

Bellacosa Mainframe e 20 laboratorios praticos para z/os connect

☕ O Holocron do IBM z/OS Connect

Durante muitos anos, um programador COBOL precisava dominar JCL, CICS, DB2, VSAM e as ferramentas tradicionais do IBM Z para construir aplicações robustas. Hoje, entretanto, o mercado exige um novo conjunto de habilidades: integrar sistemas legados ao universo das APIs, aplicações móveis, microsserviços, cloud e Inteligência Artificial. É exatamente nesse cenário que o IBM z/OS Connect Enterprise Edition (z/OS Connect EE) se torna uma das tecnologias mais importantes da plataforma IBM Z.

Esta sequência de 20 laboratórios foi desenvolvida seguindo uma metodologia de aprendizado progressivo, inspirada no conceito de "Padawan". Cada laboratório apresenta um desafio prático que amplia gradualmente o conhecimento do desenvolvedor, começando pelos conceitos fundamentais da arquitetura do z/OS Connect, passando pela configuração do Liberty Server, publicação de programas COBOL como APIs REST, integração com CICS, IMS e DB2, segurança com RACF, TLS, OAuth e JWT, monitoramento, observabilidade e boas práticas de desempenho.

Ao concluir esta jornada, espera-se que o desenvolvedor seja capaz de compreender toda a arquitetura do z/OS Connect, publicar e consumir APIs com segurança, interpretar logs e métricas, diagnosticar problemas de integração e participar de projetos de modernização do IBM Z. Mais do que aprender uma ferramenta, o objetivo é formar profissionais capazes de conectar décadas de conhecimento em COBOL às arquiteturas modernas, tornando o mainframe um protagonista na era das APIs, da nuvem híbrida e dos agentes de Inteligência Artificial.

20 Laboratórios Práticos para um Padawan COBOL

Do "Hello REST" até Construir APIs Enterprise para IBM Z

Objetivo: transformar um programador COBOL tradicional em um desenvolvedor capaz de publicar, consumir, monitorar e administrar APIs utilizando o IBM z/OS Connect Enterprise Edition.

Cada laboratório foi pensado para ser executado em sequência. Ao final, o aluno terá construído uma pequena arquitetura moderna baseada em COBOL, CICS, REST, JSON, OpenAPI e observabilidade.

---

LAB 01 — Conhecendo o z/OS Connect

Objetivo

Entender onde o z/OS Connect fica dentro da arquitetura IBM Z.

Aprender

• Liberty Server

• HTTPS

• JSON

• REST

• CICS

• IMS

• Batch

• DB2

Exercício

Desenhar a arquitetura completa.

Cliente

↓

HTTPS

↓

Liberty

↓

z/OS Connect

↓

CICS

↓

Programa COBOL

Solução

Compreender que o z/OS Connect não substitui o COBOL.

Ele apenas traduz protocolos.

---

LAB 02 — Instalando o Liberty Server

Objetivo

Criar um servidor Liberty.

Exercício

Criar

ZCONN01

Subir o servidor.

Verificar:

• logs

• porta

• servidor ativo

Solução

Servidor respondendo em HTTPS.

---

LAB 03 — Conhecendo o server.xml

Editar

server.xml

Identificar

• features

• portas

• SSL

• aplicações

Solução

Entender como Liberty é configurado.

---

LAB 04 — Explorando a estrutura USS

Navegar

/var/zosconnect

Identificar

• logs

• config

• certificates

• api archives

Solução

Compreender que grande parte da configuração fica no USS.

---

LAB 05 — Primeiro Hello World

Criar uma API simples.

Endpoint

GET /hello

Retornar

Hello IBM Z

Solução

Primeira API publicada.

---

LAB 06 — Importando um Copybook COBOL

Criar

CLIENTE.cpy

Importar utilizando o Toolkit.

Solução

Gerar automaticamente o JSON Schema.

---

LAB 07 — Gerando OpenAPI

Gerar documentação Swagger.

Verificar

• GET

• POST

• parâmetros

• responses

Solução

Publicação da documentação automática.

---

LAB 08 — Expondo um Programa COBOL

Programa

CONSCLI

Recebe

ID

Retorna

Nome

Saldo

Cidade

Solução

Transformar em API REST.

---

LAB 09 — Testando com Postman

Executar

GET

POST

PUT

DELETE

Visualizar

Headers

Body

Status HTTP

Solução

Validar comunicação.

---

LAB 10 — Debug de JSON

Gerar erros

Campo inexistente

Formato inválido

Número onde deveria existir texto

Solução

Interpretar mensagens BAQRxxxx.

---

LAB 11 — Segurança com RACF

Criar usuário.

Criar grupo.

Configurar autenticação.

Solução

Acesso protegido.

---

LAB 12 — HTTPS e Certificados

Criar

Keyring

Certificado

Handshake TLS

Solução

API funcionando via HTTPS.

---

LAB 13 — OAuth e JWT

Adicionar autenticação.

Testar token.

Validar expiração.

Solução

API segura.

---

LAB 14 — Chamando DB2

Programa COBOL consulta DB2.

Retorna JSON.

Solução

API consultando banco de dados.

---

LAB 15 — Chamando CICS

Programa

EXEC CICS LINK

Publicar via REST.

Solução

Primeira integração CICS.

---

LAB 16 — Consumindo APIs Externas

Usar API Requester.

Consumir

• CEP

• Clima

• Cotação

Receber JSON.

Enviar ao COBOL.

Solução

COBOL consumindo REST.

---

LAB 17 — Performance

Executar

100

500

1000

5000

requisições.

Medir

CPU

Response Time

TPS

Heap Java

Solução

Descobrir gargalos.

---

LAB 18 — Monitoramento

Consultar

SMF

RMF

messages.log

trace.log

/health

/metrics

Solução

Criar dashboard.

---

LAB 19 — Tratamento de Erros

Simular

CICS indisponível

DB2 parado

MQ indisponível

Timeout

JSON inválido

Certificado expirado

Solução

Aprender troubleshooting.

---

LAB 20 — Projeto Final Enterprise

Construir uma API bancária.

Endpoints

GET /clientes

GET /clientes/{id}

POST /clientes

PUT /clientes

DELETE /clientes

GET /saldo

POST /transferencia

GET /extrato

GET /pix

GET /limite

Backend

COBOL

↓

CICS

↓

DB2

↓

z/OS Connect

↓

REST

↓

Postman

↓

Swagger

↓

OpenAPI

↓

Grafana

↓

OpenTelemetry

Solução

Projeto completo pronto para produção.

---

Desafios Extras (Modo Mestre Jedi)

• Publicar múltiplas versões da mesma API (v1 e v2).

• Implementar paginação, filtros e ordenação.

• Criar políticas de Rate Limiting e CORS.

• Integrar com IBM API Connect para gerenciamento do ciclo de vida das APIs.

• Instrumentar a aplicação com OpenTelemetry e visualizar traces em Grafana.

• Consumir a API por uma aplicação React, Angular ou Flutter.

• Configurar CI/CD com Git, Jenkins ou GitHub Actions para publicação automática.

• Criar um serviço que transforme dados EBCDIC em UTF-8.

• Implementar autenticação via JWT com RACF.

• Expor um programa COBOL que utiliza VSAM KSDS.

• Criar um API Requester para consumir um serviço de IA (LLM) e retornar a resposta para um programa COBOL.

• Desenvolver uma API que converta um Copybook COBOL em JSON e vice-versa.

• Medir throughput, latência e uso de CPU sob diferentes cargas utilizando ferramentas de benchmark.

---

Resultado Esperado

Ao concluir os 20 laboratórios, o Padawan COBOL terá desenvolvido competências para:

• Compreender profundamente a arquitetura do IBM z/OS Connect EE.

• Publicar programas COBOL, CICS, IMS e Batch como APIs REST.

• Consumir APIs externas diretamente do IBM Z.

• Trabalhar com JSON, OpenAPI e Swagger.

• Configurar Liberty Server, SSL/TLS, RACF e autenticação JWT/OAuth.

• Diagnosticar erros utilizando logs, códigos BAQR, SMF e métricas.

• Monitorar APIs com OpenTelemetry, Grafana e ferramentas de observabilidade.

• Aplicar boas práticas de performance, segurança, versionamento e governança.

• Integrar aplicações legadas com arquiteturas modernas de microserviços e agentes de IA.

• Atuar em projetos reais de modernização IBM Z utilizando COBOL sem reescrever décadas de regras de negócio.

Ao final dessa jornada, o Padawan perceberá que o IBM z/OS Connect não substitui o legado: ele o conecta ao futuro, permitindo que programas COBOL continuem sendo protagonistas na era das APIs, da nuvem híbrida e da Inteligência Artificial.