Partager via

Informations de gestion des services

  • Article

Les informations sur les services de gestion sont fournies dans la structure ms_info_sect, comme indiqué ci-dessous.

Syntaxe

typedef struct ms_info_sect {  
    unsigned long  ms_init_sect_len;  
    unsigned char  held_mds_mu_alerts;  
    unsigned char  held_nmvt_alerts;  
    unsigned short num_fps;  
    unsigned short total_fps;  
    unsigned short num_ms_appls;  
    unsigned short total_ms_appls;  
    unsigned short num_act_trans;  
    unsigned short total_act_trans;  
} MS_INFO_SECT;

Membres

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

held_mds_mu_alerts
Nombre d’alertes de service de gestion MDS qui seront envoyées au point focal des alertes de service de gestion (FP) lorsqu’un sera disponible.

held_nmvt_alerts
Nombre d’alertes de service de gestion NMVT qui seront envoyées au point focal des alertes de service de gestion (FP) lorsqu’un sera disponible.

num_fps
Nombre de points focaux de service de gestion (MS FP) pour lesquels les informations listées sous Groupe de points focaux sont retournées. Il s’agit du nombre de fois où le groupe d’informations est répété.

total_fps
Nombre total de points focaux du service de gestion pour lesquels APPC contient des informations. Ce nombre est le même que le nombre renvoyé dans le membre num_links, sauf lorsque APPC contient plus d’informations sur les liaisons actives qu’il ne peut placer dans la mémoire tampon fournie, auquel cas ce nombre est plus grand.

num_ms_appls
Nombre d’applications MS inscrites pour lesquelles les informations répertoriées sous Groupe d’applications MS inscrit sont retournées. Il s’agit du nombre de fois où le groupe d’informations est répété.

total_ms_appls
Nombre total d’applications MS enregistrées pour lesquelles APPC contient des informations. Ce nombre est le même que le nombre renvoyé dans le membre num_ms_appls, sauf lorsque APPC contient plus d’informations sur les applications MS inscrites qu’il ne peut placer dans la mémoire tampon fournie, auquel cas ce nombre est plus grand.

num_act_trans
Nombre de transactions MS actives pour lesquelles les informations figurant sous Groupe de transactions actives MS sont retournées. Il s’agit du nombre de fois où le groupe d’informations est répété.

total_act_trans
Nombre ou transactions MS actives pour lesquelles APPC contient des informations. Ce nombre est le même que le nombre renvoyé dans le membre num_act_trans, sauf lorsque APPC contient plus d’informations sur les transactions MS actives inscrites qu’il ne peut placer dans la mémoire tampon fournie, auquel cas ce nombre est plus grand.

Pour chaque groupe de points focaux du service de gestion local et distant, une structure de ms_fp_overlay pour le groupe de points focaux est fournie comme indiqué ci-dessous.

typedef struct ms_fp_overlay {  
    unsigned long  ms_fp_entry_len;  
    unsigned char  ms_appl_name[8];  
    unsigned char  ms_category[4];  
    unsigned char  fp_fq_cp_name[17];  
    unsigned char  bkup_appl_name[8];  
    unsigned char  bkup_fp_fq_cp_name[17];  
    unsigned char  reserv1;  
    unsigned char  fp_type;  
    unsigned char  fp_status;  
    unsigned char  fp_routing;  
} MS_FP_OVERLAY;

La structure ms_fp_overlay pour le groupe de points focaux contient les membres suivants :

ms_fp_entry_len
Taille de cette entrée d’informations sur le point focal du service de gestion.

ms_appl_name
Nom de l’application de service de gestion du point focal actif actuel (EBCDIC).

ms_category
Catégorie du service de gestion.

fp_fq_cp_name
Nom du point de contrôle complet du nœud sur lequel le point focal du service de gestion (actif) actuel est situé (EBCDIC). Si le nœud local n’a pas de point focal, une valeur de tous les caractères d’espace EBCDIC (0x40) est retournée.

bkup_appl_name
Nom de l’application de service de gestion du point focal de sauvegarde, s’il est connu (EBCDIC).

bkup_fp_fq_cp_name
Nom du point de contrôle complet du nœud sur lequel le point focal du service de gestion de sauvegarde est situé, s’il est connu (EBCDIC). Si le nœud local n’a pas de point focal de sauvegarde, une valeur de tous les caractères d’espace EBCDIC (0x40) est retournée.

fp_type
Type du point focal du nœud de point d’entrée du service de gestion local. Le type de point focal dépend de la façon dont la relation entre point focal et point de terminaison a été établie et de la configuration du nœud local en tant que nœud NN, EN ou LEN (un EN sans la prise en charge des sessions CP-CP). Le type peut être l’un des suivants :

  • AP_EXPLICIT_PRIMARY_FP
    Le type de point focal actuel est un principal explicite.

  • AP_BACKUP_FP
    Le type de point focal actuel est sauvegardé.

  • AP_DEFAULT_PRIMARY_FP
    Le type de point focal actuel est un principal par défaut.

  • AP_DOMAIN_FP
    Le type de point focal actuel est domaine.

  • AP_HOST_FP
    Le type de point focal actuel est hôte.

  • AP_NO_FP
    Actuellement, le nœud local n’a pas de point focal.

fp_status
État du point focal du service de gestion. Il peut s’agir d'un des états suivants :

  • AP_NOT_ACTIVE
    Le point focal a été acquis, mais il n’est plus disponible.

  • AP_ACTIVE
    Le point focal distant a été acquis et est disponible.

  • AP_PENDING
    Une requête a été envoyée à un point focal principal ou de sauvegarde distant pour acquérir ce FP et sa réponse n’a pas encore été reçue.

  • AP_NEVER_ACTIVE
    Le point focal n’a jamais été acquis, mais une ou plusieurs applications de service de gestion inscrites ont demandé des informations sur le point focal.

fp_routing
Routage utilisé pour envoyer des requêtes non sollicitées à ce point focal de service de gestion lorsque le nœud local est un EN. Notez que les requêtes d’un NN sont toujours envoyées directement au point focal.

Le routage peut être l’un des suivants :

  • AP_DEFAULT
    Les requêtes de service de gestion non sollicitées destinées au point focal sont envoyées du EN à son NN de service pour le transfert vers le point focal.

  • AP_DIRECT
    Les requêtes de service de gestion non sollicitées destinées au point focal sont envoyées directement au point focal.

Notes

Lorsqu’un programme inscrit un nom d’application de service de gestion, il peut demander des informations sur le point focal. Lorsque APPC acquiert le point focal, il transmet au programme les informations sur le point focal, y compris le type de routage à utiliser pour envoyer des requêtes de service de gestion non sollicitées au point focal.