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 サポートインジケーターの値とは無関係です。

  • SNS4003〜SNS4014フィールドは、優先度の高い指標と共に、テキスト内で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 表示セッションを識別する単一の ASCII 文字です。 HLLAPI は、これを使用して、HLLAPI 関数が参照する特定の 3270 プレゼンテーション空間を識別します。 また、セッションの短い名前として 3270、またはプレゼンテーションスペース識別子 (PS 識別子) として HLLAPI によって呼ばれます。 3270 エミュレーターでセッション識別子がサポートされていない場合は、このフィールドを 0 に設定する必要があります。

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