次の方法で共有


Open(SSCP) 要求

Open(SSCP) 要求メッセージは、アプリケーションからノードにフローします。 これは、システム サービス 制御ポイント (SSCP) 接続と共に使用されます。

構文

struct Open(SSCP) Request {  
    PTRBFHDR  nxtqptr;  
    PTRBFELT  hdrept;  
    CHAR      numelts;  
    CHAR      msgtype;  
    CHAR      srcl;  
    CHAR      srcp;  
    INTEGER   srci;  
    CHAR      destl;  
    CHAR      destp;  
    INTEGER   desti;  
    CHAR      ophdr.openqual;  
    CHAR      ophdr.opentype;  
    CHAR      ophdr.appltype;  
    CHAR      ophdr.opluno;  
    INTEGER   ophdr.opresid;  
    INTEGER   ophdr.icreditr;  
    INTEGER   ophdr.icredits;  
    CHAR      ophdr.opninfo1;  
    CHAR      ophdr.opnpad1;  
};   
struct Open(SSCP) Request {  
    PTRBFELT   hdreptr->elteptr;  
    INTEGER    hdreptr->startd;  
    INTEGER    hdreptr->endd;  
    CHAR       hdreptr->trpad;  
    CHAR[268]  hdreptr->dataru;  
};  
struct Open(SSCP) Request {  
    PTRBFELT  hdreptr->elteptr->elteptr;  
    INTEGER   hdreptr->elteptr->startd;  
    INTEGER   hdreptr->elteptr->endd;  
    CHAR      hdreptr->elteptr->trpad;  
    CHAR[268] hdreptr->elteptr->dataru;  
};  

Members

nxtqptr
次のバッファー ヘッダーへのポインター。

hdrept
最初のバッファー要素へのポインター。

numelts
バッファー要素の数 (0x02)。

msgtype
メッセージ・タイプ OPENMSG (0x01)。

srcl
ソースのローカリティ。

srcp
ソース パートナー。 (詳細については、「解説」を参照してください。

srci
ソース インデックス。

destl
宛先のローカリティ。

destp
移行先パートナー。

desti
変換先インデックス。

ophdr.openqual
修飾子 REQU (0x01) を開きます。

ophdr.opentype
SSCPSEC (0x01) 型を開きます。

ophdr.appltype
アプリケーション プログラム インターフェイスの種類。

チャンク (0x02) を使用しない関数管理インターフェイス (FMI)。

チャンク (0x82) を含む FMI。 (詳細については、「解説」を参照してください。

ophdr.opluno
論理ユニット番号。 (詳細については、「解説」を参照してください。

ophdr.opresid
リソース識別子。

ophdr.icreditr
予約済み。

ophdr.icredits
予約済み。

ophdr.opninfo1
予約済み。

ophdr.opnpad1
フォースタイプを開きます。 (詳細については、「解説」を参照してください。

OPEN_TEST (0x00)

OPEN_FORCE (0x01)

要素 1

hdreptr–>elteptr
次のバッファー要素へのポインター。

hdreptr–>startd
このバッファー要素のデータの先頭 (1)。

hdreptr–>endd
このバッファー要素内のデータの末尾。

hdreptr–>trpad
予約済み (1 バイト)。

hdreptr–>dataru
データ要求/応答ユニット (RU) を次に示します。

dataru[0–9]

ソース名。 空白を入力する必要があります。

dataru[10–19]

宛先名。 通信する論理ユニット (LU) に設定します。

dataru[20]

Sense 4003 フラグ。

dataru[21]

Sense 4004 フラグ。

dataru[22]

Sense 4006 フラグ。

dataru[23]

Sense 4007 フラグ。

dataru[24]

Sense 4009 フラグ。

dataru[25]

Sense 400A フラグ。

dataru[26]

Sense 400B フラグ。

dataru[27]

Sense 400C フラグ。

dataru[28]

Sense 400D フラグ。

dataru[29]

Sense 400F フラグ。

dataru[30]

Sense 4011 フラグ。

dataru[31]

Sense 4012 フラグ。

dataru[32]

Sense 4014 フラグ。

dataru[33]

優先度の高いインジケーター。

HIGH (0x01)

LOW (0x02)

dataru[34]

論理ユニット アプリケーション (LUA) でサポートされているインジケーター。

サポート対象 (0x01)

サポートされていません (0x00)

dataru[35-36]

ダイナミック アクセス モジュール (DMOD) から取得したチャンク サイズ。 (詳細については、「解説」を参照してください。

dataru[37]

セグメント配信オプション。

要求/応答ユニット (RU) セグメントを配信しない (0x00)

RU セグメントの配信 (0x01)

dataru[38]

高レベル言語アプリケーション プログラミング インターフェイス (HLLAPI) セッション識別子。 (詳細については、「解説」を参照してください。

要素 2

hdreptr–>elteptr–>elteptr
次のバッファー要素 (NIL) へのポインター。

hdreptr–>elteptr–>startd
このバッファー要素のデータの先頭 (1)。

hdreptr–>elteptr–>endd
このバッファー要素内のデータの末尾。

hdreptr–>elteptr–>trpad
予約済み。

hdreptr–>elteptr–>dataru
データ RU は次のとおりです。

dataru[0]

3270 エミュレーターを識別する ASCII 文字列。 (詳細については、「解説」を参照してください。

注釈

  • Open(SSCP) 要求メッセージは、バッファー ヘッダーと 2 つのバッファー要素で構成されます。

  • ソース L 値、宛先の Locality Partner Index (LPI) 値、およびソース名が予約されています。

  • 3270 エミュレーターの場合、ソース P 値を S3PROD (0x12) に設定する必要があります。これは、アプリケーションを 3270 エミュレーターとして識別します。 宛先名は、3270 ユーザー・レコードから取得した LU 名またはプール名に設定する必要があります (10 文字未満の場合は ASCII スペースで右入力)。

  • LUA アプリケーションでは、ソース P 値 LUAPROD (0x1D) が使用されます。 これは、FMI の LUA バリアントを選択する LUA サポートインジケーターの値とは無関係です。

  • SNS4014フィールドへのSNS4003は、優先度の高いインジケーターと共に、テキスト内で SSCP 接続情報制御ブロック (CICB) と呼ばれます。 (詳細については、「 SSCP 接続を開く」を参照してください)。0x00の値は、センス コードに対応するデータ フロー制御 (DFC) 受信チェックがこの LU でサポートされていないことを示します。 0x01の値は、それがサポートされていることを示します。 対応する送信チェックは、これらの値に関係なく常に実行されることに注意してください。

  • LU 番号は、 Open(SSCP) 要求のローカル ノード内でのみ使用されます。 これは、最初の要素の宛先名から生成されます。

  • オープンフォースタイプフィールドは、複数のサーバー間でリソースを検索する場合や、アプリケーションが接続が非アクティブな LU を使用する場合に、接続の自動アクティブ化に使用されます。 アプリケーションでこのフラグを設定する必要はありません。 DL-BASE によって使用されます。 詳細については、「 SSCP 接続を開く」を参照してください。

  • アプリケーション・プログラム・インターフェース・タイプ・フィールドは、ローカル・ノードからアプリケーションへの RU チャンクを使用するかどうかを定義します。 これは、大規模な RU が使用されている場合に必要になる場合があります。 FMI チャンクの詳細については、「 ペーシングとチャンク」を参照してください。

  • チャンク サイズ フィールド ( dataru[35]) は整数値です。

  • セグメント配信オプションは、ローカル ノードが RU のセグメントを受信したらすぐにアプリケーションに配信するか、または RU 全体をアセンブルしてからアプリケーションに配信するかを指定します。 セグメント配信を使用すると、データを受信するとすぐにアプリケーションでユーザーの画面を更新できます(ウィンドウ シェーディングと呼ばれます)。これにより、認識される応答が速くなる可能性があります。 詳細については、「 セグメント配信」を参照してください。 このオプションは、チャンクが使用されている場合にのみ必要です。 ローカル ノードが対応するプライマリ論理ユニット (PLU) 接続の初期チャンク クレジット値を計算できるように、このメッセージに含まれています。 このオプションは、 Open(PLU) 応答で引き続き設定する必要があります。 競合が発生した場合、そのメッセージに指定された設定は、ここで指定した設定をオーバーライドします。 この場合、初期クレジット値が適切でない可能性があります。

  • LUA でサポートされるインジケーターは、アプリケーションが FMI の LUA バリアントを使用するかどうかを指定します。

  • 要素が (s+34) バイトより短い場合、Microsoft® Host Integration Server では LUA もチャンクも想定されません。 これにより、これらのオプションが使用できなかった以前のバージョンのローカル ノード ソフトウェアとの下位互換性が確保されます。

  • HLLAPI セッション識別子は、 Open(SSCP) が適用される 3270 表示セッションを識別する単一の ASCII 文字です。 HLLAPI はこれを使用して、HLLAPI 関数が参照する特定の 3270 プレゼンテーション空間を識別します。 また、セッションの短い名前として 3270、またはプレゼンテーション空間識別子 (PS 識別子) として HLLAPI によって呼び出されます。 3270 エミュレーターがセッション識別子をサポートしていない場合は、このフィールドを 0 に設定する必要があります。

  • 2 番目の要素には、3270 エミュレーターの型を識別するために使用できる ASCII 文字列が含まれています。 この文字列は、クライアントの DL-BASE によって監査ログ ファイルに記録され、トレースにも表示されます。 この文字列の制限を定義するには、開始フィールドと終了フィールドを設定する必要があります。