GET_STATE

Il verbo GET_STATE restituisce lo stato di una conversazione specifica.

Nella struttura seguente viene descritto 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;  
};   

Members

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

opext
Questo campo non è utilizzato dal verbo GET_STATE .

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

Conv_id
Parametro fornito. Fornisce l'identificatore per la conversazione su cui è inquisto questo tp. Il valore di questo parametro è stato restituito da MC_ALLOCATE o ALLOCATE nella chiamata di 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 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_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).

• 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ò essere in qualsiasi stato quando il tp rilascia questo verbo.

Non esiste alcuna modifica dello stato.