Open(SSCP) Request

  • [アーティクル]

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;  
};

メンバー

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)。

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

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>
このバッファー要素のデータの終わり (13)。

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
このバッファー要素のデータの終わり (13)。

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

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