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 lu partenaire spécifiée, ou toutes les sessions sur un mode particulier.

La structure suivante décrit le bloc de contrôle de 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 de verbe, AP_DEACTIVATE_SESSION.

reserv2
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 dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.

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 dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.

reserv3
Un champ réservé.

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

session_id
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é lu et le mode partenaire.

plu_alias
Paramètre fourni. Fournit le nom ASCII de 8 octets utilisé localement pour l’unité lu partenaire. Si l’unité lu distante par défaut doit être utilisée, remplissez ce paramètre avec des espaces. Si l’unité lu partenaire doit être spécifiée avec le paramètre fqplu_name , renseignez 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 ne se sont pas terminées.

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

reserv4
Un champ réservé.

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

reserv5
Un champ réservé.

Codes de retour

AP_OK
Code de retour principal ; indique que le verbe s’est exécuté correctement. 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 été 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 trouve pas le lu_alias spécifié parmi ceux définis.

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

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

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

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

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 abandon (ABEND).

La connexion entre le TP et le nœud PU 2.1 a été rompue (une erreur de réseau local s’est produite).

Le processus SnaBase qui se déroule sur l’ordinateur du programme transactionnel a rencontré un abandon (ABEND).

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

AP_COMM_SUBSYSTEM_NOT_LOADED
Code de retour principal ; indique qu’il n’a pas été possible de charger un composant requis ou d’y mettre fin lors du traitement du verbe. Par conséquent, la communication n’a pas pu être établie. Contactez l’administrateur système pour mettre en place une action corrective.

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

AP_THREAD_BLOCKING
Code de retour principal ; indique que le thread appelant se trouve déjà dans un appel de blocage.