管理服務資訊

管理服務資訊依 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
當有管理服務警示中心（FP）可用時，持有的 MDS 警示數量會被傳送給該中心。

held_nmvt_alerts
管理服務 NMVT 警示的數量，當管理服務警示焦點（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 活躍交易群組中所列資訊所回傳的 MS 活躍交易數量。 這是該資訊群組重複的次數。

total_act_trans
APPC 擁有的 MS 活躍交易資訊數量。 此號碼與 num_act_trans 成員中回傳的號碼相同，除非 APPC 擁有比其能放入緩衝區更多的註冊微軟活躍交易資訊，此時該數字會較大。

對於每個本地及遠端管理服務焦點群組，提供如下定義的焦點群組 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（即無 CP-CP 會話支援的 EN）。 這種類型可以是以下其中一種：

  • 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 取得焦點時，會將焦點資訊傳給程式，其中包括用於向焦點發送未經請求的管理服務請求的路由類型。

  • Last updated on