GET_STATE

Il verbo GET_STATE restituisce lo stato di una conversazione specifica.

La struttura seguente descrive il blocco di controllo verbo (VCB) utilizzato dal verbo GET_STATE .

Sintassi

  
struct get_state {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned long    conv_id;  
    unsigned char    conv_state;  
};   

Membri

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

opext
Questo campo viene inutilizzato dal verbo GET_STATE .

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 nella chiamata tp o da RECEIVE_ALLOCATE nel tp richiamato.

conv_id
Parametro fornito. Fornisce l'identificatore per la conversazione 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.

conv_state
Parametro restituito. Indica lo stato della conversazione. Il parametro conv_state può essere uno dei valori seguenti:

AP_RESET_STATE

La conversazione si trova nello stato RESET.

AP_SEND_STATE

La conversazione si trova nello stato SEND.

AP_RECEIVE_STATE

La conversazione si trova nello stato RECEIVE.

AP_CONFIRM_STATE

La conversazione si trova nello stato CONFIRM.

AP_CONFIRM_SEND_STATE

La conversazione si trova nello stato CONFIRM_SEND.

AP_CONFIRM_DEALL_STATE

La conversazione si trova nello stato CONFIRM_DEALLOCATE.

AP_PEND_POST_STATE

La conversazione ha un verbo POST in sospeso.

AP_PEND_DEALL_STATE

La conversazione ha un verbo DEALLOCATE in sospeso.

AP_END_CONV_STATE

La conversazione si trova nello stato END_CONVERSATION.

AP_SEND_PENDING_STATE

La conversazione si trova nello stato SEND_PENDING.

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_CONV_ID

Codice restituito secondario; il valore di conv_id non corrisponde a un identificatore di conversazione assegnato 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 quando il tp emette questo verbo.

Non viene apportata alcuna modifica allo stato.