Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il verbo REQUEST_TO_SEND notifica al programma di transazione partner (TP) che il tp locale vuole inviare dati.
La struttura seguente descrive il blocco di controllo verbo (VCB) utilizzato dal verbo REQUEST_TO_SEND .
Sintassi
struct request_to_send {
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;
};
Membri
Opcode
Parametro fornito. Specifica il codice dell'operazione verbo, AP_B_REQUEST_TO_SEND.
opext
Parametro fornito. Specifica l'estensione dell'operazione verbo, AP_BASIC_CONVERSATION.
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 tp locale.
Il valore di questo parametro viene restituito da TP_STARTED nella chiamata tp o da RECEIVE_ALLOCATE nel tp richiamato.
conv_id
Parametro fornito. Fornisce l'identificatore della conversazione.
Il valore di questo parametro viene restituito da ALLOCATE nella chiamata tp o da RECEIVE_ALLOCATE nel tp richiamato.
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_STATE_CHECK
Codice restituito primario; il verbo non è stato eseguito perché è stato emesso in uno stato non valido.
AP_R_T_S_BAD_STATE
Codice restituito secondario; la conversazione non è in uno stato consentito quando il TP ha emesso questo verbo.
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_COMM_SUBSYSTEM_NOT_LOADED
Codice restituito primario; Impossibile caricare o terminare un componente obbligatorio durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva avvenire. Contattare l'amministratore di sistema per un'azione correttiva.Quando questo codice restituito viene usato con ALLOCATE, può indicare che non è stato possibile trovare alcun sistema di comunicazione per supportare l'unità logica locale (LU). Ad esempio, l'alias LU locale specificato con TP_STARTED non è corretto o non è stato configurato. Si noti che se lu_alias o mode_name è inferiore a otto caratteri, è necessario assicurarsi che questi campi siano riempiti con spazi a destra. Questo errore viene restituito se questi parametri non vengono riempiti di spazi, poiché non è disponibile alcun nodo in grado di soddisfare la richiesta ALLOCATE .
Quando ALLOCATE produce questo codice restituito per un sistema client di Microsoft Host Integration Server configurato con più nodi, esistono due codici restituiti secondari come indicato di seguito:
0xF0000001
Codice restituito secondario; nessun nodo è stato avviato.
0xF0000002
Codice restituito secondario; almeno un nodo è stato avviato, ma l'lu locale (quando viene emesso TP_STARTED) non è configurato in alcun nodo attivo. Il problema potrebbe essere uno dei seguenti:
Il nodo con l'unità lu locale non viene avviato.
L'unità lu locale non è configurata.
AP_CONVERSATION_TYPE_MIXED
Codice restituito primario; il TP ha rilasciato verbi di conversazione di base e mappati. In una singola conversazione è possibile emettere un solo tipo.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_THREAD_BLOCKING
Codice restituito primario; il thread chiamante è già in una chiamata di blocco.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ò trovarsi in uno degli stati seguenti quando il tp emette questo verbo:
CONFERMARE
PENDING_POST (SISTEMA OPERATIVO/2)
RICEVERE
Non viene apportata alcuna modifica allo stato.
La notifica di richiesta a invio viene ricevuta dal programma partner tramite il parametro rts_rcvd dei verbi seguenti:
-
È anche indicato da un primary_rc di AP_OK su TEST_RTS.
La notifica di richiesta all'invio viene inviata immediatamente al tp del partner; APPC non attende fino a quando il buffer di invio si riempie o viene scaricato. Di conseguenza, la notifica di richiesta a invio potrebbe arrivare fuori sequenza. Ad esempio, se il TP locale si trova nello stato SEND ed emette PREPARE_TO_RECEIVE seguito da REQUEST_TO_SEND, il partner TP, nello stato RECEIVE, potrebbe ricevere la notifica di richiesta-invio prima di ricevere la notifica di invio. Per questo motivo, la richiesta a invio può essere segnalata a un tp tramite un verbo di ricezione.
In risposta a questa richiesta, il partner TP può modificare la conversazione in:
RECEIVE state by emittente PREPARE_TO_RECEIVE o RECEIVE_AND_WAIT.
PENDING_POST stato eseguendo RECEIVE_AND_POST.
Il tp del partner può anche ignorare la richiesta da inviare.
Lo stato della conversazione cambia in SEND per il tp locale quando il tp locale riceve uno dei valori seguenti tramite il parametro what_rcvd di un verbo di ricezione successivo:
AP_CONFIRM_SEND e risposte con CONFERMATO
AP_DATA_COMPLETE_CONFIRM_SEND e risposte con CONFERMATO
AP_DATA_CONFIRM_SEND e risposte con CONFERMATO
AP_SEND
I verbi di ricezione sono RECEIVE_AND_POST, RECEIVE_IMMEDIATE e RECEIVE_AND_WAIT.