TP_STARTED

Kata kerja TP_STARTED dikeluarkan oleh program transaksi pemanggilan (TP), dan memberi tahu APPC bahwa TP dimulai.

Untuk Microsoft® Windows® versi 3. sistem x , disarankan agar Anda menggunakan fungsi WinAsyncAPPC daripada versi pemblokiran panggilan ini.

Struktur berikut menjelaskan blok kontrol kata kerja yang digunakan oleh kata kerja TP_STARTED .

Sintaksis

  
struct tp_started {  
    unsigned short  opcode;  
    unsigned char   opext;  
    unsigned char   reserv2;  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   lu_alias[8];  
    unsigned char   tp_id[8];  
    unsigned char   tp_name[64];  
    unsigned char   syncpoint_rqd;  
};

Anggota

Opcode
Parameter yang disediakan. Menentukan kode operasi kata kerja, AP_TP_STARTED.

opext
Parameter yang disediakan. Menentukan ekstensi operasi kata kerja. Jika bit AP_EXTD_VCB diatur, ini menunjukkan bahwa struktur tp_started menyertakan anggota syncpoint_rqd yang digunakan untuk dukungan Titik Sinkronisasi. Jika tidak, blok kontrol kata kerja berakhir segera setelah anggota tp_name .

reserv2
Bidang yang dipesan.

primary_rc
Parameter yang dikembalikan. Menentukan kode pengembalian utama yang ditetapkan oleh APPC pada penyelesaian kata kerja. Kode pengembalian yang valid bervariasi tergantung pada kata kerja APPC yang dikeluarkan. Lihat Mengembalikan Kode untuk kode kesalahan yang valid untuk kata kerja ini.

secondary_rc
Parameter yang dikembalikan. Menentukan kode pengembalian sekunder yang ditetapkan oleh APPC pada penyelesaian kata kerja. Kode pengembalian yang valid bervariasi tergantung pada kata kerja APPC yang dikeluarkan. Lihat Mengembalikan Kode untuk kode kesalahan yang valid untuk kata kerja ini.

lu_alias
Parameter yang disediakan. Menentukan alias tempat LU lokal diketahui oleh TP lokal.

Nama harus cocok dengan alias LU yang dibuat selama konfigurasi. APPC memeriksa alias LU terhadap file konfigurasi Server Integrasi Host saat ini. Namun, karena arsitektur klien/server yang digunakan oleh Server Integrasi Host, parameter ini tidak divalidasi hingga ALOKASI atau MC_ALLOCATE dilakukan.

Parameter ini adalah string karakter ASCII 8-byte. Ini dapat terdiri dari karakter ASCII berikut:

  • Huruf besar

  • Angka dari 0 hingga 9

  • Ruang

  • Karakter khusus $, #, % dan @

Karakter pertama dari string ini tidak boleh berupa spasi.

Jika nilai parameter ini kurang dari delapan byte panjangnya, pad di sebelah kanan dengan spasi ASCII (0x20).

Untuk menggunakan LU dari kumpulan LU default, atur bidang ini ke delapan nol heksadesimal. Untuk informasi selengkapnya, lihat LUs Default.

tp_id
Parameter yang dikembalikan. Mengidentifikasi TP yang baru ditetapkan.

tp_name
Parameter yang disediakan. Menentukan nama TP lokal.

Di bawah implementasi Server Integrasi Host APPC, parameter ini diabaikan ketika dikeluarkan oleh TP_STARTED. Namun, parameter ini diperlukan jika program berjalan di bawah IBM ES untuk implementasi OS/2 versi 1.0 APPC.

Parameter ini adalah string karakter EBCDIC 64 byte dan peka huruf besar/kecil. Parameter tp_name dapat terdiri dari karakter EDCDIC berikut:

  • Huruf besar dan huruf kecil

  • Angka dari 0 hingga 9

  • Karakter khusus $, #, @, dan titik (.)

Jika panjang nama TP kurang dari 64 byte, gunakan spasi EBCDIC (0x40) untuk mengayuhnya di sebelah kanan.

Konvensi SNA untuk nama TP layanan hingga empat karakter. Karakter pertama adalah byte heksadesimal antara 0x00 dan 0x3F.

syncpoint_rqd
Parameter opsional ini hanya berlaku jika bit AP_EXTD_VCB diatur dalam parameter opext dan layanan Titik Sinkronisasi diperlukan.

  • AP_YES jika Titik Sinkronisasi diperlukan.
  • AP_NO jika Titik Sinkronisasi tidak diperlukan.

Kode Pengembalian

AP_OK
Kode pengembalian utama; kata kerja berhasil dijalankan.

AP_COMM_SUBSYSTEM_ABENDED
Kode pengembalian utama; menunjukkan salah satu kondisi berikut:

  • Simpul yang digunakan oleh percakapan ini menemukan ABEND.

  • Koneksi antara TP dan simpul PU 2.1 telah rusak (kesalahan LAN).

  • SnaBase di komputer TP mengalami ABEND.

Administrator sistem harus memeriksa log kesalahan untuk menentukan alasan ABEND.

AP_COMM_SUBSYSTEM_NOT_LOADED
Kode pengembalian utama; komponen yang diperlukan tidak dapat dimuat atau dihentikan saat memproses kata kerja. Dengan demikian, komunikasi tidak dapat terjadi. Hubungi administrator sistem untuk tindakan korektif.

AP_INVALID_VERB_SEGMENT
Kode pengembalian utama; VCB diperluas di luar akhir segmen data.

AP_STACK_TOO_SMALL
Kode pengembalian utama; ukuran tumpukan aplikasi terlalu kecil untuk menjalankan kata kerja. Tingkatkan ukuran tumpukan aplikasi Anda.

AP_TP_BUSY
Kode pengembalian utama; TP lokal telah mengeluarkan panggilan ke APPC saat APPC memproses panggilan lain untuk TP yang sama.

AP_THREAD_BLOCKING
Kode pengembalian utama; utas panggilan sudah dalam panggilan pemblokiran.

AP_UNEXPECTED_DOS_ERROR
Kode pengembalian utama; sistem operasi telah mengembalikan kesalahan ke APPC saat memproses panggilan APPC dari TP lokal. Kode pengembalian sistem operasi dikembalikan melalui secondary_rc. Ini muncul dalam urutan intel byte-swapped. Jika masalah berlanjut, konsultasikan dengan administrator sistem.

Komentar

Sebagai respons terhadap TP_STARTED, APPC menghasilkan pengidentifikasi TP untuk TP yang memanggil. Pengidentifikasi ini adalah parameter yang diperlukan untuk kata kerja APPC berikutnya yang dikeluarkan oleh TP pemanggilan.

Ini harus menjadi kata kerja APPC pertama yang dikeluarkan oleh TP pemanggilan. Akibatnya, tidak ada status APPC sebelumnya.

Jika kata kerja berhasil dijalankan (primary_rc AP_OK), status berubah menjadi RESET.

Pada bagian ini

  • Last updated on