Olá, amigos e leitores dessa coisa aqui!!!
Tudo bem?
Espero que sim…
Em agosto deste ano, publiquei aqui no blog a apostila COBOL do básico ao avançado, um material gratuito que preparei especialmente para pessoas cegas e usuários de leitores de tela.
Na primeira publicação, COBOL do básico ao avançado: uma apostila acessível para quem programa com leitores de tela, apresentei a proposta, a organização dos capítulos, as ferramentas utilizadas e as duas versões do material.
Algumas horas depois, publiquei também COBOL além da apostila: vídeos, exercícios e até um mainframe para continuar estudando, reunindo cursos, exercícios, vídeos, códigos-fonte e oportunidades de experimentar ambientes de mainframe.
Pois bem! A apostila continuou existindo, o COBOL continuou resistindo ao tempo e eu continuei encontrando coisas para mexer, assim como fiz com a apostila Programando para o Dosvox, aaa…
Dessa vez, entretanto, não se trata simplesmente de acrescentar conteúdo. Foi feita uma revisão técnica dos exemplos de programação e também refeita e corrigida a versão em texto linear, destinada principalmente aos usuários do DOSVOX.
A revisão técnica foi concluída em 19 de outubro de 2026, e agora quero explicar o que mudou e por que vale a pena baixar novamente o material.
Nesta publicação
- Uma revisão que foi além da aparência
- Correções nos códigos COBOL
- Compilação e testes dos exemplos
- A versão linear para DOSVOX foi refeita
- Espaços, colunas e acessibilidade
- O conteúdo da apostila continua completo
- Onde baixar as versões revisadas
- Considerações finais
Uma revisão que foi além da aparência
Uma apostila de programação tem uma responsabilidade que vai além de explicar conceitos: os exemplos precisam estar corretos.
Não adianta escrever páginas e páginas sobre uma linguagem e apresentar um código que não compila, produz um resultado incorreto ou possui uma condição capaz de deixar o programa executando indefinidamente.
Imagine alguém que está aprendendo COBOL pela primeira vez. A pessoa copia o exemplo, segue as instruções, executa o compilador e recebe uma mensagem de erro.
Naturalmente, a primeira reação pode ser pensar que digitou alguma coisa errada. Só que nem sempre o problema está em quem estuda. Às vezes, o erro está no próprio material didático.
Por isso, essa revisão concentrou-se principalmente no comportamento dos programas, nas validações, na precisão dos cálculos e na maneira como cada exemplo é apresentado e explicado.
A ideia foi manter a proposta original da apostila, mas tornar os exemplos mais confiáveis e as explicações mais precisas.
Correções nos códigos COBOL
Durante a revisão, foram encontrados alguns problemas que mereciam atenção. Alguns eram relativamente simples; outros poderiam produzir resultados errados sem que o estudante percebesse imediatamente.
Validação de entradas numéricas
Uma das correções envolveu a maneira como determinados exemplos recebiam e validavam números digitados pelo usuário.
Em COBOL, é importante distinguir um campo de texto de um campo numérico. Uma entrada recebida por ACCEPT não deve ser considerada válida apenas porque o usuário deveria ter digitado um número.
Também existem detalhes relacionados aos espaços de preenchimento, sinais e conversões.
Na revisão, foram ajustadas situações em que entradas inadequadas poderiam passar por determinadas verificações. Um exemplo envolvia valores como -5 e 105, que podiam acabar sendo interpretados incorretamente como 5.
As explicações também passaram a enfatizar a diferença entre verificar se uma entrada contém números e verificar se esses números fazem sentido para a regra do programa.
Afinal, um campo pode conter somente dígitos e, mesmo assim, representar uma idade impossível ou um valor fora dos limites permitidos.
Correções em cálculos e campos numéricos
Outro ponto importante foi o tratamento de valores monetários e saldos.
Encontrei uma situação em que o tamanho de um campo poderia provocar perda de dígitos durante determinadas operações.
Esse tipo de problema merece atenção especial numa linguagem utilizada frequentemente em sistemas financeiros e comerciais.
Em COBOL, declarar um campo com PIC 9(5)V99, por exemplo, não significa que ele possa receber qualquer resultado numérico. É preciso considerar quantos dígitos inteiros e decimais serão necessários, inclusive depois de somas, multiplicações e outras operações.
Revisei os exemplos afetados e reforçamos as explicações sobre capacidade dos campos, arredondamento e prevenção de perda de valores.
Um exemplo de SORT que precisava de correção
Também foi corrigido um exemplo relacionado à ordenação de registros com SORT.
Na versão anterior, havia um problema que impedia sua compilação como previsto.
Esse é justamente o tipo de falha que pode atrapalhar bastante quem está estudando processamento de arquivos, porque a pessoa pode entender a finalidade da instrução e, ainda assim, não conseguir executar o programa.
O exemplo foi revisto para apresentar uma estrutura adequada ao ambiente utilizado na apostila.
Correção de um possível laço infinito
Outro problema identificado envolvia uma repetição cuja condição de encerramento não estava sendo tratada corretamente.
O resultado poderia ser um programa que continuava executando sem alcançar a saída esperada.
A revisão corrigiu esse comportamento e reforçou a importância de verificar como uma variável de controle muda durante a execução de um PERFORM.
Um laço precisa ter uma condição de saída alcançável. Caso contrário, o pobre do computador fica trabalhando eternamente, provavelmente se perguntando o que fez para merecer aquilo,aaa…
Validações no cadastro de clientes
Também foram revisadas as verificações de dados relacionadas ao projeto prático de cadastro de clientes.
A intenção foi deixar mais claro que receber um valor, armazená-lo e considerá-lo válido são operações diferentes.
Essas correções ajudam a aproximar os exercícios de situações reais, nas quais um sistema precisa lidar com informações incorretas ou fora das regras estabelecidas.
Compilação e testes dos exemplos
Para essa revisão, não foram apenas lidos os programas procurando possíveis erros de sintaxe.
Os exemplos passaram por verificações técnicas utilizando o GnuCOBOL 3.1.2 em ambiente Linux.
Durante o trabalho, foram identificados 84 blocos de código, entre programas, declarações, trechos explicativos e exemplos que dependem de outras partes para funcionar.
O registro da revisão aponta 55 testes aprovados.
É importante fazer uma distinção: nem todo bloco apresentado numa apostila é um programa completo que pode ser compilado isoladamente.
Alguns mostram apenas uma declaração de variável, uma instrução, um parágrafo ou uma operação específica. Nesses casos, é necessário considerar o contexto ao qual pertencem.
A própria apostila revisada passou a deixar essa diferença mais clara, indicando quando o estudante pode copiar um programa completo e quando está diante de um trecho destinado à explicação de determinado recurso.
Naturalmente, isso não significa garantir o funcionamento de todos os exemplos em qualquer compilador ou sistema operacional. COBOL possui diferentes dialetos e particularidades, especialmente quando entramos no universo dos mainframes.
O ambiente principal adotado continua sendo o GnuCOBOL, com destaque para o formato livre.
A versão linear para DOSVOX foi refeita
Essa foi outra parte importante do trabalho.
Desde a primeira publicação, a apostila é oferecida em dois formatos: DOCX, com navegação estruturada, e TXT, preparado para leitura linear no DOSVOX.
Mas transformar um documento do Word em texto puro não significa simplesmente salvar o arquivo com outra extensão.
Uma tabela pode funcionar muito bem quando o leitor de tela permite navegar entre linhas e colunas. Entretanto, quando ela é apresentada como texto corrido, a sequência pode ficar confusa.
Imagine uma tabela com três colunas: comando, finalidade e exemplo. Se o conteúdo for extraído sem reorganização, a leitura pode misturar comandos, explicações e exemplos que pertencem a linhas diferentes.
Por isso, a versão linear foi refeita e conferida.
Tabelas explicadas por extenso
Na revisão, foram trabalhadas 17 tabelas, reorganizando seus dados para que possam ser compreendidos sequencialmente.
Em vez de depender da posição visual de cada célula, a leitura apresenta os elementos em uma ordem textual compreensível.
A versão DOCX também inclui explicações lineares para as tabelas, oferecendo uma alternativa a quem prefere acompanhar o conteúdo dessa maneira.
Blocos de código identificados
Os exemplos de programação receberam atenção especial.
Na versão TXT, os blocos possuem marcadores que ajudam o leitor a identificar onde começa e termina cada trecho.
Isso permite distinguir o código COBOL das explicações que aparecem antes ou depois dele.
Também procurou-se preservar os espaços necessários, algo particularmente importante nos exemplos que demonstram o formato fixo tradicional da linguagem.
Codificação compatível com o DOSVOX
O TXT revisado utiliza a codificação Windows-1252 e quebras de linha no padrão Windows, buscando manter a compatibilidade com os programas tradicionais de leitura e edição de texto do DOSVOX.
O material continua integral. A versão linear não é um resumo, não elimina os capítulos avançados e não substitui os programas por descrições genéricas.
É a mesma apostila, organizada para outra maneira de leitura.
Espaços, colunas e acessibilidade
Quem já programou em COBOL no formato fixo sabe que a posição de um caractere pode fazer diferença.
Existem áreas destinadas a números de sequência, indicadores e instruções, com regras específicas para determinadas colunas.
Agora imagine acompanhar tudo isso utilizando exclusivamente um sintetizador de voz.
Um espaço não anunciado, um Tab interpretado de maneira diferente ou uma instrução deslocada para a coluna errada podem transformar um exemplo aparentemente correto em uma fonte de erros.
A revisão reforçou as explicações sobre espaços, posições, colunas e utilização da tecla Tab.
Também foi dada atenção à diferença entre caracteres e bytes, especialmente quando trabalhamos com arquivos em UTF-8.
Um campo PIC X(40), por exemplo, não deve ser interpretado automaticamente como espaço para quarenta caracteres Unicode. Dependendo da codificação, determinadas letras podem ocupar mais de um byte.
Esse detalhe é importante tanto para evitar problemas de armazenamento quanto para compreender o comportamento de algumas operações com texto.
O objetivo continua sendo o mesmo da publicação original: ensinar COBOL sem exigir que o estudante enxergue a formatação do código.
O conteúdo da apostila continua completo
A revisão não transformou a apostila em outro curso, nem eliminou os assuntos mais avançados.
O material continua começando pela história da linguagem e pelos fundamentos da programação, incluindo um capítulo preparatório de lógica com exemplos em COBOL.
Depois, passa pela instalação e configuração do ambiente de desenvolvimento, utilização do GnuCOBOL, VS Code e leitores de tela.
Entre os assuntos abordados estão variáveis, operações aritméticas, decisões, repetições, tabelas com OCCURS, arquivos sequenciais e indexados, ordenação, copybooks, subprogramas, testes e tratamento de erros.
Os capítulos avançados incluem representações numéricas como COMP e COMP-3, concorrência, transações, integração com SQL, JSON, XML e C, além de uma introdução a JCL, CICS, DB2 e ao ambiente de mainframe.
Há também um projeto prático de cadastro de clientes, exercícios, respostas comentadas, glossário e orientações de acessibilidade.
Portanto, quem já estava estudando pode continuar de onde parou, mas recomendo substituir os arquivos antigos pelos revisados, especialmente para acompanhar os exemplos corrigidos.
Onde baixar as versões revisadas
A apostila continua gratuita, disponível em dois formatos.
Versão DOCX
Indicada para quem utiliza o Microsoft Word ou outro editor compatível, com leitores de tela como NVDA, JAWS e Orca.
O documento possui títulos estruturados, sumário navegável, exemplos de código e explicações textuais.
Você pode fazer download da versão Docx revisada Aqui!
Versão TXT para DOSVOX
Indicada especialmente para leitura linear, incluindo usuários do Edivox e de outros recursos de leitura de texto.
Apresenta tabelas reorganizadas por extenso, blocos de código identificados, preservação dos espaços necessários e codificação Windows-1252.
Download dessa versão Aqui!
As duas versões apresentam o conteúdo completo da apostila. A diferença principal está na organização para leitura e navegação.
Quem quiser complementar os estudos também pode consultar as duas publicações de agosto mencionadas na introdução, especialmente a segunda, que reúne vídeos, exercícios, códigos-fonte e recursos para conhecer melhor o universo dos mainframes.
Considerações finais
Uma das coisas que aprendi produzindo materiais de programação é que publicar não significa necessariamente terminar.
Mesmo depois de revisar dezenas de capítulos, sempre pode aparecer um exemplo que precisa ser melhorado, uma explicação que ficou ambígua ou algum comportamento que não foi observado durante os testes.
É por isso que considero essa revisão importante.
Não basta entregar uma apostila acessível se o estudante encontra erros que poderiam ter sido evitados. Acessibilidade também envolve oferecer informações corretas, exemplos compreensíveis e condições para que a pessoa aprenda com autonomia.
E, no caso do DOSVOX, envolve lembrar que uma leitura perfeitamente organizada visualmente pode não fazer o menor sentido quando apresentada em sequência por uma voz sintetizada.
Se você já baixou a apostila anteriormente, recomendo atualizar seus arquivos.
Se está conhecendo o material agora, seja bem-vindo ao mundo de uma linguagem que nasceu há mais de seis décadas, atravessou gerações de computadores e continua presente em sistemas importantes.
E, naturalmente, se encontrar algum erro nos exemplos, alguma dificuldade de acessibilidade ou alguma explicação que possa ser melhorada, entre em contato.
Porque a apostila pode continuar evoluindo. E o COBOL, pelo jeito, ainda vai nos dar muito trabalho,aaa…
Boa leitura, bons estudos e bons códigos!
Um abraço e… Até a próxima!
Fernando