使用上の注意
- EAB を返すことができるのは、セッションパラメーター(9) 機能の EAB オプションが使用されている場合です。EAB は表示スペースの各文字に関連して、それぞれの文字に続いて返されます。
-
ストリングへの表示スペースのコピー機能は、以下のオプションの影響を受けます。
- ATTRB/NOATTRB/NULLATTRB
- EAB/NOEAB
- XLate/NOXLate
- 空白/NOBLANK
- 表示/NODISPLAY
- EXTEND_PS/NOEXTEND_PS
提供されたターゲット・データ・ストリングが要求されたバイト数を保持するのに十分でない場合、ターゲット・データ・ストリングの最後に達したときに、コピーは正常に終了します (RC=0、4、または 5)。
前に説明したように、さまざまなコピー(5、8、34) 関数による属性の戻しは、セッションパラメーターの設定(9) 関数の影響を受けます。関連するセットセッションパラメータは、以下の効果があります:- セッションパラメータの設定
- コピー機能への影響
- NOEAB と NOEAD
- 属性は返されません。テキストのみが、表示スペースからユーザー・バッファーにコピーされます。
- EAB と NOXLATE
- 次の表の定義に従って属性が返されます。
- EAB と XLATE
- 表示スペースの表示に使用されている色が返されます。色は再マップできるため、XLATE と EAB が同時にオンの場合、色属性はコピー機能によって返されるものではありません。
返される文字属性を次の表に定義します。属性のビット位置は IBM 形式であり、ビット 0 がバイトの最も左のビットです。- ホストからエミュレータに 3270 文字属性が返されます。次の表は、EAB と NOXLATE が設定されている場合に適用されます。
ビット位置
意味 0–1 文字の強調表示 - 00 = 通常
- 01 = ブリンク
- 10 = リバースビデオ
- 11 = 下線
2–4 文字の色 (カラーリマップでこの色の定義を上書きできます。) - 000 = デフォルト
- 001 = 青
- 010 = 赤
- 011 = ピンク
- 100 = 緑
- 101 = ターコイズ
- 110 = 黄
- 111 = ホワイト
5–7 予約済み - ホストからエミュレータに、5250 文字属性が返されます。次の表は、EAB と NOXLATE が設定されている場合に適用されます。
ビット位置
意味 0 リバースイメージ - 0 = 通常イメージ
- 1 = イメージの反転
1 下線 - 0 = 下線なし
- 1 = 下線
2 明滅 - 0 = ブリンクしない
- 1 = ブリンク
3 列のセパレータ - 0 = 区切り文字なし
- 1 = セパレータ
4–7 予約済み - ホストからエミュレータに VT 文字属性を返します。次の表は、EAB と NOXLATE が設定されている場合に適用されます。
ビット位置
意味 0-3 予約済み 4 太字 - 1 = オン
- 0 = オフ
5 アンダースコア - 1 = オン
- 1 = オフ
6 明滅 - 1 = オン
- 0 = オフ
7 リバース - 0 = オン
- 1 = オフ
- 次の表に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 行の情報を、24 行またはステータスバーに表示します。ステータスバーに情報を表示するには、ステータスバーを設定する必要があります参照Quick Beginningsステータスバーの設定の詳細については、を参照してください。EXTEND_PSオプションを指定し、EHLLAPIアプリケーションは、～と同じインターフェースを使用できます。Communication ManagerEHLLAPIこの状態が発生すると、有効な表示スペースが拡張されます。