使用上の注意

フィールドの位置と長さの情報は、フィールド位置の検索(31) およびフィールド長の検索(32) 機能を使用して、見つけることができます。フィールドからストリングへのコピー機能は、保護フィールドまたは無保護フィールドと共に使用することができます。
次の条件の 1 つが発生した場合、コピーは終了します。
- フィールドの最後に達したとき
- 対象文字列の長さを超えた場合
EAB を返すことができるのは、セッションパラメーター(9) 機能の EAB オプションが使用されている場合です。EAB は、表示スペースの各文字に関連して、各文字の前に戻されます。

「 フィールド を ストリング に コピー 」 機能 は 、 以下 の 条件 の 影響 を 受ける : セッションオプション。項目を参照5;13 and14 ;17 ; andsparopt.html#sparopt__opt18 andsparopt.html#sparopt__opt19を参照してください。

前に説明したように、さまざまなコピー(5、8、34) 関数による属性の戻しは、セッションパラメーターの設定(9) 関数の影響を受けます。関連するセットセッションパラメータは、以下の効果があります:

セッションパラメータの設定: COPY 機能への影響
NOEAB と NOEAD: 属性は返されません。テキストのみが、表示スペースからユーザー・バッファーにコピーされます。
EAB と NOXLATE: 次の表の定義に従って属性が返されます。
EAB と XLATE: 表示スペースの表示に使用されている色が返されます。色は再マップできます。したがって、XLATE と EAB が同時にオンの時、色属性はCOPY機能によって返されるものではありません。

返される文字属性を次の表に定義します。属性のビット位置はIBM®形式であり、ビット 0 がバイトの最も左のビットです。

ホストからエミュレータに 3270 文字属性が返されます。次の表は、EAB と NOXLATE が設定されている場合に適用されます。


ビット位置	意味
0–1	文字の強調表示 00 = 通常 01 = ブリンク 10 = リバースビデオ 11 = 下線
2–4	文字の色 (カラーリマップでこの色の定義を上書きできます。) 000 = デフォルト 001 = 青 010 = 赤 011 = ピンク 100 = 緑 101 = ターコイズ 110 = 黄 111 = ホワイト
5–6	キャラクタ属性 00 = デフォルト値
7	予約済み

ホストからエミュレータに、5250 文字属性が返されます。次の表は、EAB と NOXLATE が設定されている場合に適用されます。


ビット位置	意味
0	リバースイメージ 0 = 通常イメージ 1 = イメージの反転
1	下線 0 = 下線なし 1 = 下線
2	明滅 0 = ブリンクしない 1 = ブリンク
3	列のセパレータ 0 = 区切り文字なし 1 = セパレータ
4–7	予約済み

次の表にZ and I Emulator for Windows文字色の属性です。次の表は、EAB と XLATE が設定されている場合に適用されます。


ビット位置	意味
0–3	背景文字色 0000 = 黒 0001 = 青 0010 = 緑 0011 = 水色 0100 = 赤 0101 = マゼンタ 0110 = ブラウン (3270)、イエロー (5250) 0111 = ホワイト
4–7	文字の前景色 0000 = 黒 0001 = 青 0010 = 緑 0011 = 水色 0100 = 赤 0101 = マゼンタ 0110 = ブラウン (3270)、イエロー (5250) 0111 = ホワイト 1000 = グレー 1001 = 水色 1010 = ライトグリーン 1011 = ライトシアン 1100 = ライトレッド 1101 = ライトマゼンタ 1110 = 黄 1111 = ホワイト (高強度)

PS/2®モノクロ画面の場合、アプリケーション (ワークステーション) セッションの文字が、さまざまな濃淡で表示されます。これは、EHLLAPIユーザーがホスト・アプリケーション表示スペースを取得できるようにします。

この関数を使用するには、返されたデータ文字列パラメータを受信するメモリを事前に割り当てます。このメモリーを事前に割り当てるために必要な文は、アプリケーションが作成されている言語によって異なります。参照メモリー割り振りを参照してください。

Note: 5250 エミュレーションは、24 行 x 80 列の表示スペースをサポートします。場合によっては、Communication Manager 5250 エミュレーションは 25 行を表示します。これは、ホストからのエラーメッセージが表示されたとき、またはオペレータが SysReq キーを選択したときに発生します。Z and I Emulator for Windowsステータスバーの 25 行の情報を表示します。EXTEND_PSオプションにより、EHLLAPIアプリケーションは、～と同じインターフェースを使用できます。Communication ManagerEHLLAPIこの状態が発生すると、有効な表示スペースが拡張されます。