![]() |
| Bellacosa Mainframe e os detalhes do cics |
☕ UM CAFÉ NO BELLACOSA MAINFRAME
📜 O PAPIRO DAS MIL FACES NO CICS: CINCO CONTAINERS, DOIS PROGRAMAS E UM TESOURO QUE MUDOU DE IDENTIDADE — PUT CONTAINER, GET CONTAINER, FLENGTH, CCSID, BIT, CHAR E A CONVERSÃO SILENCIOSA NO IBM Z!
São 03h17. Um programa COBOL organiza uma transferência de R$ 1,25 bilhão em cinco containers de um mesmo channel. O CICS executa o LINK, o programa Java recebe os dados e nenhuma falha de comunicação é registrada. Entretanto, o nome do beneficiário chega com caracteres estranhos, o comprovante binário está sendo tratado como texto e um valor COMP-3 corre o risco de ser interpretado como caracteres. Uma investigação sobre o transporte de informações, a diferença entre bytes e significado, a conversão EBCDIC/UTF-8 e os perigos de um papiro que assume mil faces dependendo de quem o lê.
🎬 Prólogo — 03h17: cinco papiros atravessaram o templo, mas um deles mudou de rosto
São Paulo, 19 de novembro de 2026.
03h17.
O Banco de Mênfis acabara de modernizar a passagem de dados entre programas COBOL e Java.
No episódio anterior, duas aplicações haviam interpretado incorretamente uma COMMAREA.
O problema fora provocado por layouts incompatíveis.
Um programa esperava dezessete bytes.
Outro enviava dezenove.
A equipe decidiu avançar com uma arquitetura baseada em channels e containers.
Agora, em vez de transportar uma única estrutura monolítica, o programa emissor organizava os dados em cinco containers.
O canal recebeu o nome:
FINCHAN
Os containers foram definidos como:
FIN-HEADER
FIN-VALOR
FIN-CLIENTE
FIN-DOC
FIN-STATUS
A equipe comemorou.
— Finalmente não precisamos mais colocar tudo em uma COMMAREA!
O novo programa COBOL executou sua primeira operação importante.
R$ 1.250.000.000,00.
O CICS recebeu os containers.
O programa Java foi chamado.
O processamento terminou.
Mas o relatório de homologação apresentou uma surpresa.
O nome do beneficiário, que deveria ser:
João Gonçalves
Apareceu com caracteres incorretos.
O comprovante financeiro não podia ser interpretado corretamente.
E um diagnóstico revelou que a equipe estava considerando transportar um campo COMP-3 pelo mesmo caminho de conversão usado para textos.
O gerente perguntou:
— O tesouro foi roubado?
— Não encontramos evidência de alteração financeira.
— Então os dados se perderam?
— Ainda precisamos examinar a codificação e a representação de cada container.
— Mas o CICS não converte os dados automaticamente?
O veterano aproximou-se.
— Converte determinados dados de caracteres, quando o protocolo e as opções exigem. Não significa que qualquer sequência de bytes possa ser convertida como texto.
O gerente franziu a testa.
— O que há de errado em tratar os cinco containers da mesma forma?
O veterano retirou um papiro ilustrado.
Thoth, o deus escriba, aparecia registrando símbolos.
— Porque um papiro pode conter nomes, números, desenhos e registros. Nem todos possuem a mesma representação. O erro começa quando alguém tenta interpretar tudo como se fosse uma única inscrição.
Ele escreveu no quadro:
UM CHANNEL ORGANIZA CONTAINERS. CADA CONTAINER PRECISA DE UM CONTRATO DE DADOS.
A investigação começa.
🏺 Capítulo I — Thoth e o papiro das mil faces: quando o significado dependia de quem sabia ler
Na religião egípcia, Thoth era uma divindade associada à escrita, ao conhecimento, à contagem, à sabedoria e aos registros.
Frequentemente representado com cabeça de íbis, também podia aparecer associado ao babuíno.
Seu papel como escriba dos deuses aparece em diferentes tradições religiosas.
Na conhecida cena da pesagem do coração, Thoth registra o resultado do julgamento.
Isso combina perfeitamente com a proposta da nossa série.
A escrita preserva informações.
Mas preservar símbolos não garante que todos consigam interpretá-los corretamente.
O valor de uma inscrição
Um papiro antigo pode conter escrita hieroglífica, hierática ou demótica, dependendo do período e do contexto.
Um leitor moderno que desconheça essas convenções poderá observar apenas desenhos e marcas.
O documento permanece fisicamente presente.
O significado, entretanto, exige conhecimento do sistema de escrita.
O mesmo acontece em computadores.
Um conjunto de bytes pode representar:
Um texto codificado em EBCDIC.
Um texto codificado em UTF-8.
Um número COMP-3.
Um inteiro binário.
Um documento PDF.
Uma imagem.
Uma sequência de controle.
Os bytes não anunciam universalmente seu significado.
É o contrato de dados que determina como interpretá-los.
A metáfora do papiro
Imagine cinco papiros.
O primeiro contém o nome do faraó.
O segundo contém seu tesouro expresso numericamente.
O terceiro contém uma lista de pessoas.
O quarto apresenta uma imagem.
O quinto registra uma decisão administrativa.
Seria inadequado interpretar uma imagem como uma lista de números.
Também seria inadequado tratar um número binário como uma frase.
No CICS, temos exatamente o mesmo problema.
A integridade de uma informação depende não apenas de sua transmissão, mas também da interpretação correta de sua representação.
🏛️ Capítulo II — Channel: o corredor que reúne cinco câmaras
No CICS Transaction Server, um channel reúne containers nomeados.
Um container é uma unidade de dados.
O channel oferece uma maneira de transportar essas unidades entre programas e determinados fluxos de execução.
A IBM descreve o channel como um conjunto de containers, com função semelhante à de uma lista de parâmetros.
Nosso canal financeiro
Criamos:
FINCHAN
Dentro dele colocamos cinco containers.
| Container | Conteúdo | Representação planejada |
|---|---|---|
| FIN-HEADER | Versão e identificador | CHAR |
| FIN-VALOR | Valor COMP-3 versionado | BIT |
| FIN-CLIENTE | Nome do beneficiário | CHAR |
| FIN-DOC | Documento binário | BIT |
| FIN-STATUS | Situação da operação | CHAR |
Essa divisão é um projeto didático.
Não existe uma regra universal segundo a qual todo programa financeiro deva usar exatamente esses cinco containers.
O que muda em relação à COMMAREA?
Na COMMAREA tradicional, uma única estrutura poderia reunir todos os campos em posições físicas conhecidas.
Uma mudança no tamanho de um campo poderia deslocar os seguintes.
Com containers, é possível separar unidades independentes de informação.
Isso oferece maior flexibilidade para evoluir determinados contratos.
Mas atenção!
Se FIN-VALOR contém uma estrutura COMP-3, o consumidor precisa conhecer a definição desse container.
O problema de layout não desaparece.
Ele fica localizado dentro de uma unidade menor.
Os nomes importam
Um programa pode procurar:
FIN-CLIENTE
Enquanto outro escreveu:
FIN-CLIENTES
São identificadores diferentes.
O CICS não precisa presumir que ambos representam a mesma unidade.
Portanto, é necessário definir nomes estáveis e tratar explicitamente a ausência de containers esperados.
O mesmo cuidado vale para versões.
Uma interface pode utilizar FIN-VALOR-V2, por exemplo, desde que isso faça parte de uma política de compatibilidade definida.
Channel organiza. Container transporta. Contrato interpreta.
📦 Capítulo III — PUT CONTAINER: quando o escriba deposita um papiro no cofre
O primeiro comando fundamental é:
EXEC CICS PUT CONTAINER
Ele permite colocar dados em um container pertencente a um channel.
Um exemplo didático:
EXEC CICS PUT CONTAINER('FIN-HEADER')
CHANNEL('FINCHAN')
FROM(WS-FIN-HEADER)
FLENGTH(LENGTH OF WS-FIN-HEADER)
DATATYPE(DFHVALUE(CHAR))
RESP(WS-RESP)
END-EXECAqui declaramos que o conteúdo é texto.
O comando pode criar um container ou atualizar o conteúdo de um container existente, segundo as opções e a versão do CICS.
Uma curiosidade perigosa
O DATATYPE do container é estabelecido quando ele é criado.
Não devemos imaginar que escrever novamente em um container existente, desta vez especificando BIT ou CHAR, sempre transformará sua natureza.
A IBM esclarece que o tipo do container existente não é redefinido por uma nova operação PUT.
Isso cria uma armadilha.
Se um programa criou FIN-VALOR como CHAR, outro não deveria presumir que poderá simplesmente convertê-lo em BIT ao reescrever os dados com uma opção diferente.
A estratégia correta precisa respeitar o ciclo de vida do container e seu contrato.
Outra armadilha: sobrescrever dados
Em geral, escrever novamente no mesmo container substitui o conteúdo anterior, salvo opções específicas suportadas para outros comportamentos.
Portanto, repetir um PUT não deve ser confundido com acrescentar automaticamente uma nova transação a uma fila.
Channels não são, por si só, filas de mensageria persistente.
E containers comuns de channel não oferecem automaticamente as mesmas garantias transacionais de IBM MQ ou do banco de dados.
O que devemos validar?
Se o channel é o correto.
Se o nome do container corresponde ao contrato.
Se o DATATYPE está correto.
Se a área FROM contém dados válidos.
Se FLENGTH corresponde ao comprimento real.
E se a operação terminou com uma condição de retorno apropriada.
📥 Capítulo IV — GET CONTAINER: quando o receptor precisa saber qual papiro está abrindo
O segundo comando é:
EXEC CICS GET CONTAINER
Ele permite recuperar o conteúdo de determinado container.
Exemplo conceitual:
EXEC CICS GET CONTAINER('FIN-HEADER')
CHANNEL('FINCHAN')
INTO(WS-FIN-HEADER)
FLENGTH(WS-TAMANHO)
RESP(WS-RESP)
END-EXECA variável WS-TAMANHO deve possuir definição compatível com o formato esperado pelo comando.
No caso de GET com INTO, FLENGTH participa da informação sobre a capacidade de recebimento e retorna o comprimento efetivo do conteúdo recuperado.
Se houver conversão de caracteres, o comprimento retornado pode refletir o tamanho depois da conversão.
O risco de receber dados grandes demais
Imagine que o container FIN-CLIENTE contenha uma descrição de 300 bytes.
O programa receptor oferece uma área de somente 80 bytes.
É necessário tratar a condição de comprimento.
Não se deve presumir que todo GET colocará qualquer conteúdo em uma área insuficiente de maneira segura e adequada à aplicação.
A alternativa NODATA
O CICS fornece uma opção especialmente útil:
NODATA
Ela permite descobrir o comprimento de um container sem recuperar seu conteúdo naquele momento.
O receptor pode utilizar essa informação para planejar a leitura.
Entretanto, se houver conversão de caracteres, o tamanho na codificação de destino pode ser diferente.
Por isso, a consulta precisa considerar o CCSID pretendido.
O perigo do comprimento correto
Mesmo que o container possua exatamente oito bytes, isso não prova que ele contenha um valor COMP-3 válido.
Poderá conter oito bytes de outro formato.
O programa deve interpretar a representação conforme o contrato e validar o valor.
É a mesma lição da COMMAREA, agora aplicada a containers independentes.
🧭 O mapa do tesouro — um Channel, cinco Containers
<box border radius="xl" padding={3} gap={3}> <text color="secondary" weight="medium" size="xs">ARQUITETURA DIDÁTICA • FINCHAN</text> <box background="surface-secondary" radius="lg" padding={3} align="center" gap={1}> <icon name="server" size="lg"/> **COBOL — Programa emissor** <text size="xs" color="secondary">PUT CONTAINER</text> </box> <row justify="center"><icon name="arrow-down" color="secondary"/></row> <box border={{size:2,color:"strong"}} radius="lg" padding={3} gap={3}> <row align="center" justify="center" gap={2}> <icon name="boxes" size="lg"/> **CHANNEL FINCHAN** </row> <grid columns={2} gap={2}> {#each [{n:"FIN-HEADER",t:"CHAR",d:"Versão e identificação"},{n:"FIN-VALOR",t:"BIT",d:"Packed decimal COMP-3"},{n:"FIN-CLIENTE",t:"CHAR",d:"Nome em caracteres"},{n:"FIN-DOC",t:"BIT",d:"Documento binário"},{n:"FIN-STATUS",t:"CHAR",d:"Situação da transação"}] as c} <grid-item> <box background="surface-secondary" radius="md" padding={2} gap={1}> <row align="center" justify="between" wrap="wrap"> <text size="xs" weight="medium">{c.n}</text> <text size="3xs" color="secondary">{c.t}</text> </row> <text size="xs" color="secondary">{c.d}</text> </box> </grid-item> {/each} </grid> </box> <row justify="center"><icon name="arrow-down" color="secondary"/></row> <box background="surface-secondary" radius="lg" padding={3} align="center" gap={1}> <icon name="coffee" size="lg"/> **Java — Programa receptor** <text color="secondary" size="xs">GET CONTAINER / API JCICS</text> </box> <caption>O fluxo apenas transporta dados. Cada container precisa ser identificado, validado e interpretado conforme a sua representação.</caption> </box>
<WritingBlock id="76432" variant="document">## 🔤 Capítulo V — CCSID: a pedra de Roseta dos caracteres
Agora chegamos ao verdadeiro coração do incidente.
CCSID significa Coded Character Set Identifier.
Esse identificador informa uma codificação de caracteres reconhecida pelo ambiente.
Em sistemas IBM Z, é comum encontrar dados textuais em codificações EBCDIC.
Em sistemas Java e interfaces modernas, UTF-8 é frequentemente utilizado para representar texto em arquivos e protocolos, embora as strings Java sejam uma abstração de caracteres e não simplesmente um conjunto de bytes UTF-8.
Por que isso importa?
Imagine a palavra:
JOÃO
Em uma determinada codificação EBCDIC, ela possui uma representação em bytes.
Em UTF-8, possui outra.
Um consumidor que interprete bytes EBCDIC diretamente como UTF-8 poderá produzir caracteres incorretos ou falhas de decodificação.
O dado foi transportado.
Mas sua interpretação foi inadequada.
O papel de FROMCCSID
No PUT CONTAINER, FROMCCSID permite indicar o CCSID dos dados de caracteres enviados.
A documentação IBM também oferece FROMCODEPAGE para determinadas formas de identificação de página de códigos.
Quando FROMCCSID ou FROMCODEPAGE é especificado, o container é tratado como CHAR.
O papel de INTOCCSID
No GET CONTAINER, INTOCCSID permite solicitar a recuperação dos dados de caracteres em determinada codificação.
O CICS poderá executar a conversão apropriada, se ela for suportada e necessária.
Quando a opção não é especificada, o CCSID local da região participa do comportamento padrão.
Um exemplo
O container FIN-CLIENTE guarda o nome de um beneficiário.
O programa COBOL produz texto em uma codificação EBCDIC suportada.
O programa Java precisa receber uma string correspondente aos caracteres originais.
Se a interface usar corretamente o DATATYPE CHAR e a conversão aplicável, o processo poderá preservar o texto.
O problema do CCSID incorreto
Imagine declarar que os bytes já estão em UTF-8 quando, na realidade, foram produzidos em EBCDIC.
Nesse caso, o sistema recebe uma indicação falsa sobre a origem dos dados.
Mesmo que exista um mecanismo automático de conversão, ele não consegue adivinhar com segurança a codificação correta quando a informação fornecida está errada.
O que precisamos documentar?
A codificação de origem.
A codificação de destino.
Os caracteres permitidos.
O comportamento esperado para caracteres não representáveis.
O tratamento de erros de conversão.
E os testes com acentos, pontuação e caracteres não ASCII.
A pedra de Roseta não era mágica.
Ela fornecia informações que permitiam relacionar sistemas de escrita.
No CICS, o CCSID desempenha uma função técnica semelhante dentro da nossa metáfora.
Para converter corretamente um texto, precisamos saber como seus caracteres foram codificados.
🐍 Capítulo VI — CHAR versus BIT: a maldição que pode destruir o tesouro
O DBA apresenta duas palavras.
CHAR
BIT
Elas parecem simples.
Mas representam uma decisão fundamental.
CHAR: dados de caracteres
Quando um container possui DATATYPE CHAR, seus dados estão sujeitos aos mecanismos de conversão de caracteres aplicáveis.
Isso é apropriado para conteúdo genuinamente textual.
Exemplos:
Nome do cliente.
Descrição de uma operação.
Mensagem textual.
Código alfanumérico definido por um contrato de caracteres.
BIT: dados binários
Quando um container possui DATATYPE BIT, seus bytes não são convertidos pelo mecanismo de conversão de caracteres do CICS.
Isso é adequado para dados que devem preservar exatamente sua representação binária.
Exemplos:
Campos COMP-3.
Inteiros binários armazenados em formato específico.
Documentos PDF.
Imagens.
Blocos binários definidos por contrato.
A maldição do COMP-3
Imagine um campo COBOL:
05 FIN-VALOR
PIC S9(12)V99 COMP-3.Esse campo possui oito bytes em packed decimal.
Não é uma string de oito caracteres.
Contém nibbles que representam dígitos decimais e sinal.
Se ele for colocado em um container CHAR e submetido a uma conversão de caracteres incompatível, os bytes podem ser transformados como se representassem texto.
O resultado não terá necessariamente o mesmo significado numérico.
O perigo da conversão silenciosa
Não devemos afirmar que toda conversão incorreta ocorrerá sem emitir erro.
O CICS pode sinalizar condições como CCSIDERR, CODEPAGEERR e outros erros pertinentes.
Entretanto, também existem situações em que uma representação incorreta pode atravessar uma interface sem que a aplicação detecte a divergência semântica.
É por isso que precisamos validar o resultado final.
A regra fundamental
Dados de texto podem exigir conversão de caracteres. Dados binários não devem ser submetidos indiscriminadamente a essa conversão.
Uma estrutura que mistura campos textuais e COMP-3 não deve ser colocada inteira em um container CHAR com a expectativa de que o CICS descubra quais bytes precisam ser convertidos.
O mecanismo trata o conteúdo CHAR como dados de caracteres.
Ele não interpreta automaticamente um copybook COBOL para converter somente os campos textuais.
🏺 Capítulo VII — O container de cinco rostos: cada peça exige uma regra diferente
Vamos voltar aos cinco containers.
FIN-HEADER — A identidade da transação
Contém identificador e versão.
Pode ser representado como texto, desde que o contrato defina claramente sua codificação e seu formato.
Por exemplo:
V02|FIN-990217
A separação por delimitadores é apenas ilustrativa.
Uma implementação real deverá considerar escapes, comprimento e formatos definidos.
FIN-VALOR — O tesouro monetário
Contém um valor financeiro.
Se utilizar COMP-3, pode ser transportado como BIT, acompanhado de um contrato que defina precisão, escala, sinal e tamanho.
Uma alternativa seria representar o valor em um formato textual decimal explicitamente padronizado.
Nesse caso, a transformação deve ser feita pela aplicação, com validação numérica apropriada.
Os dois projetos são possíveis.
Não são intercambiáveis sem conversão.
FIN-CLIENTE — O nome que precisa continuar legível
Contém:
JOÃO GONÇALVES
É um candidato apropriado ao uso de CHAR.
O CCSID precisa corresponder à representação real.
O teste deve verificar os caracteres após a conversão e não apenas a ausência de erro técnico.
FIN-DOC — O documento que não pode ser traduzido como texto
Contém um comprovante binário.
Pode ser um PDF, por exemplo.
Seu conteúdo precisa permanecer binariamente íntegro durante o transporte.
Neste projeto, BIT é a escolha apropriada.
Se a aplicação alterar seus bytes indiscriminadamente, poderá tornar o documento inválido.
FIN-STATUS — O estado da operação
Contém um código ou uma descrição textual.
Por exemplo:
PENDING
APPROVED
REJECTED
O contrato precisa definir valores permitidos e seus significados.
Não basta converter os caracteres corretamente.
O programa também precisa interpretar corretamente a regra de negócio.
A conclusão
Cinco containers.
Cinco responsabilidades.
Duas categorias fundamentais de representação.
E uma exigência comum:
Cada conteúdo deve chegar ao consumidor com o significado preservado.
📏 Capítulo VIII — FLENGTH: quando o comprimento muda sem que ninguém altere o texto
O gerente encontra uma nova discrepância.
O nome do cliente foi transmitido corretamente.
Mas o comprimento em bytes mudou.
Como isso é possível?
Porque caracteres não ocupam necessariamente a mesma quantidade de bytes em todas as codificações.
Um exemplo simples
Considere:
JOÃO
Em uma codificação EBCDIC de byte único que represente esses caracteres, o texto pode ocupar quatro bytes.
Em UTF-8, o caractere à — ou o caractere acentuado correspondente, dependendo do texto efetivo — pode exigir mais de um byte.
No nome JOÃO, o caractere à ocupa dois bytes em UTF-8.
Assim, a sequência de quatro caracteres pode ocupar cinco bytes em UTF-8.
O texto não ganhou uma nova letra.
Mudou a codificação.
O papel de FLENGTH no PUT
Em PUT CONTAINER, FLENGTH indica o comprimento, em bytes, dos dados da área de origem.
Não deve ser interpretado simplesmente como quantidade de caracteres visíveis.
O papel de FLENGTH no GET
Em GET CONTAINER com INTO, o campo FLENGTH pode ser utilizado no controle do comprimento da área de destino e, na conclusão, informa o comprimento efetivamente retornado.
Se houver conversão, o comprimento depois da conversão pode ser diferente do original.
A consulta com NODATA
O CICS permite solicitar informações de comprimento sem copiar o conteúdo, utilizando NODATA.
Quando se pretende converter para um CCSID diferente, é importante especificar a codificação de destino também nessa consulta, para que o comprimento retornado corresponda aos dados convertidos.
O erro clássico
O programador descobre que o texto tem vinte caracteres.
Reserva vinte bytes.
Mas a codificação de destino exige mais bytes.
O resultado pode ser uma área insuficiente.
A lição
Comprimento em caracteres não é necessariamente comprimento em bytes.
Isso vale para UTF-8, para diversas codificações multibyte e para interfaces de integração que atravessam plataformas.
<WritingBlock id="76433" variant="document">## ☕ Capítulo IX — Java entra na tumba: strings, byte arrays e a API JCICS
O Banco de Mênfis possui um programa Java executado dentro do ambiente CICS.
A equipe utiliza a API JCICS para trabalhar com channels e containers.
É importante distinguir esse cenário de um serviço Java externo que se comunica por HTTP, MQ ou outra integração.
A API JCICS oferece objetos e métodos próprios para aplicações Java executadas sob CICS.
Strings Java
Uma string Java representa texto.
Quando esse texto é colocado em um container de caracteres por meio das interfaces apropriadas, o CICS pode realizar a conversão necessária.
Isso facilita a comunicação com programas COBOL que utilizam dados textuais em codificações suportadas.
Byte arrays
Um array byte[] representa uma sequência de bytes.
É adequado para transportar dados binários quando a interface e o container são utilizados de forma apropriada.
A documentação IBM diferencia explicitamente o tratamento de strings e dados binários na API de channels e containers.
O problema do BigDecimal
Imagine que o Java receba os oito bytes do campo COMP-3.
Não pode simplesmente executar uma conversão textual e esperar que o valor monetário apareça como uma representação decimal legível.
Packed decimal exige decodificação numérica específica.
A interpretação precisa conhecer:
A quantidade de dígitos.
A escala decimal.
O tratamento do sinal.
A validade da sequência.
E os limites de capacidade.
Depois dessa interpretação, a aplicação poderá representar o valor com um tipo decimal adequado, como BigDecimal, respeitando o contrato.
Uma alternativa arquitetural
O sistema também poderia transportar o valor monetário como texto decimal padronizado.
Por exemplo:
1250000000.00
Nesse caso, a aplicação COBOL teria de produzir essa representação corretamente.
O container poderia ser CHAR.
O Java precisaria interpretar a sequência como número decimal segundo um formato acordado.
A representação textual deve evitar ambiguidades de separador decimal, agrupamento e sinal.
Não é correto utilizar vírgulas e pontos conforme a configuração regional sem definir uma convenção de intercâmbio.
Qual das duas é melhor?
Depende dos requisitos.
Packed decimal em BIT pode preservar um formato legado com eficiência, mas obriga o consumidor a conhecer sua representação.
Texto decimal em CHAR pode oferecer maior interoperabilidade, mas exige conversão explícita e validação.
Uma representação de mensagem padronizada, com esquema, também pode ser considerada.
O essencial é manter o contrato explícito.
🕵️ Capítulo X — O erro que passou despercebido: o mesmo nome, duas codificações
O DBA apresenta as evidências da investigação fictícia.
O container FIN-CLIENTE havia sido criado como CHAR.
O programa emissor forneceu bytes textuais cuja codificação real não correspondia à indicação utilizada pela interface.
O Java recebeu o conteúdo.
Nenhum mecanismo poderia garantir a recuperação automática do significado correto a partir de uma identificação de codificação falsa.
O nome chegou incorreto.
Outro teste revelou que a equipe planejava transportar o comprovante PDF em um container de caracteres.
O documento ainda não havia sido alterado em produção, mas o desenho técnico apresentava risco.
Finalmente, o container FIN-VALOR utilizava uma estrutura COMP-3.
Esse conteúdo precisava de um contrato binário apropriado, e não de uma conversão genérica de caracteres.
A diferença entre três problemas
Problema de codificação: os bytes textuais são interpretados segundo o CCSID errado.
Problema de representação: bytes de um valor numérico são tratados como texto.
Problema de contrato: emissor e receptor discordam sobre os campos, versões ou significados.
Eles podem produzir sintomas semelhantes.
Mas exigem diagnósticos diferentes.
Por que o CICS não resolveu sozinho?
Porque o CICS oferece serviços de transporte e conversão dentro das regras configuradas.
Ele não conhece automaticamente a definição empresarial de cada campo.
Não sabe se um PDF deveria conter determinado texto.
Não decide se um valor monetário representa reais, dólares ou centavos.
Não conhece por si só o layout COMP-3 específico que uma aplicação criou.
Essas responsabilidades pertencem aos contratos e às aplicações.
🧪 Capítulo XI — Laboratório Bellacosa: testes para os cinco containers
Vamos construir um roteiro seguro de homologação.
O canal é:
FINCHAN
Os cinco containers possuem contratos definidos.
Teste 1 — Identificador e versão
Envie FIN-HEADER com um identificador conhecido.
Verifique se o Java recupera exatamente os caracteres esperados.
Confirme a versão.
Teste 2 — Valor monetário
Envie FIN-VALOR contendo um valor COMP-3 de oito bytes, dentro da capacidade definida.
Use BIT.
Valide os bytes recebidos e a interpretação numérica realizada pelo consumidor.
A operação de R$ 1,25 bilhão deve resultar exatamente no valor pretendido.
Teste 3 — Nome acentuado
Envie FIN-CLIENTE contendo:
JOÃO GONÇALVES
Verifique o CCSID declarado.
Confirme o nome após a conversão.
Não considere o teste aprovado apenas porque o container foi recebido.
Teste 4 — Documento binário
Envie FIN-DOC com um arquivo de teste, sem dados sensíveis.
Use BIT.
Compare o tamanho e um hash criptográfico adequado do conteúdo antes e depois do transporte.
Isso ajuda a identificar alterações inesperadas nos bytes.
Teste 5 — Status financeiro
Envie FIN-STATUS com um código reconhecido.
Teste também um código desconhecido.
O receptor deve rejeitar ou tratar explicitamente valores que não fazem parte do contrato.
Teste 6 — Container ausente
Não crie FIN-VALOR.
Verifique se o programa receptor detecta e trata a ausência, sem assumir valor zero.
Teste 7 — Comprimento inadequado
Envie um conteúdo diferente do tamanho exigido para a estrutura binária.
O receptor deve rejeitar a representação incompatível.
Teste 8 — CCSID incorreto
Em laboratório controlado, informe uma codificação que não corresponde aos bytes textuais reais.
Observe o comportamento.
O resultado pode variar conforme a conversão e os caracteres envolvidos.
Teste 9 — Reutilização do nome
Tente gravar conteúdos diferentes no mesmo container.
Valide o comportamento de substituição e as regras relativas ao DATATYPE já estabelecido.
Teste 10 — Carga e concorrência
Execute testes com várias tarefas e operações.
Confirme que os canais e containers são utilizados conforme seus escopos e que a aplicação não confunde dados de transações diferentes.
O que medir?
Comprimentos.
Codificações.
Identificadores.
Status.
Valores financeiros.
Integridade binária.
Condições de retorno.
Tempo de processamento.
O laboratório não deve validar apenas que todos os comandos foram executados.
Ele precisa demonstrar que o conteúdo recebido preservou o significado esperado.
🥚 Capítulo XII — Dez maldições do papiro das mil faces
Primeira maldição — A conversão que ninguém solicitou. Um container CHAR pode participar de conversão de caracteres, produzindo resultados inadequados quando o conteúdo foi classificado incorretamente.
Segunda maldição — O binário tratado como texto. COMP-3 e documentos PDF não devem ser submetidos a conversões genéricas de caracteres.
Terceira maldição — O CCSID falso. Declarar uma codificação diferente da real compromete a interpretação.
Quarta maldição — O comprimento antes e depois da conversão. Uma string pode ocupar quantidades diferentes de bytes nas codificações de origem e destino.
Quinta maldição — O container sobrescrito. Uma segunda escrita pode substituir o conteúdo anterior, conforme o comando e suas opções.
Sexta maldição — O nome diferente. FIN-CLIENTE e FIN-CLIENTES são contratos distintos quando usados como nomes de containers.
Sétima maldição — A versão esquecida. Um container pode transportar dados corretos para um contrato antigo e incorretos para um consumidor novo.
Oitava maldição — O Java que recebe bytes, mas espera uma string. O método utilizado precisa corresponder à natureza da informação.
Nona maldição — A falsa persistência. Containers de channel comuns não substituem automaticamente arquivos, bancos de dados ou mensageria recuperável.
Décima maldição — O sucesso técnico sem validação empresarial. Um LINK concluído não comprova que o valor de R$ 1,25 bilhão foi interpretado corretamente.
⚖️ Capítulo XIII — O julgamento de Thoth: quem mudou o rosto do tesouro?
O tribunal se reúne.
O especialista COBOL apresenta as estruturas originais.
O administrador CICS demonstra os comandos PUT e GET.
O desenvolvedor Java apresenta os métodos da API JCICS.
O responsável financeiro confirma o valor esperado.
O especialista de integração mostra os resultados de conversão.
Finalmente, a equipe identifica três falhas de projeto.
A primeira estava na indicação incorreta de codificação do texto.
A segunda estava na tentativa de tratar uma representação binária como caracteres.
A terceira estava na ausência de um contrato rigoroso para todos os containers.
A correção
FIN-HEADER passou a possuir um formato textual versionado.
FIN-VALOR recebeu uma representação financeira explicitamente definida e testada.
FIN-CLIENTE passou a utilizar a codificação declarada e validada.
FIN-DOC foi mantido como conteúdo binário.
FIN-STATUS passou a validar os códigos permitidos.
A equipe documentou os nomes, tamanhos, versões e tipos.
Os testes COBOL/Java foram ampliados.
E o processamento passou a confrontar os valores financeiros recebidos com os dados esperados do fluxo.
O veredito
O gerente pergunta:
— Então a culpa era dos containers?
O veterano responde:
— Não. Eles fizeram o trabalho para o qual foram concebidos. O problema estava na maneira como a aplicação descreveu e interpretou o conteúdo.
— Então o channel não garante a integridade de tudo?
— Ele oferece mecanismos de organização, transferência e conversão apropriados. A integridade empresarial depende também das regras aplicadas pelos participantes.
— E os cinco papiros?
— Cada um agora possui seu próprio contrato.
O gerente sorri.
— Finalmente o tesouro chegou ao destino certo?
— No nosso teste, sim. O valor foi interpretado corretamente, o nome foi preservado, o documento permaneceu íntegro e o status correspondeu ao processo.
☕ Epílogo — 03h17: o papiro recuperou seu verdadeiro rosto
O Banco de Mênfis conclui a homologação.
O COBOL envia os cinco containers.
O CICS executa o LINK.
O Java recebe os dados.
O nome do beneficiário aparece corretamente.
O documento binário conserva seus bytes.
O valor financeiro é interpretado segundo o contrato aprovado.
A transação fictícia de R$ 1,25 bilhão passa na conciliação do laboratório.
O gerente observa a imagem de Thoth.
— Afinal, qual era o segredo dos papiros?
O veterano responde:
— O escriba não precisava apenas preservar os símbolos. Era necessário preservar também as regras que permitiam compreendê-los.
— E isso vale para o CICS?
— Especialmente para o CICS.
— Por quê?
— Porque os dados podem atravessar programas COBOL, Java, APIs e outros ambientes. Cada fronteira precisa respeitar a representação e o significado da informação.
O veterano encerra a sessão.
No monitor aparece:
FINCHAN — CONTRACT VALIDATION PASSED
O relógio marca 03h17.
E ele escreve a conclusão:
O problema mais perigoso de uma integração não é quando os sistemas deixam de conversar. É quando continuam conversando, mas passam a atribuir significados diferentes aos mesmos dados.
🏺 A última lição do Mestre Jedi do Mainframe
Channels agrupam containers.
PUT CONTAINER grava os dados.
GET CONTAINER recupera os dados.
FLENGTH representa comprimentos em bytes envolvidos nessas operações.
CCSID identifica codificações de caracteres.
CHAR permite a conversão de caracteres segundo regras aplicáveis.
BIT preserva dados binários sem essa conversão.
A API JCICS permite que programas Java utilizem channels e containers no ambiente CICS.
Mas nenhuma dessas tecnologias elimina a necessidade de contratos de dados claros, versionados e validados.
Porque, no Papiro das Mil Faces, cada tesouro possuía sua própria linguagem. E somente aquele que respeitava a linguagem dos dados conseguia atravessar o templo sem transformá-los em outra coisa.
☕ Bellacosa Mainframe — Onde Thoth documenta os formatos, Tutancâmon protege o tesouro, Anúbis vigia os canais, Java conversa com COBOL e o CICS ensina que transportar bytes não é a mesma coisa que preservar significados.
📚 Referências técnicas oficiais IBM
A documentação IBM confirma as regras fundamentais deste episódio:
Channels and Containers — como os containers são agrupados, transmitidos e disponibilizados entre programas.
IBMEXEC CICS PUT CONTAINER — DATATYPE CHAR/BIT, FROMCCSID e FLENGTH.
IBMEXEC CICS GET CONTAINER — INTOCCSID, FLENGTH, NODATA e conversão.
IBMJava JCICS — Channel and Container Examples — diferenças entre strings e arrays de bytes.
IBMConversion CCSIDs for CICS TS — conversões de codificação suportadas.
IBMIBM Redbooks — Using CICS TS Channels and Containers — aprofundamento arquitetural e exemplos práticos.
IBM Redbooks





Sem comentários:
Enviar um comentário