DISPLAY
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 を超える場合は、各情報セクションを個別に要求することを選択できます。 または、次の手順を実行できます。
表示される合計数が実際の合計数と等しい情報セクションを完全な情報で処理します。
不完全な情報を含む要求した情報セクションのサブセットを選択し、それらの情報セクションを要求する動詞を再発行します。
必要に応じて、ステップ 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 に設定する必要があります。