SLI_CLOSE

2023-07-21

Kata kerja SLI_CLOSE mengakhiri sesi yang dibuka dengan SLI_OPEN. Sumber daya LU-LU dan LU-SSCP dirilis.

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

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 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_SLI_CLOSE.

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

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

lua_data_length
Tidak digunakan oleh SLI_CLOSE dan harus diatur ke nol.

lua_data_ptr
Tidak digunakan oleh SLI_CLOSE dan harus diatur ke nol.

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

lua_rh
Tidak digunakan oleh SLI_CLOSE dan harus diatur ke nol.

lua_flag1
Parameter yang disediakan. Berisi struktur data yang berisi bendera untuk pesan yang disediakan oleh aplikasi. Subparameternya adalah sebagai berikut:

lua_flag1.bid_enable

Indikator pengaktifan bid, satu bit.

lua_flag1.close_abend

Tutup indikator langsung, satu bit. Parameter yang disediakan yang digunakan oleh SLI_CLOSE untuk menentukan apakah sesi akan segera ditutup (AKTIF) atau ditutup secara normal (NONAKTIF). Untuk kata kerja selain SLI_CLOSE, bendera ini harus nonaktif.

lua_flag1.nowait

Tidak menunggu bendera data, satu bit.

lua_flag1.sscp_exp

Alur yang dipercepat titik kontrol layanan sistem (SSCP), satu bit.

lua_flag1.sscp_norm

Aliran normal SSCP, satu bit.

lua_flag1.lu_exp

LU dipercepat alur, satu bit.

lua_flag1.lu_norm

Lu aliran normal, satu bit.

lua_message_type
Tidak digunakan oleh SLI_CLOSE 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
Tidak digunakan oleh SLI_CLOSE 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_PARAMETER_CHECK
Kode pengembalian utama; kata kerja tidak dijalankan karena kesalahan parameter.

LUA_INVALID_LUNAME

Kode pengembalian sekunder; lua_luname yang tidak valid ditentukan.

LUA_BAD_SESSION_ID

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

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_STATE_CHECK
Kode pengembalian utama; kata kerja tidak dijalankan karena dikeluarkan dalam status tidak valid.

LUA_NO_SLI_SESSION

Kode pengembalian sekunder; sesi tidak terbuka atau tidak berfungsi karena kegagalan SLI_CLOSE atau sesi saat perintah dikeluarkan.

LUA_CLOSE_PENDING

Kode pengembalian sekunder; salah satu hal berikut ini telah terjadi:

CLOSE_ABEND masih tertunda ketika CLOSE_ABEND lain dikeluarkan. Anda dapat mengeluarkan CLOSE_ABEND jika CLOSE_NORMAL tertunda.
Baik CLOSE_ABEND atau CLOSE_NORMAL masih tertunda ketika CLOSE_NORMAL dikeluarkan.

LUA_SESSION_FAILURE
Kode pengembalian utama; kondisi kesalahan, yang ditentukan dalam kode pengembalian sekunder, menyebabkan sesi gagal.

LUA_NOT_ACTIVE

Kode pengembalian sekunder; LUA tidak aktif dalam Microsoft Host Integration 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_NEGATIVE_RSP_CHASE

Kode pengembalian sekunder; respons negatif terhadap perintah SNA CHASE dari host diterima oleh antarmuka LUA saat SLI_CLOSE sedang diproses. SLI_CLOSE pemrosesan berkelanjutan untuk menghentikan sesi.

LUA_NEGATIVE_RSP_SHUTC

Kode pengembalian sekunder; respons negatif terhadap perintah SHUTC SNA dari host diterima oleh SLI saat SLI_CLOSE masih diproses. SLI_CLOSE pemrosesan berkelanjutan untuk menghentikan sesi.

LUA_NEGATIVE_RSP_SHUTD

Kode pengembalian sekunder; respons negatif terhadap perintah SNA RSHUTD dari host diterima oleh antarmuka LUA saat SLI_CLOSE masih diproses. SLI_CLOSE pemrosesan berkelanjutan untuk menghentikan sesi.

LUA_RECEIVED_UNBIND

Kode pengembalian sekunder; unit logis utama (PLU) mengirim perintah SNA UNBIND ke antarmuka LUA saat sesi aktif. Akibatnya, sesi dihentikan.

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_LU_COMPONENT_DISCONNECTED

Kode pengembalian sekunder; komponen LU tidak tersedia karena tidak tersambung dengan benar. Pastikan listrik menyala.

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

Ada dua jenis SLI_CLOSE: normal dan ABEND. Untuk penutupan normal, lua_flag1.close_abend diatur ke nol. Urutan untuk penutupan normal dapat dimulai baik sebagai primer (dimulai host) atau sekunder (diminta oleh aplikasi Windows LUA). Selama penutupan normal utama, antarmuka WINDOWS LUA:

Membaca perintah SHUTD dan memposting status SESSION_END_REQUESTED ke aplikasi.
Menulis perintah CHASE (jika perlu).
Membaca dan memproses respons perintah CHASE (jika perlu).
Menulis perintah matikan selesai (SHUTC).
Membaca dan memproses respons perintah SHUTC.
Membaca dan memproses perintah CLEAR (jika perlu).
Menulis respons perintah CLEAR (jika perlu).
Membaca dan memproses perintah UNBIND.
Menulis respons perintah UNBIND.
Menghentikan sesi.

Selama penutupan normal sekunder, antarmuka WINDOWS LUA:
Menulis perintah RSHUTD.
Membaca dan memproses respons perintah RSHUTD.
Membaca dan memproses perintah CLEAR (jika perlu).
Menulis respons perintah CLEAR (jika perlu).
Membaca dan memproses perintah UNBIND.
Menulis respons perintah UNBIND.
Menghentikan sesi.

Untuk penutupan ABEND, lua_flag1.close_abend diatur ke 1, yang mengarahkan antarmuka LUA Windows untuk segera menutup sesi. Setelah SLI_CLOSE mulai diproses, koneksi LU-LU dihentikan dan SSCP diberitahu bahwa LU tidak mampu mempertahankan sesi.

Lihat Juga

SLI_OPEN

Bagikan melalui