管理服務的相關資訊會依照下列定義,在 ms_info_sect 結構中提供。
語法
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;
成員
ms_init_sect_len
初始 MS 資訊區段的長度,包括此參數,最多到第一個 MS 焦點群組。 長度不包含任何先前的資訊區段。
held_mds_mu_alerts
保留的管理服務 MDS 警示數目,將在 FP) 可用時傳送至管理服務警示 (焦點。
held_nmvt_alerts
保留的管理服務 NMVT 警示數目,將在 FP) 可用時傳送至管理服務警示焦點 (FP。
num_fps
傳回 MS 焦點群組下所列資訊的 MS FP (管理服務焦點數目) 。 這是重複資訊群組的次數。
total_fps
APPC 具有資訊的管理服務焦點總數。 這個數位與 在num_fps 成員中傳回的數位相同,但 APPC 具有管理服務焦點的詳細資訊,而不是在提供的緩衝區中放置,在此情況下,這個數位會較大。
num_ms_appls
傳回 [已註冊的 MS 應用程式群組] 下所列資訊的已註冊 MS 應用程式數目。 這是重複資訊群組的次數。
total_ms_appls
APPC 具有資訊的已註冊 MS 應用程式總數。 這個數位與 num_ms_appls 成員中傳回的數位相同,但 APPC 具有已註冊 MS 應用程式的詳細資訊,而不是在提供的緩衝區中放置,在此情況下,這個數位會較大。
num_act_trans
傳回 MS Active Transaction Group 下所列資訊的 MS 作用中交易數目。 這是重複資訊群組的次數。
total_act_trans
APPC 具有資訊的數位或 MS 作用中交易。 這個數位與 num_act_trans 成員中傳回的數位相同,但 APPC 具有已註冊 MS 作用中交易的詳細資訊,而不是在提供的緩衝區中放置,在此情況下,這個數位會較大。
針對每個本機和遠端系統管理服務焦點群組,會提供 焦點群組的ms_fp_overlay 結構,如下所示。
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;
焦點群組的ms_fp_overlay結構包含下列成員:
ms_fp_entry_len
此管理服務焦點資訊進入的大小。
ms_appl_name
目前作用中焦點的管理服務應用程式名稱 (EBCDIC) 。
ms_category
管理服務類別。
fp_fq_cp_name
目前 (作用中) 管理服務焦點所在的節點完整控制點名稱, (EBCDIC) 。 如果本機節點沒有焦點,則會傳回所有 EBCDIC 空白字元的值 (0x40) 。
bkup_appl_name
如果已知 (EBCDIC) ,則備份焦點的管理服務應用程式名稱。
bkup_fp_fq_cp_name
如果已知 (EBCDIC) ,則備份管理服務焦點所在的節點完整控制點名稱。 如果本機節點沒有備份焦點,則會傳回所有 EBCDIC 空白字元的值 (0x40) 。
fp_type
本機管理服務進入點節點的焦點類型。 焦點類型取決於焦點端點關聯性的建立方式,以及本機節點是否設定為 NN、EN 或 LEN 節點, (EN 而不支援 CP-CP 會話) 。 類型可以是下列其中之一:
AP_EXPLICIT_PRIMARY_FP
目前的焦點類型是明確的主要。AP_BACKUP_FP
目前焦點類型已備份。AP_DEFAULT_PRIMARY_FP
目前的焦點類型是預設的主要焦點。AP_DOMAIN_FP
目前的焦點類型為領域。AP_HOST_FP
目前的焦點類型為主機。AP_NO_FP
目前本機節點沒有焦點。
fp_status
管理服務焦點的狀態。 狀態可能是下列任何一項:
AP_NOT_ACTIVE
已取得焦點,但已變成無法使用。AP_ACTIVE
已取得遠端焦點並可供使用。AP_PENDING
要求已傳送至遠端主要或備份焦點以取得該 FP,且尚未收到其回復。AP_NEVER_ACTIVE
從未取得焦點,但一或多個已註冊的管理服務應用程式要求焦點資訊。
fp_routing
當本機節點為 EN 時,用來將未經要求的要求傳送至管理服務焦點的路由。 請注意,來自 NN 的要求一律會直接傳送至焦點。
路由可以是下列其中一項:
AP_DEFAULT
目的地為焦點的未要求管理服務要求會從 EN 傳送至其服務 NN,以便轉送至焦點。AP_DIRECT
目的地為焦點的未要求管理服務要求會直接傳送至焦點。
備註
當程式註冊管理服務應用程式名稱時,它可以要求焦點資訊。 當 APPC 取得焦點時,它會傳遞程式焦點資訊,其中包括用來將未經請求的管理服務要求傳送至焦點的路由類型。