Compartir a través de

Información de servicios de administración

  • Artículo

La información sobre los servicios de administración se proporciona en la estructura ms_info_sect, tal y como se define a continuación.

Sintaxis

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;

Miembros

ms_init_sect_len
La longitud de la sección de información de MS inicial, incluido este parámetro, hasta el primer grupo de puntos focales de MS. La longitud no incluye ninguna sección de información anterior.

held_mds_mu_alerts
El número de alertas MDS de servicios de administración que se mantienen y que se enviarán al punto focal (FP) de alertas del servicio de administración cuando haya alguna disponible.

held_nmvt_alerts
El número de alertas NMVT de servicios de administración que se mantienen y que se enviarán al punto focal (FP) de alertas del servicio de administración cuando haya alguna disponible.

num_fps
Número de puntos focales del servicio de administración (MS FP) para los que se devuelve la información que aparece en el grupo de puntos focales de MS. Este es el número de veces que se repite el grupo de información.

total_fps
Número total de puntos focales del servicio de administración para los que APPC tiene información. Este número es el mismo que el que se devuelve en el miembro num_fps, excepto cuando APPC tiene más información sobre los puntos focales del servicio de administración de la que puede colocar en el búfer proporcionado, en cuyo caso este número es mayor.

num_ms_appls
Número de aplicaciones de MS registradas para las que se devuelve la información que aparece en la sección de grupo de aplicaciones MS registradas. Este es el número de veces que se repite el grupo de información.

total_ms_appls
Número total de aplicaciones de MS registradas para las que APPC tiene información. Este número es el mismo que el que se devuelve en el miembro num_ms_appls, excepto cuando APPC tiene más información sobre las aplicaciones MS registradas de la que puede colocar en el búfer proporcionado, en cuyo caso este número es mayor.

num_act_trans
Número de transacciones activas de MS para las que se devuelve la información que aparece en la sección de grupo de transacciones activas de MS. Este es el número de veces que se repite el grupo de información.

total_act_trans
Número de transacciones activas de MS para las que APPC tiene información. Este número es el mismo que el que se devuelve en el miembro num_act_trans, excepto cuando APPC tiene más información sobre las transacciones activas de MS de la que puede colocar en el búfer proporcionado, en cuyo caso este número es mayor.

Para cada grupo de puntos focales del servicio de administración tipo tanto de tipo local como remoto, se proporciona una estructura ms_fp_overlay para el grupo de puntos focales, tal y como se define a continuación.

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 estructura ms_fp_overlay del grupo de puntos focales contiene los miembros siguientes:

ms_fp_entry_len
Tamaño de esta entrada de información de punto focal del servicio de administración.

ms_appl_name
Nombre de la aplicación del servicio de administración del punto focal activo actual (EBCDIC).

ms_category
Categoría del servicio de administración.

fp_fq_cp_name
Nombre completo del punto de control del nodo en el que se encuentra el punto focal del servicio de administración (activo) actual (EBCDIC). Si el nodo local no tiene ningún punto focal, se devuelve un valor de todos los caracteres de espacio de EBCDIC (0x40).

bkup_appl_name
El nombre de la aplicación del servicio de administración del punto focal de copia de seguridad, si se conoce alguno (EBCDIC).

bkup_fp_fq_cp_name
Nombre completo del punto de control del nodo en el que se encuentra el punto focal del servicio de administración de copia de seguridad, si se conoce alguno (EBCDIC). Si el nodo local no tiene ningún punto focal de copia de seguridad, se devuelve un valor de todos los caracteres de espacio de EBCDIC (0x40).

fp_type
Tipo del punto focal para el nodo de punto de entrada del servicio de administración local. El tipo de punto focal depende de cómo se haya establecido la relación de punto focal - punto de conexión y de si el nodo local está configurado como nodo NN, EN o LEN (EN sin compatibilidad con sesiones CP-CP). El tipo puede ser uno de los siguientes:

  • AP_EXPLICIT_PRIMARY_FP
    El punto focal actual es de tipo primario explícito.

  • AP_BACKUP_FP
    El punto focal actual es de tipo de copia de seguridad.

  • AP_DEFAULT_PRIMARY_FP
    El punto focal actual es de tipo principal predeterminado.

  • AP_DOMAIN_FP
    El punto focal actual es de tipo de dominio.

  • AP_HOST_FP
    El punto focal actual es de tipo host.

  • AP_NO_FP
    El nodo local no tiene ningún punto focal actualmente.

fp_status
Estado del punto focal del servicio de administración. El estado puede ser uno de los siguientes:

  • AP_NOT_ACTIVE
    El punto focal se ha adquirido, pero ha quedado como no disponible desde entonces.

  • AP_ACTIVE
    El punto focal remoto se ha adquirido y está disponible.

  • AP_PENDING
    Se ha enviado una solicitud a un punto focal (FP) de copia de seguridad o principal remoto para adquirir ese FP y la respuesta aún no se ha recibido.

  • AP_NEVER_ACTIVE
    El punto focal no se ha adquirido nunca, pero una o varias aplicaciones del servicio de administración registradas han solicitado información del punto focal.

fp_routing
Enrutamiento que se usa para enviar solicitudes no realizadas al punto focal del servicio de administración cuando el nodo local es una instancia de EN. Tenga en cuenta que las solicitudes de NN siempre se envían directamente al punto focal.

El enrutamiento puede ser de los tipos siguientes:

  • AP_DEFAULT
    Las solicitudes del servicio de administración no realizadas destinadas al punto focal se envían desde la instancia de EN a la instancia de NN de servicio para reenviar al punto focal.

  • AP_DIRECT
    Las solicitudes del servicio de administración no realizadas destinadas al punto focal se envían directamente a este.

Comentarios

Cuando un programa registra un nombre de aplicación del servicio de administración, puede solicitar información del punto focal. Cuando APPC adquiere el punto focal, pasa al programa la información de este, que incluye el tipo de enrutamiento que se va a usar para enviar solicitudes del servicio de administración no realizadas al punto focal.