RUI_PURGE

Il RUI_PURGE verbo annulla un'operazione RUI_READ.

La struttura seguente descrive il 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 del verbo, LUA_VERB_RUI verbi RUI (Request Unit Interface).

lua_verb_length
Parametro fornito. Specifica la lunghezza in byte del VCB dell'applicazione di unità logica (LUA). Deve contenere la lunghezza del record verbo generato.

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

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

lua_opcode
Parametro fornito. Contiene il codice di comando LUA (codice operazione verbo) per il verbo da emissione, 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.

lua_luname
Parametro fornito. Specifica il nome ASCII della lu locale usata dal Windows LUA.

RUI_PURGE richiede questo parametro solo se lua_sid è zero.

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

lua_extension_list_offset
Non usato da RUI 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 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 lua_sid parametro su zero.

lua_max_length
Non usato dal RUI_PURGE e deve essere impostato su zero.

lua_data_length
Non usato dal RUI_PURGE e deve essere impostato su zero.

lua_data_ptr
Punta alla posizione del RUI_READ verbi 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 dal RUI_PURGE e deve essere impostato su zero.

lua_rh
Non usato dal RUI_PURGE e deve essere impostato su zero.

lua_flag1
Non usato dal RUI_PURGE e deve essere impostato su zero.

lua_message_type
Non usato dal RUI_PURGE e deve essere impostato su zero.

lua_flag2
Parametro restituito. Contiene i 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 devono essere impostati su zero.

lua_encr_decr_option
Riservato e devono essere impostati su zero.

Codici restituiti

LUA_OK
Codice restituito primario; Il verbo è stato 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 emesso 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 lua_data_ptr è stato impostato su Null.

LUA_BAD_SESSION_ID

Codice restituito secondario; È stato specificato un lua_sid non valido per il vcb.

LUA_INVALID_POST_HANDLE

Codice restituito secondario; Per un Windows sistema operativo che usa eventi come metodo di pubblicazione asincrono, il vcb lua di Windows non contiene un handle di evento 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 emesso 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 del sistema operativo/2 che ha emesso questo verbo non è lo stesso che ha RUI_INIT per questa sessione. Solo il processo che ha avviato una sessione può rilasciare verbi in tale sessione.

LUA_NO_READ_TO_PURGE

Codice restituito secondario; Il lua_data_ptr non contiene un puntatore a un vcb RUI_READ o RUI_READ prima dell'RUI_PURGE stato eseguito.

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 dell'unità fisica (PU) 2.1 è stata interrotta (errore LAN).

  • SnaBase nel computer TP ha rilevato un ABEND.

    LUA_SESSION_FAILURE
    Codice restituito primario; Un componente Host Integration Server richiesto è terminato.

    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'host LU.

    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; Non è stato possibile caricare un componente obbligatorio o è stato terminato durante l'elaborazione del verbo. Di conseguenza, la comunicazione non è stata possibile. Contattare l'amministratore di sistema per un'azione correttiva.

    LUA_UNEXPECTED_DOS_ERROR
    Codice restituito primario; Dopo l'emissione di una chiamata al sistema operativo, è stato ricevuto un codice restituito imprevisto del sistema operativo specificato nel codice restituito secondario.

Commenti

RUI_READ possibile attendere per un tempo illimitato se viene inviato senza usare l'opzione lua_flag1.nowait (restituzione immediata) e non sono disponibili dati nel flusso specificato. RUI_PURGE forza la restituzione del verbo in attesa (con il codice restituito LUA_CANCELED).

Questo verbo viene usato solo quando RUI_READ è stato emesso ed è in attesa di completamento. Il codice restituito principale è LUA_IN_PROGRESS.

Vedere anche

RUI_INIT
RUI_READ
RUI_TERM
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND