Principais Erros do CICS e Suas Possíveis Soluções
Salve jovem padawan, na aula de hoje, entre muitos abends da transação de teste no CICS de desenvolvimento, fiquei pensativo em como ajudar minha turma, deste pensamento, após um loop que quase derrubou o CICS, mapset faltante, conteiner inexistente, erro de logica na navegação. Resolvi criar um mini tour, sobre os erros mais comuns e possiveis soluções.
Introdução
O CICS (Customer Information Control System) é um monitor de transações extremamente robusto e confiável, amplamente utilizado em ambientes corporativos com mainframes IBM. No entanto, como qualquer sistema complexo, ele pode gerar mensagens de erro que desafiam até os analistas mais experientes. Muitas vezes bugs simples, que causam grande dor de cabeça ao iniciante.
Neste artigo, vamos explorar os principais erros do CICS, o que significam, e como resolvê-los de forma prática. Se você é um dos alunos da formação, ira se recordar destes erros ocorridos na aula. Nosso trabalho de Analista de Sistemas e isso, sermos os Freuds do Sistema Z, identificando os erros e corrigindo, num trabalho de idas e vindas, com muita reviravolta.
🔧 1. APCT (Program Not Found)
🛑 Erro:
DFHAP0001 CICSTRN Transaction abended with abend code APCT.
📌 Causa:
O programa especificado na transação não foi encontrado ou não foi definido no CICS (via RDO ou CSD).
✅ Soluções:
- Verifique se o programa foi definido corretamente via RDO (CEDA) ou no DFHCSD.
- Confira se o programa foi link-editado como reentrant.
- Assegure que o LOADLIB onde o programa reside esteja no DFHRPL.
🔧 2. AEI0 (Map Not Found)
🛑 Erro:
DFHAC2001 CICSTRN Transaction abended with abend code AEI0.
📌 Causa:
O mapa solicitado com o comando EXEC CICS SEND MAP não foi encontrado.
✅ Soluções:
- Verifique se o mapa foi montado e link-editado corretamente.
- Certifique-se de que o mapa está presente na biblioteca mapset associada ao CICS.
- Use o comando CEDA DISPLAY MAPSET(...) para validar se o mapset está definido no CICS.
🔧 3. AEY9 (DB2 Not Available)
🛑 Erro:
DFHAC2001 CICSTRN Transaction abended with abend code AEY9.
📌 Causa:
Erro relacionado ao DB2, geralmente porque:
- O DB2 está inativo;
- A thread não está alocada corretamente;
- A autorização RACF está faltando.
✅ Soluções:
- Verifique o status da conexão DB2/CICS com DSNC DISPLAY THREAD.
- Certifique-se de que o usuário da transação tem permissão RACF para acessar o plano do DB2.
- Verifique se o recurso está definido com o parâmetro correto no RDO (DB2ENTRY, DB2TRAN).
🔧 4. AEIP (Security Violation)
🛑 Erro:
DFHAC2001 CICSTRN Transaction abended with abend code AEIP.
📌 Causa:
Violação de segurança – usuário sem permissão para a transação, recurso, ou dataset.
✅ Soluções:
- Analise o log do RACF (SMF 80 ou comandos SEARCH CLASS(...)) para identificar a violação.
- Verifique as regras no RACF para a transação (TCICSTRN, PROGRAM, DATASET, etc).
- Utilize RACFIND ou RACROUTE para testes com permissões temporárias.
🔧 5. AEZC (Web Service Error)
🛑 Erro:
DFHAC2001 CICSTRN Transaction abended with abend code AEZC.
📌 Causa:
Erro durante invocação ou resposta de um CICS Web Service.
✅ Soluções:
- Verifique os arquivos PIPELINE e as definições de WEBSERVICE.
- Analise os logs do SIT (System Initialization Table) para mensagens associadas ao WS.
- Revise o SOAPMessage para erros de XML/SOAP malformado.
🔧 6. ASRA (Program Check - ABEND 0Cxx)
🛑 Erro:
DFHAC2206 CICSTRN Transaction abended with abend code ASRA.
📌 Causa:
Erro de execução em linguagem de programação (COBOL/PLI) – divisão por zero, index inválido, etc.
✅ Soluções:
- Execute um TRACE ou veja o auxiliary trace para identificar o ponto de falha.
- Compile com TEST ou NOSSRANGE e utilize um debugger como CEEDUMP ou CEDF.
- Avalie o uso de variáveis não inicializadas ou ponteiros incorretos.
🔧 7. AEIM (Invalid Request)
🛑 Erro:
DFHAC2001 CICSTRN Transaction abended with abend code AEIM.
📌 Causa:
Comando CICS inválido para o contexto (ex: RECEIVE fora de uma transação terminal).
✅ Soluções:
- Revise a lógica do programa. Alguns comandos devem estar dentro de contexto apropriado.
- Habilite CEDF para debug em tempo real da transação.
Extras: Outras Mensagens Comuns e Dicas
AEIO
Terminal indisponível
Use CEMT I TERM(...) para verificar o status
AEYD
Erro ao iniciar DB2
Reanalise parâmetros DB2ENTRY
AICA
Loop detectado no programa
Confirme presença de comandos EXEC CICS RETURN
ASRB
Interrupção por usuário (ex: ATTN)
Pode indicar travamento
Conclusão
Não entre em panico, os erros no CICS fazem parte do dia a dia de qualquer analista mainframe. A chave é entender o contexto do abend, dominar ferramentas como CEDF, CEEDUMP, CEDA, CEMT e manter boas práticas de logging e rastreamento.
Por isso é importante testar, fazer um check-list dos elementos a serem criados no CEDA, verificar a Instalação dos mesmo, usar o CEMT para atualizar as novas versões do executavel.
Ter muita, mas muita paciência, regados a café e no pior cenário, levante-se da cadeira, vá caminhar um pouco, relaxe e a solução surgirá na mente. Quando estiver muito difícil, consulte o manual da IBM, converse com colegas e chame o professor. Juntos iremos mais longe.
💡 Dica de ouro:
Mantenha uma tabela interna de erros recorrentes no seu ambiente, com soluções testadas e links de documentação. Isso acelera o diagnóstico e reduz o retrabalho.
