Definir o analisador de cópia

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.