Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Mainframe Connector oferece suporte a duas versões do analisador de copybook:
Native copybook parser:o Native copybook parser
é a versão mais recente do analisador. O analisador de copybook nativo
implementa um analisador baseado em ANTLR4 e oferece suporte a copybooks COBOL. Para mais
informações sobre os recursos compatíveis com o analisador de copybook nativo e as
restrições de uso, consulte Analisador de copybook nativo.
Analisador de copybook legado:é uma versão mais antiga do
analisador que oferece suporte a recursos que não são COBOL. Se você estiver usando um livro de cópias baseado em linguagem específica de domínio (DSL, na sigla em inglês), o analisador legado pode ser mais adequado, já que o analisador de livro de cópias nativo pode causar erros. Para
mais informações sobre os recursos compatíveis com o analisador de copybook legado e
as restrições de uso, consulte Analisador de copybook legado.
É possível definir qual analisador você quer usar com base no seu livro de cópia usando a
flag parser_type=legacy|copybook. O valor padrão é
auto, que é o modo de detecção automática. O modo de detecção automática
prioriza o uso do analisador de copybook nativo, que é adequado para analisar
copybooks baseados em COBOL. No entanto, se você estiver usando um copybook não baseado em COBOL com
o formato antigo, a flag parser_type=legacy oferece compatibilidade
retroativa para ajudar a usar o analisador de copybook legado.
A tabela a seguir define o comportamento do conector de mainframe com base
na flag.
Sinalização
Ação
auto
O Mainframe Connector detecta o analisador automaticamente e
executa três tentativas de análise na seguinte ordem:
Faz a análise usando o analisador nativo e a área de comentários explícita nas colunas 1 a 6. Se a análise for bem-sucedida, o Mainframe Connector vai registrar o analisador usado e retornar o resultado. Se a análise falhar,
o Mainframe Connector tenta o próximo analisador.
Faz a análise usando o analisador nativo sem a área de comentários. Se a análise for
bem-sucedida, o Mainframe Connector registra o analisador usado
e retorna o resultado. Se a análise falhar, o Mainframe Connector
vai tentar o próximo analisador.
Faz a análise usando o analisador legado. Se a análise for bem-sucedida,
o Mainframe Connector registra o analisador usado e retorna
o resultado. Se a análise falhar, o Mainframe Connector vai mostrar um
erro.
legacy
O analisador legado é usado para análise. Ele espera um livro de cópias semelhante ao COBOL,
como um livro de cópias baseado em linguagem específica de domínio (DSL). Quando você
usa a flag legacy, o Mainframe Connector mostra um
aviso de que o analisador legado será descontinuado. Depois de usar o analisador
legado para a análise, o Mainframe Connector compara o resultado do
analisador legado com o do analisador nativo executando duas tentativas
de análise na seguinte ordem:
Analisa o livro de cópias usando o analisador nativo que espera uma área de comentário explícita nas colunas 1 a 6. Se a análise for bem-sucedida,
o Mainframe Connector vai comparar o resultado analisado com o do
analisador legado. Se não for igual, um aviso será mostrado. Se a análise falhar,
o Mainframe Connector tentará o próximo analisador.
Analisa o livro de cópias usando o analisador nativo sem área de comentários nas colunas 1 a 6. Se a análise for bem-sucedida, o Mainframe Connector
vai comparar o resultado analisado com o do analisador legado. Se não for igual, um alerta será mostrado. Se a análise falhar, o Mainframe Connector
registra a exceção.
copybook
O analisador de modelo nativo é usado para análise. Ele espera que os
copybooks nativos sejam usados como entrada, incluindo uma área de comentários explícita nas colunas 1 a 6. Se
a análise falhar, o Mainframe Connector vai mostrar um erro.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-03 UTC."],[],[],null,["# Define the copybook parser\n\nMainframe Connector supports two versions of the copybook parser:\n\n- **Native copybook parser:** The Native copybook parser is the latest version of the parser. The Native copybook parser implements an ANTLR4 based parser and supports COBOL copybooks. For more information on the features supported by the Native copybook parser and the restrictions of its use, see [Native copybook parser](/mainframe-connector/docs/copybook-reference#native-copybook-parser).\n- **Legacy copybook parser:** The legacy copybook parser is an older version of\n the parser that supports non-COBOL features. If you are using Domain-Specific\n Language (DSL) based-copybook the legacy parser might be more suitable as the\n Native copybook parser might cause errors. For\n more information on the features supported by the legacy copybook parser and\n the restrictions of its use, see [Legacy copybook parser](/mainframe-connector/docs/copybook-reference#legacy-copybook-parser).\n\n | **Note:** The Legacy parser is being deprecated. We recommend that you switch to the Native copybook parser.\n\nYou can define which parser you want to use based on your copybook by using the\n`parser_type=legacy|copybook` flag. The default value is\n`auto` which is the auto-detect mode. The auto-detect mode\nprioritizes using the Native copybook parser, which is suitable for parsing\nCOBOL-based copybooks. However, if you are using a non-COBOL-based copybook with\nthe old format, the `parser_type=legacy` flag offers backward\ncompatibility helping you use the Legacy copybook parser.\n| **Note:** You cannot explicitly set `parser_type` to `auto` from the command line.\n\nThe following table defines the behavior of Mainframe Connector based\non the flag."]]
