Freigeben über

Informationen zu Verwaltungsdiensten

  • Artikel

Informationen zu Verwaltungsdiensten werden in der ms_info_sect-Struktur bereitgestellt, wie im Folgenden definiert.

Syntax

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;

Member

ms_init_sect_len
Die Länge des anfänglichen MS-Informationsabschnitts (Management Service, Verwaltungsdienst), einschließlich dieses Parameters, bis zur ersten MS-Fokuspunktgruppe. Die Länge enthält keine vorherigen Informationsabschnitte.

held_mds_mu_alerts
Die Anzahl von Verwaltungsdienst-MDS-Warnungen, die an den Verwaltungsdienst-Warnungsfokuspunkt (FP) gesendet werden, wenn einer verfügbar wird.

held_nmvt_alerts
Die Anzahl von Verwaltungsdienst-NMVT-Warnungen, die an den Verwaltungsdienst-Warnungsfokuspunkt (FP) gesendet werden, wenn einer verfügbar wird.

num_fps
Die Anzahl von Verwaltungsdienst-Fokuspunkten (MS-FPs), für die die unter der MS-Fokuspunktgruppe aufgeführten Informationen zurückgegeben werden. Dies ist die Häufigkeit, mit der die Informationsgruppe wiederholt wird.

total_fps
Die Gesamtzahl von Verwaltungsdienst-Fokuspunkten, für die APPC Informationen bereitstellt. Diese Zahl entspricht der Zahl, die im num_fps-Member zurückgegeben wird, außer wenn APPC mehr Informationen zu Verwaltungsdienst-Fokuspunkten bereitstellt, als im angegebenen Puffer platziert werden können. In diesem Fall ist diese Zahl größer.

num_ms_appls
Die Anzahl von registrierten MS-Anwendungen, für die die unter der Gruppe der registrierten MS-Anwendungen aufgeführten Informationen zurückgegeben werden. Dies ist die Häufigkeit, mit der die Informationsgruppe wiederholt wird.

total_ms_appls
Die Gesamtzahl von registrierten MS-Anwendungen, für die APPC Informationen bereitstellt. Diese Zahl entspricht der Zahl, die im num_ms_appls-Member zurückgegeben wird, außer wenn APPC mehr Informationen zu registrierten MS-Anwendungen bereitstellt, als im angegebenen Puffer platziert werden können. In diesem Fall ist diese Zahl größer.

num_act_trans
Die Anzahl von aktiven MS-Transaktionen, für die die unter der Gruppe der aktiven MS-Transaktionen aufgeführten Informationen zurückgegeben werden. Dies ist die Häufigkeit, mit der die Informationsgruppe wiederholt wird.

total_act_trans
Die Anzahl von aktiven MS-Transaktionen, für die APPC Informationen bereitstellt. Diese Zahl entspricht der Zahl, die im num_act_trans-Member zurückgegeben wird, außer wenn APPC mehr Informationen zu registrierten aktiven MS-Transaktionen bereitstellt, als im angegebenen Puffer platziert werden können. In diesem Fall ist diese Zahl größer.

Für jede lokal und remote operierende Verwaltungsdienst-Fokusgruppe wird eine ms_fp_overlay-Struktur für die Fokuspunktgruppe bereitgestellt, wie im Folgenden definiert.

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;

Die ms_fp_overlay-Struktur für die Fokuspunktgruppe enthält die folgenden Member:

ms_fp_entry_len
Größe dieses Informationseintrags für den Verwaltungsdienst-Fokuspunkt.

ms_appl_name
Der Name der Verwaltungsdienstanwendung des aktuellen aktiven Fokuspunkts (EBCDIC).

ms_category
Die Kategorie des Verwaltungsdiensts.

fp_fq_cp_name
Der vollqualifizierte Name des Steuerungspunkts des Knotens, auf dem sich der aktuelle (aktive) Verwaltungsdienst-Fokuspunkt (EBCDIC) befindet. Wenn der lokale Knoten keinen Fokuspunkt besitzt, wird ein Wert aller EBCDIC-Leerzeichen (0x40) zurückgegeben.

bkup_appl_name
Der Name der Verwaltungsdienstanwendung des Sicherungsfokuspunkts, sofern bekannt (EBCDIC).

bkup_fp_fq_cp_name
Der vollqualifizierte Name des Steuerungspunkts des Knotens, auf dem sich der Sicherungsfokuspunkt des Verwaltungsdiensts (EBCDIC) befindet, sofern bekannt. Wenn der lokale Knoten keinen Sicherungsfokuspunkt besitzt, wird ein Wert aller EBCDIC-Leerzeichen (0x40) zurückgegeben.

fp_type
Der Typ des Fokuspunkts für den Einstiegspunktknoten des lokalen Verwaltungsdiensts. Der Fokuspunkttyp richtet sich danach, wie die Beziehung zwischen Fokuspunkt und Endpunkt eingerichtet wurde und ob der lokale Knoten als NN-, EN- oder LEN-Knoten (EN ohne CP-CP-Sitzungsunterstützung) konfiguriert ist. Als Typ kann eines der folgenden Elemente verwendet werden:

  • AP_EXPLICIT_PRIMARY_FP
    Der aktuelle Fokuspunkttyp ist explizit primär.

  • AP_BACKUP_FP
    Der aktuelle Fokuspunkttyp ist „Sicherung“.

  • AP_DEFAULT_PRIMARY_FP
    Der aktuelle Fokuspunkttyp ist standardmäßig primär.

  • AP_DOMAIN_FP
    Der aktuelle Fokuspunkttyp ist „Domäne“.

  • AP_HOST_FP
    Der aktuelle Fokuspunkttyp ist „Host“.

  • AP_NO_FP
    Derzeit hat der lokale Knoten keinen Fokuspunkt.

fp_status
Der Status des Verwaltungsdienst-Fokuspunkts. Folgende Statuswerte sind möglich:

  • AP_NOT_ACTIVE
    Der Fokuspunkt wurde abgerufen, ist aber inzwischen nicht mehr verfügbar.

  • AP_ACTIVE
    Der Remotefokuspunkt wurde abgerufen und ist verfügbar.

  • AP_PENDING
    Eine Anforderung wurde an einen remote vorhandenen Primär- oder Sicherungsfokuspunkt gesendet, um diesen FP abzurufen, und die Antwort wurde noch nicht empfangen.

  • AP_NEVER_ACTIVE
    Der Fokuspunkt wurde nie abgerufen, aber mindestens eine registrierte Verwaltungsdienstanwendung hat Fokuspunktinformationen angefordert.

fp_routing
Das Routing, das verwendet wird, um nicht angeforderte Anforderungen an den Verwaltungsdienst-Fokuspunkt zu senden, wenn der lokale Knoten ein EN-Knoten ist. Beachten Sie, dass Anforderungen von einem NN-Knoten immer direkt an den Fokuspunkt gesendet werden.

Das Routing kann einen der folgenden Werte aufweisen:

  • AP_DEFAULT
    Unaufgeforderte, für den Fokuspunkt bestimmte Verwaltungsdienstanforderungen werden vom EN-Knoten zur Weiterleitung an den Fokuspunkt an den bereitstellenden NN-Knoten gesendet.

  • AP_DIRECT
    Unaufgeforderte, für den Fokuspunkt bestimmte Verwaltungsdienstanforderungen werden direkt an den Fokuspunkt gesendet.

Hinweise

Wenn ein Programm den Namen einer Verwaltungsdienstanwendung registriert, kann es Fokuspunktinformationen anfordern. Beim Abrufen des Fokuspunkts übergibt APPC dem Programm die Fokusinformationen, einschließlich der Art des zu verwendenden Routings, um unaufgeforderte Verwaltungsdienstanforderungen an den Fokuspunkt zu senden.