ACTIVATE_SESSION

Kata kerja ACTIVATE_SESSION meminta Microsoft® Host Integration Server untuk mengaktifkan sesi antara unit logis lokal (LU) dan LU mitra tertentu, menggunakan mode tertentu. Kata kerja ini selesai baik ketika sesi yang ditentukan telah menjadi aktif atau ketika telah gagal.

Struktur berikut menjelaskan blok kontrol kata kerja yang digunakan oleh kata kerja ACTIVATE_SESSION .

Sintaksis

  
typedef struct activate_session {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   reserv3[8];  
    unsigned char   lu_alias[8];  
    unsigned char   plu_alias[8];  
    unsigned char   mode_name[8];  
    unsigned char   fqplu_name[17];  
    unsigned char   polarity;  
    unsigned char   session_id[8];  
    unsigned long   conv_group_id;  
    unsigned char   reserv4[1];  
    unsigned char   type;  
    HANDLE          deactivation_event;  
    unsigned short* p_deactivation_status;  
    unsigned char   reserv5[10];  
} ACTIVATE_SESSION;

Anggota

Opcode
Parameter yang disediakan. Menentukan kode operasi kata kerja, AP_ACTIVATE_SESSION.

reserv2
Bidang yang dipesan.

primary_rc
Parameter yang dikembalikan. Menentukan kode pengembalian utama yang ditetapkan oleh APPC pada penyelesaian kata kerja. Kode pengembalian yang valid bervariasi tergantung pada kata kerja APPC yang dikeluarkan. Lihat Mengembalikan Kode untuk kode kesalahan yang valid untuk kata kerja ini.

secondary_rc
Parameter yang dikembalikan. Menentukan kode pengembalian sekunder yang ditetapkan oleh APPC pada penyelesaian kata kerja. Kode pengembalian yang valid bervariasi tergantung pada kata kerja APPC yang dikeluarkan. Lihat Mengembalikan Kode untuk kode kesalahan yang valid untuk kata kerja ini.

reserv3
Bidang yang dipesan.

lu_alias
Parameter yang disediakan. Menyediakan nama ASCII 8-byte yang digunakan secara lokal untuk LU. Jika LU lokal default akan digunakan, isi parameter ini dengan spasi.

plu_alias
Parameter yang disediakan. Menyediakan nama ASCII 8-byte yang digunakan secara lokal untuk LU mitra. Jika LU jarak jauh default akan digunakan, isi parameter ini dengan spasi. Jika LU mitra akan ditentukan dengan parameter fqplu_name , isi parameter ini dengan nol biner.

mode_name
Parameter yang disediakan. Menentukan nama mode EBCDIC (tipe A).

fqplu_name
Parameter yang disediakan. Menyediakan nama LU mitra di EBCDIC (jenis A) ketika tidak ada nama plu_alias yang ditentukan pada simpul lokal dan LU mitra terletak di simpul yang berbeda. Parameter ini diabaikan jika plu_alias ditentukan.

Polaritas
Parameter yang disediakan. Menentukan polaritas untuk sesi. Nilai yang mungkin adalah:

AP_POL_EITHER
Jika AP_POL_EITHER diatur, ACTIVATE_SESSION mengaktifkan sesi pembicara pertama jika tersedia; jika tidak, sesi bidder diaktifkan.

AP_POL_FIRST_SPEAKER
Jika AP_POL_FIRST_SPEAKER diatur, ACTIVATE_SESSION hanya berhasil jika sesi polaritas yang diminta tersedia.

AP_POL_BIDDER
Jika AP_POL_BIDDER diatur, ACTIVATE_SESSION hanya berhasil jika sesi polaritas yang diminta tersedia.

id_sesi
Parameter yang dikembalikan. Menyediakan pengidentifikasi 8 byte dari sesi aktifkan.

conv_group_id
Parameter yang dikembalikan. Menyediakan pengidentifikasi grup percakapan. Parameter ini dapat ditentukan pada ALOKASI dan MC_ALLOCATE kata kerja untuk memulai percakapan pada sesi khusus ini.

reserv4
Bidang yang dipesan.

tipe
Parameter yang disediakan. Menentukan jenis aktivasi. Nilai yang mungkin adalah:

AP_ACT_ACTIVE
Jika AP_ACT_ACTIVE ditentukan, Server Integrasi Host akan mencoba memulai sesi yang diperlukan (dengan mengirim BIND atau INIT-SELF).

AP_ACT_PASSIVE
Jika AP_ACT_PASSIVE ditentukan, Server Integrasi Host tidak akan mencoba memulai sesi dan kata kerja akan selesai ketika mitra telah memulai sesi.

deactivation_event
Parameter yang disediakan. Menyediakan handel peristiwa yang akan disinyalir APPC saat sesi dinonaktifkan. Handel peristiwa harus diperoleh dengan memanggil fungsi CreateEvent atau OpenEvent Win32®.

p_deactivation_status
Parameter yang dikembalikan. Penunjuk ke nilai yang diatur saat peristiwa pennonaktifkanan disinyalir untuk memberikan status penyelesaian. Nilai berikut dapat dikembalikan.

AP_SESSION_DEACTIVATED
AP_COMM_SUBSYSTEM_ABENDED
reserv5
Bidang yang dipesan.

Kode Pengembalian

AP_OK
Kode pengembalian utama; kata kerja berhasil dijalankan. Kode pengembalian sekunder menunjukkan polaritas sesi yang ditetapkan. Nilai berikut dapat dikembalikan.

AP_POL_FIRST_SPEAKER
AP_POL_BIDDER
AP_PARAMETER_CHECK
Kode pengembalian utama; kata kerja tidak dijalankan karena kesalahan parameter.

AP_INVALID_LU_ALIAS
Kode pengembalian sekunder; APPC tidak dapat menemukan lu_alias yang ditentukan di antara yang ditentukan.

AP_INVALID_PLU_ALIAS
Kode pengembalian sekunder; APPC tidak mengenali plu_alias yang ditentukan.

AP_INVALID_MODE_NAME
Kode pengembalian sekunder; APPC tidak mengenali mode_name yang ditentukan.

AP_INVALID_FQPLU_NAME
Kode pengembalian sekunder; APPC tidak mengenali fqplu_name yang ditentukan.

AP_INVALID_POLARITY
Kode pengembalian sekunder; APPC tidak mengenali polaritas yang ditentukan.

AP_INVALID_TYPE
Kode pengembalian sekunder; APPC tidak mengenali jenis yang ditentukan.

AP_ACTIVATION_FAIL_NO_RETRY
Kode pengembalian utama; sesi tidak dapat diaktifkan karena kondisi yang memerlukan tindakan (seperti ketidakcocokan konfigurasi atau kesalahan protokol sesi).

AP_ACTIVATION_FAIL_RETRY
Kode pengembalian utama; sesi tidak dapat diaktifkan karena kondisi sementara (seperti kegagalan tautan).

AP_SESSION_LIMITS_EXCEEDED
Kode pengembalian utama; sesi tidak dapat diaktifkan karena batas sesi telah terlampaui.

AP_SESSION_LIMITS_CLOSED
Kode pengembalian utama; sesi tidak dapat diaktifkan karena batas sesi ditutup (yaitu, nol).

AP_COMM_SUBSYSTEM_ABENDED
Kode pengembalian utama; menunjukkan salah satu kondisi berikut terjadi:

Simpul yang digunakan oleh percakapan ini menemukan ABEND.

Koneksi antara TP dan simpul PU 2.1 telah rusak (terjadi kesalahan jaringan area lokal).

SnaBase di komputer TP mengalami ABEND.

Administrator sistem harus memeriksa log kesalahan untuk menentukan alasan ABEND.

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

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

AP_THREAD_BLOCKING
Kode pengembalian utama; utas panggilan sudah dalam panggilan pemblokiran.

Komentar

Kata kerja ini mendukung aktivasi aktif dan pasif.

Bentuk aktif dari kata kerja ini menghasilkan Server Integrasi Host yang mencoba memulai sesi (dengan mengirim BIND untuk LUs independen atau INIT-SELF untuk LUs dependen). Bentuk aktif kata kerja ini juga akan mengakibatkan perilaku berikut:

  • Jika koneksi ke LU mitra tidak aktif dan dikonfigurasi sesuai permintaan, Node akan mencoba memulai koneksi.

  • Jika mitra dinamis sedang digunakan, Node akan menyiapkan kemitraan LU-LU/MODE.

  • Jika CNOS belum berjalan, Node akan memulai CNOS (tetapi tidak akan mengubah batas sesi apa pun).

    Formulir pasif tidak mencoba memulai sesi, tetapi selesai ketika LU dimulai oleh BIND dari LU mitranya. Untuk LUs independen, beberapa kata kerja ACTIVATE_SESSION pasif dapat diantrekan untuk LU-LU/MODE yang sama, dan selesai pada gilirannya saat sesi baru dimulai.

    Kata kerja ini juga mencakup peristiwa pennonaktifkanan, yang diposting ketika sesi dinonaktifkan oleh metode apa pun selain kata kerja DEACTIVATE_SESSION (misalnya, UNBIND yang tidak diminta dari LU mitranya menghasilkan peristiwa ini diposting).

  • Last updated on