これはレコード・レベル・キーワードで、定義中のレコード様式がウィンドウを使用して表示されるよう指定するために使用します。
ウィンドウは、画面の一部をオーバーレイする情報です。ウィンドウは通常、実際のワークステーション画面よりも小さく、画面上のどこにでも置くことができます。
- ウィンドウの位置およびサイズを指定することにより、ウィンドウを定義します。これはウィンドウ定義レコードとして認識されます。
- ウィンドウ位置およびサイズが定義されているレコード様式名を参照します。これはウィンドウ参照レコードとして認識されます。
WINDOW(start-line | &start-line-field start-position
| &start-position-field window-lines window-positions
[*MSGLIN | *NOMSGLIN])
[*RSTCSR | *NORSTCSR])
または
WINDOW(*DFT window-lines window-position
[*MSGLIN | *NOMSGLIN]
[*RSTCSR | *NORSTCSR])ウィンドウの定義を行う場合には、この形式の WINDOW キーワードを指定してください。 定義中のレコード様式がこのウィンドウに表示されます。 画面には、一度に最大 12 個までのウィンドウを表示することができます。 DDS には 12 個を超えるウィンドウを定義することができますが、同時に表示することができるのは 12 個だけです。 しかし、USRRSTDSP が指定されている場合には、ウィンドウの数は制限されません。 このレコードで定義するすべてのフィールドが、ウィンドウに収まらなければなりません。
- ウィンドウ枠の左上隅が入る行の番号を指定する番号またはフィールドの名前。フィールド名を指定する場合には、 そのフィールドはレコード様式内に存在しなければならず、桁数が 3 桁以下で、符号付き数字 (データ・タイプ S) のプログラム - システム間 (使用目的 P) フィールドでなければなりません。
- ウィンドウ枠の左上端が入る桁の番号を指定する番号またはフィールドの名前。フィールド名を指定する場合には、 そのフィールドはレコード様式内に存在しなければならず、桁数が 3 桁以下で、符号付き数字 (データ・タイプ S) のプログラム - システム間 (使用目的 P) フィールドでなければなりません。
- ウィンドウ内のウィンドウ行数。
ウィンドウ行は、表示画面サイズで使用できる行から 2 を引いた数を超えることはできません。これは、上および下のウィンドウ枠がそれぞれ 1 行使用するからです。
ウィンドウの最終ウィンドウ行はメッセージ行として使用され、フィールドを含むことはできません。 例えば、ウィンドウに 10 行のウィンドウ行を指定する WINDOW キーワードをコーディングする場合には、それらのうちの 9 行だけがフィールドを含むことができ、10 行目はメッセージ行です。
- ウィンドウ内のウィンドウの桁数。ウィンドウ桁は、画面サイズで使用できる桁から 4 を引いた数以下でなければなりません。これは、ウィンドウ内で右の枠と左の枠の両方で属性バイトが必要なためです。 属性バイトは、枠文字と使用できるウィンドウ桁の間に存在します。 DBCS 可能ウィンドウの場合、見えない DBCS フィールドについてのシフトアウト文字およびシフトイン文字のために、ウィンドウの両側でさらに 2 バイトずつが必要になる可能性があります。
- MSGLIN パラメーターは、ウィンドウにメッセージ行が入るかどうかを指定します。 このパラメーターを指定しない場合、デフォルトは *MSGLIN です。*NOMSGLIN を指定すると、メッセージはウィンドウの外側に移動され、画面の最下部、または MSGLOC キーワードで定義された位置に置かれます。 ウィンドウ内の最後の使用可能行は、エラー・メッセージ用に予約されています。そこにはレコードは表示されません。エラー・メッセージは、行よりも長い場合には、行に収まるように切り捨てられます。
- *RSTCSR パラメーターは、カーソルがウィンドウの外側にあるときにユーザーが限定された機能を使用できるかどうかを指定します。 *NORSTCSR を指定すると、カーソルがウィンドウの外側にあるときでも、カーソルがウィンドウ内にある場合のように機能キーを押してその機能を有効にすることができます。 非プログラマブル・ワークステーションの拡張インターフェースをサポートする制御装置上で *RSTCSR を指定する場合、ユーザーはウィンドウの外側にカーソルを移動することができます (マウスを使用する場合は例外)。 他のワークステーションについては、カーソルがウィンドウの外側にある間にユーザーが機能キーを押そうとするとビープ音が鳴り、カーソルはウィンドウの内側に配置されます。制御はアプリケーションに戻されません。*RSTCSR はデフォルトです。
特殊値 *DFT を start-line および start-position パラメーターの代わりに指定することは、システムがウィンドウの開始行および開始桁を判別することを示します。
ウィンドウは、可変開始位置のアプリケーション・ヘルプ・ウィンドウと同様に、カーソル位置に関連して位置が決められます。システムがウィンドウを位置づけるために使用する規則の詳細については、Application Display Programming
資料を参照してください。
WINDOW キーワードの 2 番目の形式は WINDOW(record-format-name) です。
WINDOW キーワードのこの形式は、定義中のレコード様式を他のレコード様式で定義されたウィンドウに表示する場合に指定します。
パラメーターは、指定されたウィンドウ属性を持つレコード様式名を指定します。 このパラメーターを使用するレコード様式が、参照されるレコードで定義されたウィンドウに表示されます。
WINDOW キーワードで指定された、レコード様式内のフィールド位置は、ウィンドウの左上隅の初めに使用できるウィンドウ位置と相対関係にあります。 初めに使用できるウィンドウ位置は上枠のすぐ下で、左枠から 2 桁右のところです (枠のすぐ右のバイトは終了属性バイトが使用します)。
USRRSTDSP が指定されていない場合には、ウィンドウが表示されるとき、現在画面上にあるどのレコードも中断します。中断しているレコードは、ウィンドウのわきに見ることができます。入力は活動状態のウィンドウの中でだけ行えます。 画面からウィンドウを除去するには、レコードを見えないウィンドウに書き込むか、画面で非ウィンドウ・レコードをオーバーレイする必要があります。
WINDOW キーワードは、次のキーワードが指定されているレコード様式で使用することはできません。
ALWROL |
PULLDOWN |
WINDOW は PASSRCD キーワードで指定されたレコード様式に使用することはできません。
ERRSFL キーワードは、WINDOW キーワードが指定されたレコードでは無視されます。
MSGLOC キーワードは、NOMSGLIN が指定されない限り、WINDOW が指定されているレコードについては無視されます。
レコード様式に WINDOW および WDWBORDER の両方のキーワードが指定されている場合には、WINDOW キーワードで start-line、start-position、window-lines、および window-positions パラメーターを指定してください。 WINDOW キーワードで record-format-name パラメーターを指定するべきではありません。
オプション標識は、このキーワードでは無効です。しかし、画面サイズ条件名は使用することができます。
例 1
次の例は、ウィンドウを定義するための WINDOW キーワードの指定方法を示します。
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R WINDOW1 WINDOW(4 20 9 30 *NORSTCSR)
A FIELD1 8A B 5 10
A FIELD2 10A B 6 10
A R WINDOW2 WINDOW(*DFT 9 30 *NOMSGLIN)
A- 下枠行 = 上枠行 + ウィンドウ行 + 1
- 右枠桁 = 左枠桁 + ウィンドウ桁 + 3
- 実際のフィールド行 = 上枠行 + フィールドの行番号
- 実際のフィールド桁 = 左枠桁 + フィールドの桁 + 1
フィールド FIELD2 は、上枠の 6 行下、左枠 (画面の 10 行目の 31 桁目) の 11 桁右から始まります。
カーソルがウィンドウの外側に移動しても、機能キーは活動状態のままです。
レコード WINDOW 2 が表示されるときには、ウィンドウの左上端は実行時のカーソル位置になります。メッセージ行はウィンドウの内側には表示されず、画面の最下部に表示されます。
カーソルがウィンドウの外側に移動すると、機能キーは非活動状態になります。ユーザーが機能キーを押すとビープ音が鳴り、カーソルはウィンドウの内側に配置されます。
例 2
次の例は、同じウィンドウ内に複数のレコードを表示するための WINDOW キーワードの使用方法を示しています。
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R WINDOW1 WINDOW(&LINE &POS 9 30)
A USERID 8A O 2 10
A LINE 2S 0P
A POS 3S 0P
A
A R RECORD1 WINDOW(WINDOW1)
A OVERLAY
A FIELD1 5A B 7 2
A FIELD2 20A B 8 5
A
A R RECORD2 WINDOW(WINDOW1)
A FIELD3 10A B 2 2
A FIELD4 8A B 8 5
A FIELD4 8A B 8 5
Aレコード WINDOW1 が表示されるとき、枠の左上隅は、LINE および POS フィールドで指定された行および桁番号に配置されます。枠の右下隅は、上枠より 10 行下で、左枠から 33 桁右に位置します。
フィールド USERID は、上枠の 2 行下、左枠文字の 11 桁右から始まります。
RECORD1 (前の例の) が表示される場合には、WINDOW1 内に配置されます。そのフィールドはウィンドウの左上隅と関連して位置付けされます。 RECORD1 に OVERLAY キーワードが使用され、2 つのレコードは重なり合わないので、画面上のレコード WINDOW1 のフィールドは残ります。
RECORD2 (前の例の) が表示される場合には、これも WINDOW1 内に配置されます。そのフィールドはウィンドウの左上隅と関連して位置付けされます。 OVERLAY キーワードが使用されていないので、レコード WINDOW1 および RECORD1 のフィールドはウィンドウから除去されます。
例 3
次の例は、サブファイルを指定する WINDOW キーワードの使用方法を示しています。
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R SFLDATA SFL
A NAME 20A B 4 5
A RANK 10A B 4 27
A SERIAL 8A B 4 38
A
A R WINDOW1 SFLCTL(SFLDATA)
A WINDOW(8 25 10 50)
A SFLPAG(4)
A SFLSIZ(17)
A SFLDSP
A SFLDSPCTL
A 2 5'Full Name'
A 2 27'Rank'
A 2 38'Serial Nbr'
AWINDOW1 サブファイル制御レコードが表示されるとき、それとサブファイルがウィンドウに表示されます。 ウィンドウ枠の左上隅は画面の 8 行目の 25 桁目になります。枠の右下隅は、19 行目の 78 桁目に位置します。
サブファイル・レコードおよびサブファイル制御レコードの両方のフィールドは、ウィンドウの左上隅の初めの使用可能ウィンドウ桁と関連して位置付けされます。 例えば、SFLDATA レコードの NAME フィールドは、ウィンドウの 4 行目の 5 桁目から始まります。 これは、画面の 12 行目の 31 桁目と同じことです。