LUA_COMMON

Struktur berikut mencantumkan parameter struktur data umum yang digunakan oleh semua kata kerja aplikasi unit logis (LUA).

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;  
} LUA_COMMON;  

Komentar

Anggota

lua_verb
Parameter yang disediakan. Berisi kode kata kerja, LUA_VERB_RUI untuk kata kerja Antarmuka Unit Permintaan (RUI) atau LUA_VERB_SLI untuk kata kerja Antarmuka Tingkat Sesi (SLI). Untuk kedua makro ini, nilainya 0x5200.

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, misalnya, LUA_OPCODE_RUI_BID untuk kata kerja RUI_BID .

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 dan RUI_INIT memerlukan parameter ini. Kata kerja LUA Windows lainnya 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
Menentukan offset dari awal VCB ke daftar ekstensi pustaka tautan dinamis (DLL) yang disediakan pengguna. Tidak digunakan oleh RUI di Server Integrasi Host dan harus diatur ke nol.

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

lua_sid
Parameter yang disediakan dan dikembalikan. 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
Menentukan panjang buffer yang diterima untuk RUI_READdan SLI_RECEIVE. Untuk kata kerja RUI dan SLI lainnya, kata kerja tidak digunakan dan harus diatur ke nol.

lua_data_length
Parameter yang dikembalikan. Menentukan panjang data yang dikembalikan dalam lua_peek_data untuk kata kerja RUI_BID .

lua_data_ptr
Pointer ke buffer yang disediakan aplikasi yang berisi data yang akan dikirim untuk SLI_SEND dan RUI_WRITE atau yang akan menerima data untuk SLI_RECEIVE dan RUI_READ. Untuk kata kerja RUI dan SLI lainnya, parameter ini tidak digunakan dan harus diatur ke nol.

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

lua_th
Parameter yang dikembalikan. Berisi header transmisi SNA (TH) pesan yang dikirim atau diterima. Berbagai sub parameter diatur untuk fungsi tulis dan dikembalikan untuk fungsi baca dan bid.

lua_th.flags_fid

Format identifikasi tipe 2, empat bit.

lua_th.flags_mpf

Bidang pemetaan segmenting, dua bit.

lua_th.flags_odai

Indikator penugasan bidang alamat asal–alamat tujuan (OAF–DAF), satu bit.

lua_th.flags_efi

Indikator alur yang dipercepat, satu bit.

lua_th.daf

Bidang alamat tujuan (DAF), karakter yang tidak ditandatangani.

lua_th.oaf

Bidang alamat asal (OAF), karakter yang tidak ditandatangani.

lua_th.snf

Bidang nomor urut, karakter yang tidak ditandatangani[2].

lua_rh
Parameter yang dikembalikan. Berisi header permintaan/respons SNA (RH) dari pesan yang dikirim atau diterima. Ini diatur untuk fungsi tulis dan dikembalikan oleh fungsi baca dan bid.

lua_rh.rri

Indikator respons permintaan, satu bit.

lua_rh.ruc

Kategori RU, dua bit.

lua_rh.fi

Indikator format, satu bit.

lua_rh.sdi

Merasakan data menyertakan indikator, satu bit.

lua_rh.bci

Mulai indikator rantai, satu bit.

lua_rh.eci

Indikator rantai akhir, satu bit.

lua_rh.dr1i

Indikator respons pasti 1, satu bit.

lua_rh.dr2i

Indikator respons pasti 2, satu bit.

lua_rh.ri

Indikator respons pengecualian (untuk permintaan), atau indikator jenis respons (untuk respons), satu bit.

lua_rh.qri

Indikator respons antrean, satu bit.

lua_rh.pi

Indikator pacing, satu bit.

lua_rh.bbi

Mulai indikator tanda kurung siku, satu bit.

lua_rh.ebi

Indikator tanda kurung akhir, satu bit.

lua_rh.cdi

Ubah indikator arah, satu bit.

lua_rh.csi

Indikator pemilihan kode, satu bit.

lua_rh.edi

Indikator data yang disandikan, satu bit.

lua_rh.pdi

Indikator data berlapis, satu bit.

lua_flag1
Parameter yang disediakan. Berisi struktur data yang berisi bendera untuk pesan yang disediakan oleh aplikasi. Parameter ini digunakan oleh RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE, dan SLI_SEND. Untuk kata kerja LUA lainnya, parameter ini tidak digunakan dan harus diatur ke nol.

lua_flag1.bid_enable

Indikator pengaktifan bid, satu bit.

lua_flag1.close_abend

Tutup indikator langsung, satu bit.

lua_flag1.nowait

Tidak menunggu bendera data, satu bit.

lua_flag1.sscp_exp

Alur yang dipercepat 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
Menentukan jenis perintah dan data SNA masuk atau keluar. Ini adalah parameter yang dikembalikan untuk RUI_INIT dan SLI_OPEN dan parameter yang disediakan untuk SLI_SEND. Untuk kata kerja LUA lainnya, variabel ini tidak digunakan dan harus diatur ke nol.

Nilai yang mungkin adalah:

LUA_MESSAGE_TYPE_LU_DATA

LUA_MESSAGE_TYPE_SSCP_DATA

LUA_MESSAGE_TYPE_BID

LUA_MESSAGE_TYPE_BIND

LUA_MESSAGE_TYPE_BIS

LUA_MESSAGE_TYPE_CANCEL

LUA_MESSAGE_TYPE_CHASE

LUA_MESSAGE_TYPE_CLEAR

LUA_MESSAGE_TYPE_CRV

LUA_MESSAGE_TYPE_LUSTAT_LU

LUA_MESSAGE_TYPE_LUSTAT_SSCP

LUA_MESSAGE_TYPE_QC

LUA_MESSAGE_TYPE_QEC

LUA_MESSAGE_TYPE_RELQ

LUA_MESSAGE_TYPE_RQR

LUA_MESSAGE_TYPE_RTR

LUA_MESSAGE_TYPE_SBI

LUA_MESSAGE_TYPE_SHUTD

LUA_MESSAGE_TYPE_SIGNAL

LUA_MESSAGE_TYPE_SDT

LUA_MESSAGE_TYPE_STSN

LUA_MESSAGE_TYPE_UNBIND

SLI menerima dan menanggapi permintaan BIND, CRV, dan STSN melalui rutinitas ekstensi antarmuka LUA.

LU_DATA, LUSTAT_LU, LUSTAT_SSCP, dan SSCP_DATA bukan perintah SNA.

lua_flag2
Parameter yang dikembalikan. Berisi bendera untuk pesan yang dikembalikan oleh LUA. Parameter ini dikembalikan oleh RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE, dan SLI_SEND. Untuk kata kerja LUA lainnya, parameter ini tidak digunakan dan harus diatur ke nol.

lua_flag2.bid_enable

Menunjukkan bahwa RUI_BID berhasil diaktifkan kembali jika diatur ke 1.

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
Parameter yang disediakan. Bidang cadangan yang digunakan oleh SLI_OPEN dan RUI_INIT. Untuk semua kata kerja LUA lainnya, parameter ini dicadangkan dan harus diatur ke nol.

lua_encr_decr_option
Bidang untuk opsi kriptografi. Pada RUI_INIT, hanya berikut ini yang didukung:

• lua_encr_decr_option = 0

• lua_encr_decr_option = 128

  Untuk semua kata kerja LUA lainnya, parameter ini dicadangkan dan harus diatur ke nol.