Freigeben über

RECEIVE_ALLOCATE

Das RECEIVE_ALLOCATE Verb wird vom aufgerufenen Transaktionsprogramm (TP) ausgegeben, um zu bestätigen, dass der aufgerufene TP bereit ist, eine Unterhaltung mit dem aufrufenden TP zu beginnen, das ZUWEISUNG oder MC_ALLOCATE ausgestellt hat.

In der folgenden Struktur wird der verbsteuerungsblock (VCB) beschrieben, der vom RECEIVE_ALLOCATE Verb verwendet wird.

Syntax

  
struct receive_allocate {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_name[64];  
    unsigned char    tp_id[8];  
    unsigned long    conv_id;  
    unsigned char    sync_level;  
    unsigned char    conv_type;  
    unsigned char    user_id[10];  
    unsigned char    lu_alias[8];  
    unsigned char    plu_alias[8];  
    unsigned char    mode_name[8];  
    unsigned char    reserv3[2];  
    unsigned long    conv_group_id;  
    unsigned char    fqplu_name[17];  
    unsigned char    pip_incoming;  
    unsigned char    syncpoint_rqd;  
    unsigned char    reserv4[3];  
};

Elemente

opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_RECEIVE_ALLOCATE an.

opext
Angegebener Parameter. Gibt die Verbvorgangserweiterung AP_BASIC_CONVERSATION an.

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".

tp_name
Angegebener Parameter. Stellt den Namen des lokalen TP bereit. Der Wert von tp_name muss mit dem TP-Namen übereinstimmen, der über Registrierungs- oder Umgebungsvariablen konfiguriert ist. APPC stimmt mit dem tp_name-Parameter des RECEIVE_ALLOCATE Verbs mit dem tp-Namen überein, der durch die eingehende Zuordnung angegeben wird, die von MC_ALLOCATE oder ZUWEISEN im aufrufenden TP generiert wird.

Dieser Parameter ist eine 64-Byte-EBCDIC-Zeichenzeichenfolge und berücksichtigt die Groß-/Kleinschreibung. Der parameter tp_name kann aus Zeichen des Typs AE EBCDIC bestehen:

  • Groß- und Kleinbuchstaben

  • Ziffern 0 bis 9

  • Sonderzeichen $, #und Punkt (.)

    Wenn tp_name weniger als 64 Bytes beträgt, verwenden Sie EBCDIC-Leerzeichen (0x40), um sie auf der rechten Seite zu speichern.

    Die SNA-Konvention besteht darin, dass ein Dienst-TP-Name bis zu vier Zeichen enthalten kann. Das erste Zeichen ist ein hexadezimales Byte zwischen 0x00 und 0x3F. Die anderen Zeichen stammen aus dem Typ AE EBCDIC Zeichensatz.

    tp_id
    Zurückgegebener Parameter. Identifiziert das lokale TP.

    conv_id
    Zurückgegebener Parameter. Stellt den Unterhaltungsbezeichner bereit. Es identifiziert die Unterhaltung APPC zwischen den beiden Partner-TPs.

    sync_level
    Zurückgegebener Parameter. Gibt die Synchronisierungsebene der Unterhaltung an. Sie bestimmt, ob die TPs die Bestätigung des Empfangs von Daten anfordern und den Empfang der Daten bestätigen können.

  • AP_NONE gibt an, dass die Bestätigungsverarbeitung in dieser Unterhaltung nicht verwendet wird.

  • AP_CONFIRM_SYNC_LEVEL gibt an, dass die TPs die Bestätigungsverarbeitung in dieser Unterhaltung verwenden können.

  • AP_SYNCPT gibt an, dass TPs die Bestätigungsverarbeitung von Synchronisierungspunktebene 2 in dieser Unterhaltung verwenden können.

    conv_type
    Zurückgegebener Parameter. Gibt den Vom Partner-TP ausgewählten Unterhaltungstyp mit MC_ALLOCATE oder ZUWEISUNG an. Folgende Werte sind möglich:

    AP_BASIC_CONVERSATION

    AP_MAPPED_CONVERSATION

    user_id
    Zurückgegebener Parameter. Stellt den vom Partner-TP angegebenen Benutzerbezeichner mithilfe von MC_ALLOCATE oder ZUWEISUNG bereit (wenn der Partner-TP den Sicherheitsparameter des MC_ALLOCATE oder ZUWEISEN-Verbs auf AP_PGM oder AP_SAME festgelegt hat). Es handelt sich um einen Typ AE EBCDIC-Zeichenfolge.

    lu_alias
    Zurückgegebener Parameter. Stellt den Alias bereit, mit dem die lokale logische Einheit (LU) dem lokalen TP bekannt ist. Es handelt sich um eine ASCII-Zeichenfolge.

    plu_alias
    Zurückgegebener Parameter. Stellt den Alias bereit, mit dem die Partner-LU (die die eingehende Zuordnung initiiert hat) dem lokalen TP bekannt ist. Es handelt sich um eine ASCII-Zeichenfolge.

    mode_name
    Zurückgegebener Parameter. Stellt den Modusnamen bereit, der durch MC_ALLOCATE oder ALLOCATE im Partner-TP angegeben wird. Es ist der Name einer Reihe von Netzwerkmerkmalen, die während der Konfiguration definiert sind. Die mode_name ist eine EBCDIC-Zeichenfolge vom Typ A.

    Reserv3
    Ein reserviertes Feld.

    conv_group_id
    Unterhaltungsgruppenbezeichner.

    fqplu_name
    Dieser zurückgegebene Parameter stellt den vollqualifizierten LU-Namen bereit.

    pip_incoming
    Dieser optionale und zurückgegebene Parameter gilt nur, wenn Synchronisierungspunktdienste erforderlich sind.

    Für den angegebenen Parameter:

    AP_YES, wenn TP PIP-Daten akzeptiert.

    AP_NO, wenn TP KEINE PIP-Daten akzeptiert.

    Für den zurückgegebenen Parameter:

    AP_YES, wenn PIP-Daten verfügbar sind.

    AP_NO, wenn PIP-Daten nicht verfügbar sind.

    syncpoint_rqd
    Dieser Parameter gibt an, ob Synchronisierungspunktdienste erforderlich sind.

    AP_YES, wenn Synchronisierungspunkt erforderlich ist.

    AP_NO, wenn der Synchronisierungspunkt nicht erforderlich ist.

    reserv4
    Ein reserviertes Feld.

Rückgabecodes

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

AP_PARAMETER_CHECK
Primärer Rückgabecode; das Verb wurde aufgrund eines Parameterfehlers nicht ausgeführt.

AP_UNDEFINED_TP_NAME

Sekundärer Rückgabecode; Der TP-Name wurde nicht ordnungsgemäß konfiguriert.

AP_STATE_CHECK
Primärer Rückgabecode; das Verb wurde nicht ausgeführt, weil es in einem ungültigen Zustand ausgegeben wurde.

AP_ALLOCATE_NOT_PENDING

Sekundärer Rückgabecode; APPC hat keine eingehende Zuordnung (vom aufrufenden TP) gefunden, um dem Wert von tp_name zu entsprechen, der von RECEIVE_ALLOCATE bereitgestellt wird. RECEIVE_ALLOCATE auf die eingehende Zuordnung und schließlich ein Timeout gewartet.

AP_INVALID_PROCESS

Sekundärer Rückgabecode; der Prozess, der RECEIVE_ALLOCATE ausgestellt wurde, unterscheidet sich von dem prozess, der von APPC gestartet 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_CONV_BUSY
    Primärer Rückgabecode; es kann jeweils nur ein herausragendes Unterhaltungsverb für jede Unterhaltung vorhanden sein.

    AP_THREAD_BLOCKING
    Primärer Rückgabecode; Der aufrufende Thread befindet sich bereits in einem blockierenden Aufruf.

    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_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

Dies muss das erste APPC-Verb sein, das vom aufgerufenen TP ausgegeben wird. Der Anfangszustand ist RESET. Wenn das Verb erfolgreich ausgeführt wird (primary_rc ist AP_OK), ändert sich der Zustand in RECEIVE.

Als Reaktion auf dieses Verb stellt APPC eine Unterhaltung zwischen den beiden TPs her und generiert einen TP-Bezeichner für den aufgerufenen TP und einen Unterhaltungsbezeichner. Diese Bezeichner sind erforderliche Parameter für nachfolgende APPC-Verben.

Wenn das aufgerufene TP RECEIVE_ALLOCATE ausgibt und eine entsprechende eingehende Zuordnung (die sich aus MC_ALLOCATE oder ZUWEISUNG ergibt, die vom aufrufenden TP ausgegeben wurde) nicht vorhanden ist, wartet der aufgerufene TP, bis die eingehende Zuordnung eingeht oder das Verb Timesout ausgeht. Der Timeoutwert wird vom Systemadministrator festgelegt.

HostIntegration Server unterstützt auch APPC-RECEIVE_ALLOCATE_EX- und RECEIVE_ALLOCATE_EX_END-Funktionen, um das Entwerfen und Implementieren einiger aufrufbarer Transaktionsprogramme zu vereinfachen. Mit dieser Funktion kann eine APPC-Anwendung alle eingehenden FMH-5 Attach-Anforderungen empfangen, die von Host Integration Server über eine bestimmte lokale APPC LU empfangen werden, sodass eine Anwendung als "Anfüge-Manager" fungiert. Ein Anfüge-Manager ist ein Programm, das eine eingehende FMH-5 Attach-Anforderung verarbeitet, um eine LU6.2-Unterhaltung zu starten. Wenn eine APPC-Anwendung RECEIVE_ALLOCATE aufruft (im Gegensatz zu RECEIVE_ALLOCATE_EX), verarbeitet Hostintegrationsserver die Funktion des Anfügen-Managers.

Weitere Informationen zum Anfügen-Manager finden Sie unter RECEIVE_ALLOCATE_EX.

  • Last updated on