SLI_BIND_ROUTINE

Kata kerja SLI_BIND_ROUTINE memberi tahu aplikasi unit logis (LUA) Microsoft® Windows® bahwa permintaan BIND telah berasal dari host dan memungkinkan rutinitas yang disediakan pengguna untuk memeriksa permintaan dan merumuskan respons.

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

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_SLI untuk kata kerja Antarmuka Tingkat Sesi (SLI).

lua_verb_length
Parameter yang disediakan. Menentukan panjang dalam byte DARI 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_SLI_BIND_ROUTINE.

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.

SLI_BIND_ROUTINE 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 SLI_BIND_ROUTINE dan harus diatur ke nol.

lua_cobol_offset
Tidak digunakan oleh LUA di Microsoft® Host Integration Server atau SNA Server 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 SLI_BIND_ROUTINE dan harus diatur ke nol.

lua_data_length
Parameter yang dikembalikan. Menentukan panjang data unit permintaan/respons (RU) BIND yang dikembalikan dalam buffer data.

lua_data_ptr
Untuk SLI_BIND_ROUTINE parameter ini berisi alamat BIND RU.

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
Parameter yang disediakan. Berisi header transmisi SNA (TH) pesan yang diterima. Berbagai subparameter dikembalikan untuk fungsi baca dan bid.

lua_rh
Parameter yang disediakan. Berisi header permintaan/respons SNA (RH) dari pesan yang dikirim atau diterima.

lua_flag1
Parameter yang disediakan. Berisi struktur data yang berisi bendera untuk pesan yang disediakan oleh aplikasi.

lua_message_type
Parameter yang disediakan. Menentukan jenis data atau perintah SNA yang dikirim ke host.

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_flag2.sscp_exp

Menunjukkan alur yang dipercepat SSCP jika diatur ke 1.

lua_flag2.sscp_norm

Menunjukkan alur normal SSCP jika diatur ke 1.

lua_flag2.lu_exp

Menunjukkan alur lu yang dipercepat jika diatur ke 1.

lua_flag2.lu_norm

Menunjukkan alur normal LU jika diatur ke 1.

lua_resv56
Dicadangkan dan harus diatur ke nol.

lua_encr_decr_option
Tidak digunakan oleh SLI_BIND_ROUTINE dan harus diatur ke nol.

Kode Pengembalian

LUA_OK
Kode pengembalian utama; kata kerja berhasil dijalankan.

LUA_SEC_OK

Kode pengembalian sekunder; tidak ada informasi tambahan untuk LUA_OK.

LUA_NEGATIVE_RSP
Kode pengembalian utama; BAIK LUA mengirim respons negatif ke pesan yang diterima dari unit logis utama (PLU) karena kesalahan ditemukan dalam pesan, atau aplikasi merespons secara negatif rantai di mana ujung rantai telah tiba.

Komentar

SLI_BIND_ROUTINE menyediakan mekanisme untuk aplikasi WINDOWS LUA untuk memeriksa permintaan BIND yang diterima dari host. WINDOWS LUA menggunakan pustaka tautan dinamis yang disediakan pengguna (DLL) untuk memberi tahu aplikasi WINDOWS LUA bahwa permintaan BIND telah diterima. Rutinitas DLL yang disediakan pengguna kemudian memeriksa konten BIND dan merumuskan respons untuk permintaan tersebut.

Nama DLL untuk rutinitas disediakan sebagai ekstensi SLI_OPEN kata kerja VCB. Parameter lua_extension_list_offset menyediakan offset dari awal VCB ke nama depan dalam daftar ekstensi.

Antarmuka LUA Windows menetapkan ruang penyimpanan tempat VCB disusun. VCB SLI_BIND_ROUTINE berisi lua_th dan lua_rh. Alamat RU BIND ditentukan dalam lua_data_ptr dan panjang RU ditentukan dalam lua_data_length.

Ketika SLI_BIND_ROUTINE kembali ke WINDOWS LUA, pemrosesan SLI_BIND_ROUTINE selesai. Respons BIND harus menimpa BIND RU. Ketika BIND diterima, kode pengembalian utama harus diatur ke LUA_OK. Jika BIND ditolak, kode pengembalian utama harus diatur ke LUA_NEGATIVE_RSP dan buffer BIND berisi kode indera negatif. Parameter lua_data_ptr tidak boleh dimodifikasi.

Jika respons negatif dikembalikan dari SLI_BIND_ROUTINE, SLI_OPEN dibatalkan. Lua_prim_rc SLI_OPEN diatur ke LUA_SESSION_FAILURE, dan lua_sec_rc diatur ke LUA_NEG_RSP_FROM_BIND_ROUTINE.

Lihat Juga

RUI_INIT
RUI_PURGE
RUI_READ
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND

Last updated on 2025-06-05

Bagikan melalui