SLI_BIND_ROUTINE

Articolo
07/21/2023

Il verbo SLI_BIND_ROUTINE notifica all'applicazione luA (Microsoft® Windows® logic unit application) che una richiesta BIND proviene dall'host e consente alla routine fornita dall'utente di esaminare la richiesta e formulare una risposta.

La struttura seguente descrive il membro LUA_COMMON del blocco di controllo verbo (VCB) usato da SLI_BIND_ROUTINE.

Sintassi

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

Members

lua_verb
Parametro fornito. Contiene il codice verbo, LUA_VERB_SLI per verbi SLI (Session Level Interface).

lua_verb_length
Parametro fornito. Specifica la lunghezza in byte del VCB LUA. Deve contenere la lunghezza del record verbo rilasciato.

lua_prim_rc
Codice restituito primario impostato da LUA al completamento del verbo. I codici restituiti validi variano a seconda del verbo LUA rilasciato.

lua_sec_rc
Codice restituito secondario impostato da LUA al completamento del verbo. I codici restituiti validi variano a seconda del verbo LUA rilasciato.

lua_opcode
Parametro fornito. Contiene il codice del comando LUA (codice operazione verbo) per l'emissione del verbo, LUA_OPCODE_SLI_BIND_ROUTINE.

lua_correlator
Parametro fornito. Contiene un valore fornito dall'utente che collega il verbo ad altre informazioni fornite dall'utente. LUA non usa o modifica queste informazioni. Questo parametro è facoltativo e,

lua_luname
Parametro fornito. Specifica il nome ASCII dell'LU locale usato dalla sessione LUA di Windows.

SLI_BIND_ROUTINE richiede solo questo parametro se lua_sid è zero.

Questo parametro è lungo otto byte, spaziato a destra con spazi (0x20) se il nome è più breve di otto caratteri.

lua_extension_list_offset
Non usato da SLI_BIND_ROUTINE e deve essere impostato su zero.

lua_cobol_offset
Non usato da LUA in Microsoft® Host Integration Server o SNA Server e deve essere zero.

lua_sid
Parametro fornito. Specifica l'identificatore di sessione e viene restituito da SLI_OPEN e RUI_INIT. Altri verbi usano questo parametro per identificare la sessione usata per il comando. Se altri verbi usano il parametro lua_luname per identificare le sessioni, impostare il parametro lua_sid su zero.

lua_max_length
Non usato da SLI_BIND_ROUTINE e deve essere impostato su zero.

lua_data_length
Parametro restituito. Specifica la lunghezza dei dati dell'unità richiesta/risposta BIND restituiti nel buffer dei dati.

lua_data_ptr
Per il SLI_BIND_ROUTINE questo parametro contiene l'indirizzo dell'UR BIND.

lua_post_handle
Parametro fornito. Usato in Microsoft Windows Server se la notifica asincrona deve essere eseguita dagli eventi. Questa variabile contiene l'handle dell'evento da segnalare o un handle di finestra.

lua_th
Parametro fornito. Contiene l'intestazione di trasmissione SNA (TH) del messaggio ricevuto. Vengono restituiti vari sottoparametri per le funzioni di lettura e offerta.

lua_rh
Parametro fornito. Contiene l'intestazione richiesta/risposta SNA del messaggio inviato o ricevuto.

lua_flag1
Parametro fornito. Contiene una struttura di dati contenente flag per i messaggi forniti dall'applicazione.

lua_message_type
Parametro fornito. Specifica il tipo di dati o comandi SNA inviati all'host.

lua_flag2
Parametro restituito. Contiene flag per i messaggi restituiti da LUA.

lua_flag2.async

Indica che il verbo dell'interfaccia LUA è stato completato in modo asincrono se impostato su 1.

lua_flag2.sscp_exp

Indica il flusso rapido di SSCP se impostato su 1.

lua_flag2.sscp_norm

Indica il flusso normale di SSCP se impostato su 1.

lua_flag2.lu_exp

Indica il flusso rapido lu se impostato su 1.

lua_flag2.lu_norm

Indica il flusso normale lu se impostato su 1.

lua_resv56
Riservato e deve essere impostato su zero.

lua_encr_decr_option
Non usato da SLI_BIND_ROUTINE e deve essere impostato su zero.

Codici restituiti

LUA_OK
Codice restituito primario; il verbo eseguito correttamente.

LUA_SEC_OK

Codice restituito secondario; nessuna informazione aggiuntiva per LUA_OK.

LUA_NEGATIVE_RSP
Codice restituito primario; LUA ha inviato una risposta negativa a un messaggio ricevuto dall'unità logica primaria (PLU) perché è stato rilevato un errore nel messaggio oppure l'applicazione ha risposto negativamente a una catena per cui è arrivata la fine della catena.

Commenti

SLI_BIND_ROUTINE fornisce un meccanismo per l'applicazione Windows LUA per esaminare le richieste BIND ricevute dall'host. Windows LUA usa una libreria di collegamento dinamica (DLL) fornita dall'utente per notificare all'applicazione WINDOWS LUA che è stata ricevuta una richiesta BIND. La routine DLL fornita dall'utente esamina quindi il contenuto di BIND e formula una risposta per la richiesta.

Il nome della DLL per la routine viene fornito come estensioni dei verbi di SLI_OPEN VCB. Il parametro lua_extension_list_offset fornisce l'offset dall'inizio del VCB al primo nome nell'elenco di estensioni.

L'interfaccia LUA di Windows assegna spazio di archiviazione in cui è strutturato il VCB. Il VCB di SLI_BIND_ROUTINE contiene lua_th e lua_rh. L'indirizzo dell'UR BIND viene specificato in lua_data_ptr e la lunghezza dell'UR viene specificata in lua_data_length.

Quando SLI_BIND_ROUTINE restituisce a Windows LUA, l'elaborazione di SLI_BIND_ROUTINE viene completata. La risposta BIND deve sovrascrivere l'UR BIND. Quando si accetta BIND, il codice restituito primario deve essere impostato su LUA_OK. Se BIND viene rifiutato, il codice restituito primario deve essere impostato su LUA_NEGATIVE_RSP e il buffer BIND contiene il codice di senso negativo. Il parametro lua_data_ptr non deve essere modificato.

Se viene restituita una risposta negativa da SLI_BIND_ROUTINE, SLI_OPEN viene annullata. Il lua_prim_rc del SLI_OPEN è impostato su LUA_SESSION_FAILURE e il lua_sec_rc è impostato su LUA_NEG_RSP_FROM_BIND_ROUTINE.

Vedere anche

RUI_INIT
RUI_PURGE
RUI_READ
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND