Freigeben über

GET_TP_PROPERTIES

  • Artikel

Das GET_TP_PROPERTIES Verb gibt Attribute des Transaktionsprogramms (TP) und der aktuellen Transaktion zurück.

Die folgende Struktur beschreibt den Verb-Kontrollblock, der vom GET_TP_PROPERTIES Verb verwendet wird.

Syntax

  
struct get_tp_properties {  
    unsigned short  opcode;  
    unsigned char   opext;  
    unsigned char   reserv2;  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   tp_id[8];  
    unsigned char   tp_name[64];  
    unsigned char   lu_alias[8];  
    unsigned char   luw_id[26];  
    unsigned char   fqlu_name[17];  
    unsigned char   reserve3[10];  
    unsigned char   user_id[10];  
    unsigned char   prot_luw_id[26];  
    unsigned char   pwd[10];  
};

Member

opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_GET_TP_PROPERTIES an.

opext
Angegebener Parameter. Gibt die Verbvorgangserweiterung an. Wenn das AP_EXTD_VCB Bit festgelegt ist, gibt dies an, dass die get_tp_properties-Struktur den prot_luw_id-Member enthält, der für die Unterstützung des Synchronisierungspunkts verwendet wird. Andernfalls endet der Verb-Kontrollblock unmittelbar nach dem user_id-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“.

tp_id
Angegebener Parameter. Identifiziert den lokalen TP. Der Wert dieses Parameters wurde von TP_STARTED im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

tp_name
Zurückgegebener Parameter. Gibt den TP-Namen des TP an, der das Verb ausgestellt hat. Der Name wird als 64-Byte-EBCDIC-Zeichenfolge zurückgegeben, die rechts mit EBCDIC-Leerzeichen aufgefüllt ist.

lu_alias
Zurückgegebener Parameter. Gibt den Aliasnamen an, der der lokalen LU zugewiesen ist. Es wird als 8-Byte-ASCII-Zeichenfolge zurückgegeben, die auf der rechten Seite mit ASCII-Leerzeichen aufgefüllt ist.

luw_id
Zurückgegebener Parameter. Stellt den ungeschützten logischen Arbeitseinheitsbezeichner für die Transaktion bereit, an der das TP beteiligt ist. Mehrere TPs können an einer Transaktion beteiligt sein. Dieser Bezeichner, der im Namen des TP zugewiesen wird, der die Transaktion initiiert, ermöglicht die logische Verbindung der Konversation, aus der die Transaktion besteht.

Die luw_id kann als luw_id_overlay-Struktur mit den folgenden Feldern dargestellt werden:

typedef struct luw_id_overlay { unsigned char fqla_name_len; unsigned char fqla_name[17]; nsigned char instance[6]; unsigned char sequence[2];} LUW_ID_OVERLAY;

luw_id.fqla_name_len

Eine Länge von 1 Byte des vollqualifizierten LU-Namens für die LU des ursprünglichen TP.

luw_id.fqla_name

Der vollqualifizierte Name der LU für den ursprünglichen TP. Der Name wird als 17-Byte-EBCDIC-Zeichenfolge zurückgegeben, die aus der NETID, einem Punkt und dem LU-Namen besteht. Wenn die Länge des Namens weniger als 17 Byte beträgt, folgen sofort die instance und die Sequenznummern. (Beachten Sie, dass Sie daher nicht die Felder der luw_id_overlay-Struktur verwenden sollten, um auf diese Werte zuzugreifen. Diese werden nur aus Kompatibilitätsgründen bereitgestellt.)

luw_id.instance

Eine 6-Byte-Zeichenfolge, die von der LU für den ursprünglichen TP eindeutig generiert wird.

luw_id.sequence

Eine 2-Byte-Zahl, die das Segment der Arbeitseinheit angibt. (Dies ist immer auf 1 festgelegt, wenn der Synchronisierungspunkt nicht unterstützt wird.)

Wenn die luw_id Länge weniger als 26 Bytes beträgt, wird sie rechts mit EBCDIC-Leerzeichen aufgefüllt.

fqlu_name
Zurückgegebener Parameter. Stellt den vollqualifizierten Namen der lokalen LU bereit. Der Name wird als 17-Byte-EBCDIC-Zeichenfolge zurückgegeben, die aus der NETID, einem Punkt und dem LU-Namen besteht. Der Name ist auf der rechten Seite mit EBCDIC-Leerzeichen aufgefüllt.

reserve3
Ein reserviertes Feld.

User_id
Angegebener Parameter. Gibt die user_id an, die vom initiierenden TP in der Zuordnungsanforderung bereitgestellt wird. Der Name wird als 10-Byte-EBCDIC-Zeichenfolge angegeben, die rechts mit EBCDIC-Leerzeichen aufgefüllt ist.

prot_luw_id
Zurückgegebener Parameter. Enthält den geschützten logischen Arbeitseinheitsbezeichner für die Transaktion, an der das TP teilnimmt, wenn die Konversation dem Synclevel-Synchronisierungspunkt zugeordnet wurde.

Mehrere TPs können an einer Transaktion beteiligt sein. Dieser Bezeichner, der im Namen des TP zugewiesen wird, der die Transaktion initiiert, ermöglicht die logische Verbindung der Konversation, aus der die Transaktion besteht.

Die prot_luw_id kann als luw_id_overlay-Struktur mit den folgenden Feldern dargestellt werden:

typedef struct luw_id_overlay { unsigned char fqla_name_len; unsigned char fqla_name[17]; nsigned char instance[6]; unsigned char sequence[2];} LUW_ID_OVERLAY;

luw_id.fqla_name_len

Eine Länge von 1 Byte des vollqualifizierten LU-Namens für die LU des ursprünglichen TP.

luw_id.fqla_name

Der vollqualifizierte Name der LU für den ursprünglichen TP. Der Name wird als 17-Byte-EBCDIC-Zeichenfolge zurückgegeben, die aus der NETID, einem Punkt und dem LU-Namen besteht. Wenn die Länge des Namens weniger als 17 Byte beträgt, folgen sofort die instance und die Sequenznummern. (Beachten Sie, dass Sie daher nicht die Felder der luw_id_overlay-Struktur verwenden sollten, um auf diese Werte zuzugreifen. Diese werden nur aus Kompatibilitätsgründen bereitgestellt.

luw_id.instance

Eine 6-Byte-Zeichenfolge, die von der LU für den ursprünglichen TP eindeutig generiert wird.

luw_id.sequence

Eine 2-Byte-Zahl, die das Segment der Arbeitseinheit angibt. (Dies ist immer auf 1 festgelegt, wenn der Synchronisierungspunkt nicht unterstützt wird.)

Wenn die prot_luw_id Länge weniger als 26 Bytes beträgt, wird sie rechts mit EBCDIC-Leerzeichen aufgefüllt.

pwd
Angegebener Parameter. Enthält das Kennwort des user_id des initiierenden TP in der Zuordnungsanforderung. Das Kennwort wird als 10-Byte-EBCDIC-Zeichenfolge bereitgestellt, die auf der rechten Seite mit EBCDIC-Leerzeichen aufgefüllt ist.

Rückgabecodes

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

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

AP_BAD_TP_ID

Sekundärer Rückgabecode; Der Wert von tp_id stimmte nicht mit einem TP-Bezeichner überein, der von APPC zugewiesen wurde.

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. Dies kann auftreten, wenn das lokale TP über mehrere Threads verfügt und mehr als ein Thread APPC-Aufrufe mit demselben tp_id ausgibt.

    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

Dieses Verb bezieht sich auf den TP und nicht auf eine Spezifikationsunterhaltung, sodass das TP das Verb in einem beliebigen Zustand ausgeben kann. Es gibt keine Zustandsänderung.

Der luw_id Member enthält Felder für fqla_name_len (die Länge des vollqualifizierten LU-Namens der LU, die dem TP entstammt), fqla_name (der vollqualifizierte Name der LU, der dem TP entstammt), instance (eindeutig von der LU generiert, die dem TP entstammt) und sequenz (immer auf 1 festgelegt und gibt das Segment der Arbeitseinheit an).