RUI_PURGE

  • Articolo

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