Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Kata kerja SLI_OPEN mentransfer kontrol unit logis (LU) yang ditentukan ke aplikasi aplikasi unit logis (LUA) Microsoft® Windows®. SLI_OPEN menetapkan sesi antara titik kontrol layanan sistem (SSCP) dan LU yang ditentukan, serta sesi LU-LU.
Struktur berikut menjelaskan LUA_COMMON anggota blok kontrol kata kerja (VCB) yang digunakan oleh SLI_OPEN.
Penyatuan sintaks kedua menjelaskan anggota LUA_SPECIFIC VCB yang digunakan oleh SLI_OPEN. Anggota serikat lainnya dihilangkan untuk kejelasan.
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;
};
union LUA_SPECIFIC {
struct union SLI_OPEN open;
};
The SLI_OPEN structure contains the following nested structures and members:
struct LUA_EXT_ENTRY {
unsigned char lua_routine_type;
unsigned char lua_module_name[9];
unsigned char lua_procedure_name[33];
} ;
struct SLI_OPEN {
unsigned char lua_init_type;
unsigned char lua_resv65;
unsigned short lua_wait;
struct LUA_EXT_ENTRY lua_open_extension[3];
unsigned char lua_ending_delim;
} ;
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_OPEN.
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_OPEN memerlukan parameter ini.
Parameter ini panjangnya delapan byte, diisi di sebelah kanan dengan spasi (0x20) jika namanya lebih pendek dari delapan karakter.
lua_extension_list_offset
Parameter yang disediakan. Menentukan offset dari awal VCB ke daftar ekstensi pustaka tautan dinamis (DLL) yang disediakan pengguna. Nilai harus menjadi awal batas kata kecuali tidak ada daftar ekstensi. Dalam hal ini, nilai harus diatur ke nol.
Jika opsi ini tidak digunakan oleh SLI_OPEN, anggota ini harus diatur ke nol.
lua_cobol_offset
Tidak digunakan oleh LUA di Microsoft® Host Integration Server dan harus nol.
lua_sid
Parameter yang dikembalikan. Menentukan pengidentifikasi sesi.
lua_max_length
Tidak digunakan oleh SLI_OPEN dan harus diatur ke nol.
lua_data_length
Parameter yang disediakan. Menentukan panjang aktual data yang dikirim.
lua_data_ptr
Pointer ke buffer yang disediakan aplikasi yang berisi data yang akan dikirim untuk SLI_OPEN.
Perintah SNA dan data ditempatkan dalam buffer ini, dan dapat berada dalam format Extended Binary Coded Decimal Interchange Code (EBCDIC).
Ketika SLI_OPEN dikeluarkan, parameter ini bisa menjadi salah satu hal berikut:
Pesan LOGON untuk alur normal SSCP saat jenis inisialisasi adalah sekunder dengan pesan LOGON yang tidak diformat.
Unit permintaan/respons (RU) untuk INITSELF. Ketika jenis inisialisasi sekunder dengan INITSELF, data yang diperlukan untuk aplikasi disediakan.
Untuk semua jenis terbuka lainnya, bidang ini harus diatur ke nol.
Informasi ini disediakan oleh aplikasi WINDOWS LUA.
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 SLI_OPEN dan harus diatur ke nol.lua_rh
Tidak digunakan oleh SLI_OPEN dan harus diatur ke nol.lua_flag1
Tidak digunakan oleh SLI_OPEN dan harus diatur ke nol.lua_message_type
Tidak digunakan oleh SLI_OPEN dan harus diatur ke nol.lua_flag2
Parameter yang dikembalikan. Berisi bendera untuk pesan yang dikembalikan oleh LUA. Subparameternya adalah sebagai berikut:lua_flag2.asinkron
Menunjukkan bahwa kata kerja antarmuka LUA selesai secara asinkron jika diatur ke 1.
lua_resv56
Parameter yang disediakan. Bidang cadangan yang digunakan oleh SLI_OPEN dan RUI_INIT. Untuk informasi selengkapnya, lihat bagian Keterangan.lua_resv56[1]
Parameter yang disediakan. Parameter ini harus diatur ke nol.
lua_resv56[2]
Parameter yang disediakan. Menunjukkan apakah aplikasi SLI dapat mengakses LUs yang dikonfigurasi sebagai 3270 RU, selain LUA LUs. Jika parameter ini diatur ke 1, 3270 LUs dapat diakses.
lua_resv56[3]
Parameter yang disediakan. Menunjukkan apakah bacaan yang tidak lengkap didukung. Jika parameter ini diatur ke 1, bacaan yang tidak lengkap atau terpotong didukung. Untuk detail selengkapnya, lihat keterangan untuk RUI_READ.
lua_encr_decr_option
Tidak digunakan oleh SLI_OPEN dan harus diatur ke nol.buka
Anggota serikat LUA_SPECIFIC yang digunakan oleh SLI_OPEN. Sekumpulan parameter yang disediakan yang terkandung dalam struktur SLI_OPEN yang diperlukan dengan SLI_OPEN.open.lua_init_type
Parameter yang disediakan. Menentukan bagaimana sesi LU-LU diinisialisasi oleh antarmuka LUA Windows.
Nilai yang valid adalah sebagai berikut:
LUA_INIT_TYPE_SEC_IS
LUA_INIT_TYPE_SEC_LOG
LUA_INIT_TYPE_PRIM
LUA_INIT_TYPE_PRIM_SSCP
open.lua_resv65
Bidang yang dipesan.
open.lua_wait
Parameter yang disediakan. Mewakili waktu tunggu coba lagi sekunder yang menunjukkan jumlah detik antarmuka LUA Windows adalah menunggu sebelum mencoba kembali transmisi INITSELF atau pesan LOGON setelah host mengirim salah satu pesan ini:
Respons negatif dan kode pengembalian sekunder adalah salah satu hal berikut:
SESSION_SERVICE_PATH_ERROR 0x08010000 SESSION_SERVICE_PATH_ERROR (0x087D0000 SESSION_LIMIT_EXCEEDED) RESOURCE_NOT_AVAILABLE (0x08050000)
Perhatikan bahwa SLI_OPEN berakhir dengan kesalahan jika lua_wait diatur ke nol dan salah satu sebelumnya terjadi.
Pesan kesalahan prosedur layanan jaringan (NSPE).
Perintah NOTIFY, yang menunjukkan kesalahan prosedur.
open.lua_open_extension
Parameter yang disediakan. Berisi daftar DLL ekstensi yang disediakan aplikasi untuk memproses perintah BIND, STSN, dan CRV.
open.open_extension.lua_routine_type
Jenis rutinitas ekstensi. Nilai hukum adalah:
LUA_ROUTINE_TYPE_BIND
LUA_ROUTINE_TYPE_CRV
LUA_ROUTINE_TYPE_END (menunjukkan akhir daftar ekstensi)
LUA_ROUTINE_TYPE_STSN
open.open_extension.lua_module_name
Parameter yang disediakan. Menyediakan nama modul ASCII untuk DLL ekstensi yang disediakan pengguna. Panjang nama modul dapat mencapai delapan karakter, dengan byte yang tersisa diatur ke 0x00.
open.open_extension.lua_procedure_name
Parameter yang disediakan. Menyediakan nama prosedur di ASCII untuk DLL ekstensi yang disediakan pengguna. Panjang nama prosedur dapat mencapai 32 karakter, dengan byte yang tersisa diatur ke 0x00.
open.lua_ending_delim
Pemisah daftar ekstensi.
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_PARAMETER_CHECK
Kode pengembalian utama; kata kerja tidak dijalankan karena kesalahan parameter.
LUA_INVALID_LUNAME
Kode pengembalian sekunder; nama lua_luname yang tidak valid ditentukan.
LUA_BAD_SESSION_ID
Kode pengembalian sekunder; nilai yang tidak valid untuk lua_sid ditentukan dalam VCB.
LUA_BAD_DATA_PTR
Kode pengembalian sekunder; parameter lua_data_ptr tidak berisi penunjuk yang valid atau tidak menunjuk ke segmen baca/tulis dan data yang disediakan diperlukan.
LUA_DATA_SEGMENT_LENGTH_ERROR
Kode pengembalian sekunder; salah satu hal berikut ini terjadi:
Segmen data yang disediakan untuk SLI_RECEIVE atau SLI_SEND bukan segmen data baca/tulis sesuai kebutuhan.
Segmen data yang disediakan untuk SLI_RECEIVE tidak selama yang disediakan dalam lua_max_length.
Segmen data yang disediakan untuk SLI_SEND tidak selama yang disediakan dalam lua_data_length.
LUA_RESERVED_FIELD_NOT_ZERO
Kode pengembalian sekunder; parameter yang dipesan untuk kata kerja yang baru saja dikeluarkan tidak diatur ke nol.
LUA_INVALID_POST_HANDLE
Kode pengembalian sekunder; untuk sistem operasi Microsoft Windows menggunakan peristiwa sebagai metode posting asinkron, Windows LUA VCB tidak berisi handel peristiwa yang valid.
LUA_VERB_LENGTH_INVALID
Kode pengembalian sekunder; kata kerja LUA dikeluarkan dengan nilai untuk lua_verb_length tidak terduga oleh LUA.
LUA_INVALID_OPEN_INIT_TYPE
Kode pengembalian sekunder; nilai dalam lua_init_type yang terkandung dalam SLI_OPEN tidak valid.
LUA_INVALID_OPEN_DATA
Kode pengembalian sekunder; lua_init_type untuk SLI_OPEN yang dikeluarkan diatur ke LUA_INIT_TYPE_SEC_IS ketika buffer untuk data tidak memiliki perintah INITSELF yang valid.
LUA_INVALID_OPEN_ROUTINE_TYPE
Kode pengembalian sekunder; lua_open_routine_typeuntuk daftar SLI_OPEN rutinitas ekstensi tidak valid.
LUA_DATA_LENGTH_ERROR
Kode pengembalian sekunder; aplikasi tidak menyediakan data yang disediakan pengguna yang diperlukan oleh kata kerja yang dikeluarkan. Perhatikan bahwa ketika SLI_SEND dikeluarkan untuk perintah SNA LUSTAT, status (dalam empat byte) diperlukan, dan bahwa ketika SLI_OPEN dikeluarkan dengan inisialisasi sekunder, data diperlukan.
LUA_INVALID_SLI_ENCR_OPTION
Kode pengembalian sekunder; parameter lua_encr_decr_option diatur ke 128 dalam SLI_OPEN, yang tidak didukung untuk opsi pemrosesan enkripsi/dekripsi.
LUA_STATE_CHECK
Kode pengembalian utama; kata kerja tidak dijalankan karena dikeluarkan dalam status tidak valid.LUA_NOT_ACTIVE
Kode pengembalian sekunder; LUA tidak aktif dalam Microsoft Host Integration Server atau SNA Server ketika kata kerja LUA dikeluarkan.
LUA_UNEXPECTED_SNA_SEQUENCE
Kode pengembalian sekunder; data atau perintah tak terduga diterima dari host saat SLI_OPEN sedang diproses.
LUA_NEG_RSP_FROM_BIND_ROUTINE
Kode pengembalian sekunder; rutinitas SLI_BIND yang disediakan pengguna merespons secara negatif terhadap BIND. SLI_OPEN berakhir dengan tidak berhasil.
LUA_NEG_RSP_FROM_STSN_ROUTINE
Kode pengembalian sekunder; rutinitas SLI STSN yang disediakan pengguna merespons negatif STSN. SLI_OPEN berakhir dengan tidak berhasil.
LUA_PROCEDURE_ERROR
Kode pengembalian sekunder; kesalahan prosedur host ditunjukkan oleh tanda terima pesan NSPE atau NOTIFY. Kode pengembalian diposting ke SLI_OPEN ketika opsi coba lagi tidak digunakan. Untuk menggunakan opsi reset, atur lua_wait ke nilai selain nol. Perintah LOGON atau INITSELF akan dicoba kembali hingga host siap atau sampai Anda mengeluarkan SLI_CLOSE.
LUA_RECEIVED_UNBIND
Kode pengembalian sekunder; unit logis utama (PLU) mengirim perintah SNA UNBIND ke antarmuka LUA saat sesi aktif. Akibatnya, sesi dihentikan.
LUA_SLI_LOGIC_ERROR
Kode pengembalian sekunder; antarmuka LUA menemukan kesalahan internal dalam logika.
LUA_NO_RUI_SESSION
Kode pengembalian sekunder; tidak ada sesi yang diinisialisasi untuk kata kerja LUA yang dikeluarkan, atau beberapa kata kerja selain SLI_OPEN dikeluarkan sebelum sesi diinisialisasi.
LUA_RESOURCE_NOT_AVAILABLE
Kode pengembalian sekunder; unit logis, unit fisik, tautan, atau stasiun tautan yang ditentukan dalam unit permintaan tidak tersedia. Kode pengembalian ini diposting ke SLI_OPEN ketika sumber daya tidak tersedia kecuali Anda menggunakan opsi coba lagi.
Untuk menggunakan opsi coba lagi, atur lua_wait ke nilai selain nol. Perintah LOGON atau INITSELF akan dicoba kembali hingga host siap atau sampai Anda mengeluarkan SLI_CLOSE.
LUA_SESSION_LIMIT_EXCEEDED
Kode pengembalian sekunder; sesi yang diminta tidak diaktifkan karena NAU berada pada batas sesinya. Kode pengertian SNA ini berlaku untuk permintaan berikut: BID, CINIT, INIT, dan ACTDRM.
Kode akan diposting ke SLI_OPEN ketika NAU berada pada batasnya, kecuali Anda menggunakan opsi COBA LAGI.
Untuk menggunakan opsi reset, atur lua_wait ke nilai selain nol. Perintah LOGON atau INITSELF akan dicoba kembali hingga host siap atau sampai Anda mengeluarkan SLI_CLOSE.
LUA_LU_COMPONENT_DISCONNECTED
Kode pengembalian sekunder; komponen LU tidak tersedia karena tidak tersambung dengan benar. Pastikan listrik menyala.
LUA_NEGOTIABLE_BIND_ERROR
Kode pengembalian sekunder; BIND yang dapat dinegosiasikan diterima, yang hanya diizinkan oleh SLI ketika rutinitas SLI_BIND yang disediakan pengguna disediakan dengan SLI_OPEN.
LUA_BIND_FM_PROFILE_ERROR
Kode pengembalian sekunder; hanya profil header manajemen file 3 dan 4 yang didukung oleh antarmuka LUA. Profil manajemen file selain 3 atau 4 ditemukan di BIND.
LUA_BIND_TS_PROFILE_ERROR
Kode pengembalian sekunder; hanya profil Layanan Transmisi (TS) 3 dan 4 yang didukung oleh antarmuka LUA. Profil TS selain 3 atau 4 ditemukan di BIND.
LUA_BIND_LU_TYPE_ERROR
Kode pengembalian sekunder; hanya LU 0, LU 1, LU 2, dan LU 3 yang didukung oleh LUA. LU selain 0, 1, 2, atau 3 ditemukan.
LUA_SSCP_LU_SESSION_NOT_ACTIVE
Kode pengembalian sekunder; SSCP-LU yang diperlukan tidak aktif. Informasi kode indra tertentu berada dalam byte 2 dan 3. Pengaturan yang valid adalah 0x0000, 0x0001, 0x0002, 0x0003, dan 0x0004.
LUA_SESSION_SERVICES_PATH_ERROR
Kode pengembalian sekunder; permintaan untuk layanan sesi tidak dapat dialihkan ke jalur sesi SSCP-SSCP. Informasi kode pengertian tertentu dalam byte 2 dan 3 memberikan informasi lebih lanjut tentang mengapa permintaan tidak dapat dialihkan.
LUA_UNSUCCESSFUL
Kode pengembalian utama; catatan kata kerja yang disediakan valid tetapi kata kerja tidak berhasil diselesaikan.LUA_VERB_RECORD_SPANS_SEGMENTS
Kode pengembalian sekunder; parameter panjang LUA VCB ditambah offset segmen berada di luar ujung segmen.
LUA_SESSION_ALREADY_OPEN
Kode pengembalian sekunder; sesi sudah terbuka untuk nama LU yang ditentukan dalam SLI_OPEN.
LUA_INVALID_PROCESS
Kode pengembalian sekunder; sesi di mana kata kerja LUA dikeluarkan tidak tersedia karena proses lain memiliki sesi.
LUA_LINK_NOT_STARTED
Kode pengembalian sekunder; LUA tidak dapat mengaktifkan tautan data selama inisialisasi sesi.
LUA_INVALID_ADAPTER
Kode pengembalian sekunder; konfigurasi untuk kontrol tautan data (DLC) mengalami kesalahan, atau file konfigurasi rusak.
LUA_ENCR_DECR_LOAD_ERROR
Kode pengembalian sekunder; kode pengembalian yang tidak terduga diterima dari fungsi OS/2 DosLoadModule saat mencoba memuat modul tautan dinamis enkripsi atau dekripsi yang disediakan pengguna.
LUA_ENCR_DECR_PROC_ERROR
Kode pengembalian sekunder; kode pengembalian yang tidak terduga diterima dari fungsi OS/2 DosGetProcAddr saat mencoba mendapatkan alamat prosedur dalam modul tautan dinamis enkripsi atau dekripsi yang disediakan pengguna.
LUA_NEG_NOTIFY_RSP
Kode pengembalian sekunder; SSCP merespons negatif permintaan NOTIFY yang dikeluarkan yang menunjukkan bahwa LU sekunder mampu melakukan sesi. Komponen setengah sesi yang menerima permintaan memahami dan mendukung permintaan tetapi tidak dapat menjalankannya.
LUA_LU_INOPERATIVE
Kode pengembalian sekunder; terjadi kesalahan parah saat SLI mencoba menghentikan sesi. LU ini tidak tersedia untuk permintaan LUA apa pun hingga unit logis aktif (ACTLU) diterima dari host.
LUA_CANCELED
Kode pengembalian utama; kode pengembalian sekunder memberikan alasan untuk membatalkan perintah.LUA_TERMINATED
Kode pengembalian sekunder; sesi dihentikan ketika kata kerja tertunda. Proses kata kerja dibatalkan.
LUA_IN_PROGRESS
Kode pengembalian utama; perintah asinkron diterima tetapi tidak selesai.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 telah rusak (kesalahan LAN).
SnaBase di komputer TPs mengalami ABEND.
LUA_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.LUA_INVALID_VERB_SEGMENT
Kode pengembalian utama; VCB diperluas di luar akhir segmen data.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.LUA_STACK_TOO_SMALL
Kode pengembalian utama; ukuran tumpukan aplikasi terlalu kecil untuk menjalankan kata kerja. Tingkatkan ukuran tumpukan aplikasi Anda.LUA_INVALID_VERB
Kode pengembalian utama; kode kata kerja atau kode operasi, atau keduanya, tidak valid. Kata kerja tidak dijalankan.
Komentar
Untuk setiap SLI_OPEN, antarmuka WINDOWS LUA:
Memulai sesi komunikasi.
Membaca dan memverifikasi perintah BIND dari host, dan meneruskannya ke aplikasi jika rutinitas ekstensi BIND disediakan.
Menulis respons BIND.
Membaca dan memproses perintah STSN dan meneruskannya ke aplikasi jika ekstensi BIND disediakan (jika perlu).
Menulis respons STSN (jika perlu).
Membaca perintah CRV (jika perlu).
Menulis respons CRV (jika perlu).
Membaca dan memproses perintah SDT.
Menulis respons SDT.
Antarmuka LUA Windows melakukan fungsi tambahan berikut untuk sesi yang mengeluarkan SLI_OPEN dengan jenis terbuka yang diatur ke LUA_INIT_TYPE_SEC_IS atau LUA_INIT_TYPE_SEC_LOG:
Menulis INITSELF atau pesan LOGON yang tidak diformat.
Membaca dan memproses respons INITSELF atau respons pesan LOGON.
Semua lalu lintas pesan SNA dikelola oleh SLI_OPEN melalui respons perintah SDT.
Untuk memilih LU tertentu yang dikonfigurasi untuk Windows LUA, aplikasi mengatur lua_luname ke nama LU di ASCII, diisi dengan spasi berikutnya jika perlu.
Ketika SLI_OPEN diposting dengan LUA_OK dalam parameter lua_prim_rc, SLI_OPEN berhasil diselesaikan dan sesi aliran data LU-LU dibuat. Aplikasi sekarang dapat mengeluarkan SLI_BID, SLI_CLOSE, SLI_PURGE, SLI_RECEIVE, dan SLI_SEND.
Ketika SLI_OPEN diposting dengan kode pengembalian utama selain LUA_OK atau LUA_IN_PROGRESS, perintah tidak berhasil membuat sesi.
Saat menggunakan SLI_OPEN, aplikasi WINDOWS LUA harus menyediakan jenis inisialisasi sesi. Jenis yang valid adalah: