Bagikan melalui


Data Pengguna Pesan Permintaan Transaksi TCP

Model pemrograman Data Pengguna pesan permintaan transaksi (TRM) TCP memungkinkan data dan parameter untuk dipertukarkan langsung antara TI dan TP host. Model Data Pengguna TCP TRM didasarkan pada model Server Bersamaan CICS. Listener standar menggunakan dua pertukaran jaringan untuk menjalankan satu program transaksi dan mengharuskan klien untuk:

  • Mengirim Pesan Permintaan Transaksi (TRM) ke Listener standar

  • Menerima balasan TRM dari program aplikasi

  • Mengirim aliran data permintaan aplikasi ke program transaksi server

    Menerima data balasan aplikasi dari program transaksi server

    Gambar berikut ini meringkas alur kerja yang terjadi antara klien, Pendengar CICS standar, dan Server Bersamaan. Angka-angka dalam tanda kurung menunjukkan perkiraan urutan peristiwa terjadi. Deskripsi peristiwa yang lebih rinci mengikuti gambar.

    Gambar yang menunjukkan proses di mana klien memulai Listener default lalu mengirim dan menerima data dari klien.
    Proses di mana klien memulai Listener default, yang meneruskan panggilan ke server bersamaan, yang kemudian mengirim dan menerima data dari klien

Diagram Alur Kerja Ringkasan untuk Model Pemrograman Data Pengguna TCP TRM

Model pemrograman Data Pengguna TCP TRM berfungsi sebagai berikut:

  1. Aplikasi memanggil metode dalam objek TI .NET yang dikonfigurasi di Layanan Komponen atau .NET Framework.

  2. Runtime TI memanggil proksi TI.

  3. Proksi TI:

    1. Membaca data perakitan dan meta yang dibuat sebelumnya oleh Designer TI.

    2. Memetakan jenis data .NET Framework ke jenis data COBOL.

      Proksi TI kemudian:

    3. Memanggil rutinitas konversi untuk mengonversi data aplikasi ke jenis COBOL mainframe.

    4. Membangun buffer aliran data yang diratakan yang mewakili deklarasi COBOL atau copybook.

    5. Meneruskan pesan ke komponen transportasi TCP.

  4. Transportasi TI TCP mengirimkan permintaan sambungkan ke Listener standar menggunakan alamat Protokol Internet (IP) komputer mainframe dan alamat port Listener.

  5. Listener standar menerima permintaan koneksi dan memberi tahu runtime TI untuk mengirim TRM. Listener standar kemudian menunggu TRM.

    TRM adalah rekaman data berformat yang mengidentifikasi TP server yang akan dipanggil dengan menggunakan TRANID-nya. TP Listener CICS adalah TP mainframe khusus, yang fungsi utamanya adalah menerima pemanggilan TP server yang dikirim oleh aplikasi klien yang menjalankan TCP/IP.

    TRANID dari TP Listener standar yang disediakan IBM adalah CSKL. Nama TP TP Listener seperti yang muncul di tabel kontrol program (PCT) EZACIC02.

  6. Runtime TI memformat TRM dan mengirimkannya ke Listener standar. TI menunggu balasan TRM.

  7. Listener standar menerima TRM, mengirim runtime TI konfirmasi terima, lalu membaca konten TRM. Listener menginterpretasikan informasi dalam TRM dan mengekstrak ID transaksi program Server Bersamaan yang melayani permintaan.

  8. Listener standar memulai program TP server bersamaan yang diidentifikasi oleh TRANID di TRM (aplikasi sampel Mscmtics.cbl) menggunakan EXEC CICS Start.

    Mscmtics.cbl adalah file TP sampel Microsoft yang digunakan untuk meneruskan data antara TI dan TP server menggunakan COMMAREA. TP sampel Mscmtics.cbl dikembangkan oleh Microsoft dan disediakan sebagai bagian dari perangkat lunak Host Integration Server. Ini terletak di $\Microsoft Host Integration Server\SDK\Samples\Comti\ProgrammingSpecifics\Tcp. Ini harus dikompilasi, ditautkan, dan diinstal pada komputer mainframe sebelum menggunakan model ini.

Catatan

Jika Listener standar tidak dapat memulai Server Bersamaan, Listener memformat pesan kesalahan dan mengirimkannya kembali ke Transportasi TCP TI. Alasan Pendengar mungkin tidak dapat memulai meliputi:

  • koneksi yang ditolak karena sumber daya CICS terbatas (misalnya, melebihi jumlah maksimum tugas CICS atau tugas server bersamaan)

  • TRANID tidak valid atau dinonaktifkan untuk server bersamaan

  • program Server Bersamaan yang tidak valid, dinonaktifkan, atau tidak tersedia yang terkait dengan ID transaksi

Catatan

Pesan kesalahan dari pendengar CICS berbasis karakter dan selalu dimulai dengan huruf EZY. Panjang pesan kesalahan bervariasi, dan akhir pesan ditentukan oleh soket yang ditutup oleh Pendengar CICS.

  1. Listener standar memanggil antarmuka protokol aplikasi soket (API) di lingkungan host. Listener standar tidak dapat mengirim Balasan TRM. Balasan TRM mewakili proses sinkronisasi yang memungkinkan waktu untuk program transaksi dimulai sebelum data permintaan aplikasi dikirim oleh klien. Proses sinkronisasi ini diperlukan karena pertimbangan arsitektur CICS internal (tidak ada jaminan kapan program transaksi dimulai setelah permintaan dibuat).

    Setelah Pendengar CICS standar mengeluarkan perintah mulai untuk transaksi server bersamaan, Listener standar berada di luar perulangan pemrosesan aplikasi dan bebas mendengarkan permintaan masuk lainnya.

  2. Setelah server bersamaan berjalan, server membaca pesan awal transaksi (TIM) yang dikirim oleh Listener standar.

    TIM menjelaskan lingkungan TCP/IP tempat server berjalan dan berisi informasi soket TCP/IP yang digunakan server bersamaan untuk berkomunikasi dengan COMTI TCP Transport dan header pesan klien yang digunakan server bersamaan untuk menyesuaikan perilaku eksekusinya.

  3. Server Bersamaan:

    1. Memformat balasan TRM.

    2. Mengirim Balasan TRM ke Transportasi TCP TI untuk memberi tahu bahwa sekarang dapat mengirim data permintaan aplikasi.

    3. Mengeluarkan penerimaan dan menunggu data permintaan aplikasi.

      Pengiriman Balasan TRM menyelesaikan bagian ke-1 dari urutan pertukaran Pendengar Standar.

  4. TI mengevaluasi TRM dan meneruskan data ke Server Bersamaan. TI juga mengirim matikan soket, lalu TI menunggu data balasan.

  5. Setelah Server Bersamaan menerima data permintaan aplikasi, server melakukan logika bisnis pada data.

  6. Setelah server selesai memproses permintaan dan merumuskan balasan, menyiapkan data balasan dan kemudian mengirim respons langsung ke klien. Menyelesaikan pemrosesan data aplikasi menandakan akhir dari urutan pertukaran ke-2.

  7. Server bersamaan menutup soket.

  8. Proksi TI menerima data balasan dan memproses balasan. Proksi TI:

    1. Menerima pesan dari komponen transportasi TCP.

    2. Membaca buffer pesan.

      Proksi TI:

    3. Memetakan jenis data COBOL ke jenis data .NET Framework.

    4. Memanggil rutinitas konversi untuk mengonversi jenis COBOL mainframe ke data aplikasi.

  9. Runtime TI mengirimkan data yang dikonversi kembali ke aplikasi .NET Framework yang memanggil metode .

    Untuk mengimplementasikan model ini, Anda harus menyediakan TI dengan alamat IP, nomor port, dan nama program CICS untuk menjalankan aplikasi yang diteruskan oleh program server bersamaan (Mscmtics.cbl). Model ini memerlukan penginstalan, dalam CICS, dari Listener default yang disediakan IBM (EZACIC02). Listener default IBM CICS menggunakan pengaturan default yang disediakan IBM.

    Host Integration Server menyertakan kode sampel yang menunjukkan cara mengimplementasikan model pemrograman TCP TRM Link. Kode sampel terletak di \direktori penginstalan\SDK\Samples\AppInt. Mulai Visual Studio, buka tutorial yang ingin Anda gunakan, dan ikuti instruksi dalam Readme.

    Untuk informasi tentang mengonfigurasi mainframe dan menulis aplikasi server untuk TCP/IP, lihat TCP/IP V3R2 untuk MVS: Panduan Antarmuka Soket TCP/IP CICS (Dokumen IBM #SC31-7131).

Lihat juga

Komponen Integrator Transaksi
Pesan Permintaan Transaksi
Mengonversi Tipe Data dari Automation ke z/OS COBOL]
Mengonversi Jenis Data dari z/OS COBOL ke Automation
Komponen CICS
TI Runtime
Memilih Model Pemrograman yang Sesuai
Model Pemrograman