Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O conetor de mainframe suporta duas versões do analisador de copybook:
Analisador de copybook nativo: o analisador de copybook nativo é a versão mais recente do analisador. O analisador de livros de registo nativo
implementa um analisador baseado em ANTLR4 e suporta livros de registo COBOL. Para mais
informações sobre as funcionalidades suportadas pelo analisador nativo de livros de cópias e as
restrições da respetiva utilização, consulte o artigo Analisador nativo de livros de cópias.
Analisador de copybook antigo: o analisador de copybook antigo é uma versão mais antiga do analisador que suporta funcionalidades não COBOL. Se estiver a usar um livro de registos baseado na linguagem específica do domínio (DSL), o analisador de código antigo pode ser mais adequado, uma vez que o analisador de código nativo pode causar erros. Para
mais informações sobre as funcionalidades suportadas pelo analisador de copybook antigo e
as restrições da respetiva utilização, consulte o artigo Analisador de copybook antigo.
Pode definir o analisador que quer usar com base no seu livro de registos através da flag parser_type=legacy|copybook. O valor predefinido é
auto, que é o modo de deteção automática. O modo de deteção automática dá prioridade à utilização do analisador de livros de cópias nativo, que é adequado para analisar livros de cópias baseados em COBOL. No entanto, se estiver a usar um copybook não baseado em COBOL com o formato antigo, a flag parser_type=legacy oferece retrocompatibilidade, o que ajuda a usar o analisador de copybook antigo.
A tabela seguinte define o comportamento do conetor de mainframe com base na flag.
Bandeira
Ação
auto
O Mainframe Connector deteta o analisador automaticamente e
executa três tentativas de análise pela seguinte ordem:
Analisa através do analisador nativo e da área de comentários explícita nas colunas 1 a 6. Se a análise for bem-sucedida, o Mainframe Connector
regista o analisador usado e devolve o resultado. Se a análise falhar,
o conector do mainframe tenta o analisador seguinte.
Análise com o analisador nativo sem a área de comentários. Se a análise for bem-sucedida, o Mainframe Connector regista o analisador usado e devolve o resultado. Se a análise falhar, o Mainframe Connector
tenta o analisador seguinte.
Analisa através do analisador antigo. Se a análise for bem-sucedida,
o conector do mainframe regista o analisador usado e devolve
o resultado. Se a análise falhar, o conetor de mainframe apresenta um erro.
legacy
O analisador antigo é usado para a análise. Espera um copybook semelhante ao COBOL, como um copybook baseado numa linguagem específica do domínio (DSL). Quando usa a flag legacy, o Mainframe Connector mostra um aviso de que o analisador Legacy vai ser descontinuado. Após usar o analisador
antigo para a análise, o conetor de mainframe compara o resultado do
analisador antigo com o do analisador nativo executando duas tentativas de
análise pela seguinte ordem:
Analisa o copybook através do analisador nativo, esperando uma área de comentário explícita nas colunas 1 a 6. Se a análise for bem-sucedida,
o conetor do mainframe compara o resultado da análise com o do
analisador de dados antigo. Se não for igual, é apresentado um aviso. Se a análise falhar,
O conector do mainframe tenta o analisador seguinte.
Analisa o copybook através do analisador nativo sem área de comentários nas colunas 1 a 6. Se a análise for bem-sucedida, o Mainframe Connector
compara o resultado da análise com o do analisador de dados antigo. Se não for igual, é apresentado um aviso. Se a análise falhar, o Mainframe Connector
regista a exceção.
copybook
O analisador de livro de cópias nativo é usado para a análise. Espera receber livros de registos nativos como entrada, incluindo uma área de comentários explícita nas colunas 1 a 6. Se a análise falhar, o conetor do mainframe apresenta 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-08-21 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."]]
