TP_STARTED
Das TP_STARTED-Verb wird vom aufrufenden Transaktionsprogramm (TP) ausgegeben und benachrichtigt APPC, dass das TP gestartet wird.
Microsoft® Windows® Version 3. x-System: Es wird empfohlen, die WinAsyncAPPC-Funktion anstelle der blockierenden Version dieses Aufrufs zu verwenden.
In der folgenden Struktur wird der vom TP_STARTED-Verb verwendete Verbkontrollblock (Verb Control Block, VCB) beschrieben.
Syntax
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;
};
Member
opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_TP_STARTED an.
opext
Angegebener Parameter. Gibt die Verbvorgangserweiterung an. Wenn das AP_EXTD_VCB-Bit festgelegt ist, weist dies darauf hin, dass die tp_started-Struktur den syncpoint_rqd-Member enthält, der für die Unterstützung des Synchronisierungspunkts verwendet wird. Andernfalls endet der Verbkontrollblock unmittelbar nach dem tp_name-Member.
reserv2
Ein reserviertes Feld.
primary_rc
Zurückgegebener Parameter. Gibt den primären Rückgabecode an, der von APPC nach Abschluss des Verbs festgelegt wird. Die gültigen Rückgabecodes variieren je nach ausgegebenem APPC-Verb. Gültige Fehlercodes für dieses Verb finden Sie unter „Rückgabecodes“.
secondary_rc
Zurückgegebener Parameter. Gibt den sekundären Rückgabecode an, der von APPC nach Abschluss des Verbs festgelegt wird. Die gültigen Rückgabecodes variieren je nach ausgegebenem APPC-Verb. Gültige Fehlercodes für dieses Verb finden Sie unter „Rückgabecodes“.
lu_alias
Angegebener Parameter. Gibt den Alias an, mit dem die lokale LU dem lokalen TP bekannt ist.
Der Name muss mit einem LU-Alias übereinstimmen, der während der Konfiguration eingerichtet wurde. APPC überprüft den LU-Alias anhand der aktuellen Host Integration Server-Konfigurationsdatei. Aufgrund der von Host Integration Server verwendeten Client/Server-Architektur wird dieser Parameter jedoch erst überprüft, wenn ein ALLOCATE oder MC_ALLOCATE ausgeführt wird.
Dieser Parameter ist eine 8-Byte-ASCII-Zeichenfolge. Sie kann aus den folgenden ASCII-Zeichen bestehen:
Großbuchstaben
Zahlen von 0 bis 9
Leerzeichen
Sonderzeichen $, #, % und @
Das erste Zeichen dieser Zeichenfolge darf kein Leerzeichen sein.
Wenn der Wert dieses Parameters weniger als acht Bytes lang ist, füllen Sie ihn rechts mit ASCII-Leerzeichen (0x20) auf.
Um eine LU aus dem Standard-LU-Pool zu verwenden, legen Sie dieses Feld auf acht hexadezimale Nullen fest. Weitere Informationen finden Sie unter Standard-LUs.
tp_id
Zurückgegebener Parameter. Identifiziert die neu eingerichtete TP.
tp_name
Angegebener Parameter. Gibt den Namen des lokalen TPs an.
Unter der Host Integration Server-Implementierung von APPC wird dieser Parameter ignoriert, wenn er von TP_STARTED ausgegeben wird. Dieser Parameter ist jedoch erforderlich, wenn das Programm unter der Implementierung von IBM ES für OS/2 Version 1.0 von APPC ausgeführt wird.
Dieser Parameter ist eine EBCDIC-Zeichenfolge mit 64 Byte und berücksichtigt Groß-/Kleinschreibung. Der tp_name-Parameter kann aus den folgenden EDCDIC-Zeichen bestehen:
Groß- und Kleinbuchstaben
Zahlen von 0 bis 9
Sonderzeichen $, #, @ und Punkt (.)
Wenn der TP-Name weniger als 64 Byte lang ist, verwenden Sie EBCDIC-Leerzeichen (0x40), um ihn auf der rechten Seite aufzufüllen.
Die SNA-Konvention für den TP-Namen eines Diensts beträgt bis zu vier Zeichen. Das erste Zeichen ist ein hexadezimales Byte zwischen 0x00 und 0x3F.
syncpoint_rqd
Dieser optionale Parameter ist nur anwendbar, wenn das AP_EXTD_VCB-Bit im opext-Parameter festgelegt ist und Synchronisierungspunktdienste erforderlich sind.
- AP_YES, wenn ein Synchronisierungspunkt erforderlich ist.
- AP_NO, wenn kein Synchronisierungspunkt erforderlich ist.
Rückgabecodes
AP_OK
Primärer Rückgabecode; das Verb wurde erfolgreich ausgeführt.
AP_COMM_SUBSYSTEM_ABENDED
Primärer Rückgabecode; weist darauf hin, dass eine der folgenden Bedingungen aufgetreten ist:
Der von dieser Konversation verwendete Knoten hat einen ABEND gefunden.
Die Verbindung zwischen dem TP und dem PU 2.1-Knoten wurde unterbrochen (LAN-Fehler).
SnaBase auf dem Computer des TP hat einen ABEND gefunden.
Der Systemadministrator sollte das Fehlerprotokoll untersuchen, um den Grund für den ABEND zu ermitteln.
AP_COMM_SUBSYSTEM_NOT_LOADED
Primärer Rückgabecode; eine erforderliche Komponente konnte während der Verarbeitung des Verbs nicht geladen oder beendet werden. Folglich konnte die Kommunikation nicht stattfinden. Wenden Sie sich an den Systemadministrator, um Korrekturmaßnahmen zu ergreifen.
AP_INVALID_VERB_SEGMENT
Primärer Rückgabecode; der VCB wurde über das Ende des Datensegments hinaus erweitert.
AP_STACK_TOO_SMALL
Primärer Rückgabecode; die Stapelgröße der Anwendung ist zu klein, um das Verb auszuführen. Vergrößern Sie die Stapelgröße Ihrer Anwendung.
AP_TP_BUSY
Primärer Rückgabecode; die lokale TP hat APPC aufgerufen, während APPC einen weiteren Aufruf für denselben TP verarbeitet hat.
AP_THREAD_BLOCKING
Primärer Rückgabecode; der aufrufende Thread befindet sich bereits in einem blockierenden Aufruf.
AP_UNEXPECTED_DOS_ERROR
Primärer Rückgabecode; das Betriebssystem hat bei der Verarbeitung eines APPC-Aufrufs vom lokalen TP einen Fehler an APPC zurückgegeben. Der Rückgabecode des Betriebssystems wurde über secondary_rc zurückgegeben. Er wird in Intel-Bytetauschreihenfolge angezeigt. Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Systemadministrator.
Hinweise
Als Reaktion auf TP_STARTED generiert APPC einen TP-Bezeichner für das aufrufende TP. Dieser Bezeichner ist ein erforderlicher Parameter für nachfolgende APPC-Verben, die vom aufrufenden TP ausgegeben werden.
Dies muss das erste APPC-Verb sein, das vom aufrufenden TP ausgegeben wird. Folglich ist kein vorheriger APPC-Zustand vorhanden.
Wenn das Verb erfolgreich ausgeführt wird (primary_rc ist AP_OK), ändert sich der Zustand in RESET.