Defina o analisador de copybook

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.