管理サービス情報

管理サービスに関する情報は、以下に定義されている 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 は、フォーカル・ポイントを取得すると、フォーカル・ポイント情報をプログラムに渡します。これには、要求されていない管理サービス要求をフォーカル・ポイントに送信するために使用するルーティングのタイプが含まれます。