GET_LU_STATUS

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.

La struttura seguente descrive 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];  
};   

Membri

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

opext
Questo campo viene inutilizzato dal verbo GET_LU_STATUS .

reserv2
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 rilasciato. Per questo verbo, vedere Codici restituiti per i 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 rilasciato. Per questo verbo, vedere Codici restituiti per i 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 nel TP richiamato oppure da RECEIVE_ALLOCATE o RECEIVE_ALLOCATE_EX nel TP richiamato.

plu_alias
Parametro fornito. Fornisce l'identificatore per l'unità di aggiornamento su cui si sta indagando. Il valore di questo parametro è stato restituito da MC_ALLOCATE o ALLOCATE nella chiamata 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, ovvero il 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, ovvero il punto di sincronizzazione e default_pool.

reserv3
Campo riservato.

Codici di ritorno

AP_OK
Codice restituito primario; 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).

• La SnaBase nel computer del TP ha incontrato 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 è stato esteso 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 del sistema operativo viene restituito tramite il secondary_rc. Viene visualizzato nell'ordine di scambio dei byte Intel. Se il problema persiste, rivolgersi all'amministratore di sistema.

Osservazioni:

La conversazione può essere in qualsiasi stato tranne RESET quando il tp emette questo verbo.

Non viene apportata alcuna modifica allo stato.

La versione corrente di GET_LU_STATUS consente a un'applicazione di recuperare i parametri di configurazione per un'unità logica app 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'lu locale di interesse)

• GET_LU_STATUS (con local_only impostato su AP_YES)

• TP_ENDED (AP_SOFT)