DEACTIVATE_SESSION

Le verbe DEACTIVATE_SESSION demande à Microsoft® Host Integration Server de désactiver une session particulière entre l’unité logique locale (LU) et une unité logique partenaire spécifiée, ou toutes les sessions sur un mode particulier.

La structure suivante décrit le bloc de contrôle verbe utilisé par le verbe DEACTIVATE_SESSION .

Syntaxe

  
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;   

Membres

Opcode
Paramètre fourni. Spécifie le code d’opération verbe, AP_DEACTIVATE_SESSION.

réserver2
Champ réservé.

primary_rc
Paramètre retourné. Spécifie le code de retour principal défini par APPC à l’achèvement du verbe. Les codes de retour valides varient en fonction du verbe APPC émis. Consultez les codes de retour pour obtenir des codes d’erreur valides pour ce verbe.

secondary_rc
Paramètre retourné. Spécifie le code de retour secondaire défini par APPC à l’achèvement du verbe. Les codes de retour valides varient en fonction du verbe APPC émis. Consultez les codes de retour pour obtenir des codes d’erreur valides pour ce verbe.

réserver3
Champ réservé.

lu_alias
Paramètre fourni. Fournit le nom ASCII de 8 octets utilisé localement pour l’unité logique.

identifiant_de_session
Paramètre fourni. Fournit l’identificateur de 8 octets de la session à désactiver (retourné sur le verbe ACTIVATE_SESSION ). Si ce champ est défini sur 8 zéros binaires, Host Integration Server désactive toutes les sessions pour l’unité logique et le mode partenaire.

plu_alias
Paramètre fourni. Fournit le nom ASCII de 8 octets utilisé localement pour l’unité logique partenaire. Si la lu distante par défaut doit être utilisée, remplissez ce paramètre avec des espaces. Si l’unité logique partenaire doit être spécifiée avec le paramètre fqplu_name , remplissez ce paramètre avec des zéros binaires.

mode_name
Paramètre fourni. Spécifie le nom du mode EBCDIC (type A).

type
Paramètre fourni. Spécifie le type de désactivation. Les valeurs possibles sont les suivantes :

AP_DEACT_CLEANUP
Désactivez la session immédiatement, sans attendre la fin des sessions.

AP_DEACT_NORMAL
Ne désactivez pas la session tant que toutes les conversations utilisant la session n’ont pas pris fin.

sense_data
Paramètre retourné. Spécifie les données de détection de désactivation de la session.

réserver4
Champ réservé.

fqplu_name
Paramètre fourni. Fournit le nom de l’unité logique partenaire dans EBCDIC (type A) lorsqu’aucun nom de plu_alias n’est défini sur le nœud local et que l’unité logique partenaire se trouve à un autre nœud. Ce paramètre est ignoré si plu_alias est spécifié.

réserver5
Champ réservé.

Codes de retour

AP_OK
Code de retour principal ; le verbe exécuté avec succès. Le code de retour secondaire indique la polarité de la session établie. Les valeurs suivantes peuvent être retournées.

AP_PARAMETER_CHECK
Code de retour principal ; le verbe n’a pas exécuté en raison d’une erreur de paramètre, spécifiée par l’un des codes de retour secondaires suivants :

AP_INVALID_LU_ALIAS
Code de retour secondaire ; APPC ne peut pas trouver la lu_alias spécifiée parmi celles définies.

AP_INVALID_PLU_ALIAS
Code de retour secondaire ; APPC n’a pas reconnu la plu_alias spécifiée.

AP_INVALID_SESSION_ID
Code de retour secondaire ; APPC n’a pas reconnu la session_id spécifiée.

AP_INVALID_MODE_NAME
Code de retour secondaire ; APPC n’a pas reconnu la mode_name spécifiée.

AP_INVALID_FQPLU_NAME
Code de retour secondaire ; APPC n’a pas reconnu la fqplu_name spécifiée.

AP_INVALID_TYPE
Code de retour secondaire ; APPC n’a pas reconnu le type spécifié.

AP_COMM_SUBSYSTEM_ABENDED
Code de retour principal ; indique que l’une des conditions suivantes s’est produite :

Le nœud utilisé par cette conversation a rencontré un ABEND.

La connexion entre le tp et le nœud PU 2.1 a été interrompue (une erreur réseau locale s’est produite).

Le SnaBase sur l’ordinateur du TP a rencontré un ABEND.

L’administrateur système doit examiner le journal des erreurs pour déterminer la raison de l’ABEND.

AP_COMM_SUBSYSTEM_NOT_LOADED
Code de retour principal ; un composant requis n’a pas pu être chargé ou arrêté lors du traitement du verbe. Ainsi, la communication n’a pas pu avoir lieu. Contactez l’administrateur système pour obtenir une action corrective.

AP_STACK_TOO_SMALL
Code de retour principal ; la taille de la pile de l’application est trop petite pour exécuter le verbe. Augmentez la taille de la pile de votre application.

AP_THREAD_BLOCKING
Code de retour principal ; le thread appelant est déjà dans un appel bloquant.