Menentukan parser copybook

Mainframe Connector mendukung dua versi parser copybook:

  • Parser buku salinan native: Parser buku salinan native adalah versi terbaru parser. Parser copybook Native menerapkan parser berbasis ANTLR4 dan mendukung copybook COBOL. Untuk informasi selengkapnya tentang fitur yang didukung oleh parser copybook Native dan batasan penggunaannya, lihat Parser copybook Native.
  • Parser copybook lama: Parser copybook lama adalah parser versi lama yang mendukung fitur non-COBOL. Jika Anda menggunakan buku salinan berbasis Bahasa Khusus Domain (DSL), parser lama mungkin lebih cocok karena Parser buku salinan native dapat menyebabkan error. Untuk informasi selengkapnya tentang fitur yang didukung oleh parser copybook lama dan batasan penggunaannya, lihat Parser copybook lama.

Anda dapat menentukan parser yang ingin digunakan berdasarkan copybook menggunakan flag parser_type=legacy|copybook. Nilai defaultnya adalah auto yang merupakan mode deteksi otomatis. Mode deteksi otomatis memprioritaskan penggunaan parser copybook Native, yang cocok untuk mengurai copybook berbasis COBOL. Namun, jika Anda menggunakan copybook non-COBOL dengan format lama, flag parser_type=legacy menawarkan kompatibilitas mundur yang membantu Anda menggunakan parser Copybook lama.

Tabel berikut menentukan perilaku Konektor Mainframe berdasarkan flag.

Flag Tindakan
auto Konektor Mainframe mendeteksi parser secara otomatis dan menjalankan tiga upaya penguraian dalam urutan berikut:
  • Mengurai menggunakan parser Native dan area komentar eksplisit di kolom 1-6. Jika penguraian berhasil, Mainframe Connector akan mencatat parser yang digunakan dan menampilkan hasilnya. Jika penguraian gagal, Konektor Mainframe akan mencoba parser berikutnya.
  • Mengurai menggunakan parser Native tanpa area komentar. Jika penguraian berhasil, Mainframe Connector akan mencatat parser yang digunakan dan menampilkan hasilnya. Jika penguraian gagal, Konektor Mainframe akan mencoba parser berikutnya.
  • Mengurai menggunakan parser Lama. Jika penguraian berhasil, Mainframe Connector akan mencatat parser yang digunakan dan menampilkan hasilnya. Jika penguraian gagal, Mainframe Connector akan menampilkan error.
legacy Parser Lama digunakan untuk penguraian. Fungsi ini mengharapkan buku salinan mirip COBOL seperti buku salinan berbasis Domain-Specific Language (DSL). Saat Anda menggunakan flag legacy, Konektor Mainframe akan menampilkan peringatan bahwa Parser lama tidak akan digunakan lagi. Setelah menggunakan parser Legacy untuk penguraian, Konektor Mainframe membandingkan hasil parser Legacy dengan parser Native dengan menjalankan dua upaya penguraian dalam urutan berikut:
  • Mengurai buku salinan menggunakan parser Native yang mengharapkan area komentar eksplisit di kolom 1-6. Jika penguraian berhasil, Mainframe Connector akan membandingkan hasil yang diuraikan dengan hasil Parser lama. Jika tidak sama, peringatan akan ditampilkan. Jika penguraian gagal, Konektor Mainframe akan mencoba parser berikutnya.
  • Mengurai buku salinan menggunakan parser Native tanpa area komentar di kolom 1-6. Jika penguraian berhasil, Konektor Mainframe akan membandingkan hasil yang diuraikan dengan pengurai Legacy. Jika tidak sama, peringatan akan ditampilkan. Jika penguraian gagal, Mainframe Connector akan mencatat pengecualian ke dalam log.
copybook Parser copybook Native digunakan untuk penguraian. Fungsi ini mengharapkan buku salinan Native sebagai input, termasuk area komentar eksplisit di kolom 1-6. Jika penguraian gagal, Mainframe Connector akan menampilkan error.