共用方式為


管理服務資訊

管理服務的相關資訊會依照下列定義,在 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 取得焦點時,它會傳遞程式焦點資訊,其中包括用來將未經請求的管理服務要求傳送至焦點的路由類型。