RUI_PURGE

Kata kerja RUI_PURGE membatalkan RUI_READ sebelumnya.

Struktur berikut menjelaskan anggota LUA_COMMON blok kontrol kata kerja (VCB) yang digunakan oleh RUI_PURGE.

Sintaksis

  
struct LUA_COMMON {  
    unsigned short lua_verb;  
    unsigned short lua_verb_length;  
    unsigned short lua_prim_rc;  
    unsigned long  lua_sec_rc;  
    unsigned short lua_opcode;  
    unsigned long  lua_correlator;  
    unsigned char  lua_luname[8];  
    unsigned short lua_extension_list_offset;  
    unsigned short lua_cobol_offset;  
    unsigned long  lua_sid;  
    unsigned short lua_max_length;  
    unsigned short lua_data_length;  
    char FAR *      lua_data_ptr;  
    unsigned long  lua_post_handle;  
    struct LUA_TH  lua_th;  
    struct LUA_RH  lua_rh;  
    struct LUA_FLAG1 lua_flag1;  
    unsigned char  lua_message_type;  
    struct LUA_FLAG2 lua_flag2;  
    unsigned char  lua_resv56[7];  
    unsigned char  lua_encr_decr_option;  
};

Anggota

lua_verb
Parameter yang disediakan. Berisi kode kata kerja, LUA_VERB_RUI untuk kata kerja Request Unit Interface (RUI).

lua_verb_length
Parameter yang disediakan. Menentukan panjang byte aplikasi unit logis (LUA) VCB. Ini harus berisi panjang catatan kata kerja yang dikeluarkan.

lua_prim_rc
Kode pengembalian utama yang ditetapkan oleh LUA pada penyelesaian kata kerja. Kode pengembalian yang valid bervariasi tergantung pada kata kerja LUA yang dikeluarkan.

lua_sec_rc
Kode pengembalian sekunder yang ditetapkan oleh LUA pada penyelesaian kata kerja. Kode pengembalian yang valid bervariasi tergantung pada kata kerja LUA yang dikeluarkan.

lua_opcode
Parameter yang disediakan. Berisi kode perintah LUA (kode operasi kata kerja) agar kata kerja dikeluarkan, LUA_OPCODE_RUI_PURGE.

lua_correlator
Parameter yang disediakan. Berisi nilai yang disediakan pengguna yang menautkan kata kerja dengan informasi lain yang disediakan pengguna. LUA tidak menggunakan atau mengubah informasi ini. Parameter ini bersifat opsional.

lua_luname
Parameter yang disediakan. Menentukan nama ASCII dari LU lokal yang digunakan oleh sesi LUA Windows.

RUI_PURGE hanya memerlukan parameter ini jika lua_sid nol.

Parameter ini panjangnya delapan byte, diisi di sebelah kanan dengan spasi (0x20) jika namanya lebih pendek dari delapan karakter.

lua_extension_list_offset
Tidak digunakan oleh RUI di Microsoft® Host Integration Server dan harus diatur ke nol.

lua_cobol_offset
Tidak digunakan oleh LUA di Server Integrasi Host dan harus nol.

lua_sid
Parameter yang disediakan. Menentukan pengidentifikasi sesi dan dikembalikan oleh SLI_OPEN dan RUI_INIT. Kata kerja lain menggunakan parameter ini untuk mengidentifikasi sesi yang digunakan untuk perintah . Jika kata kerja lain menggunakan parameter lua_luname untuk mengidentifikasi sesi, atur parameter lua_sid ke nol.

lua_max_length
Tidak digunakan oleh RUI_PURGE dan harus diatur ke nol.

lua_data_length
Tidak digunakan oleh RUI_PURGE dan harus diatur ke nol.

lua_data_ptr
Arahkan ke lokasi kata kerja RUI_READ VCB yang akan dibatalkan.

lua_post_handle
Parameter yang disediakan. Digunakan di bawah Microsoft® Windows Server jika pemberitahuan asinkron akan dicapai oleh peristiwa. Variabel ini berisi handel peristiwa yang akan disinyalir atau handel jendela.

lua_th
Tidak digunakan oleh RUI_PURGE dan harus diatur ke nol.

lua_rh
Tidak digunakan oleh RUI_PURGE dan harus diatur ke nol.

lua_flag1
Tidak digunakan oleh RUI_PURGE dan harus diatur ke nol.

lua_message_type
Tidak digunakan oleh RUI_PURGE dan harus diatur ke nol.

lua_flag2
Parameter yang dikembalikan. Berisi bendera untuk pesan yang dikembalikan oleh LUA.

lua_flag2.asinkron

Menunjukkan bahwa kata kerja antarmuka LUA selesai secara asinkron jika diatur ke 1.

lua_resv56
Dicadangkan dan harus diatur ke nol.

lua_encr_decr_option
Dicadangkan dan harus diatur ke nol.

Kode Pengembalian

LUA_OK
Kode pengembalian utama; kata kerja berhasil dijalankan.

LUA_CANCELED
Kode pengembalian utama; kata kerja tidak berhasil diselesaikan karena dibatalkan oleh kata kerja lain.

LUA_TERMINATED

Kode pengembalian sekunder; RUI_TERM dikeluarkan saat RUI_PURGE tertunda.

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

LUA_BAD_DATA_PTR

Kode pengembalian sekunder; parameter lua_data_ptr diatur ke null.

LUA_BAD_SESSION_ID

Kode pengembalian sekunder; nilai yang tidak valid untuk lua_sid ditentukan dalam VCB.

LUA_INVALID_POST_HANDLE

Kode pengembalian sekunder; untuk sistem operasi Windows yang menggunakan peristiwa sebagai metode posting asinkron, Windows LUA VCB tidak berisi handel peristiwa yang valid.

LUA_RESERVED_FIELD_NOT_ZERO

Kode pengembalian sekunder; bidang yang dipesan dalam catatan kata kerja, atau parameter yang tidak digunakan oleh kata kerja ini, diatur ke nilai bukan nol.

LUA_VERB_LENGTH_INVALID

Kode pengembalian sekunder; kata kerja LUA dikeluarkan dengan nilai lua_verb_length tidak terduga oleh LUA.

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

LUA_NO_RUI_SESSION

Kode pengembalian sekunder; RUI_INIT belum berhasil diselesaikan untuk nama LU yang ditentukan pada kata kerja ini.

LUA_UNSUCCESSFUL
Kode pengembalian utama; kata kerja yang disediakan valid, tetapi kata kerja tidak berhasil diselesaikan.

LUA_INVALID_PROCESS

Kode pengembalian sekunder; proses OS/2 yang mengeluarkan kata kerja ini bukanlah proses yang sama yang dikeluarkan RUI_INIT untuk sesi ini. Hanya proses yang memulai sesi yang dapat mengeluarkan kata kerja pada sesi tersebut.

LUA_NO_READ_TO_PURGE

Kode pengembalian sekunder; baik lua_data_ptr tidak berisi penunjuk ke RUI_READ VCB, atau RUI_READ selesai sebelum RUI_PURGE dikeluarkan.

LUA_COMM_SUBSYSTEM_ABENDED
Kode pengembalian utama; menunjukkan salah satu kondisi berikut:

  • Simpul yang digunakan oleh percakapan ini menemukan ABEND.

  • Koneksi antara program transaksi (TP) dan simpul unit fisik (PU) 2.1 rusak (kesalahan LAN).

  • SnaBase di komputer TPs mengalami ABEND.

    LUA_SESSION_FAILURE
    Kode pengembalian utama; komponen Server Integrasi Host yang diperlukan telah dihentikan.

    LUA_LU_COMPONENT_DISCONNECTED

    Kode pengembalian sekunder; menunjukkan bahwa sesi LUA gagal karena masalah dengan layanan tautan atau dengan LU host.

    LUA_RUI_LOGIC_ERROR

    Kode pengembalian sekunder; kesalahan internal terdeteksi dalam LUA. Kesalahan ini tidak boleh terjadi selama operasi normal.

    LUA_INVALID_VERB
    Kode pengembalian utama; kode kata kerja atau kode operasi, atau keduanya, tidak valid. Kata kerja tidak dijalankan.

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

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

    LUA_UNEXPECTED_DOS_ERROR
    Kode pengembalian utama; setelah mengeluarkan panggilan sistem operasi, kode pengembalian sistem operasi yang tidak terduga diterima dan ditentukan dalam kode pengembalian sekunder.

Komentar

RUI_READ dapat menunggu tanpa batas waktu jika dikirim tanpa menggunakan opsi lua_flag1.nowait (pengembalian segera) dan tidak ada data yang tersedia pada alur yang ditentukan. RUI_PURGE memaksa kata kerja tunggu untuk kembali (dengan kode pengembalian utama LUA_CANCELED).

Kata kerja ini hanya digunakan ketika RUI_READ telah dikeluarkan dan tertunda penyelesaiannya. (Kode pengembalian utama adalah LUA_IN_PROGRESS.)

Lihat Juga

RUI_INIT
RUI_READ
RUI_TERM
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND

  • Last updated on