DISPLAY

[アーティクル]
07/21/2023

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

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

Note

クライアント/サーバーアーキテクチャの性質上、Host Integration Server での DISPLAY 動詞の実装には、それが基になっていた IBM Extended Services for OS/2 バージョン 1.0 (IBM ES for OS/2 バージョン 1.0) との重要な違いが含まれています。

Note

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

次の構造体では、 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 に対する Attach Manager 情報が要求されるかどうかを指定します。使用できる値は、AP_YESとAP_NOです。

Note

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

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

Note

このオプションは 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です。

Note

このオプションは 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
返されたパラメーター。データバッファー内の Attach Manager 情報の先頭のアドレスを示します。

Note

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

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

Note

このオプションは、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 情報の先頭のアドレスを示します。

Note

このオプションは、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
セカンダリリターンコード。返された DISPLAY 情報がバッファーに収まらなかった。

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

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

この会話で使用されるノードで、異常終了が発生しました。

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

TP コンピューターの SnaBase で、異常終了が発生しました。

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

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

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

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

解説

DISPLAY は、別名だけで LU を識別します。ドメイン内で同じローカル LU エイリアスが (バックアップやその他の目的で) 複数回使用され、その LU エイリアスが DISPLAY を介して指定されている場合、動詞は意図した LU とは異なる LU に流れる可能性があります。

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

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 を繰り返します。
Note

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

DISPLAY 動詞はスレッドセーフではないため、同じプロセスのさまざまなスレッドから実行しないでください。

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

	NS/2 形式	IBM EE 形式	NS/2 形式 (Windows のみ)	IBM EE 形式 (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 の拡張機能
 情報の種類による違い

次の方法で共有

DISPLAY

構文

メンバー

リターンコード

解説

参照

その他のリソース

次の方法で共有

DISPLAY

構文

メンバー

リターン コード

解説

参照

その他のリソース

リターンコード