Menentukan parser copybook

Mainframe Connector mendukung dua versi parser copybook:

  • Parser copybook native: Copybook Native parser adalah versi terbaru dari parser. Parser copybook Native mengimplementasikan parser berbasis ANTLR4 dan mendukung copybook COBOL. Untuk selengkapnya tentang fitur yang didukung oleh Native copybook parser dan batasan penggunaannya, lihat Parser copybook native.
  • Parser salinan buku lama: Parser copybook lama adalah versi lama dari parser yang mendukung fitur non-COBOL. Jika Anda menggunakan Domain-Spesifik, Salinan berbasis bahasa (DSL), parser lama mungkin lebih cocok sebagai Parser copybook native dapat menyebabkan error. Sebagai informasi lebih lanjut tentang fitur yang didukung oleh {i> parser copybook <i}lama dan batasan penggunaannya, lihat Parser copybook lama.

Anda bisa mendefinisikan parser yang ingin Anda gunakan berdasarkan copybook dengan menggunakan parser_type=legacy|copybook. Nilai defaultnya adalah auto yang merupakan mode deteksi otomatis. Mode deteksi otomatis memprioritaskan menggunakan Native copybook parser, yang cocok untuk mengurai {i>Copybook<i} berbasis COBOL. Namun, jika Anda menggunakan copybook berbasis non-COBOL dengan format lama, flag parser_type=legacy menawarkan versi sebelumnya kompatibilitas yang membantu Anda menggunakan parser copybook Lama.

Tabel berikut mendefinisikan perilaku Mainframe Connector berdasarkan pada bendera tersebut.

Tanda Tindakan
auto Mainframe Connector mendeteksi parser secara otomatis dan mengeksekusi tiga upaya penguraian dalam urutan berikut:
  • Mengurai menggunakan Native parser dan area komentar eksplisit di kolom 1-6. Jika penguraian berhasil, Mainframe Connector mencatat parser yang digunakan dan menampilkan hasilnya. Jika penguraian gagal, Mainframe Connector mencoba parser berikutnya.
  • Mengurai menggunakan Native parser tanpa area komentar. Jika penguraian adalah berhasil, Mainframe Connector mencatat parser yang digunakan dan menampilkan hasilnya. Jika penguraian gagal, Mainframe Connector mencoba parser berikutnya.
  • Mengurai menggunakan parser Lama. Jika penguraian berhasil, Mainframe Connector mencatat parser yang digunakan dan menampilkan hasilnya. Jika penguraian gagal, Mainframe Connector akan menampilkan {i>error<i}.
legacy Parser Lama digunakan untuk mengurai. Mengharapkan penampilan COBOL {i>copybook<i} seperti buku salinan ({i>copybook<i}) berbasis Domain-Specific Language (DSL). Jika Anda gunakan flag legacy, Mainframe Connector akan menampilkan peringatan bahwa parser Lama tidak akan digunakan lagi. Setelah menggunakan versi Lama untuk mengurai, Mainframe Connector akan membandingkan hasil Parser lama dengan parser Native dengan menjalankan dua penguraian percobaan dengan urutan berikut:
  • Mengurai copybook menggunakan Parser Native yang mengharapkan eksplisit area komentar di kolom 1-6. Jika penguraian berhasil, Mainframe Connector membandingkan hasil yang diuraikan dengan Parser lama. Jika tidak sama, peringatan akan ditampilkan. Jika penguraian gagal, Mainframe Connector mencoba parser berikutnya.
  • Mengurai copybook menggunakan Native parser tanpa area komentar di kolom 1-6. Jika penguraian berhasil, Mainframe Connector membandingkan hasil yang diurai dengan hasil parser Lama. Jika bukan sama dengan, peringatan akan ditampilkan. Jika penguraian gagal, Mainframe Connector mencatat pengecualian tersebut.
copybook Parser copybook Native digunakan untuk mengurai. Aplikasi ini mengharapkan Native {i>copybooks<i} sebagai input, termasuk area komentar eksplisit di kolom 1-6. Jika penguraian yang gagal Mainframe Connector menampilkan kesalahan.