Freigeben über

TP_STARTED

Das TP_STARTED Verb wird vom aufrufenden Transaktionsprogramm (TP) ausgegeben und benachrichtigt APPC, dass der TP gestartet wird.

Für Microsoft® Windows®, Version 3. x system, it is recommended that you use the WinAsyncAPPC function rather the blocking version of this call.

In der folgenden Struktur wird der verbsteuerelementblock beschrieben, der vom verb TP_STARTED verb verwendet wird.

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

Elemente

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, gibt dies an, dass die tp_started Struktur das syncpoint_rqd Element enthält, das für die Unterstützung von Synchronisierungspunkt verwendet wird. Andernfalls endet der Verb-Steuerelementblock unmittelbar nach dem tp_name-Element .

reserv2
Ein reserviertes Feld.

primary_rc
Zurückgegebener Parameter. Gibt den primären Rückgabecode an, der von APPC am Ende des Verbs festgelegt wurde. Die gültigen Rückgabecodes variieren je nach ausgegebenen APPC-Verb. Informationen zu gültigen Fehlercodes für dieses Verb finden Sie unter "Rückgabecodes".

secondary_rc
Zurückgegebener Parameter. Gibt den von APPC festgelegten sekundären Rückgabecode am Ende des Verbs an. Die gültigen Rückgabecodes variieren je nach ausgegebenen APPC-Verb. Informationen zu gültigen 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 Konfigurationsdatei des Hostintegrationsservers. Aufgrund der client/server-Architektur, die vom Hostintegrationsserver verwendet wird, wird dieser Parameter jedoch erst überprüft, wenn eine ZUWEISUNG oder MC_ALLOCATE ausgeführt wird.

Dieser Parameter ist eine 8-Byte ASCII-Zeichenfolge. Sie kann aus den folgenden ASCII-Zeichen bestehen:

  • Großbuchstaben

  • Ziffern 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, legen Sie ihn auf der rechten Seite mit ASCII-Leerzeichen (0x20).

Wenn Sie eine LU aus dem Standard-LU-Pool verwenden möchten, legen Sie dieses Feld auf acht hexadezimale Nullen fest. Weitere Informationen finden Sie unter Standard-LUs.

tp_id
Zurückgegebener Parameter. Identifiziert den neu eingerichteten TP.

tp_name
Angegebener Parameter. Gibt den Namen des lokalen TP an.

Unter der Hostintegrationsserverimplementierung von APPC wird dieser Parameter ignoriert, wenn er von TP_STARTED ausgegeben wird. Dieser Parameter ist jedoch erforderlich, wenn das Programm unter der IBM ES für OS/2 Version 1.0-Implementierung von APPC ausgeführt wird.

Dieser Parameter ist eine 64-Byte-EBCDIC-Zeichenzeichenfolge und berücksichtigt die Groß-/Kleinschreibung. Der tp_name-Parameter kann aus den folgenden EDCDIC-Zeichen bestehen:

  • Groß- und Kleinbuchstaben

  • Ziffern von 0 bis 9

  • Sonderzeichen $, #, @und Punkt (.)

Wenn der TP-Name weniger als 64 Bytes lang ist, verwenden Sie EBCDIC-Leerzeichen (0x40), um ihn auf der rechten Seite zu speichern.

Die SNA-Konvention für einen Dienst-TP-Namen beträgt bis zu vier Zeichen. Das erste Zeichen ist ein hexadezimales Byte zwischen 0x00 und 0x3F.

syncpoint_rqd
Dieser optionale Parameter gilt nur, wenn das AP_EXTD_VCB Bit im opext-Parameter festgelegt ist und Synchronisierungspunktdienste erforderlich sind.

  • AP_YES, wenn Synchronisierungspunkt erforderlich ist.
  • AP_NO, wenn der Synchronisierungspunkt nicht erforderlich ist.

Rückgabecodes

AP_OK
Primärer Rückgabecode; das Verb erfolgreich ausgeführt wurde.

AP_COMM_SUBSYSTEM_ABENDED
Primärer Rückgabecode; gibt eine der folgenden Bedingungen an:

  • Der von dieser Unterhaltung verwendete Knoten hat einen ABEND gefunden.

  • Die Verbindung zwischen dem TP und dem PU 2.1-Knoten wurde unterbrochen (LAN-Fehler).

  • Die SnaBase auf dem Computer des TP ist ein ABEND aufgetreten.

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 beim Verarbeiten des Verbs nicht geladen oder beendet werden. So konnte die Kommunikation nicht stattfinden. Wenden Sie sich an den Systemadministrator, um Korrekturmaßnahmen zu ergreifen.

AP_INVALID_VERB_SEGMENT
Primärer Rückgabecode; die VCB über das Ende des Datensegments hinaus erweitert wurde.

AP_STACK_TOO_SMALL
Primärer Rückgabecode; Die Stapelgröße der Anwendung ist zu klein, um das Verb auszuführen. Erhöhen Sie die Stapelgröße Ihrer Anwendung.

AP_TP_BUSY
Primärer Rückgabecode; Der lokale TP hat einen Aufruf an APPC ausgegeben, während APPC einen anderen Aufruf für dasselbe 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 beim Verarbeiten eines APPC-Aufrufs vom lokalen TP einen Fehler an APPC zurückgegeben. Der Rückgabecode des Betriebssystems wird über die secondary_rc zurückgegeben. Es wird in intel byte-getauschter Reihenfolge angezeigt. Wenn das Problem weiterhin besteht, wenden Sie sich an den Systemadministrator.

Bemerkungen

Als Reaktion auf TP_STARTED generiert APPC einen TP-Bezeichner für den aufrufenden 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.

In diesem Abschnitt

  • Last updated on