Condividi tramite

TP_STARTED

Il verbo TP_STARTED viene emesso dal programma di transazione chiamante (TP) e notifica all'APPC che il tp è in fase di avvio.

Per Microsoft® Windows® versione 3. X system, è consigliabile usare la funzione WinAsyncAPPC anziché la versione di blocco di questa chiamata.

Nella struttura seguente viene descritto il blocco di controllo verbo utilizzato dal verbo TP_STARTED .

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;  
};

Membri

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

opext
Parametro fornito. Specifica l'estensione dell'operazione verbo. Se il bit AP_EXTD_VCB è impostato, indica che la struttura tp_started include il membro syncpoint_rqd utilizzato 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'unità lu locale è nota 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 finché non viene eseguita un'operazione ALLOCATE o MC_ALLOCATE .

Questo parametro è una stringa di caratteri ASCII a 8 byte. Può essere costituito dai seguenti caratteri ASCII:

  • Lettere maiuscole

  • Numerali 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, aggiungerlo a destra con spazi ASCII (0x20).

Per usare un lu dal pool lu predefinito, impostare questo campo su otto zeri 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 host integration server di APPC questo parametro viene ignorato quando viene rilasciato da TP_STARTED. Tuttavia, questo parametro è obbligatorio se il programma viene eseguito nell'implementazione IBM ES per OS/2 versione 1.0 di APPC.

Questo parametro è una stringa di caratteri EBCDIC a 64 byte e fa distinzione tra maiuscole e minuscole. Il parametro tp_name può essere costituito dai caratteri EDCDIC seguenti:

  • Lettere maiuscole e minuscole

  • Numerali da 0 a 9

  • Caratteri speciali $, #, @e punto (.)

Se il nome TP è di lunghezza inferiore a 64 byte, usare spazi EBCDIC (0x40) per riempirlo a destra.

La convenzione SNA per un nome TP del servizio è composta da un massimo di quattro caratteri. Il primo carattere è un byte esadecimale tra 0x00 e 0x3F.

syncpoint_rqd
Questo parametro facoltativo è applicabile solo se il bit AP_EXTD_VCB è impostato nel parametro opext e sono necessari i servizi punto di sincronizzazione.

  • AP_YES se il punto di sincronizzazione è obbligatorio.
  • AP_NO se il punto di sincronizzazione non è obbligatorio.

Codici di ritorno

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

  • 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 necessario durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva avvenire. Contattare l'amministratore di sistema per un'azione correttiva.

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_TP_BUSY
Codice restituito primario; il TP locale ha inviato una chiamata ad 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 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:

In risposta a TP_STARTED, APPC genera un identificatore TP per il richiamo tp. Questo identificatore è un parametro obbligatorio per i verbi APPC successivi emessi dal tp di chiamata.

Deve trattarsi del primo verbo APPC emesso dal tp di richiamo. Di conseguenza, non esiste alcuno stato APPC precedente.

Se il verbo viene eseguito correttamente (primary_rc è AP_OK), lo stato cambia in RESET.

In questa sezione

  • Last updated on