Informazioni sui servizi di gestione
Le informazioni sui servizi di gestione vengono fornite nella struttura ms_info_sect , come definito di seguito.
Sintassi
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;
Members
ms_init_sect_len
Lunghezza della sezione iniziale delle informazioni MS, incluso questo parametro, fino al primo gruppo di punti focali MS. La lunghezza non include sezioni di informazioni precedenti.
held_mds_mu_alerts
Numero di avvisi MDS del servizio di gestione che verranno inviati al punto focale dell'avviso del servizio di gestione (FP) quando diventa disponibile.
held_nmvt_alerts
Numero di avvisi NMVT del servizio di gestione che verranno inviati al punto focale dell'avviso del servizio di gestione (FP) quando diventa disponibile.
num_fps
Numero di punti focali del servizio di gestione per i quali vengono restituite le informazioni elencate in MS Focal Point Group. Si tratta del numero di volte in cui il gruppo di informazioni viene ripetuto.
total_fps
Numero totale di punti focali del servizio di gestione per i quali APPC dispone di informazioni. Questo numero è lo stesso del numero restituito nel membro num_fps tranne quando APPC ha più informazioni sui punti focali del servizio di gestione che possono essere inseriti nel buffer fornito, nel qual caso questo numero è più grande.
num_ms_appls
Numero di applicazioni MS registrate per cui vengono restituite le informazioni elencate in Gruppo di applicazioni MS registrato. Si tratta del numero di volte in cui il gruppo di informazioni viene ripetuto.
total_ms_appls
Numero totale di applicazioni MS registrate per cui APPC dispone di informazioni. Questo numero è lo stesso del numero restituito nel membro num_ms_appls tranne quando APPC ha più informazioni sulle applicazioni MS registrate che può posizionare nel buffer fornito, nel qual caso questo numero è più grande.
num_act_trans
Numero di transazioni attive ms per cui vengono restituite le informazioni elencate in MS Active Transaction Group. Si tratta del numero di volte in cui il gruppo di informazioni viene ripetuto.
total_act_trans
Numero o transazioni attive ms per cui APPC dispone di informazioni. Questo numero è lo stesso del numero restituito nel membro num_act_trans tranne quando APPC ha più informazioni sulle transazioni attive MS registrate che può essere inserito nel buffer fornito, nel qual caso questo numero è più grande.
Per ogni gruppo di punti focali del servizio di gestione locale e remota, viene fornita una struttura ms_fp_overlay per il gruppo di punti focali come definito di seguito.
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 struttura ms_fp_overlay per il gruppo di punti focali contiene i membri seguenti:
ms_fp_entry_len
Dimensioni di questa voce di informazioni sul punto focale del servizio di gestione.
ms_appl_name
Nome dell'applicazione del servizio di gestione del punto focale attivo corrente (EBCDIC).
ms_category
Categoria di servizio di gestione.
fp_fq_cp_name
Nome del punto di controllo completo del nodo in cui si trova il punto focale del servizio di gestione corrente (attivo). Se il nodo locale non ha un punto focale, viene restituito un valore di tutti i caratteri di spazio EBCDIC (0x40).
bkup_appl_name
Nome dell'applicazione del servizio di gestione del punto focale di backup, se è noto (EBCDIC).
bkup_fp_fq_cp_name
Nome del punto di controllo completo del nodo in cui si trova il punto focale del servizio di gestione del backup, se è noto (EBCDIC). Se il nodo locale non ha un punto focale di backup, viene restituito un valore di tutti i caratteri di spazio EBCDIC (0x40).
fp_type
Tipo del punto focale per il nodo del punto di ingresso del servizio di gestione locale. Il tipo di punto focale dipende dal modo in cui è stata stabilita la relazione del punto focale e dal fatto che il nodo locale sia configurato come nodo NN, EN o LEN (un nodo EN senza supporto della sessione CP-CP). Il tipo può essere uno dei seguenti:
AP_EXPLICIT_PRIMARY_FP
Il tipo di punto focale corrente è primario esplicito.AP_BACKUP_FP
Il tipo di punto focale corrente viene eseguito il backup.AP_DEFAULT_PRIMARY_FP
Il tipo di punto focale corrente è primario predefinito.AP_DOMAIN_FP
Il tipo di punto focale corrente è dominio.AP_HOST_FP
Il tipo di punto focale corrente è host.AP_NO_FP
Attualmente il nodo locale non ha alcun punto focale.
fp_status
Stato del servizio di gestione focale. Lo stato può essere uno dei seguenti:
AP_NOT_ACTIVE
Il punto focale è stato acquisito, ma è diventato non disponibile.AP_ACTIVE
Il punto focale remoto è stato acquisito ed è disponibile.AP_PENDING
Una richiesta è stata inviata a un punto focale primario o di backup remoto per acquisire tale FP e la relativa risposta non è ancora stata ricevuta.AP_NEVER_ACTIVE
Il punto focale non è mai stato acquisito, ma una o più applicazioni di servizio di gestione registrate hanno richiesto informazioni sul punto focale.
fp_routing
Routing usato per inviare richieste non richieste non richieste al servizio di gestione focale quando il nodo locale è un'EN. Si noti che le richieste da un NN vengono sempre inviate direttamente al punto focale.
Il routing può essere uno dei seguenti:
AP_DEFAULT
Le richieste di servizio di gestione non richieste non richieste destinate al punto focale vengono inviate dall'EN al relativo servizio NN per l'inoltro al punto focale.AP_DIRECT
Le richieste di servizio di gestione non richieste richieste destinate al punto focale vengono inviate direttamente al punto focale.
Commenti
Quando un programma registra un nome dell'applicazione del servizio di gestione, può richiedere informazioni sul punto focale. Quando APPC acquisisce il punto focale, passa il programma le informazioni sul punto focale, che include il tipo di routing da usare per inviare richieste di servizio di gestione non richieste non richieste al punto focale.