Informations de session

Article
07/21/2023

Des informations sur les informations de session sont fournies dans la structure sess_info_sect définie ci-dessous.

Syntaxe

typedef struct sess_info_sect {  
    unsigned long  sess_sect_len;  
    unsigned short num_sessions;  
    unsigned short total_sessions;  
} SESS_INFO_SECT;

Membres

sess_sect_len
Longueur de la section d’informations de session initiale, y compris ce paramètre, jusqu’au premier groupe de sessions. La longueur n’inclut pas les sections d’informations précédentes.

num_sessions
Nombre de groupes de sessions retournés par le verbe DISPLAY dans la mémoire tampon de votre programme. Il s’agit du nombre de fois où le groupe de sessions est répété.

total_sessions
Nombre total de groupes de sessions. Ce nombre est le même que le nombre renvoyé dans le membre num_sessions, sauf lorsque APPC contient plus d’informations sur les groupes de sessions qu’il ne peut placer dans la mémoire tampon fournie, auquel cas ce nombre est plus grand.

Pour chaque groupe de sessions, une structure sess_overlay pour la session est fournie, comme indiqué ci-dessous.

typedef struct sess_overlay {  
    unsigned long  sess_entry_len;  
    unsigned long  reserv3;  
    unsigned char  sess_id[8];  
    unsigned long  conv_id[8];  
    unsigned char  lu_alias[8];  
    unsigned char  plu_alias[8];  
    unsigned char  mode_name[8];  
    unsigned short send_ru_size;  
    unsigned short rcv_ru_size;  
    unsigned short send_pacing_size;  
    unsigned short rcv_pacing_size;  
    unsigned char  link_id[12];  
    unsigned char  daf;  
    unsigned char  oaf;  
    unsigned char  odai;  
    unsigned char  sess_type;  
    unsigned char  conn_type;  
    unsigned char  reserv4;  
    FPCID_OVERLAY  fpcid;  
    unsigned char  cgid[4];  
    unsigned char  fqlu_name[17];  
    unsigned char  fqplu_name[17];  
    unsigned char  pacing_type;  
    unsigned char  reserv5;  
 } SESS_OVERLAY;

Défini par IBM ES pour OS/2 version 1.0

La structure sess_overlay telle que définie par IBM ES pour OS/2 version 1.0 contient les membres suivants :

sess_entry_len
Taille de cette entrée de groupe de sessions.

sess_id
Identificateur interne de la session pour laquelle ces informations sont affichées.

conv_id
ID unique à quatre octets de la conversation qui utilise actuellement cette session.

lu_alias
Alias de l’unité logique (ASCII).

plu_alias
Alias de l’unité logique partenaire (ASCII).

mode_name
Le nom du mode (EBCDIC).

send_ru_size Taille maximale de l’unité de requête utilisée dans cette session et cette valeur mode_name pour l’envoi d’unités de requête.

rcv_ru_size
Taille maximale de l’unité de requête utilisée dans cette session et cette valeur mode_name pour la réception d’unités de requête.

send_pacing_size
Taille de la fenêtre de rythme d’envoi sur cette session.

rcv_pacing_size
Taille de la fenêtre de rythme de réception sur cette session.

link_id
Nom de la station de liaison logique locale.

daf
Champ d’adresse de destination pour cette session.

oaf
Champ d’adresse d’origine pour cette session.

odai
Champ d’indicateur d’adresse de destination d’origine pour cette session.

sess_type
Type de session. Le type de session peut être l’un des suivants :

SSCP_PU_SESSION
Cette session se trouve entre une unité physique de station de travail et un point de contrôle des services du système hôte. Ce type de session existe si le nœud local contient une unité logique dépendante, ou si la session a été sollicitée pour envoyer des alertes à l’hôte.
SSCP_LU_SESSION
Cette session est comprise entre une unité logique dépendante et un point de contrôle des services du système hôte.
LU_LU _SESSION
Cette session est comprise entre deux unités logiques.

conn_type
Indique si le protocole d’activation de session suit les règles pour un LU indépendant ou un LU dépendant. Le type de connexion peut être l’un des suivants :

AP_HOST_SESSION
Pour les protocoles d’unité logique dépendants, l’unité logique de station de travail est définie comme dépendant de l’hôte, l’unité logique hôte envoie la requête d’activation de session (BIND) et chaque unité logique de station de travail ne peut prendre en charge qu’une seule session à la fois.
AP_PEER_SESSION
Pour les protocoles d’unité logique indépendants, une unité logique peut envoyer une liaison et peut avoir plusieurs sessions vers différents partenaires, ou des sessions parallèles vers la même unité logique partenaire.

fq_pc_id
Identificateur de corrélation de procédure complet de la session.

cgid
Identificateur unique du groupe de conversations de la session.

fqlu_name
Nom complet de l’unité logique dans EBCDIC (type A).

fqplu_name
Nom complet de l’unité logique partenaire dans EBCDIC (type A).

pacing_type
Voici les types de rythme possibles :

AP_FIXED
Rythme fixe.
AP_ADAPTIVE
Rythme adaptatif.

Retourné par Host Integration Server

La structure sess_overlay retournée par Host Integration Server contient les membres suivants :