DEACTIVATE_SESSION

Das DEACTIVATE_SESSION Verb fordert Microsoft® Host Integration Server auf, eine bestimmte Sitzung zwischen der lokalen logischen Einheit (LU) und einer angegebenen Partner-LU oder alle Sitzungen in einem bestimmten Modus zu deaktivieren.

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

Syntax

  
typedef struct deactivate_session {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   reserv3[8];  
    unsigned char   lu_alias[8];  
    unsigned char   session_id[8];  
    unsigned char   plu_alias[8];  
    unsigned char   mode_name[8];  
    unsigned char   type;  
    unsigned char   reserv4[3];  
    unsigned short  sense_data;  
    unsigned char   fqplu_name[17];  
    unsigned char   reserv5[19];  
} DEACTIVATE_SESSION;   

Member

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

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

reserv3
Ein reserviertes Feld.

lu_alias
Angegebener Parameter. Stellt den 8-Byte-ASCII-Namen bereit, der lokal für die LU verwendet wird.

session_id
Angegebener Parameter. Stellt den 8-Byte-Bezeichner der zu deaktivierenden Sitzung bereit (wird für das ACTIVATE_SESSION Verb zurückgegeben). Wenn dieses Feld auf 8 binäre Nullen festgelegt ist, deaktiviert Host Integration Server alle Sitzungen für die Partner-LU und den Modus.

plu_alias
Angegebener Parameter. Stellt den 8-Byte-ASCII-Namen bereit, der lokal für die Partner-LU verwendet wird. Wenn die Standard-Remote-LU verwendet werden soll, füllen Sie diesen Parameter mit Leerzeichen aus. Wenn die Partner-LU mit dem parameter fqplu_name angegeben werden soll, füllen Sie diesen Parameter mit binären Nullen aus.

mode_name
Angegebener Parameter. Gibt den Namen des EBCDIC-Modus (Typ A) an.

Typ
Angegebener Parameter. Gibt den Deaktivierungstyp an. Mögliche Werte:

AP_DEACT_CLEANUP
Deaktivieren Sie die Sitzung sofort, ohne auf das Ende der Sitzungen zu warten.

AP_DEACT_NORMAL
Deaktivieren Sie die Sitzung erst, wenn alle Unterhaltungen, die die Sitzung verwenden, beendet wurden.

sense_data
Zurückgegebener Parameter. Gibt die Deaktivierungsoptimierungsdaten für die Sitzung an.

reserv4
Ein reserviertes Feld.

fqlu_name
Angegebener Parameter. Stellt den Partner-LU-Namen in EBCDIC (Typ A) bereit, wenn auf dem lokalen Knoten kein plu_alias Name definiert ist und sich die Partner-LU auf einem anderen Knoten befindet. Dieser Parameter wird ignoriert, wenn plu_alias angegeben wird.

reserv5
Ein reserviertes Feld.

Rückgabecodes

AP_OK
Primärer Rückgabecode; das Verb wurde erfolgreich ausgeführt. Der sekundäre Rückgabecode gibt die Polarität der eingerichteten Sitzung an. Die folgenden Werte können zurückgegeben werden.

AP_PARAMETER_CHECK
Primärer Rückgabecode; Das Verb wurde aufgrund eines Parameterfehlers, der durch einen der folgenden sekundären Rückgabecodes angegeben wird, nicht ausgeführt:

AP_INVALID_LU_ALIAS
Sekundärer Rückgabecode; APPC kann die angegebene lu_alias unter den definierten nicht finden.

AP_INVALID_PLU_ALIAS
Sekundärer Rückgabecode; APPC hat die angegebene plu_alias nicht erkannt.

AP_INVALID_SESSION_ID
Sekundärer Rückgabecode; APPC hat die angegebene session_id nicht erkannt.

AP_INVALID_MODE_NAME
Sekundärer Rückgabecode; APPC hat die angegebene mode_name nicht erkannt.

AP_INVALID_FQPLU_NAME
Sekundärer Rückgabecode; APPC hat die angegebene fqplu_name nicht erkannt.

AP_INVALID_TYPE
Sekundärer Rückgabecode; APPC hat den angegebenen Typ nicht erkannt.

AP_COMM_SUBSYSTEM_ABENDED
Primärer Rückgabecode; gibt an, 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 (ein Lokaler Netzwerkfehler ist aufgetreten).

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_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_THREAD_BLOCKING
Primärer Rückgabecode; der aufrufende Thread befindet sich bereits in einem blockierenden Aufruf.