Merancang Artefak Metadata untuk Aplikasi Host CICS atau IMS

Panduan ini menunjukkan cara mendesain artefak metadata untuk aplikasi host CICS atau IMS. Anda kemudian dapat menyimpan artefak metadata ini sebagai file HOST Integration Server Definition XML (HIDX) untuk digunakan dengan konektor berbasis penyedia layanan bawaan CICS dan IMS di Azure Logic Apps.

Prasyarat

• Unduh dan instal Visual Studio. Setelah penginstalan, pastikan Anda juga menginstal beban kerja bernama Pengembangan desktop dengan C++ di Visual Studio. Jika tidak, Anda mendapatkan pengecualian kesalahan dari 0x800A007C HRESULT.

• Unduh dan instal Designer HIS untuk Azure Logic Apps. Satu-satunya prasyarat adalah Microsoft .NET Framework 4.8.

• Aktifkan dukungan Visual Studio untuk prosesor File Datar di Azure Logic Apps. Untuk tugas ini, ikuti langkah-langkah berikut:

  1. Buka Visual Studio. Pada toolbar, buka menu Alat , dan pilih Opsi.

  2. Dari daftar Opsi , perluas Server Integrasi Host, dan pilih File Host.

  3. Pada tab Lingkungan Host , pilih Sertakan dukungan untuk Prosesor File Datar dan Logic Apps.

     

Membuat proyek aplikasi host

Di Visual Studio, Anda dapat menggunakan templat proyek Aplikasi Host untuk membuat artefak metadata. Anda kemudian dapat menggunakan artefak ini dengan konektor berbasis penyedia layanan bawaan CICS dan IMS dalam alur kerja Standar untuk Azure Logic Apps. Untuk membuat proyek aplikasi host baru, ikuti langkah-langkah berikut:

1. Di Visual Studio, dari menu File, pilihProyek Baru>.

2. Dari daftar templat proyek, pilih Aplikasi> HostBerikutnya.

3. Dalam kotak Konfigurasikan proyek baru Anda , ubah detail yang Anda inginkan, dan pilih Buat.

   

Menambahkan definisi klien .NET

Untuk mendukung konektor CICS dan IMS di Azure Logic Apps, Anda perlu menambahkan definisi klien .NET.

1. Di Penjelajah Solusi, buka menu pintasan proyek aplikasi host baru, dan pilih Tambahkan>Definisi Klien .NET.

2. Saat kotak Tambahkan Item Baru muncul, di properti Nama , berikan nama untuk definisi klien .NET, dan pilih Tambahkan.

   Langkah-langkah ini berlanjut dengan nama contoh NetClnt1.

3. Setelah wizard Definisi Klien .NET diluncurkan, dalam kotak Pustaka , berikan nama untuk antarmuka yang digunakan untuk mengidentifikasi pustaka klien .NET yang ingin Anda buat.

   Contoh ini berlanjut dengan nama antarmuka IInterface1:

   

4. Setelah selesai, pilih Berikutnya.

5. Dalam kotak Lingkungan Jarak Jauh , identifikasi mainframe jarak jauh atau lingkungan midrange dan model pemrograman untuk digunakan dengan memberikan informasi berikut:

   Parameter	Nilai atau tindakan
   Vendor	Microsoft
   Protokol	Pilih protokol jaringan yang sesuai untuk mengakses mainframe atau sistem midrange: - TCP - HTTP - LU 6.2 (Tidak didukung untuk konektor Azure Logic Apps)
   Lingkungan Target	Pilih sistem target: - CICS - IMS - Sistem i - Sistem Z - Panggilan Program Terdistribusi Sistem i
   Model Pemrograman	Pilih model pemrograman.
   Bahasa Host	Pilih bahasa yang digunakan: COBOL atau RPG
   Izinkan 32K masuk/keluar	Pilih opsi ini untuk menggunakan 32K lengkap area data COMMAREA saat Anda menggunakan model LINK.

6. Jika sudah selesai, pilih Buat.

Setelah Anda selesai dengan wizard, tampilan desain utama muncul bagi Anda untuk membuat atau mengimpor artefak metadata secara manual. Untuk tugas ini, lanjutkan ke bagian berikutnya.

Mendesain artefak metadata

Bagian ini menunjukkan cara membuat artefak metadata secara manual. Untuk mengimpor definisi host, lihat Mengimpor Definisi Host.

Tabel berikut mencantumkan komponen tampilan desain utama:

Komponen	Deskripsi
Simpul komponen	Akar artefak metadata. Menyimpan informasi tentang pustaka klien dan lingkungan jarak jauh.
Simpul antarmuka	Mengelompokkan semua metode dalam komponen.
Folder Tabel Data	Mengelompokkan tabel data dalam rakitan.
Folder struktur	Mengelompokkan variabel dengan atribut bersama.
Folder unions	Mewakili persatuan COBOL yang setara.

Menambahkan metode

Untuk artefak metadata, Anda dapat menambahkan metode untuk mengekspos logika bisnis program mainframe ke alur kerja di Azure Logic Apps.

1. Dalam tampilan desain utama, buka menu pintasan antarmuka baru, dan pilih Tambahkan Metode.

   

2. Buka menu pintasan metode, dan pilih Properti. Berikan nilai untuk properti metode berdasarkan artikel Properti Metode.

Menambahkan parameter atau mengembalikan nilai

Setelah menambahkan metode, Anda dapat menentukan parameter dan nilai pengembalian untuk meneruskan dan menerima data antara program mainframe dan alur kerja di Azure Logic Apps.

1. Dalam tampilan desain utama, buka menu pintasan metode baru, dan pilih Tambahkan Parameter.

   

2. Buka menu pintasan parameter, dan pilih Properti. Berikan nilai untuk properti parameter berdasarkan tabel berikut:

   Properti	Deskripsi atau nilai
   Adalah Array	Jika true, Anda harus mengatur dimensi array, yang mendukung array dengan hingga 7 dimensi dan 16.777.215 elemen. Anda juga harus memasukkan nilai untuk properti array Terjadi Hitungan Masuk dan Terjadi Tergantung Pada.
   Jenis Data	Jenis data .NET parameter
   Nama	Nama parameter
   Arah Parameter	Arah parameter metode: Masuk, Masuk/Keluar, atau Keluar
   Penanganan Kesalahan	Memicu kesalahan, membulatkan, atau memotong.
   Jenis Data Host	Jenis data COBOL atau RPG parameter
   Presisi	Presisi data parameter
   Pengisi Berikutnya	Untuk parameter di mana panjangnya kurang dari maksimum yang ditentukan, Anda harus menentukan ukuran pengisi.

   

3. Buka menu pintasan metode baru, dan pilih Tambahkan Nilai Yang Dikembalikan.

   

4. Buka menu pintasan nilai yang dikembalikan, dan pilih Properti. Berikan nilai untuk properti nilai yang dikembalikan berdasarkan tabel berikut ini:

   Properti	Deskripsi atau nilai
   Adalah Array	Jika true, Anda harus mengatur dimensi array, yang mendukung array dengan hingga 7 dimensi dan 16.777.215 elemen. Anda juga harus memasukkan nilai untuk properti array Terjadi Hitungan Masuk dan Terjadi Tergantung Pada.
   Jenis Hasil	Jenis data .NET nilai yang dikembalikan
   Nilai Yang Dikembalikan Diposisikan Setelah	Menunjukkan posisi nilai yang dikembalikan relatif terhadap parameter.
   Gunakan Area Kerja TICS	Nilai Boolean yang menentukan untuk menggunakan area kerja 256 byte, yang disimpan melalui koneksi persisten dan ditempatkan di awal data.
   Penanganan Kesalahan	Memicu kesalahan, membulatkan, atau memotong.
   Jenis Data Host	Jenis data COBOL atau RPG nilai yang dikembalikan
   Presisi	Presisi data parameter
   Pengisi Berikutnya	Untuk parameter di mana panjangnya kurang dari maksimum yang ditentukan, Anda harus menentukan ukuran pengisi.

   

Menambahkan tabel data

1. Dalam tampilan desain utama, buka menu pintasan DataTables , dan pilih Tambahkan DataTable.

   

2. Buka menu pintasan tabel data baru, dan pilih Tambahkan Kolom DataTable. Ulangi langkah ini seperlunya.

3. Buka menu pintasan kolom baru, dan pilih Properti. Berikan nilai untuk properti setiap kolom berdasarkan tabel berikut ini:

   Properti	Deskripsi atau nilai
   Jenis Data	Jenis data .NET kolom
   Nama	Nama kolom
   Penanganan Kesalahan	Memicu kesalahan, membulatkan, atau memotong.
   Jenis Data Host	Jenis data COBOL atau RPG kolom
   Presisi	Presisi data kolom
   Pengisi berikutnya	Untuk kolom yang panjangnya kurang dari maksimum yang ditentukan, Anda harus menentukan ukuran pengisi.

   

Menambahkan struktur

1. Di tampilan desain utama, buka menu pintasan Struktur , dan pilih Tambahkan Struct.

   

   Perancang membuat struktur dengan satu anggota.

2. Untuk menambahkan anggota lain, buka menu pintasan struktur baru, dan pilih Tambahkan Anggota Struktur. Ulangi langkah ini seperlunya.

3. Buka menu pintasan anggota, dan pilih Properti. Berikan nilai untuk properti setiap anggota berdasarkan tabel berikut ini:

   Properti	Deskripsi atau nilai
   Adalah Array	Jika true, Anda harus mengatur dimensi array, yang mendukung array dengan hingga 7 dimensi dan 16.777.215 elemen. Anda juga harus memasukkan nilai untuk properti array Terjadi Hitungan Masuk dan Terjadi Tergantung Pada.
   Jenis Data	Jenis data .NET anggota
   Nama	Nama anggota
   Penanganan Kesalahan	Memicu kesalahan, membulatkan, atau memotong.
   Jenis Data Host	Jenis data COBOL atau RPG anggota
   Presisi	Presisi data anggota
   Pengisi berikutnya	Untuk anggota yang panjangnya kurang dari maksimum yang ditentukan, Anda harus menentukan ukuran pengisi.

   

Menambahkan union

1. Di tampilan desain utama, buka menu pintasan Unions , dan pilih Tambahkan Union.

   

   Perancang membuat persatuan dengan dua anggota.

2. Untuk menambahkan anggota lain, buka menu pintasan union baru, dan pilih Tambahkan Anggota Union. Ulangi langkah ini seperlunya.

3. Buka menu pintasan anggota, dan pilih Properti. Berikan nilai untuk properti setiap anggota berdasarkan tabel berikut ini:

   Properti	Deskripsi atau nilai
   Adalah Array	Jika true, Anda harus mengatur dimensi array, yang mendukung array dengan hingga 7 dimensi dan 16.777.215 elemen. Anda juga harus memasukkan nilai untuk properti array Terjadi Hitungan Masuk dan Terjadi Tergantung Pada.
   Jenis Data	Jenis data .NET anggota. Nilai ini dapat mencakup struktur yang ditentukan di bagian sebelumnya.
   Nama	Nama anggota
   Penanganan Kesalahan	Memicu kesalahan, membulatkan, atau memotong.
   Jenis Data Host	Jenis data COBOL atau RPG anggota
   Presisi	Presisi data anggota
   Pengisi berikutnya	Untuk anggota yang panjangnya kurang dari maksimum yang ditentukan, Anda harus menentukan ukuran pengisi.

   

4. Setelah selesai, lanjutkan ke bagian berikutnya untuk membuat pustaka yang menyimpan desain metadata.

Membuat XML Definisi Integrasi Host (HIDX) atau artefak metadata

Bagian ini menjelaskan cara membuat pustaka yang menyimpan desain artefak metadata.

1. Untuk menghasilkan artefak metadata, pada menu atau toolbar File Visual Studio, pilih Simpan Semua. (Keyboard: Tekan Ctrl+Shift+S)

   

2. Untuk menemukan file HIDX yang dihasilkan, buka folder aplikasi host Anda.

   

Konten terkait

• Mengimpor Definisi Host