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 allen Sitzungen in einem bestimmten Modus zu deaktivieren.

In der folgenden Struktur wird der verbsteuerelementblock beschrieben, der vom verb 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;   

Elemente

opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_DEACTIVATE_SESSION 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".

Reserv3
Ein reserviertes Feld.

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

Sitzungs-ID
Angegebener Parameter. Stellt den 8-Byte-Bezeichner der zu deaktivierenden Sitzung bereit (zurückgegeben für das verb ACTIVATE_SESSION ). Wenn dieses Feld auf 8 binäre Nullen festgelegt ist, deaktiviert Der Hostintegrationsserver 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 standardmäßige 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 Typ der Deaktivierung an. Mögliche Werte:

AP_DEACT_CLEANUP
Deaktivieren Sie die Sitzung sofort, ohne auf das Beenden von 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.

fqplu_name
Angegebener Parameter. Stellt den Partner-LU-Namen in EBCDIC (Typ A) bereit, wenn kein plu_alias Name am lokalen Knoten definiert ist und sich die Partner-LU an 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 erfolgreich ausgeführt wurde. Der sekundäre Rückgabecode gibt die Polarität der etablierten Sitzung an. Die folgenden Werte können zurückgegeben werden.

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

AP_INVALID_LU_ALIAS
Sekundärer Rückgabecode; APPC kann die angegebene lu_alias unter diesen 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 Unterhaltung verwendete Knoten hat einen ABEND gefunden.

Die Verbindung zwischen dem TP und dem PU 2.1-Knoten wurde unterbrochen (ein Lokaler Netzwerkfehler ist aufgetreten).

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