 |
| Bellacosa Mainframe e o max-cc conditional code |
☕🔥 MAXCC — O “HUMOR” DO JOB NO z/OS
Quando o Mainframe Diz:
“SEU JOB TERMINOU… MAS EU TENHO ALGO A DIZER.”
Se existe uma coisa que TODO Junior Padawan COBOL precisa aprender cedo…
é que no z/OS:
nem todo fim de job é igual.
Às vezes o JOB termina:
✅ normalmente
⚠️ com avisos
🔥 com erros graves
☠️ completamente destruído
E quem conta essa história é o:
🚨 MAXCC
☕ O QUE É MAXCC?
MAXCC significa:
MAXIMUM CONDITION CODE
É o maior retorno gerado pelos steps do JOB.
🔥 A FILOSOFIA DO MAXCC
No z/OS:
programas “conversam” com o scheduler usando códigos numéricos.
Exemplo:
RETURN-CODE = 0
significa:
“Tudo OK.”
Mas:
RETURN-CODE = 16
significa:
“O APOCALIPSE CHEGOU.”
☕ O MAXCC MAIS FAMOSO
No SDSF/JESMSGLG:
MAXCC=0000
ou:
COND CODE 0004
🔥 O SEGREDO
MAXCC NÃO É ABEND.
Isso é MUITO importante.
☕ ABEND
Falha anormal.
Exemplo:
S0C7
S0C4
S806
☕ MAXCC
Programa terminou normalmente…
MAS quer avisar algo.
🔥 MAXCC 00 — O “MUNDO EM PAZ”
✅ MAXCC=0000
Significa:
tudo terminou perfeitamente.
☕ EXEMPLO
IEF142I STEP01 - STEP WAS EXECUTED - COND CODE 0000
🔥 INTERPRETAÇÃO BELLACOSA
O mainframe está dizendo:
☕ “Excelente, Padawan. Nada explodiu hoje.”
☕ CENÁRIO TÍPICO
arquivo processado
SORT OK
DB2 OK
nenhum warning
tudo consistente
🔥 MAXCC 04 — O “WARNING ELEGANTE”
⚠️ MAXCC=0004
O JOB terminou.
Mas:
algo merece atenção.
☕ O MAIS IMPORTANTE
MAXCC 4 normalmente NÃO é erro fatal.
Muitos jobs em produção aceitam:
RC=4 normalmente.
🔥 EXEMPLOS CLÁSSICOS
☕ SORT
SORT FIELDS=COPY
Mas:
registro inválido ignorado
campo truncado
duplicidade encontrada
Resultado:
RC=4
☕ IDCAMS
DELETE DATASET
Dataset não existe.
IDCAMS retorna:
4
Porque:
“não achei, mas sobrevivi.”
☕ IEBCOPY
Membro duplicado.
Warning.
RC=4.
🔥 INTERPRETAÇÃO BELLACOSA
☕ “Nada morreu… mas eu notei uma coisa estranha.”
🔥 MAXCC 08 — O “ERRO OPERACIONAL”
❌ MAXCC=0008
Agora a conversa ficou séria.
☕ SIGNIFICADO
o processamento falhou parcialmente.
🔥 MUITOS JOBS PARAM EM RC=8
Schedulers frequentemente tratam:
RC >= 8
como falha.
☕ EXEMPLOS CLÁSSICOS
☕ SORT
Campo inválido.
Chave inconsistente.
Arquivo problemático.
☕ IDCAMS
Falha em DEFINE CLUSTER.
☕ DB2
SQLCODE sério.
☕ COBOL
Programa detecta erro de negócio:
MOVE 8 TO RETURN-CODE
STOP RUN
🔥 INTERPRETAÇÃO BELLACOSA
☕ “Padawan… algo deu errado e você PRECISA olhar.”
🔥 MAXCC 12 — O “DESASTRE CONTROLADO”
☠️ MAXCC=0012
Agora entramos na zona crítica.
☕ SIGNIFICADO
Erro grave.
Processamento comprometido.
🔥 EXEMPLOS CLÁSSICOS
falha forte em SORT
utility quebrada
VSAM inconsistente
falha DB2 importante
step inutilizado
☕ O JOB AINDA TERMINOU
Isso diferencia de ABEND.
O programa conseguiu:
terminar conscientemente.
Mas avisando:
“o resultado NÃO é confiável.”
🔥 EXEMPLO COBOL
IF WS-ERRO-CRITICO = 'S'
MOVE 12 TO RETURN-CODE
STOP RUN
END-IF
🔥 INTERPRETAÇÃO BELLACOSA
☕ “O castelo ainda está de pé… mas está pegando fogo.”
🔥 MAXCC 16 — O “JUÍZO FINAL”
🚨 MAXCC=0016
Aqui o sistema está praticamente gritando.
☕ SIGNIFICADO
falha gravíssima.
🔥 MUITOS PRODUTOS TRATAM 16 COMO FATAL
Especialmente:
DFSORT
IDCAMS
DB2 utilities
IEBCOPY
custom utilities
☕ EXEMPLOS CLÁSSICOS
arquivo inacessível
utility impossível de executar
parâmetro inválido
corrupção
inconsistência crítica
🔥 COBOL TAMBÉM PODE RETORNAR 16
MOVE 16 TO RETURN-CODE
STOP RUN
☕ INTERPRETAÇÃO BELLACOSA
☕ “Padawan… o processamento fracassou de forma épica.”
🔥 O SEGREDO MAIS IMPORTANTE
CADA PRODUTO INTERPRETA RC DE FORMA DIFERENTE.
☕ EXEMPLO
Para um utilitário:
RC=4
pode ser trivial.
Para outro:
RC=4
já significa problema sério.
🔥 O JCL E O COND=
Agora nasce o verdadeiro conhecimento Jedi.
☕ EXEMPLO
//STEP2 EXEC PGM=PROG2,COND=(8,LT)
Significa:
execute STEP2 somente se RC anterior NÃO for menor que 8.
🔥 O IF/THEN/ELSE MODERNO
Mais elegante:
// IF (STEP1.RC > 4) THEN
//STEPERR EXEC PGM=ALERTA
// ENDIF
☕ O MAXCC E O JES2
O JES acompanha:
RCs
ABENDs
steps
histórico do JOB
🔥 O MAXCC E O SCHEDULER
Ferramentas como:
Control-M
CA7
TWS
tomam decisões usando:
RC/MAXCC.
☕ EXEMPLO REAL
RC=0 → continua fluxo
RC=4 → warning
RC>=8 → dispara incidente
🔥 O MAIOR ERRO DO PADAWAN
Achar:
RC=4 = tudo OK
Não necessariamente.
Você PRECISA entender:
o contexto do utilitário/programa.
☕ O SEGREDO DOS VETERANOS
Veteranos sempre perguntam:
“QUEM RETORNOU O RC?”
Porque:
DFSORT
IDCAMS
COBOL
DB2
CICS utilities
cada um possui semântica própria.
🔥 CURIOSIDADE HISTÓRICA
MAXCC existe desde os tempos do:
OS/360
Década de:
🏛️ 1960
IBM precisava que jobs batch “conversassem” automaticamente entre si.
Então nasceram:
return codes
condition codes
job control logic
☕ EASTER EGG MAINFRAME
Veteranos brincam:
