管理サービスに関する情報は、以下に定義されている 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;
Members
ms_init_sect_len
このパラメーターを含む、最初の MS フォーカル・ポイント・グループまでの初期 MS 情報セクションの長さ。 この長さには、前の情報セクションは含まれません。
held_mds_mu_alerts
管理サービス MDS アラートが使用可能になったときに管理サービス アラート フォーカル ポイント (FP) に送信される、保持されている管理サービス MDS アラートの数。
held_nmvt_alerts
利用可能になると管理サービス・アラート・フォーカルポイント (FP) に送信される、保留中の管理サービス NMVT アラートの数。
num_fps
MS フォーカル ポイント グループにリストされている情報が返される管理サービス フォーカル ポイント (MS FP) の数。 これは、情報グループが繰り返される回数です。
total_fps
APPC に情報が含まれる管理サービスフォーカル ポイントの合計数。 この数値は、 APPC が指定されたバッファーに配置できるよりも管理サービスのフォーカル ポイントに関する情報が多い場合を除き、num_fps メンバーで返される数と同じです。この場合、この数は大きくなります。
num_ms_appls
登録済み MS アプリケーション グループに一覧表示されている情報が返される登録済み MS アプリケーションの数。 これは、情報グループが繰り返される回数です。
total_ms_appls
APPC に情報が含まれる登録済み MS アプリケーションの合計数。 この数値は、 APPC が登録された MS アプリケーションに関する情報が指定されたバッファーに配置できるよりも多い場合を除き、num_ms_appls メンバーで返される数と同じです。この場合、この数は大きくなります。
アクティブ取引数
MS アクティブ トランザクション グループに一覧されている情報に応じて返される MS アクティブ トランザクションの数。 これは、情報グループが繰り返される回数です。
total_act_trans
APPC が情報を持っている MS またはアクティブなトランザクションの数。 この数値は、 APPC が指定されたバッファーに配置できるよりも登録済みの MS アクティブ トランザクションに関する情報が多い場合を除き、num_act_trans メンバーで返される数と同じです。この場合、この数は大きくなります。
ローカルおよびリモート管理サービスのフォーカル・ポイント・グループごとに、フォーカル・ポイント・グループの 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_未アクティブ
フォーカル ポイントは取得されましたが、その後使用できなくなります。AP_ACTIVE
リモート・フォーカル・ポイントが獲得され、使用可能です。AP_PENDING
その FP を取得するための要求がリモートのプライマリまたはバックアップフォーカル ポイントに送信され、応答はまだ受信されていません。AP_NEVER_ACTIVE
フォーカル・ポイントは取得されていませんが、1 つ以上の登録済み管理サービス・アプリケーションがフォーカル・ポイント情報を要求しました。
fp_routing
ローカル ノードが EN の場合に、要求されていない要求を管理サービス フォーカル ポイントに送信するために使用されるルーティング。 NN からの要求は常にフォーカル・ポイントに直接送信されることに注意してください。
ルーティングには、次のいずれかを指定できます。
AP_DEFAULT
フォーカル ポイント宛ての要請されていない管理サービス要求は、フォーカル ポイントに転送するために EN からサービス NN に送信されます。AP_DIRECT
フォーカル・ポイント宛ての要請されていない管理サービス要求は、フォーカル・ポイントに直接送信されます。
注釈
プログラムが管理サービス・アプリケーション名を登録すると、フォーカル・ポイント情報を要求できます。 APPC は、フォーカル・ポイントを取得すると、フォーカル・ポイント情報をプログラムに渡します。これには、要求されていない管理サービス要求をフォーカル・ポイントに送信するために使用するルーティングのタイプが含まれます。