TP_STARTED
Il verbo TP_STARTED viene rilasciato dal programma di transazione richiamato (TP) e notifica all'APPC che il TP viene avviato.
Per Microsoft® Windows® versione 3. x system, è consigliabile usare la funzione WinAsyncAPPC anziché la versione di blocco di questa chiamata.
La struttura seguente descrive il blocco di controllo verbo usato dal verbo TP_STARTED verbo.
Sintassi
struct tp_started {
unsigned short opcode;
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char lu_alias[8];
unsigned char tp_id[8];
unsigned char tp_name[64];
unsigned char syncpoint_rqd;
};
Members
Opcode
Parametro fornito. Specifica il codice dell'operazione verbo, AP_TP_STARTED.
opext
Parametro fornito. Specifica l'estensione dell'operazione verbo. Se il bit di AP_EXTD_VCB è impostato, questo indica che la struttura tp_started include il membro syncpoint_rqd usato per il supporto del punto di sincronizzazione. In caso contrario, il blocco di controllo verbo termina immediatamente dopo il membro tp_name .
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.
Lu_alias
Parametro fornito. Specifica l'alias in base al quale l'lu locale è noto al TP locale.
Il nome deve corrispondere a un alias LU stabilito durante la configurazione. APPC controlla l'alias LU rispetto al file di configurazione di Host Integration Server corrente. A causa dell'architettura client/server usata da Host Integration Server, tuttavia, questo parametro non viene convalidato fino a quando non viene eseguito un oggetto ALLOCATE o MC_ALLOCATE .
Questo parametro è una stringa di caratteri ASCII a 8 byte. Può essere costituito dai seguenti caratteri ASCII:
Lettere maiuscole
Numeri da 0 a 9
Spazi
Caratteri speciali $, #, % e @
Il primo carattere di questa stringa non può essere uno spazio.
Se il valore di questo parametro è inferiore a otto byte di lunghezza, tastierarlo a destra con spazi ASCII (0x20).
Per usare un lu dal pool lu predefinito, impostare questo campo su otto zero esadecimali. Per altre informazioni, vedere LUS predefinito.
Tp_id
Parametro restituito. Identifica il TP appena stabilito.
Tp_name
Parametro fornito. Specifica il nome del TP locale.
Nell'implementazione di Host Integration Server di APPC questo parametro viene ignorato quando viene rilasciato da TP_STARTED. Tuttavia, questo parametro è necessario se il programma viene eseguito in IBM ES per OS/2 versione 1.0 dell'implementazione dell'APPC.
Questo parametro è una stringa di caratteri EBCDIC a 64 byte ed è distinzione tra maiuscole e minuscole. Il parametro tp_name può essere costituito dai seguenti caratteri EDCDIC:
Lettere maiuscole e minuscole
Numeri da 0 a 9
Caratteri speciali $, #, @e periodo (.)
Se il nome TP è inferiore a 64 byte di lunghezza, usare spazi EBCDIC (0x40) per tastierarlo a destra.
La convenzione SNA per un nome TP del servizio è fino a quattro caratteri. Il primo carattere è un byte esadecimale tra 0x00 e 0x3F.
syncpoint_rqd
Questo parametro facoltativo è applicabile solo se il bit di AP_EXTD_VCB è impostato nel parametro opext e i servizi punto di sincronizzazione sono necessari.
- AP_YES se è necessario il punto di sincronizzazione.
- AP_NO se il punto di sincronizzazione non è obbligatorio.
Codici restituiti
AP_OK
Codice restituito primario; il verbo eseguito correttamente.
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_COMM_SUBSYSTEM_NOT_LOADED
Codice restituito primario; Impossibile caricare o terminare un componente obbligatorio durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva essere eseguita. Contattare l'amministratore di sistema per un'azione correttiva.
AP_INVALID_VERB_SEGMENT
Codice restituito primario; VCB 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_TP_BUSY
Codice restituito primario; il TP locale ha rilasciato una chiamata all'APPC mentre APPC stava elaborando un'altra chiamata per lo stesso TP.
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 all'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 di byte Intel. Se il problema persiste, consultare l'amministratore di sistema.
Commenti
In risposta alla TP_STARTED, APPC genera un identificatore TP per il richiamo di TP. Questo identificatore è un parametro obbligatorio per i verbi APPC successivi rilasciati dal tp di chiamata.
Questo deve essere il primo verbo APPC rilasciato dal TP richiamato. Di conseguenza, non esiste alcun stato APPC precedente.
Se il verbo viene eseguito correttamente (primary_rc è AP_OK ), lo stato viene modificato in RESET.