DISPLAY

DISPLAY動詞は、SNA ノードの構成情報と現在の操作値を返します。

getappcconfig Windows 拡張機能を使用して、APPC lu に関連するシステム構成情報を取得することをお勧めします。 特に5250エミュレーターのユーザーは、 getappcconfig Windows 拡張機能を使用する必要があります。

注意

クライアント/サーバーアーキテクチャの性質により、Host Integration Server での表示動詞の実装には、ibm Extended Services for os/2 version 1.0 (ibm ES for os/2 version 1.0) との重要な相違点があります。

注意

OS/2 バージョン1.0 互換モードでの APPC表示動詞を使用し、すべてのアクティブなサーバーと接続を列挙するために Host Integration Server の拡張機能を使用しないアプリケーションの場合、Host Integration Server では、特定の既定の表示がない限り、既定の表示接続がランダムに選択されます。 接続は SNA マネージャーで構成されています。 この接続は、すべての 表示 要求の基礎として使用されます。 既定の表示接続を指定する方法については、「Host Integration Server のヘルプ」を参照してください。

次の構造体は、 DISPLAY 動詞によって使用される動詞コントロールブロックを示しています。

構文

  
struct display {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned long   init_sect_len;  
    unsigned long   buffer_len;  
    unsigned char FAR * buffer_ptr;  
    unsigned long  num_sections;  
    unsigned long  display_len;  
    unsigned long  area_needed;  
    unsigned char  sna_global_info;  
    unsigned char  lu62_info;  
    unsigned char  am_info;  
    unsigned char  tp_info;  
    unsigned char  sess_info;  
    unsigned char  link_info;  
    unsigned char  lu_0_3_info;  
    unsigned char  gw_info;  
    unsigned char  x25_physical_link_info;  
    unsigned char  sys_def_info;  
    unsigned char  adapter_info;  
    unsigned char  lu_def_info;  
    unsigned char  plu_def_info;  
    unsigned char  mode_def_info;  
    unsigned char  link_def_info;  
    unsigned char  ms_info;  
    struct sna_global_info_sect FAR * sna_global_info_ptr;  
    struct lu62_info_sect FAR * lu62_info_ptr;  
    struct am_info_sect FAR * am_info_ptr;  
    struct tp_info_sect FAR * tp_info_ptr;  
    struct sess_info_sect FAR * sess_info_ptr;  
    struct link_info_sect FAR * link_info_ptr;  
    struct lu_0_3_info_sect FAR * lu_0_3_info_ptr;  
    struct gw_info_sect FAR * gw_info_ptr;  
    struct x25_physical_link_info_sect FAR * x25_physical_link_info_ptr;  
    struct sys_def_info_sect FAR * sys_def_info_ptr;  
    struct adapter_info_sect FAR * adapter_info_ptr;  
    struct lu_def_info_sect FAR * lu_def_info_ptr;  
    struct plu_def_info_sect FAR * plu_def_info_ptr;  
    struct mode_def_info_sect FAR * mode_def_info_ptr;  
    struct link_def_info_sect FAR * link_def_info_ptr;  
    struct ms_info_sect FAR * ms_info_ptr;  
} DISPLAY;   

メンバー

opcode
指定されたパラメーター。 動詞操作コード AP_DISPLAY を指定します。

reserv2
予約されたフィールドです。この値は NULL に設定する必要があります。

primary_rc
返されたパラメーター。 動詞の完了時に APPC によって設定されるプライマリ リターン コードを指定します。 有効なリターン コードは、発行された APPC 動詞によって異なります。 この動詞の有効なエラーコードについては、「リターン コード」を参照してください。

secondary_rc
返されたパラメーター。 動詞の完了時に APPC によって設定されるセカンダリ リターン コードを指定します。 有効なリターン コードは、発行された APPC 動詞によって異なります。 この動詞の有効なエラーコードについては、「リターン コード」を参照してください。

init_sect_len
指定されたパラメーター。 情報ポインターの先頭までの、VCB の最初のセクションのバイト数を指定します。 このパラメーターと num_sections パラメーターは、要求される形式に応じて、特定の値に設定する必要があります。 詳細については、下の注意事項を参照してください。

buffer_len
指定されたパラメーター。 渡された表示データバッファーの長さ (0 ~ 65535 バイト) を指定します。

buffer_ptr
指定されたパラメーター。 要求された情報を格納する表示データバッファーのアドレスを提供します。

num_sections
指定されたパラメーター。 動詞で返すことができる情報セクションの最大数を指定します。 このパラメーターと init_sect_len パラメーターは、要求される形式に応じて、特定の値に設定する必要があります。 詳細については、下の注意事項を参照してください。

display_len
返されたパラメーター。 ディスプレイデータバッファーに返される、使用された合計バイト数を示します。

area_needed
返されたパラメーター。 表示されるすべてのデータに必要な合計バイト数を提供します。

sna_global_info
指定されたパラメーター。 グローバル情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

lu62_info
指定されたパラメーター。 すべてのアクティブな Lu、パートナー、およびそのモードに関する情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

am_info
指定されたパラメーター。 定義された TP での接続マネージャーの情報が要求されるかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

注意

このオプションは Host Integration Server ではサポートされていません。このパラメーターを AP_NO に設定する必要があります。

tp_info
指定されたパラメーター。 アクティブな Tp とアクティブなメッセージ交換に関する情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

注意

このオプションは Host Integration Server ではサポートされていません。このパラメーターを AP_NO に設定する必要があります。

sess_info
指定されたパラメーター。 セッションに関する情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

link_info
指定されたパラメーター。 アクティブな SNA 論理行の情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

lu_0_3_info
指定されたパラメーター。 論理ユニットの種類0、1、2、および3に関する情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

gw_info
指定されたパラメーター。 SNA ゲートウェイの情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

x25_physical_link_info
指定されたパラメーター。 X.25 情報が必要かどうかを指定します。 使用できる値は AP_YES と AP_NO です。

注意

このオプションは Host Integration Server ではサポートされていません。このパラメーターを AP_NO に設定する必要があります。

sys_def_info
指定されたパラメーター。 既定の LU、ノード名、および受信および送信の暗黙的なパートナーの既定のパラメーターに関する情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

adapter_info
指定されたパラメーター。 構成された通信アダプターに関する情報が要求されるかどうかを指定します。 使用できる値は AP_YES と AP_NO です。 NS/2 形式が要求された場合、このパラメーターは AP_NO に設定する必要があります。

lu_def_info
指定されたパラメーター。 定義された Lu に関する情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

plu_def_info
指定されたパラメーター。 定義されているパートナー Lu に関する情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

mode_def_info
指定されたパラメーター。 定義されたノードに関する情報が要求されるかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

link_def_info
指定されたパラメーター。 定義された論理リンクに関する情報が要求されるかどうかを指定します。 使用できる値は AP_YES と AP_NO です。

ms_info
指定されたパラメーター。 管理サービスに関する情報を要求するかどうかを指定します。 使用できる値は AP_YES と AP_NO です。 NS/2 形式が要求された場合、このパラメーターは AP_NO に設定する必要があります。

sna_global_info_ptr
返されたパラメーター。 データバッファー内の SNA グローバル情報の先頭のアドレスを示します。

lu62_info_ptr
返されたパラメーター。 データバッファー内の LU 6.2 情報の先頭のアドレスを示します。

am_info_ptr
返されたパラメーター。 データバッファー内のアタッチマネージャー情報の先頭のアドレスを示します。

注意

このオプションは、Host Integration Server ではサポートされていません。

tp_info_ptr
返されたパラメーター。 データバッファー内の TP 情報の先頭のアドレスを示します。

注意

このオプションは、Host Integration Server ではサポートされていません。

sess_info_ptr
返されたパラメーター。 データバッファー内のセッション情報の先頭のアドレスを示します。

link_info_ptr
返されたパラメーター。 データバッファー内のリンク情報の先頭のアドレスを示します。

lu_0_3_info_ptr
返されたパラメーター。 データバッファー内の LU 情報の先頭のアドレスを示します。

gw_info_ptr
返されたパラメーター。 データバッファー内のゲートウェイ情報の先頭のアドレスを示します。

x25_physical_link_info_ptr
返されたパラメーター。 データバッファー内の x.25 情報の先頭のアドレスを示します。

注意

このオプションは、Host Integration Server ではサポートされていません。

sys_def_info_ptr
返されたパラメーター。 データバッファー内のシステムの既定の情報の先頭のアドレスを示します。

adapter_info_ptr
返されたパラメーター。 データバッファー内のアダプター情報の先頭のアドレスを示します。

lu_def_info_ptr
返されたパラメーター。 データバッファー内のローカル LU 定義情報の先頭のアドレスを示します。

plu_def_info_ptr
返されたパラメーター。 データバッファー内のパートナー LU 定義情報の先頭のアドレスを示します。

mode_def_info_ptr
返されたパラメーター。 データバッファー内のモード定義情報の先頭のアドレスを示します。

link_def_info_ptr
返されたパラメーター。 データバッファー内のリンク定義情報の先頭のアドレスを示します。

ms_info_ptr
返されたパラメーター。 データバッファー内の管理サービス情報の先頭のアドレスを示します。

リターン コード

AP_OK
プライマリ リターン コード。動詞は正常に実行されました。

AP_PARAMETER_CHECK
プライマリ リターン コード。パラメーター エラーのため、動詞は実行されませんでした。

AP_DISPLAY_INVALID_CONSTANT
セカンダリリターンコード。NUM_SECTIONS または INIT_SEC_LEN に指定された値が無効です。

AP_STATE_CHECK
プライマリ リターン コード。動詞は無効な状態で発行されたため、実行されませんでした。

AP_DISPLAY_INFO_EXCEEDS_LEN
セカンダリリターンコード。返された 表示 情報がバッファーに収まりませんでした。

AP_INVALID_DATA_SEGMENT
セカンダリリターンコード。データバッファーを含むセグメントが、指定されたデータ長に対して小さすぎます。

AP_COMM_SUBSYSTEM_ABENDED
プライマリ リターン コード。次のいずれかの条件を示します。

このメッセージ交換で使用されているノードで ABEND が発生しました。

TP とノードタイプ2.1 の間の接続が切断されました (LAN エラー)。

TPs コンピューターの SnaBase で ABEND が検出されました。

AP_COMM_SUBSYSTEM_NOT_LOADED
プライマリ リターン コード。動詞の処理中に、必要なコンポーネントを読み込めなかったか、終了できませんでした。 そのため、通信を行うことができませんでした。 是正措置については、システム管理者に問い合わせてください。

AP_INVALID_VERB_SEGMENT
プライマリ リターン コード。VCB がデータ セグメントの終わりを越えています。

AP_STACK_TOO_SMALL
プライマリ リターン コード。アプリケーションのスタック サイズが小さすぎて動詞を実行できません。 アプリケーションのスタック サイズを増やしてください。

AP_UNEXPECTED_DOS_ERROR
プライマリ リターン コード。ローカル TP からの APPC 呼び出しの処理中に、オペレーティング システムから APPC にエラーが返されました。 オペレーティング システムのリターン コードは、secondary_rc 経由で返されます。 これは、Intel バイトスワップ順で表示されます。 問題が解決しない場合は、システム管理者に問い合わせてください。

解説

表示 は、エイリアスだけで LU を識別します。 同じローカル LU エイリアスがドメイン内で複数回 (バックアップなどの目的で) 使用されていて、その LU エイリアスが DISPLAYによって指定されている場合、動詞は意図したものとは異なる lu にフローできます。

表示動詞が正常に返されるようにするには、SNA マネージャーの [プログラムの表示] ダイアログボックスで特定の接続を定義する必要があります。 IBM はもともと、1つの接続を想定した IBM OS/2 拡張エディションの製品で、 表示 動詞を定義していました。 ただし、Host Integration Server は複数の接続をサポートしているため、表示動詞に関連付けられている特定の接続を構成する必要があります。

DISPLAY動詞には、システム情報を返すためのユーザー指定のバッファーが必要です。 バッファーのサイズが十分でない場合、APPC は、要求時に実際に必要なサイズ ( area_needed パラメーター) と共に AP_DISPLAY_INFO_EXCEEDS_LEN リターンコードを返します。 この動詞を使用する方法の1つとして、次のような方法があります。

  • Buffer_len値が APPC によって返されたarea_needed値未満で、必要な長さが64キロバイト (kb) 未満の場合は、表示バッファーのサイズをarea_needed値以上に増やします。

  • Area_neededの値が 64 kb を超える場合は、各情報セクションを個別に要求することを選択できます。 または、次の手順を実行します。

    1. 情報セクションに完全な情報を処理し、合計数が実際の合計値と同じになるようにします。

    2. 不完全な情報が含まれている、要求された情報セクションのサブセットを選択し、それらの情報セクションを要求する動詞を再発行します。

    3. 必要に応じて、手順 a と b を繰り返します。

    注意

    個々の情報セクションが 64 KB を超える場合は、要求されたすべての情報を APPC から取得することはできません。

    スレッドセーフではないため、同じプロセスの異なるスレッドから 表示 動詞を実行することはできません。

    DISPLAY動詞は、 init_sect_lennum_sectionsに対して指定されたパラメーターに次の値が設定されていない場合に AP_DISPLAY_INVALID_CONSTANT を返します。

NS/2 形式 IBM Enterprise Edition 形式 NS/2 形式 (Windows のみ) IBM Enterprise Edition 形式 (Windows のみ)
init_sect_len 50 44 52 48
num_sections 16 9 16 9

AP_DISPLAY_INVALID_CONSTANT は、次のパラメーターが適切に設定されていない場合にも返されます。

  • reserv2 は NULL に設定する必要があります。

  • am_info を AP_NO に設定する必要があります。

  • tp_info を AP_NO に設定する必要があります。

  • NS/2 形式が要求された場合は、 adapter_infoを AP_NO に設定する必要があります。

  • NS/2 形式が要求された場合は、 ms_infoを AP_NO に設定する必要があります。

参照

Host Integration Server の拡張機能
情報の種類による違い