Freigeben über

GET_LU_STATUS

  • Artikel

Das GET_LU_STATUS Verb gibt den status einer bestimmten logischen Einheit (LU) zurück. Dieses Konversationsverb ist nur verfügbar, wenn Synchronisierungspunktunterhaltungen unterstützt werden.

Die folgende Struktur beschreibt den verb control block (VCB), der vom GET_LU_STATUS Verb verwendet wird.

Syntax

  
struct get_type {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned char    plu_alias[8];  
    unsigned short   active_sess;  
    unsigned char    zero_sess;  
    unsigned char    local_only;  
    unsigned char    synchpoint;  
    unsigned char    pool_member;  
    unsigned char    reserv3[7];  
};

Member

opcode
Angegebener Parameter. Gibt den Code des Verbvorgangs AP_GET_LU_STATUS an.

opext
Dieses Feld wird vom GET_LU_STATUS Verb nicht verwendet.

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. Gibt das lokale Transaktionsprogramm (TP) an. Der Wert dieses Parameters wurde von TP_STARTED im aufrufenden TP oder von RECEIVE_ALLOCATE oder RECEIVE_ALLOCATE_EX im aufgerufenen TP zurückgegeben.

plu_alias
Angegebener Parameter. Stellt den Bezeichner für die LU bereit, zu der dieser TP anfordert. Der Wert dieses Parameters wurde von MC_ALLOCATE oder ALLOCATE im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

Nicht erforderlich, wenn local_only auf AP_YES festgelegt ist

active_sess
Zurückgegebener Parameter. Gibt die Anzahl der aktiven Sitzungen für diese LU an.

zero_sess
Zurückgegebener Parameter. Gibt an, ob sich eine Sitzung mit 0 (null) auf dieser LU befindet. Werte werden AP_YES oder AP_NO.

active_sess
Zurückgegebener Parameter.

zero_sess
Zurückgegebener Parameter.

local_only
Wenn dieses Feld auf AP_YES festgelegt ist, muss die plu_alias nicht angegeben werden, und das Verb gibt nur die lokalen LU-Informationen zurück – syncpoint und default_pool.

synchpoint
Zurückgegebener Parameter.

pool_member
Wenn dieses Feld auf AP_YES festgelegt ist, muss die plu_alias nicht angegeben werden, und das Verb gibt nur die lokalen LU-Informationen zurück – syncpoint und default_pool.

reserv3
Ein reserviertes Feld.

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_LU_ALIAS

Sekundärer Rückgabecode; der Wert von plu_alias nicht mit den von APPC zugewiesenen LUs übereinstimmt.

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_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_CONV_BUSY
    Primärer Rückgabecode; es kann jeweils nur ein ausstehendes Konversationsverb gleichzeitig geben. Dies kann auftreten, wenn das lokale TP über mehrere Threads verfügt und mehr als ein Thread APPC-Aufrufe mit demselben conv_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

Die Konversation kann sich in einem beliebigen Zustand befinden, mit Ausnahme von RESET, wenn das TP dieses Verb ausgibt.

Es gibt keine Zustandsänderung.

Die aktuelle Version von GET_LU_STATUS ermöglicht es einer Anwendung, Konfigurationsparameter für eine lokale APPC-LU abzurufen.

Um die Konfiguration einer bestimmten lokalen LU vor dem Ausgeben eines RECEIVE_ALLOCATE_EX Verbs zu überprüfen, sollte die folgende Verbsequenz ausgegeben werden:

  • TP_STARTED (angabe der relevanten lokalen LU)

  • GET_LU_STATUS (wobei local_only auf AP_YES festgelegt ist)

  • TP_ENDED (AP_SOFT)