🔥 Como Criar uma Tela CICS BMS – Guia Definitivo Passo a Passo

---

☕ Introdução — Antes do HTML, existia o BMS

Antes de React, Angular e CSS, o mainframe já fazia interface rica — só que com disciplina, regra e respeito ao terminal.

No mundo CICS, tela não é arte.
Tela é contrato, estado, performance e sobrevivência em produção.

Vamos do zero absoluto até a tela rodando, sem pular etapas.

---

🧱 Conceitos Fundamentais (Sem isso, tudo quebra)

📌 O que é BMS?

BMS (Basic Mapping Support) é a linguagem declarativa usada para definir telas CICS.

Ela descreve:

• Campos

• Posições

• Atributos

• Proteção

• Entrada e saída de dados

📌 BMS não tem lógica.
Ele só descreve como a tela se comporta.

---

🧠 MAP vs MAPSET — A confusão clássica

Conceito	O que é
MAPSET	Conjunto de mapas (arquivo fonte BMS)
MAP	Uma tela individual dentro do MAPSET

📌 Analogia Bellacosa:

• MAPSET = arquivo HTML

• MAP = página individual

• FIELD = input / label

---

🧭 Passo a Passo — Criando uma Tela CICS BMS

---

1️⃣ Criar o Fonte BMS (MAPSET)

Exemplo básico:

MAPSET01 DFHMSD TYPE=MAP,MODE=INOUT,LANG=COBOL,TERM=3270

Parâmetros importantes:

• TYPE=MAP → indica que é um MAPSET

• MODE=INOUT → entrada e saída

• LANG=COBOL → gera copybook COBOL

• TERM=3270 → terminal padrão

📌 Erro comum: esquecer LANG=COBOL → não gera copybook.

---

2️⃣ Definir um MAP (Tela)

MAP01 DFHMDI SIZE=(24,80),LINE=1,COLUMN=1

O que isso faz:

• Cria uma tela de 24x80

• Posiciona no canto superior

📌 Um MAPSET pode ter vários MAPs.

---

3️⃣ Definir Campos (DFHMDF)

Exemplo:

CAMPO1 DFHMDF POS=(5,10),
       LENGTH=10,
       ATTRB=(UNPROT,IC),
       INITIAL='Digite:'

Parâmetros essenciais:

Parâmetro	Função
POS	Linha e coluna
LENGTH	Tamanho
ATTRB	Atributos
INITIAL	Texto inicial

---

🎛️ Atributos Importantes (Onde mora o poder)

Atributo	Função
PROT	Campo protegido
UNPROT	Campo editável
IC	Cursor inicial
MDT	Campo alterado
BRT	Brilho
ASKIP	Pula o campo

📌 Erro clássico: esquecer MDT → CICS acha que o campo não mudou.

---

4️⃣ Finalizar o MAPSET

DFHMSD TYPE=FINAL
END

📌 Sem isso, não compila.

---

⚙️ Workflow de Compilação (Onde muitos erram)

1️⃣ Fonte BMS
2️⃣ Assembler
3️⃣ Gera MAPSET (LOAD)
4️⃣ Gera COPYBOOK
5️⃣ COPYBOOK entra no programa COBOL
6️⃣ Programa SEND/RECEIVE MAP

📌 BMS não é compilado como COBOL.

---

🧪 Usando o MAP no Programa COBOL

Enviar a tela:

EXEC CICS SEND
     MAP('MAP01')
     MAPSET('MAPSET01')
     ERASE
END-EXEC

Receber dados:

EXEC CICS RECEIVE
     MAP('MAP01')
     MAPSET('MAPSET01')
END-EXEC

📌 O COPYBOOK gerado contém:

• campos de entrada

• campos de saída

• indicadores MDT

---

🚀 Otimização — Dicas Bellacosa de Produção

✅ Boas práticas

• Campos pequenos → menos tráfego

• Use PROT para labels

• Use UNPROT só onde necessário

• Evite mapas gigantes

• Reutilize MAPSETs

❌ Erros comuns

• Um MAP por MAPSET sem necessidade

• Tela cheia de campos UNPROT

• Esquecer MDT

• Misturar lógica com tela

• Hardcode de posição no COBOL

---

🧠 Hierarquia Mental do BMS (Grave isso)

MAPSET
 ├── MAP
 │    ├── FIELD
 │    ├── FIELD
 │    └── FIELD

📌 Se você entende isso, não se perde mais.

---

🧯 Erros Clássicos em Produção

Problema	Causa
Tela não aparece	MAPSET não instalado
Campos vazios	MDT ausente
Cursor errado	IC mal posicionado
Dump AEIM	MAP inexistente
Dados não chegam	RECEIVE errado

---

🎓 Guia de Estudo Rápido

1. Entenda MAPSET vs MAP

2. Crie tela simples

3. Compile e gere copybook

4. Faça SEND

5. Faça RECEIVE

6. Trate MDT

7. Otimize

---

💬 Comentário El Jefe Midnight Lunch

“Quem domina BMS, domina o ritmo do CICS.”

---

🏁 Conclusão Bellacosa

Tela CICS não é UI.
É contrato, estado e performance.

🔥 Quem respeita o BMS:

• evita ABEND

• entrega rápido

• sobrevive em produção

🔥 Map Programming no CICS Structure, Rules, Hierarchy & Checklist para Design de Mapas BMS

 

Programação de mapa BMS em CICS

🔥 Map Programming no CICS

Structure, Rules, Hierarchy & Checklist para Design de Mapas BMS

Workflow de compilação mapa bms cics

---

☕ Midnight Lunch, tela piscando e o mapa “quase certo”

13h42.
O programa compila.
O mapa gera.
A tela aparece… toda desalinhada.

O operador olha.
O usuário reclama.
O programador jura:

“Mas o BMS tá certo…”

Hoje vamos falar do map programming no CICS — a arte esquecida que separa interface profissional de poluição verde-fosforescente.

---

🏛️ História: antes do HTML, existia BMS

Antes de:

• HTML

• CSS

• Front-end frameworks

o CICS já tinha separação clara entre lógica e apresentação usando BMS (Basic Mapping Support).

📌 BMS é UI declarativa antes da web existir.

---

🧠 Conceito essencial (guarde isso)

Mapa não é tela.
Mapa é contrato entre usuário e programa.

Se o contrato é ruim, o sistema sofre.

---

🧩 Hierarquia de Mapas no CICS

Entender a hierarquia evita 80% dos erros.

📐 Estrutura hierárquica

MAPSET
 └── MAP
      └── FIELD

📦 MAPSET

• Conjunto lógico de mapas

• Compilado como uma única unidade

• Gera um load module

📌 MAPSET é o pacote.

---

🖥️ MAP

• Uma tela específica

• Ex: entrada, consulta, confirmação

📌 Um MAP = um propósito.

---

🔤 FIELD

• Campos de entrada ou saída

• Posicionados na tela

• Com atributos definidos

📌 Campo mal definido = bug visual.

---

🧾 Estrutura básica de um BMS Map

DFHMSD TYPE=MAP,MODE=INOUT,LANG=COBOL,STORAGE=AUTO
MAP01  DFHMDI SIZE=(24,80),LINE=1,COLUMN=1
FLD01  DFHMDF POS=(5,10),LENGTH=10,ATTRB=(UNPROT)
DFHMSD TYPE=FINAL

📌 Simples. Poderoso. Exigente.

---

📐 Regras fundamentais de Map Programming

1️⃣ Um mapa, uma função

❌ Tela “faz tudo”
✅ Tela objetiva

---

2️⃣ Campos bem definidos

• Entrada → UNPROT

• Saída → PROT

• Proteção correta evita erro de digitação

---

3️⃣ Nunca confie no input

• Sempre valide no programa

• Mapa ajuda, mas não garante

---

4️⃣ Use atributos conscientemente

• INTENS

• MDT

• IC (cursor)

• ASKIP

📌 Atributo errado confunde usuário.

---

🧠 Estrutura do Programa de Mapa (lado COBOL)

Fluxo clássico

1️⃣ RECEIVE MAP
2️⃣ Processa dados
3️⃣ Prepara saída
4️⃣ SEND MAP
5️⃣ RETURN

📌 Mapa não decide lógica. Programa decide.

---

🛠️ Passo a passo: desenhando um mapa decente

🧩 Planejamento

• O que o usuário vê?

• O que ele digita?

• Qual é o fluxo?

---

🧩 Design

• Campos alinhados

• Mensagens claras

• Uso consciente de cores

---

🧩 Implementação

• BMS limpo

• Nomes consistentes

• Sem “gambiarras visuais”

---

🧩 Teste

• Campo obrigatório

• Campo inválido

• Tela cheia

• Tela vazia

📌 Tela também precisa de teste.

---

✅ Checklist Bellacosa – antes de subir o mapa

✔ Campos protegidos corretamente
✔ Cursor posicionado logicamente
✔ Mensagens claras e humanas
✔ Nenhum campo sobreposto
✔ MAPSET organizado
✔ Nomes padronizados
✔ Layout documentado

📌 Mapa ruim vira chamado eterno.

---

⚠️ Erros clássicos (easter eggs)

🐣 Campo UNPROT que deveria ser PROT
🐣 Mensagem fixa escrita no mapa
🐣 Mapa gigante e confuso
🐣 Layout “ajustado no chute”
🐣 BMS tratado como código secundário

📌 Todo sistema feio começa assim.

---

📚 Guia de estudo para mainframers

Domine estes tópicos:

• BMS syntax

• Mapset generation

• SEND / RECEIVE MAP

• MDT, IC, ASKIP

• Pseudo-conversational design

📖 Manual essencial: CICS Basic Mapping Support Guide

---

🤓 Curiosidades de boteco mainframe

🍺 BMS já separava UI e lógica antes do MVC
🍺 Muitas telas CICS têm mais de 30 anos
🍺 Um bom mapa reduz erro humano
🍺 Operador odeia mapa mal alinhado

---

💬 Comentário El Jefe Midnight Lunch

“Código ruim quebra sistema.
Mapa ruim quebra usuário.”

---

🚀 Aplicações reais hoje

• Sistemas bancários

• Governo

• Seguradoras

• Atendimento corporativo

• Ambientes híbridos (3270 + APIs)

---

🎯 Conclusão Bellacosa

Map programming não é detalhe.
É experiência do usuário, disciplina e respeito.

Quem domina BMS:

• Recebe menos chamado

• Facilita suporte

• Cria sistemas longevos

🔥 Tela bem feita envelhece melhor que código.