Condividi tramite

GET_LU_STATUS

  • Articolo

Il verbo GET_LU_STATUS restituisce lo stato di una particolare unità logica (LU). Questo verbo di conversazione è disponibile solo quando sono supportate le conversazioni del punto di sincronizzazione.

Nella struttura seguente viene descritto il blocco di controllo verbo (VCB) utilizzato dal verbo GET_LU_STATUS .

Sintassi

  
struct get_type {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned char    plu_alias[8];  
    unsigned short   active_sess;  
    unsigned char    zero_sess;  
    unsigned char    local_only;  
    unsigned char    synchpoint;  
    unsigned char    pool_member;  
    unsigned char    reserv3[7];  
};

Members

Opcode
Parametro fornito. Specifica il codice dell'operazione verbo AP_GET_LU_STATUS.

opext
Questo campo è inutilizzato dal verbo GET_LU_STATUS .

reserv2
Un campo riservato.

Primary_rc
Parametro restituito. Specifica il codice restituito primario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC emesso. Per questo verbo, vedere Codici restituiti per codici di errore validi.

Secondary_rc
Parametro restituito. Specifica il codice restituito secondario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC emesso. Per questo verbo, vedere Codici restituiti per codici di errore validi.

Tp_id
Parametro fornito. Identifica il programma di transazione locale (TP). Il valore di questo parametro è stato restituito da TP_STARTED nella chiamata di TP oppure da RECEIVE_ALLOCATE o RECEIVE_ALLOCATE_EX nel tp richiamato.

plu_alias
Parametro fornito. Fornisce l'identificatore per l'unità a cui è inquisto il valore TP. Il valore di questo parametro è stato restituito da MC_ALLOCATE o ALLOCATE nella chiamata di TP o da RECEIVE_ALLOCATE nel tp richiamato.

Non obbligatorio se local_only è impostato su AP_YES

active_sess
Parametro restituito. Fornisce il numero di sessioni attive in questo lu.

zero_sess
Parametro restituito. Indica se una sessione zero è in questo lu. I valori sono AP_YES o AP_NO.

active_sess
Parametro restituito.

zero_sess
Parametro restituito.

local_only
Se questo campo è impostato su AP_YES, non è necessario specificare il plu_alias e il verbo restituisce solo le informazioni lu locali- punto di sincronizzazione e default_pool.

synchpoint
Parametro restituito.

pool_member
Se questo campo è impostato su AP_YES, non è necessario specificare il plu_alias e il verbo restituisce solo le informazioni lu locali- punto di sincronizzazione e default_pool.

reserv3
Un campo riservato.

Codici restituiti

AP_OK
Codice restituito primario; il verbo eseguito correttamente.

AP_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro.

AP_BAD_LU_ALIAS

Codice restituito secondario; il valore di plu_alias non corrisponde ad alcuna unità di archiviazione assegnata da APPC.

AP_BAD_TP_ID

Codice restituito secondario; il valore di tp_id non corrisponde a un identificatore TP assegnato da APPC.

AP_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 tp e il nodo pu 2.1 è stata interrotta (errore LAN).

  • SnaBase nel computer tp ha rilevato un ABEND.

    L'amministratore di sistema deve esaminare il log degli errori per determinare il motivo di ABEND.

    AP_INVALID_VERB_SEGMENT
    Codice restituito primario; VCB si estende oltre la fine del segmento di dati.

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

    AP_CONV_BUSY
    Codice restituito primario; può essere presente un solo verbo di conversazione in sospeso alla volta in qualsiasi conversazione. Ciò può verificarsi se il tp locale ha più thread e più thread eseguono chiamate APPC usando lo stesso conv_id.

    AP_UNEXPECTED_DOS_ERROR
    Codice restituito primario; il sistema operativo ha restituito un errore ad APPC durante l'elaborazione di una chiamata APPC dal tp locale. Il codice restituito dal sistema operativo viene restituito tramite il secondary_rc. Viene visualizzato nell'ordine di scambio dei byte Intel. Se il problema persiste, consultare l'amministratore di sistema.

Commenti

La conversazione può trovarsi in qualsiasi stato, ad eccezione di RESET quando il tp rilascia questo verbo.

Non esiste alcuna modifica dello stato.

La versione corrente di GET_LU_STATUS consente a un'applicazione di recuperare i parametri di configurazione per un LU APPC locale.

Per controllare la configurazione di un particolare lu locale prima di emettere un verbo RECEIVE_ALLOCATE_EX, è necessario eseguire la sequenza verbo seguente:

  • TP_STARTED (specificando l'area lu locale di interesse)

  • GET_LU_STATUS (con local_only impostato su AP_YES)

  • TP_ENDED (AP_SOFT)