RUI_PURGE
Il verbo RUI_PURGE annulla un RUI_READ precedente.
La struttura seguente descrive il membro LUA_COMMON del blocco di controllo verbo (VCB) usato da RUI_PURGE.
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_RUI per verbi URI (Request Unit Interface).
lua_verb_length
Parametro fornito. Specifica la lunghezza in byte del VCB (LUA) dell'applicazione unità logica. 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_RUI_PURGE.
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.
RUI_PURGE 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 URI in Microsoft® Host Integration Server e deve essere impostato su zero.
lua_cobol_offset
Non usato da LUA in Host Integration 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 RUI_PURGE e deve essere impostato su zero.
lua_data_length
Non usato da RUI_PURGE e deve essere impostato su zero.
lua_data_ptr
Punta alla posizione dei verbi di RUI_READ VCB da annullare.
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
Non usato da RUI_PURGE e deve essere impostato su zero.
lua_rh
Non usato da RUI_PURGE e deve essere impostato su zero.
lua_flag1
Non usato da RUI_PURGE e deve essere impostato su zero.
lua_message_type
Non usato da RUI_PURGE e deve essere impostato su zero.
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_resv56
Riservato e deve essere impostato su zero.
lua_encr_decr_option
Riservato e deve essere impostato su zero.
Codici restituiti
LUA_OK
Codice restituito primario; il verbo eseguito correttamente.
LUA_CANCELED
Codice restituito primario; il verbo non è stato completato correttamente perché è stato annullato da un altro verbo.
LUA_TERMINATED
Codice restituito secondario; RUI_TERM è stato rilasciato mentre RUI_PURGE era in sospeso.
LUA_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro.
LUA_BAD_DATA_PTR
Codice restituito secondario; il parametro lua_data_ptr è stato impostato su Null.
LUA_BAD_SESSION_ID
Codice restituito secondario; un valore non valido per lua_sid è stato specificato nel VCB.
LUA_INVALID_POST_HANDLE
Codice restituito secondario; per un sistema operativo Windows che usa eventi come metodo di registrazione asincrona, windows LUA VCB non contiene un handle di eventi valido.
LUA_RESERVED_FIELD_NOT_ZERO
Codice restituito secondario; un campo riservato nel record verbo o un parametro non usato da questo verbo, è stato impostato su un valore diverso da zero.
LUA_VERB_LENGTH_INVALID
Codice restituito secondario; un verbo LUA è stato rilasciato con il valore di lua_verb_length imprevisto da LUA.
LUA_STATE_CHECK
Codice restituito primario; il verbo non è stato eseguito perché è stato rilasciato in uno stato non valido.
LUA_NO_RUI_SESSION
Codice restituito secondario; RUI_INIT non è ancora stato completato correttamente per il nome lu specificato in questo verbo.
LUA_UNSUCCESSFUL
Codice restituito primario; il verbo fornito era valido, ma il verbo non è stato completato correttamente.
LUA_INVALID_PROCESS
Codice restituito secondario; il processo os/2 che ha rilasciato questo verbo non era lo stesso processo che ha rilasciato RUI_INIT per questa sessione. Solo il processo che ha avviato una sessione può emettere verbi in tale sessione.
LUA_NO_READ_TO_PURGE
Codice restituito secondario; lua_data_ptr non contiene un puntatore a un VCB RUI_READ o RUI_READcompletato prima dell'emissione di RUI_PURGE.
LUA_COMM_SUBSYSTEM_ABENDED
Codice restituito primario; indica una delle condizioni seguenti:
Il nodo usato da questa conversazione ha rilevato un ABEND.
La connessione tra il programma di transazione (TP) e il nodo unità fisica (PU) 2.1 è stato interrotto (errore LAN).
SnaBase nel computer TPS ha rilevato un ABEND.
LUA_SESSION_FAILURE
Codice restituito primario; è stato terminato un componente Host Integration Server necessario.LUA_LU_COMPONENT_DISCONNECTED
Codice restituito secondario; indica che la sessione LUA non è riuscita a causa di un problema con il servizio di collegamento o con l'lu host.
LUA_RUI_LOGIC_ERROR
Codice restituito secondario; è stato rilevato un errore interno all'interno di LUA. Questo errore non deve verificarsi durante il normale funzionamento.
LUA_INVALID_VERB
Codice restituito primario; Il codice verbo o il codice dell'operazione o entrambi non sono validi. Il verbo non è stato eseguito.LUA_STACK_TOO_SMALL
Codice restituito primario; le dimensioni dello stack dell'applicazione sono troppo piccole per eseguire il verbo. Aumentare le dimensioni dello stack dell'applicazione.LUA_COMM_SUBSYSTEM_NOT_LOADED
Codice restituito primario; Impossibile caricare o terminare un componente richiesto durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva avvenire. Contattare l'amministratore di sistema per un'azione correttiva.LUA_UNEXPECTED_DOS_ERROR
Codice restituito primario; dopo aver eseguito una chiamata al sistema operativo, è stato ricevuto un codice restituito imprevisto del sistema operativo e viene specificato nel codice restituito secondario.
Commenti
RUI_READ può attendere a tempo indeterminato se viene inviato senza usare l'opzione lua_flag1.nowait (restituzione immediata) e nessun dato è disponibile nel flusso specificato. RUI_PURGE forza la restituzione del verbo in attesa (con il codice restituito primario LUA_CANCELED).
Questo verbo viene usato solo quando RUI_READ è stato emesso ed è in attesa di completamento. Il codice restituito primario è LUA_IN_PROGRESS.
Vedere anche
RUI_INIT
RUI_READ
RUI_TERM
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND