マクロ・ランタイムによるマクロ画面の処理方法

このセクションでは、マクロ・ランタイムがマクロ画面を処理するときに発生するアクティビティーについて説明します。

マクロ・ランタイム処理の概要

例として使用されるシナリオ

この章では、例としてマクロからのシナリオを使用します。このマクロには、Screen1 と Screen2 の 2 つのマクロ画面のみが含まれています。

シナリオは、マクロ・ランタイムが Screen1 ですべてのアクションを 実行して、次に処理するマクロ画面を検索する準備ができた時点で始まります。

Screen1 は、「OS/390® ISPF 基本オプション・メニュー (OS/390 ISPF Primary Option Menu)」(図 7 を参照) を処理するマクロ画面です。

図 7. 「OS/390 ISPF 基本オプション・メニュー (OS/390 ISPF Primary Option Menu)」
「OS/390 ISPF 基本オプション・メニュー (OS/390 ISPF Primary Option Menu)」

表 7 は、Screen1 の内容の 概念視点を示しています。

表 7. マクロ画面 Screen1 の 内容
<screen> エレメント Screen1 に 含まれている XML エレメント: XML エレメントの内容:
<description> 記述子:
  • 入力禁止標識がクリアされています (入力が禁止されていません)。
<actions> アクション:
  1. テキスト・カーソルを行 4、列 14 に移動します。
  2. '3[enter]' を入力します。
<nextscreens> このマクロ画面の後に表示される マクロ画面の名前:
  • Screen2

Screen2 は、「Utility Selection Panel」(図 8 を参照) を処理するマクロ画面です。

図 8. 「Utility Selection Panel」アプリケーション 画面
「Utility Selection Panel」アプリケーション 画面

表 8 は、Screen2 の内容の 概念視点を示しています。

表 8. マクロ画面 Screen2 の 内容
<screen> エレメント Screen2 に 含まれている XML エレメント: XML エレメントの内容:
<description> 記述子:
  • 入力禁止標識がクリアされています (入力が禁止されていません)。
  • 80 のフィールドがあります。
  • 3 つの入力フィールドがあります。
<actions> アクション (ホスト・アプリケーションは正しい入力フィールドに テキスト・カーソルを配置します):
  1. '4[enter]' を入力します。
<nextscreens> このマクロ画面の後に表示される マクロ画面の名前:
  • (なし。これはマクロ内の最後のマクロ画面です。)

マクロ画面の処理ステージ

マクロ・ランタイムは、マクロの実行中、以下の概要に示されるとおりマクロが終了するまで アクティビティーの同じ 3 つのステージ全体をループします。ステージ 1 内には 3 つのステップがあります。

  1. 次に処理するマクロ画面を決定する。
    ステップ a.
    候補のマクロ画面の名前を、有効な次画面のリストに追加する。
    ステップ b.
    画面認識を行って、候補のマクロ画面の 1 つを、ホスト端末に現在表示されている実際のアプリケーション画面と一致させる。
    ステップ c.
    候補のマクロ画面の名前を、有効な次画面のリストから除去する。
  2. 選択したマクロ画面を新しい現行マクロ画面にする。
  3. 新しい現行マクロ画面の <actions> エレメントのアクションを実行する。

ステージ 1

上述のとおり、ステージ 1 には 3 つのステップがあるため、ステージ 2 または 3 よりも詳細な説明が必要です。これらのステップそれぞれには、有効な次画面のリストが関係しています。

有効な次画面のリストは、マクロ画面名を保持できるリストです。 マクロ・ランタイムは、マクロ再生の始め (最初のマクロ画面を再生する前) にこのリストを作成し、マクロ再生が完了した後、このリストを破棄します。 リストは最初空になっています (マクロ・ランタイムによる候補マクロ画面名の選択方法で説明される一時画面の場合を除く)。

マクロの実行中、マクロ・ランタイムが次に処理するマクロ画面を決定する必要が生じるたびに、 マクロ・ランタイムは、有効な次画面のリストを使用して、3 つのステップ 1(a)、1(b)、および 1(c) を実行します。

プロセス全体の 3 ステージすべての概要

ステージ 1 では、マクロ・ランタイムは、次に処理するマクロ画面を決定します。 上記のセクションで説明したように、ステージ 1 には 3 つのステップがあります。

ステップ 1(a) では、マクロ・ランタイムは、現行のマクロ画面の次に表示される可能性があるマクロ画面の名前を収集し、これらの名前を有効な次画面のリストに追加します。 リストには、そのような画面が 1 つだけ、または数個ある可能性があります。例のシナリオでは、マクロ・ランタイムは Screen1 の <nextscreens> エレメントを検索し、ある名前 (Screen2) を見つけて、 リストにその名前を追加します (表 7 を参照)。

ステップ 1(b) では、マクロ・ランタイムは、リスト上の各マクロ画面を定期的に調べて、その画面がアプリケーション画面と一致するかどうかを判別します。

タイミングはこのステップにおける要因です。 マクロ・ランタイムが (Screen1 では、<actions> エレメントの 最後のアクションとして '3[enter]' と入力して) 現行のマクロ画面の いずれかのアクションを実行すると、ホスト・アプリケーションは、 ホスト端末を変更する処理を実行して、古いアプリケーション画面 (「ISPF 基本オプション・メニュー (ISPF Primary Option Menu)」) の 代わりに新しいアプリケーション画面 (「Utility Selection Panel」) を表示します。しかし、この変更は、即時に行われるわけではありません。 この変更には数百ミリ秒かかり、ホストから数パケット分のデータが必要になる場合があります。

そのため、マクロ・ランタイムは、ステップ 1(b) では、OIA 行または ホスト端末の表示スペースが更新されるたびに、有効な次画面のリストに 含まれるマクロ画面を調べ、それらのいずれかがアプリケーション画面の現在の 状態に一致するかどうかを確認します。

最終的にはホスト端末は、マクロ・ランタイムがリスト上のマクロ画面のいずれかをアプリケーション画面に一致させることができる程度まで、更新されます。

ステップ 1(c) では、マクロ・ランタイムは、有効な次画面のリストからすべてのマクロ画面名を除去します (一時画面がある場合は、それを除く)。

ステージ 2 では、マクロ・ランタイムは、選択されたマクロ画面 (ステップ 1(b) でアプリケーション画面と一致した画面) を新しい現行マクロ画面にします。

最後にステージ 3 では、マクロ・ランタイムは、Screen2 の <actions> エレメントのアクションを実行します。

この章の残りの部分では、上述の概要にあるステージとステップについての詳細な情報を提供します。

ステージ 1: 次に処理するマクロ画面を決定する

前述のように、ステージ 1 には 3 つのステップがあります。すなわち、有効な次画面のリストへのマクロ画面名の追加、画面認識の実行、および有効な次画面のリストからのマクロ画面名の除去です。

ステップ 1(a): 有効な次画面のリストへのマクロ画面名の追加

このステップでは、マクロ・ランタイムは、候補のマクロ画面の名前を、有効な次画面のリストに入れます。

有効な次画面

ホスト・アプリケーションによってホスト端末にアプリケーション画面が表示され、続いてユーザー入力が行われると、通常、次に表示される可能性があるアプリケーション画面は数個 (多くの場合は 1 つ) のみになります。

例のシナリオでは、現行のマクロ画面は Screen1 で、現行のアプリケーション 画面は「ISPF 基本オプション・メニュー (ISPF Primary Option Menu)」で、 入力は '3' と Enter キーです (表 7 を参照)。 この状況では、次に表示される可能性があるアプリケーション画面は 「Utility Selection Panel」の 1 つのみです。そのため、有効な次画面のリストに 追加する必要があるのは、マクロ画面の名前 Screen2 のみです。

最初これは、反直感的に思える場合があります。最終的に ISPF 基本オプション・メニュー (ISPF Primary Option Menu) は、約 30 種類の入力 (オプション 15 種類、メニュー選択 6 種類、およびファンクション・キー 8 種類) で構成される可能性があります。リストには、マクロ画面の名前が 1 つだけでなく 30 個はあります。正しいですか

有効な次画面のリストに通常、1 つまたは数個の名前しかない理由は、何らかの特定のタスクを達成することを目的とする一連の命令をマクロが実行していることです。Screen1 では、 命令は、「ISPF 基本オプション・メニュー (ISPF Primary Option Menu)」の次に 「Utility Selection Panel」を表示することを目的としています。これは、次画面の表示に必要なアクション ('3[enter]') が 既に実行されており、予想したアプリケーション画面が表示されるのをマクロ画面が待機している状態です。

マクロ・ランタイムによる候補マクロ画面名の選択方法

このセクションでは、マクロ・ランタイムが、有効な次画面のリストに入れるマクロ画面名を選択する方法を説明します。 次の 2 つの場合があります。

最初のマクロ画面

マクロの再生が始まるときには、有効な次画面のリストは空です (一時画面を除く。一時画面を参照)。

最初に処理されるマクロ画面の候補を見つけるために、 マクロ・ランタイムは、マクロ全体を検索し、エントリー画面の マークが付いている各マクロ画面を見つけ、これらのマクロ画面の名前 をリストに追加します。

エントリー画面の設定 (<screen> エレメントの属性) は、 この目的のために存在し、最初に処理される画面として表示可能な マクロ画面にマークを付けます。

マクロが記録されるときに、マクロ・オブジェクトは、デフォルトで、最初に記録される マクロ画面のみにエントリー画面のマークを付けます。記録が完了した後、ユーザーは、任意のマクロ画面にエントリー画面のマークを付けたり、マークを解除したりすることができます。複数のエントリー画面が存在できます。

エントリー画面については、エントリー画面で詳しく説明しています。

エントリー画面のマークが付いているマクロ画面がない場合、 マクロ・ランタイムは、マクロ内のすべてのマクロ画面を、 最初に処理されるマクロ画面の候補として使用します。

後続のマクロ画面

後続のマクロ画面 (最初のマクロ画面の直後の画面を含む) の場合、マクロ・ランタイムは、現行マクロ画面の <nextscreens> エレメントにリストされる候補マクロ画面の名前を見つけます。

例のシナリオでは、Screen1 は現行のマクロ画面であり、<nextscreens> エレメントに 1 つのマクロ画面の名前 Screen2 を持ちます (表 7 を参照)。 したがって、マクロ・ランタイムは Screen2 をリストに追加します。

エレメントのリストにあるマクロ画面名すべては、マクロ・ランタイムによって有効な次画面のリストに追加されます。

マクロの記録時に、マクロ・オブジェクトが新しいマクロ画面の記録を開始すると、その新しいマクロ画面の名前 (例えば、Screen2) を、記録が終了したばかりのマクロ画面 (Screen1) の <nextscreens> エレメントに保管します。 したがって、記録されたマクロの各マクロ画面 (最後の画面を除く) は、<nextscreens> エレメントに保管されている 1 つのマクロ画面の名前を持ちます。

以後、ユーザーは、マクロ内の任意のマクロ画面の名前を、任意のマクロ画面の <nextscreens> エレメントに追加したり、そのエレメントから削除したりすることができます。

<nextscreens> エレメントの詳細については、有効な次画面の認識で説明しています。

一時画面

一時画面は、マクロの任意のポイントで生じる画面であり、予期せず発生し、常にクリアする必要がある画面です。 一時画面の例は、無効な入力に応答して表示されるエラー画面です。

マクロ・オブジェクトは、マクロの記録時にマクロ画面に一時画面のマークを付けることはありません。 しかし、以後、ユーザーは、任意のマクロ画面に一時画面のマークを付けることができます。

マクロの再生が開始すると、マクロ・ランタイムはマクロを検索し、一時画面のマークが付いている各マクロ画面を見つけ、各一時マクロ画面の名前を有効な次画面のリストに追加します。 これらの名前は、マクロ再生中、リストに存在します。

一時画面の詳細については、一時画面を参照してください。

ステップ 1(b): 画面認識

このステップでは、マクロ・ランタイムが、有効な次画面のリストに名前が指定されているマクロ画面の 1 つを、現行のアプリケーション画面と一致させます。

このプロセスは、画面認識と呼ばれます。これは、マクロ・ランタイムが、リスト上のマクロ画面の 1 つを、ホスト端末に現在表示されているアプリケーション画面に対応するものとして認識するからです。

評価の概要

マクロ・ランタイムは、候補マクロ画面を、有効な次画面のリスト内にそれらの名前が表示されている順に評価します。

マクロ・ランタイムが、候補の 1 つがアプリケーション画面と一致することを検出すると、ただちに評価を停止し、リストから候補名を除去する次のステップ (ステップ 1(c)) に進みます。一致する画面は、次に処理されるマクロ画面になります (ステージ 2)。

しかし、マクロ・ランタイムは、リストに含まれるすべてのマクロ画面を評価しても一致を検出できない場合には、評価を一時的に停止し、ホスト端末が更新されるまでは何も実行しません。

繰り返し画面評価

マクロ・ランタイムが画面認識を実行する一方で、ホスト・アプリケーションはホスト端末を新しいアプリケーション画面で更新します。 例のシナリオでは、ホスト・アプリケーションは、 「Utility Selection Panel」が表示されるようにホスト端末を更新しています。このプロセスには数百ミリ秒かかり、ホストから数パケット分のデータが必要になる場合があります。

この状況は、画面が更新されるまでマクロ・ランタイムが画面認識を一時的に停止する理由の説明になります。 画面認識が失敗した場合、新しいアプリケーション画面が不完全であることが理由である可能性があります。 したがって、マクロ・ランタイムは待機します。

マクロ・ランタイムは、OIA 行またはホスト端末の表示スペースが更新されるたびに、有効な次画面のリストを調べ、現行のアプリケーション画面との一致を検出しようとします。一致が見つからない場合、マクロ・ランタイムは再び待機します。

マクロ・ランタイムは、画面認識が正常に行われるまでに、待機と評価のサイクルを数回繰り返す場合があります。

最終的に、必要な新しいアプリケーション画面に到達し、マクロ・ランタイムは、リストに名前が指定されたマクロ画面の 1 つを、新しいアプリケーション画面と一致させることができます。

マクロ画面がアプリケーション画面と一致するかどうかの判別

マクロ・ランタイムは、マクロ画面内の個々の記述子を現行のホスト端末画面と 比較することによって、そのマクロ画面が現行のアプリケーション画面に 一致するかどうかを判別します。

例のシナリオでは、マクロ・ランタイムは有効な次画面のリストで名前 Screen2 を検索して、Screen2 を取得します。また、その記述子を検索して、 記述子をホスト端末と比較します。

各マクロ画面には、1 つの <description> エレメントが含まれ、そのエレメント自体に 1 つ以上の記述子が含まれています。 記述子は、true または false で評価できる、ホスト端末 (アプリケーション画面の現在の状態) について記述したステートメントです。 例のシナリオでは、Screen2 には次の 3 つの記述子が含まれています。

今回のように <description> エレメントに複数の 記述子がある場合、各記述子をブール値 true または false で評価した上で その結果を 1 つの結果 (true または false) に結合するために マクロ・ランタイムが使用するメソッドは、ある追加の構成情報によって決まります (この構成情報については、ここでは説明しません)。構成情報について詳しくは、記述子の評価を参照してください。

例のシナリオでは、Screen2 がデフォルトのまま構成されるため、マクロ・ランタイムは 3 つの記述子それぞれを順番に評価します。3 つのすべてが true である場合、マクロ・ランタイムは、全体的な結果が true であり、Screen2 が現行のアプリケーション画面と一致するという結論を出します。

詳しくは、記述子の評価を参照してください。

認識の終了時期の定義

画面認識のタイムアウト設定

タイマーが切れる前に画面認識が行われない場合にマクロ・ランタイムがマクロを終了させる、タイムアウト値を設定できます (画面認識のタイムアウト設定を参照)。

認識限界

認識カウントを設定すると、マクロ・ランタイムによるマクロ画面 (例えば、ScreenA) の認識回数が設定値に達したときに、マクロ・ランタイムがマクロを終了する、あるいは指定されたマクロ画面にジャンプするようにできます (認識限界を参照)。

ステップ 1(c): 有効な次画面のリストからの候補マクロ画面の名前の除去

画面認識が成功した後、マクロ・ランタイムは、ただちに次のタスクを開始します。このタスクは、有効な次画面のリストのクリーンアップです (ステップ 1(c))。

これは単純なステップです。 マクロ・ランタイムは、認識しているかどうかにかかわらず、すべての候補マクロ画面の名前を有効な次画面のリストから除去します。

リストに一時画面の名前が含まれている場合、それらの名前はリストに残ります (一時画面を参照)。

ステージ 2: 選択された候補を新しい現行マクロ画面にする

ステージ 2 は単純です。 ステージ 2 では、マクロ・ランタイムは、選択された候補を新しい 現行マクロ画面にします。

例のシナリオでは、マクロ・ランタイムは Screen2 を新しい現行マクロ画面に します。ホスト端末には、新しいアプリケーション画面である 「Utility Selection Panel」が表示されます (表 7 および 表 8 を 参照してください)。

マクロ・ランタイムは、ただちにステージ 3 を開始します。

ステージ 3: 新しい現行マクロ画面のアクションを実行する

ステージ 3 では、マクロ・ランタイムは、新しい現行マクロ画面の <actions> エレメント内のアクションを実行します。新しい現行マクロ画面に <actions> エレメントが含まれていない場合、または <actions> エレメントが空である場合、マクロ・ランタイムはこのステージをスキップします。

各マクロ画面には、通常、実行される 1 つ以上のアクションを含む <actions> エレメントが含まれています。 アクションは、何らかのアクティビティー (ホストへの一連のキーの送信、ポップアップ・ウィンドウでのユーザーへのプロンプトの表示、画面からのテキスト・ブロックの取り込みなど) を起こす命令です。

例のシナリオでは、Screen2 に 含まれているのは次の 1 つのアクションだけです。

「Utility Selection Panel」では、テキスト・カーソルが自動的に 正しい入力フィールドに配置されるため、Screen2 ではそのためのアクションは 必要ありません。

<actions> エレメントに複数のアクションが含まれている場合、マクロ・ランタイムは、<actions> エレメントに指定される順に、各マクロ・アクションを実行します。

アクションの詳細については、マクロ・アクションを参照してください。

アクション後の遅延の挿入

マクロ・ランタイムは人間のユーザーよりはるかに迅速にアクションを 実行するので、マクロの再生中に予測しない問題が発生し、 アクションが予想通りに実行されない可能性があります。 この原因は、前のアクションへの依存関係が生じることです。

このタイプの問題を避けるために、マクロ・ランタイムは、各マクロ画面の どのアクションまたはプロンプト・アクションの後にも、150 ミリ秒の 遅延をデフォルトで挿入し、各マクロ画面の最後のアクションの後には 300 ミリ秒の遅延を挿入します (pausetime 属性を参照)。

この機能を使用可能なままにしてください。ただし、必要な場合は使用不可にすることができます。 遅延は、150 ミリ秒から 300 ミリ秒の値から他の値に変更できます。

必要に応じて、特定のマクロ画面の遅延期間を変更することもできます (pause 属性を参照)。

また、特定のアクションに対して、アクション後に一時停止アクションを追加することによって、遅延を増やすこともできます (一時停止アクション (<pause> エレメント)を参照)。

処理サイクルの繰り返し

マクロ・ランタイムが現行マクロ画面の <actions> エレメント内のすべてのアクションを実行した後、マクロ・ランタイムは、新しい現行マクロ画面の <nextscreens> エレメントにリストされている候補マクロ画面を使用して、ステップ 1(a) からただちに処理サイクルを再開します。

マクロの終了

次画面があるかどうかに関係なく、マクロ・ランタイムは、 終了画面としてマークが付けられたマクロ画面の処理が 終了すると、マクロを終了します。

例のシナリオでは、Screen2 には終了画面のマークが付いています (表 8 を参照)。

終了画面の設定 (<screen> エレメントの属性) は、 この目的のために存在し、マクロを終了するマクロ画面に マークを付けます。

マクロが記録されるときに、マクロ・オブジェクトは、デフォルトで、最後に 記録されるマクロ画面に終了画面のマークを付けます。記録が完了した後、ユーザーは、任意のマクロ画面に終了画面のマークを付けたり、マークを解除したりすることができます。複数の終了画面が存在できます。

終了画面については、終了画面で詳しく説明しています。