FLUSH

Kata kerja FLUSH mengirimkan konten buffer kirim unit logis lokal (LU) ke LU mitra dan program transaksi (TP). Jika buffer kirim kosong, tidak ada tindakan yang terjadi.

Struktur berikut menjelaskan blok kontrol kata kerja (VCB) yang digunakan oleh kata kerja FLUSH .

Sintaksis

  
struct flush {  
    unsigned short   opcode;  
        unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned long    conv_id;  
};   

Members

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

opext
Parameter yang disediakan. Menentukan ekstensi operasi kata kerja, AP_BASIC_CONVERSATION.

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.

tp_id
Parameter yang disediakan. Mengidentifikasi TP lokal. Nilai parameter ini dikembalikan oleh TP_STARTED dalam TP pemanggilan atau dengan RECEIVE_ALLOCATE dalam TP yang dipanggil.

conv_id
Parameter yang disediakan. Menyediakan pengidentifikasi percakapan. Nilai parameter ini dikembalikan oleh ALOKASI dalam TP pemanggilan atau dengan RECEIVE_ALLOCATE dalam TP yang dipanggil.

Kode Pengembalian

AP_OK
Kode pengembalian utama; kata kerja berhasil dijalankan.

AP_PARAMETER_CHECK
Kode pengembalian utama; kata kerja tidak dijalankan karena kesalahan parameter.

AP_BAD_CONV_ID

Kode pengembalian sekunder; nilai conv_id tidak cocok dengan pengidentifikasi percakapan yang ditetapkan oleh APPC.

AP_BAD_TP_ID

Kode pengembalian sekunder; nilai tp_id tidak cocok dengan pengidentifikasi TP yang ditetapkan oleh APPC.

AP_STATE_CHECK
Kode pengembalian utama; kata kerja tidak dijalankan karena dikeluarkan dalam status tidak valid.

AP_FLUSH_NOT_SEND_STATE

Kode pengembalian sekunder; percakapan tidak dalam status KIRIM.

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_CONVERSATION_TYPE_MIXED
  Kode pengembalian utama; TP telah mengeluarkan kata kerja percakapan dasar dan terpetakan. Hanya satu jenis yang dapat dikeluarkan dalam satu percakapan.

  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_CONV_BUSY
  Kode pengembalian utama; hanya ada satu kata kerja percakapan yang luar biasa pada satu waktu pada percakapan apa pun. Ini dapat terjadi jika TP lokal memiliki beberapa utas, dan lebih dari satu utas mengeluarkan panggilan APPC menggunakan conv_id yang sama.

  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

Data yang diproses oleh SEND_DATA terakumulasi dalam buffer pengiriman LU lokal hingga salah satu hal berikut ini terjadi:

• TP lokal mengeluarkan FLUSH (atau kata kerja lain yang menyiram buffer pengiriman LU).

• Buffer penuh.

  Permintaan yang dihasilkan oleh ALLOCATE juga di-buffer.

  Percakapan harus dalam status KIRIM ketika TP mengeluarkan kata kerja ini.

  Tidak ada perubahan status.