管理服务信息

项目
07/21/2023

管理服务的相关信息按下面的定义在 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) 时，要发送到 FP 的已暂停管理服务 MDS 警报数。

held_nmvt_alerts
有可用的管理服务警报焦点 (FP) 时，要发送到 FP 的已暂停管理服务 NMVT 警报数。

num_fps
要为其返回“MS 焦点组”下所列信息的管理服务焦点 (MS FP) 数。这是信息组的重复次数。

total_fps
APPC 为其提供了信息的管理服务焦点的总数。此数字与 num_fps 成员中返回的数字相同，但当 APPC 提供的管理服务焦点相关信息比 APPC 能够在提供的缓冲区中放置的信息更多时除外，在这种情况下，此数字更大。

num_ms_appls
要为其返回“已注册 MS 应用程序组”下所列信息的已注册 MS 应用程序数。这是信息组的重复次数。

total_ms_appls
APPC 为其提供了信息的已注册 MS 应用程序的总数。此数字与 num_ms_appls 成员中返回的数字相同，但当 APPC 提供的已注册 MS 应用程序相关信息比 APPC 能够在提供的缓冲区中放置的信息更多时除外，在这种情况下，此数字更大。

num_act_trans
要为其返回“MS 活动事务组”下所列信息的 MS 活动事务数。这是信息组的重复次数。

total_act_trans
APPC 为其提供了信息的 MS 活动事务的数目。此数字与 num_act_trans 成员中返回的数字相同，但当 APPC 提供的已注册 MS 活动事务相关信息比 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 在获取焦点时会将向程序传递焦点信息，其中包括用于向焦点发送不请自来的管理服务请求的路由类型。

通过

管理服务信息

语法

成员

备注

其他资源