 |
| 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.
