拡張マクロ・エディター

拡張マクロ・エディター (AME) では、macro 属性と screen-level 属性の設定、画面説明の編集、およびアクション、リンク (次の画面への関連付け)、 変数の追加を行えます。

基本マクロ・エディターは、マクロを右クリックして 「オープン先を指定」 -> 「マクロ・エディター」を選択して開きます。拡張マクロ・エディターは、マクロ・エディターの「概要」ページから 開くことができます。また、「プロンプトおよび抽出」もマクロ・エディターから編集できます。

マクロを VME ではなくマクロ・エディターで開くと、 マクロ・エディターがそのマクロのデフォルト・エディター (そのマクロのみ) になります。

注:
HATS V7.5.1 ではマクロ・エディターおよび 拡張マクロ・エディターのサポートは推奨されていません。現在までサポートされていましたが、 IBM は、これ以降の製品リリースで この機能を削除することができます。このサポートは Visual Macro Editor で置き換えられました。

エディターの使用

拡張マクロ・エディターは、マクロの各部を編集するためのグラフィカル・ユーザー・インターフェースであり、ボタン、入力フィールド、リスト・ボックスなどを備えています。図 60 に、拡張マクロ・エディターを示します。

図 60. 拡張マクロ・エディター
拡張マクロ・エディター

注:
  1. AME は <HAScript> エレメントとその内容のみを 認識します。したがって、AME を使用して追加または編集するすべての prompts または extracts は、HATS の <prompts> エレメントと <extracts> エレメントにおいて手動で更新する必要があります。不一致があると、統合オブジェクトがマクロの正常実行に失敗したり、マクロ・トランザクションを実行アクションやマクロを実行アクションで実行されるときにマクロが不正に振る舞ったりするので、この点は重要です。問題を最小限に抑えるため、HATS マクロ・エディターを使用して prompts と extracts を定義し、必要に応じて、AME をマクロ内の拡張ロジック用に使用することをお勧めします。HATS の <prompts> エレメントと <extracts> エレメントについて詳しくは、HATS で使用する場合の Host On-Demand マクロの適応を参照してください。
  2. AME は、HATS マクロ・エディターと同期されません。つまり、AME で変更を行った場合、その変更はソース表示などへは即時に反映されません。ただし、一方のエディターを保存して終了すると、変更点は他方のエディターに反映されます。

マクロ・タブ

AME の操作に慣れるために、このセクションは AME の 「マクロ」タブと、前のセクションで説明されている <HAScript> エレメント との非常に簡単な比較で成り立っています。

AME には、4 つのタブがあります。「マクロ」、「画面」、「リンク」および「変数」です。最初の「マクロ」タブは、<HAScript> エレメントと非常に密接に対応します。実際に、「マクロ」タブは、<HAScript> エレメントの開始タグの属性に保管される情報に対するグラフィカル・ユーザー・インターフェースです。

したがって、<HAScript> エレメントはマクロ・スクリプトの マスター・エレメントであり、マクロ全体に適用される情報 (例えば、マクロ記述) が その属性に含まれるため、同様に「マクロ」タブは、AME の 最初のタブであり、同じグローバル情報の一部にアクセスできます。

図 61 は、「マクロ」タブが選択された状態の AME を示しています。

図 61. AME のマクロ・タブ
拡張マクロ・エディターのマクロ・タブ

図 61 では、「マクロ」タブに数個のチェック・ボックスとともにマクロの説明およびその他の情報の 入力フィールドがあります。また、次の点も知ることができます。

「マクロ名」フィールドには、マクロに割り当てる名前が入ります。この名前は、マクロを編集または実行するときに選択する名前と同じです。マクロ名では 大文字と小文字を区別します。 例えば、macro_1 は、Macro_1、MACRO_1、などとは 別の名前です。

「マクロで変数と演算式を使用する」チェック・ボックスは、マクロ・オブジェクトがこのマクロに基本マクロ形式を使用するか、拡張マクロ形式を使用するかを決定します。上記の図では、このチェック・ボックスは選択されていません。これは、基本マクロ形式が使用されることを示します (基本マクロ形式と拡張マクロ形式を参照)。

図 62 は、図 61 の「マクロ」タブに表示されているのと同じ情報およびいくつかの追加情報が含まれている、サンプル <HAScript> エレメントを示しています。ソース表示では、<HAScript> エレメントが 1 行に書き込まれますが、ここではそのエレメントが複数行に書き込まれているため、属性を確認することができます。

図 62. サンプル <HAScript> エレメント
<HAScript
     name="macro_1"
     description=" "
     timeout="60000"
     pausetime="300"
     promptall="true"
     author=""
     creationdate=""
     supressclearevents="false"
     usevars="false"
     ignorepauseforenhancedtn="false"
     delayifnotenhancedtn="0">

...

</HAScript>

図 62 の <HAScript> エレメント内には、図 61 に示される「マクロ」タブの各入力フィールドに対応する属性があります。例えば、 <HAScript> エレメント内の usevars 属性 (usevars="false") は 「マクロ」タブの「マクロで変数と演算式 を使用する」チェック・ボックスに対応します。図 62 には、図 61 には表示されない追加属性があります。

画面タブ

このセクションでは、AME の「画面」タブと、直前のセクションで説明されている XML <screen> エレメントとの関連を示します。図 63 は、 「画面」タブが選択された状態の AME を示しています。

図 63. 「画面」 タブ
拡張マクロ・エディターの画面タブ

図 63 の「画面」タブには、以下が含まれています。

現在、「一般」タブが選択されています。

「画面」タブには次の 2 つの「画面名」フィールドがあることに注意してください。

「画面」タブの一番上にある「画面名」リスト・ボックスでは、作業対象のマクロ画面の名前 (例えば、Screen1) をクリックします。AME は、そのマクロ画面に属する情報をサブタブに表示します。例えば、図 63 では、リスト・ボックスは、マクロ画面名 Screen1 を表示し、サブタブは、Screen1 に属する情報を表示します。ユーザーがリスト・ボックス内の別のマクロ画面名 (例えば、Screen10) を選択した場合、AME は、マクロ画面 Screen10 に属する情報をサブタブに表示します。

「一般」タブの下の「画面名」入力フィールドには、現在選択されているマクロ画面に割り当てたい名前を入力します。Screenx のような画面名 (ここで x は整数を表します。例えば、Screen1) は、マクロ・オブジェクトがマクロ画面を作成するときに その画面に与えるデフォルトの名前です。 この名前をそのまま使用することも、より覚えやすい記述名に置き換えることもできます。 (すべてのマクロ画面に、Screen3、Screen10、Screen24 のような名前がある場合、どのマクロ画面が何を実行するかを覚えるのは困難です。)

「画面」タブの「一般」、「説明」、および「アクション」の各サブタブは、前のセクションで説明された XML <screen> エレメントの主要部分に対応します。具体的には、次のとおりです。

しかし、<nextscreens> サブエレメントについてはどうでしょうか。 使いやすくするために、<nextscreens> エレメントに属する情報は、上位の「リンク」タブに表示されます。図 63 の「画面」タブのすぐ右に、「リンク」タブが表示されています。

図 64 は、Screen1 という名前のサンプル <screen> エレメントの XML 開始タグと終了タグを示しています。

図 64. <screen> エレメントの開始タグと終了タグ
   <screen name="Screen1" entryscreen="true" exitscreen="false" transient="false">
   ...
   </screen>

図 64 において、省略符号 (...) は XML テキストの一部ではありませんが、簡略化するために <screen> エレメント内部に含まれる必須エレメントが省略されていることを示します。開始タグの属性は、図 63 に示される「一般」タブのフィールドに対応します。例えば、name 属性 (name="Screen1") は、「一般」タブ上の「画面名」入力フィールドに対応し、entryscreen 属性 (entryscreen="true") は、「一般」タブ上の「エントリー画面」リスト・ボックスに対応します。

図 65 は、囲まれているエレメントを含めて、<screen> エレメント全体の XML テキストを示しています。

図 65. サンプル XML <screen> エレメント
   <screen name="Screen1" entryscreen="true" exitscreen="false" transient="false">
      <description>
         <oia status="NOTINHIBITED" optional="false" invertmatch="false" />
      </description>
      <actions>
         <mouseclick row="4" col="15" />
         <input value="3[enter]" row="0" col="0" movecursor="true"
                   xlatehostkeys="true" encrypted="false" />
      </actions>
      <nextscreens timeout="0" >
         <nextscreen name="Screen2" />
      </nextscreens>
   </screen>

図 65 では、<screen> エレメントに、必須の <description>、<actions>、および <nextscreens> エレメントが入っていることに注目してください。

デフォルトでは、「認識限界の設定」チェック・ボックス はクリアされていて、入力フィールドは使用不可です。 このチェック・ボックスを選択すると、マクロ・エディターは 「エラーになる前の画面」入力フィールドのデフォルト値 を 100 に設定します。この値の設定は増減できます。 詳しくは、認識限界を参照してください。

説明タブ

AME の「画面」タブ上の「説明」タブは、マクロ画面の <description> エレメント内に保管されている情報にアクセスします。図 66 は、「説明」タブの例を示しています。

図 66. 「説明」タブ
マクロ・エディターの説明タブ

図 66 では、AME の「画面」タブが選択されています。現在選択されている画面の名前 Screen1 が、「画面」タブの一番上の「画面名」フィールドに表示されています。 「画面名」フィールドの下には、「一般」、「説明」、 および「アクション」のサブタブがあります。「説明」タブが選択されています。

上記の図の「説明」タブを見ると、上部領域と下部領域があることが分かります。

上部領域には、単一の記述子エレメントを全体と見なして作用するコントロールがあります。 特に、「説明」タブの左上隅にある「記述子」リスト・ボックスには、現在選択されている記述子の名前が入っています。 上記の図では、現在選択されている記述子は、リストの一番上にある「フィールド数および OIA」記述子です。(記述子には名前がありません。 「フィールド数および OIA」は、記述子のタイプです。)

「説明」タブの下部領域には、現在選択されている記述子の内容が表示されます。現在選択されている記述子は「フィールド数および OIA」記述子であるので、「説明」タブの下部は、そのタイプの記述子に適した内容を提示します。ユーザーが別のタイプの記述子 (例えば、ストリング記述子) を作成し、選択した場合、下部領域には、ストリング記述子に該当する内容が提示されます。

図 66 の「説明」タブの下部領域をもっと詳しく調べると、「フィールド数および OIA」記述子には、次の 3 つの ID テストが含まれていることが分かります。

マクロ・ランタイムは、このマクロ画面をアプリケーション画面に一致させようとするときに、これらの 3 つの ID テストを適用します。

注:
AME は「フィールド数および OIA」記述子を、3 つのテストが含まれている 1 つの記述子として提示しますが、実際にマクロ言語は、これらの 3 つのテストを別々の独立した 3 つの記述子として定義します。「フィールド数および OIA」記述子を参照してください。

図 66 の「説明」タブの下部領域には、「フィールド数および OIA」記述子のこれら 3 つのテストごとに、「オプション」というラベルのフィールドも表示されます。ここでは、このフィールドを無視してかまいません。「フィールド数」記述子と「入力フィールドの数」記述子には、「逆記述子」というラベルのフィールドもあります。このフィールドもここでは無視してかまいません。これらのフィールドについては、デフォルト結合メソッドのセクションで説明されます。

新しい記述子の作成

図 66 の「説明」リスト・ボックスをもう一度見ると、最初のエントリーだけが実際の記述子になっていることが分かります。残りの選択項目は、すべて不等号括弧で囲まれ、「新規」という語で始まっています。これらの選択項目は、新しい記述子を作成するためのものです。 以下に 図 66 から抜粋したリストを示します。

図 67. 実際の記述子が 1 つある「記述子 (Descriptor)」リスト・ボックスの内容
フィールド数および OIA
<新規ストリング記述子>
<新規カーソル記述子>
<新規属性記述子>
<新規条件記述子>
<新規変数更新>

例えば、<新規ストリング記述子> をクリックした場合、マクロ・オブジェクトは、新しいストリング記述子を作成し、リストの先頭に置きます。 「説明」タブの下部領域では、ストリング記述子に属するさまざまなフィールド (例えば、行と列の位置や、文字ストリング) に入力できます。「記述子 (Descriptor)」リスト・ボックスは次のようになります。

図 68. 実際の記述子が 2 つある「記述子 (Descriptor)」リスト・ボックスの内容
ストリング記述子 (3, 29)
フィールド数および OIA
<新規ストリング記述子>
<新規カーソル記述子>
<新規属性記述子>
<新規条件記述子>
<新規変数更新>

図 68 では、現在選択されている記述子は、リストの一番上にある「ストリング記述子」です (3,29 は、行 3、列 29 を表します)。「フィールド数および OIA」記述子は、リスト上の 2 番目になりました。

図 68 のように、マクロ・ランタイムが複数の記述子を処理する方法については、記述子の評価を参照してください。

「フィールド数および OIA」記述子

「フィールド数および OIA」記述子は必須であり、固有の記述子でなければなりません。つまり、どの「説明」タブにも、ただ 1 つの「フィールド数および OIA」記述子が含まれていなければなりません。

次の理由により、これによって実際に何か問題が生じることはありません。

別々の独立した 3 つの記述子を 1 つの記述子として提示する方法

AME は、「フィールド数および OIA」記述子を 1 つの 記述子として表します (図 66 を参照)。しかし、実際には、 「説明」タブの「フィールド数および OIA」記述子の 3 つの部分はそれぞれ、 ベースとなる XML マクロ言語の別々の独立した記述子に対応します。具体的には、次のとおりです。

表 20 は、これらの 3 つのタイプの記述子をリストし、<description> エレメント内に存在できる各記述子の数を示します。

表 20. 3 つのタイプの <description> エレメント記述子
記述子のタイプ: マクロ画面ごと (つまり、<description> エレメントごと) に使用できるこのタイプの記述子数:
<oia> 1 (必須)
<numfields> 1 (オプション)
<numinputfields> 1 (オプション)

表 20 に示されるように、これらの記述子のタイプごとに 1 つだけが <description> エレメントに存在できます。<oia> 記述子は必須ですが、<numfields> 記述子と <numinputfields> 記述子はオプションです。 マクロ・エディターがこれらの 規則を実行します。

例えば、AME の「説明」タブに表示される「フィールド数および OIA」記述子を最初に見て、次にソース表示を見ます。図 66 は、 「説明」タブの「フィールド数および OIA」記述子を 示しています。「フィールド数および OIA」記述子の 3 つの部分の設定値は、次のように設定されます。

Number of Fields:  80
Number of Input fields:  3
Wait for OIA to Become Uninhibited:  true

一方、対応する <description> エレメントをソース表示で調べると、次のように表示されます。

図 69. 3 つの記述子を持つ <description> エレメント
<description>
   <oia status="NOTINHIBITED" optional="false" invertmatch="false" />
   <numfields number="80" optional="false" invertmatch="false" />
   <numinputfields number="3" optional="false" invertmatch="false" />
</description>

図 69 の XML コード・フラグメントは、<description> エレメントに、3 つの別々の独立した記述子が含まれていることを示します。各記述子は、「フィールド数および OIA」記述子の 3 つの部分のいずれかに対応しています。

「フィールド数および OIA」記述子の設定を次のように変更するとします。

Number of Fields:  (blank)
Number of Input fields:  (blank)
Wait for OIA to Become Uninhibited:  true

最初の 2 つのフィールドをブランクに設定すると、 これらの項目がスクリプトに組み込まれないように、 AME に指示します。 対応する <description> エレメントをソース表示で再度調べると、次のように表示されます。

<description>
   <oia status="NOTINHIBITED" optional="false" invertmatch="false" />
</description>

上記の XML コード・フラグメントは、<description> エレメントに、1 つの記述子、つまり「フィールド数および OIA」記述子の「OIA が禁止解除になるのを待つ」設定に対応する <oia> 記述子だけが含まれていることを示しています。

「OIA が禁止解除になるのを待つ」記述子

表 21 は、次のことを示しています。

表 21. 「OIA が禁止解除になるのを待つ」記述子の有効な設定値
説明タブ上の設定: <oia> エレメント内の status 属性の値: 意味:
true NOTINHIBITED ホスト端末の入力禁止標識がクリアされている (つまり、入力が禁止されていない) 場合、マクロ・ランタイムはこの記述子を true と評価します。標識がクリアされていない場合、マクロ・ランタイムはこの記述子を false と評価します。
false DONTCARE マクロ・ランタイムは、常にこの記述子を true として評価します。
<Expression> 'NOTINHIBITED'、 'DONTCARE'、またはこれらのストリングのどちらかに評価される任意の式 マクロ・ランタイムは、式を評価してから、結果のストリングを解釈します。
マクロ開発時のホスト端末上のフィールド数のカウント

「フィールド数」フィールドと「入力フィールドの数」フィールドに値を設定する必要がある場合には、現在作業している画面で、実際のフィールド数を確認し、その値を示す記述子を自動的に設定することができます。

この機能を使用する手順は、次のとおりです。

  1. ホスト端末でマクロを編集する。この機能は、マクロを記録しているときにも使用できます。
  2. ホスト端末で、作業しているマクロ画面に対応するアプリケーション画面に進む。表示される値は、常に、ホスト端末に表示された画面に基づいています。
  3. 左側のツリー表示で、画面名を右マウス・ボタンでクリックし、「編集」を選択して、「画面認識基準の定義 (Define Screen Recognition Criteria)」ページを呼び出す。
  4. マクロ・エディターに、現在のアプリケーション画面のフィールドの総数、入力フィールドの数、およびカーソル位置が表示されます。 この画面の認識基準にする基準のチェック・ボックスに、チェックマークを付けます。
  5. 「フィールド数」フィールドと 「入力フィールドの数」フィールドを正しい値に設定するには、各入力フィールドの 隣にある「最新表示」ボタンを使用して、 アプリケーション画面のフィールドをカウントすることができます。
  6. 「完了 (Finish)」をクリックする。
画面認識時の取り扱い

画面認識時に、マクロ・ランタイムが個々の記述子を評価し、ブール結果を結合するときに、マクロ・ランタイムは、<oia> 記述子、<numfields> 記述子 (存在する場合)、および <numinputfields> 記述子 (存在する場合) をそれぞれ、別々の独立した記述子として、他の記述子と同じように扱います。

複数の記述子の評価の詳細については、記述子の評価を参照してください。

新規ストリング記述子における '*' ストリング

新規ストリング記述子を作成すると、AME は、 初期デフォルト値としてストリング '*' を「ストリング」 入力フィールドに入れます。この初期ストリングを消去して、必要なストリングを入力してください。 アスタリスク (*) には意味も機能もありません。 この初期ストリングは「デフォルト・ストリング値」を示し、同じ効果があります。

アクション・タブ

AME の「画面」タブにある「アクション」タブを使用して、アクションを作成および編集 できます。「アクション」タブでアクションを作成すると、 AME は、現在選択されている画面の <actions> エレメントに 新規アクションを挿入します。図 70 に、「アクション」タブの例を示します。

図 70. アクション・タブ
マクロ・エディターのアクション・タブ

図 70 では、AME の「画面」タブが選択されています。現在選択されている画面の名前 (Screen1) が、「画面」タブの 「画面名」フィールドに表示されています。「画面名」フィールドの下には、「一般」、「説明」、 および「アクション」のサブタブがあります。「アクション」タブが選択されています。

「説明」タブと同様に、「アクション」タブには上部領域と下部領域があります。

上部領域には、単一のアクション・エレメントを全体と見なして作用する コントロールがあります。 具体的には、「アクション」タブの左上隅にある「アクション」リスト・ボックスに、 現在選択されているアクションの名前が表示されます。上の図では、まだアクションが作成されていないので、現在選択されている アクションはありません。

「アクション」タブの下部領域には、現在選択されているアクションがある場合はその 内容が表示されます。現在選択されているアクションが入力アクションの場合、 「アクション」タブの下部領域にはそのタイプのアクションに該当する 内容が表示されます。 抽出アクションなど、別のタイプのアクションをユーザーが作成または選択した場合、 下部領域には抽出アクションに該当する内容が表示されます。

新規アクションの作成

図 70 の「アクション」リスト・ボックスに もう一度注目すると、このリスト・ボックスにはまだアクションが入っていない ことが分かります。不等号括弧で囲まれ、「新規」という語で始まる 選択項目は、すべて新規アクションの作成用です。 図 70でも分かるように、 「アクション」リスト・ボックスは、 リスト全体を一度に表示するには高さが不足しています。以下にリストの全体を示します。

図 71. 作成済みアクションがない状態での「アクション」リスト・ボックス のリストの内容
<新規入力アクション>
<新規抽出アクション>
<新規プロンプト・アクション>
<新規一時停止アクション>
<新規通信待機アクション>
<新規トレース・アクション>
<新規マウス・クリック・アクション>
<新規変数更新アクション>
<新規マクロ実行アクション>
<新規実行アクション>
<新規条件付きアクション>
<新規 SQL 照会アクション>

例えば、「<新規 入力アクション>」をクリックすると、マクロ・オブジェクトは新規の入力アクションを作成し、 リストの一番上に配置します。「アクション」タブの下部領域では、 入力アクションに属する各種フィールド (入力 キー・シーケンスなど) に入力できます。「アクション」リスト・ボックスの 選択領域に新規の入力項目が表示され、リスト・ボックスのリスト部分は次のようになります。

図 72. 実際のアクションが 1 つある状態での「アクション」リスト・ボックスのリストの内容
入力アクション 1 (0,0)
<新規入力アクション>
<新規抽出アクション>
<新規プロンプト・アクション>
<新規一時停止アクション>
<新規通信待機アクション>
<新規トレース・アクション>
<新規マウス・クリック・アクション>
<新規変数更新アクション>
<新規マクロ実行アクション>
<新規実行アクション>
<新規条件付きアクション>
<新規 SQL 照会アクション>

マクロ・ランタイムがこのマクロ画面を処理する際には、 「アクション」リスト・ボックスのリスト順と同じ順序で アクションが実行されます。実際のアクションの順序を変更するには、「アクション」リスト・ボックスの 右側にある「順序変更」ボタンをクリックします。

AME では、「リンク」タブをユーザー・インターフェースとして使用して、マクロ画面の <nextscreens> エレメントに候補マクロ画面の名前を保管します。図 73 に、「リンク」タブの例を示します。

図 73では、タブの上部にある「画面名」リスト・ボックスに、マクロ全体に含まれるマクロ画面すべてのリストが表示されています。現在選択されているマクロ画面は Screen1 です。 右側の「有効な次の画面」リスト・ボックスには、Screen1 のマクロ画面候補のリストが表示されています (このリスト・ボックスには Screen1 の <nextscreens> エレメント内にある名前が含まれていますが、マクロ・ランタイムがマクロの再生時に使用する有効な次画面のリストと混同しないでください)。左側の「使用可能な画面」リスト・ボックスは、 他のマクロ画面すべての名前をリストしています。

図 73 では、「使用可能な画面」リストに画面名が 1 つしか表示されていませんが、これは、この図が 2 つのマクロ画面 (Screen1 と Screen2) だけのマクロから取られたものだからです。ここで、20 画面のマクロがあり、新しいマクロ画面 ScreenR の <nextscreens> リストにマクロ画面を追加するとします。次の手順で行います。

  1. 「リンク」タブで、「画面名」リスト・ボックスを 展開し、ScreenR が見つかるまでスクロールダウンする。
  2. ScreenR を選択する。
  3. ScreenR は新規画面なので、右側の「有効な次の画面」 リストにマクロ画面名はリストされません。
  4. 左側の「選択可能な次画面 (Available Next Screens)」リスト・ボックスには、 マクロ内のマクロ画面すべての名前があります。
  5. ScreenR のリストに追加する画面を選択する。 ScreenS を選択したとします。
  6. ScreenS を選択した後、2 つのリスト・ボックスの間にある右矢印のボタンを クリックする。ScreenS が右側のリスト・ボックスに追加され、左側の リスト・ボックスから除去されます。
  7. 同じように、追加したい他のマクロ画面の名前を ScreenR の「有効な次の画面」リスト・ボックスに移動する。
  8. 合計 3 つの画面名 (ScreenS、ScreenG、および ScreenY) を移動します。

完了すると、現在選択されているマクロ画面 ScreenR の 有効な次画面のリストに、3 つのマクロ画面の名前が表示されます。

ソース表示を参照すると、有効な次のマクロ画面の名前 ScreenS、ScreenG、および ScreenY が、図 74 に示すように ScreenR の中に保管されていることが分かります。

図 74. <nextscreens> エレメントがあるマクロ画面 ScreenR
<screen name="ScreenR" entryscreen="true" exitscreen="false" transient="false">
   <description>
      ...
   </description>
   <actions>
      ...
   </actions>
   <nextscreens>
      <nextscreen name="ScreenS"/>
      <nextscreen name="ScreenG"/>
      <nextscreen name="ScreenY"/>
   </nextscreens>
</screen>

図 74 では、ScreenR の <screen> エレメントの name 属性は "ScreenR" に設定されています。内側には、<screen> エレメントの 3 つの基本構造エレメント (<description> エレメント、 <actions> エレメント、および <nextscreens> エレメント) があります。 <description> エレメントと <actions> エレメントの内容は表示されませんが、省略符号 (...) によって示されます。<nextscreens> エレメントには 3 つの <nextscreens> エレメントがあり、それぞれの <nextscreen> エレメントには、有効な次画面 ScreenS、ScreenG、および ScreenY のいずれかの名前があります。

ランタイム処理について詳しくは、マクロ・ランタイムによるマクロ画面の処理方法を参照してください。

変数タブ

変数は 1 つの画面ではなくマクロ全体に属するため、 変数用の上位タブが別個に用意されています。「変数」タブを使用して、以下のことができます。

標準データ・タイプに属する変数を作成するには、AME の「変数」タブを使用します。図 75 に、「変数」タブの例を示しています。

図 75. 変数タブ
マクロ・エディターの変数タブ

図 75 では、AME の「変数」タブが選択されています。現在選択されている変数の名前 $strUserName$ が、 「変数」リスト・ボックスに表示されています。その他 3 つのフィールド、「名前」入力フィールド、 「タイプ」リスト・ボックス、および「初期値」 入力フィールドといった、マクロ・ランタイムがこの変数を作成するために 必要とする情報があります。

「変数」リスト・ボックスには、このマクロ用に作成された 変数すべての名前があります。編集または除去する変数をこのリスト・ボックスから選択でき、 また変数を新規に作成するための <新規変数> 項目もあります。

現在選択されている変数の項目が、別のストリングの後に括弧で囲んで 表示されていることに注意してください。

Variable1($strUserName$)

ストリング Variable1 は、作成した変数の数を示す 設定値で、マクロ・スクリプトには保存されません。変数の実名は $strUserName$ であり、 変数を使用するときには、マクロ全体でこの名前を単独で使用する必要があります。

変数名 $strUserName$ がドル記号 ($) で囲まれていることに お気付きかもしれません。これは要件であり、マクロ内で変数を使用する ときには、必ず変数名をドル記号 ($) で囲む必要があります。

「名前」入力フィールドは、現在選択されている変数 $strUserName$ の名前を表示します。既存の名前に上書き入力することによって、変数名を変更できます。通常、このフィールドは、新規に作成した変数に名前を割り当てるためだけに 使用してください。後でいつでもこのパネルに戻ってこの変数の名前を変更できますが (例えば $strUserFirstName$ に)、 マクロ内のどこかで、アクションや記述子にこの変数の以前の名前を すでに使用している可能性があるので注意してください。この「変数」タブで 名前を変更した場合は、マクロ内でこの変数を使用したすべての場所にも戻って、 以前の変数名を新しい変数名に変更する必要があります。

任意の変数名を選択できますが、選択できる文字にはいくつかの制限が あります (変数名とタイプ名を参照)。本書で行っているように、データ・タイプの省略形で始まる名前を選択する必要は ありません (ストリング変数 $strUserName$ の str のように)。

「タイプ」リスト・ボックスには、変数に使用可能なタイプがリストされ、 新規変数に使用するタイプをここから選択できます。標準タイプは、string、integer、double、 boolean、および field です。また、java.util.Hashtable などの Java クラスをインポート済みタイプとして インポートすると、「タイプ」リスト・ボックスにはこのインポート済みタイプが取り込まれ、図 76 に示すように使用可能なタイプのリストに追加されます。

図 76. インポート済みタイプ を宣言した後の「タイプ」リスト・ボックスの内容
string
integer
double
boolean
field
java.util.Hashtable

このリスト・ボックスは、新規に作成した変数にタイプを 割り当てるためだけに使用してください。後でこのパネルに戻ってこの変数のタイプを別のタイプに変更できますが、 変数名の場合と同様に、マクロの中で最初に選択したタイプを必要とする コンテキストで、すでにこの変数を使用している可能性があるので 注意してください。この場合、該当するそれぞれの個所を調べて、変数を使用しているコンテキスト が新しいタイプに適しているかどうか確認する必要があります。

「初期値」入力フィールドには、変数の初期値を指定できます。AME は、タイプに応じて 次のデフォルト値を提供します。

表 22. 変数のデフォルト初期値
変数のタイプ: デフォルト初期値:
string ストリングなし
integer 0
double 0.0
boolean false
field (初期値なし)
(すべてのインポート済みタイプ) ヌル

新しい初期値を指定するには、単にデフォルト値に上書きして入力します。

「除去」ボタンは、現在選択されている変数を除去します。

「インポート」ボタンと「インポート」ポップアップ・ウィンドウ については、Java クラスのインポート済みタイプの作成で説明します。

変数の新規作成

AME で変数を新規に作成するには、 まず「変数」リスト・ボックスの最後にある「<新規変数>」エントリーをクリックします。AME は、変数を新規に作成し、いくつかの初期特性を割り当てます。 これらの特性は、ユーザーがニーズに合うように修正する必要があります。初期値は次のとおりです。

  1. 初期名 ($a1$ など)。
  2. 初期タイプ (string)。
  3. 初期値。タイプによって異なります (表 22 を参照)。

注:
ストリング変数を作成した場合、初期値を単一引用符で囲む必要があります。 そうしないと、初期値が無効な表現であるという メッセージが表示されます。

次に、新規変数に必要な値を設定する必要があります。例えば、 画面をカウントするための整変数を作成し、その初期値を 1 にする必要がある 場合は、次のように初期値を設定します。

  1. 「名前」入力フィールドに、名前 $intScreenCount$ を入力します。
  2. 「タイプ」リスト・ボックスから、integer データ・タイプを選択します。
  3. 「初期値」フィールドに 1 を入力します。

「変数」タブのほかに、いくつかの便利な位置で、AME から 変数を新規に作成するためのポップアップ・ウィンドウにアクセスできます。例えば、変数更新アクションの場合、「名前」リスト・ボックスにはすでに作成済みの変数名がすべて表示されるだけでなく、 「<新規変数>」項目も表示されます。この項目をクリックすると、変数を新規に作成するためのポップアップ・ウィンドウ が開きます。このポップアップ・ウィンドウを使用して作成した変数は、 「変数」タブで作成した変数と同等です。

ソース表示での変数の作成については、 変数の作成を参照してください。

Java クラスのインポート済みタイプの作成

Host On-Demand マクロは、Java クラスをインポートする方法として、 インポート済みタイプを使用します。 つまり、インポート済みタイプをまず作成し、特定の Java クラスに関連付ける必要が あります。この作業は、マクロごとに、Java クラス 1 つに対して 1 回のみ行います。インポート済みタイプを作成するには、次の手順で行います。

  1. 「変数」タブの「インポート」ボタンを クリックする。「インポート」ポップアップ・ウィンドウが 表示されます。
  2. 「インポート済みタイプ」リスト・ボックスで、 項目「<新規インポート済みタイプ>」を選択する。
  3. タイプのクラス名を入力する (例: java.util.Hashtable)。パッケージ名 (ある場合) を含む、完全修飾クラス名を入力する必要があります。
  4. 短縮名を入力する (例: Hashtable)。短縮名を指定しない場合、 AME は完全修飾クラス名を 短縮名として使用します。短縮名を指定すると、インポート済みタイプを参照する際に、 短縮名または完全修飾クラス名のどちらも使用できます。
  5. 「OK」をクリックする。

このインポート済みタイプに属する変数を作成するには、 変数を通常の方法で作成しますが、インポート済みタイプを変数のタイプとして 選択します。インポート済みタイプの変数を作成するには、次の手順で行います。

  1. 「変数」リスト・ボックスの最後にある 「<新規変数>」項目をクリックする。AME は、 名前 ($a1$ など)、タイプ (string)、および初期値 (ブランク) など、デフォルトの初期値を通常どおり表示します。
  2. 「名前」入力フィールドに、任意の名前 (例: $ht$) を入力する。
  3. 「タイプ」リスト・ボックスで、インポート済みタイプを選択する。例えば、Hashtable (タイプをインポートしたときに短縮名を 指定した場合)、または java.util.Hashtable (完全修飾クラス名と 同じ、デフォルトの短縮名を受け入れた場合) を選択します。
  4. 「初期値」フィールドでは、 フィールドをブランクのままにする (初期値は null になる) か、 クラスのインスタンスを戻すメソッドを 指定できます。例えば、$new Hashtable()$ (短縮名を使用)、 または $new java.util.Hashtable()$ (完全修飾クラス名を使用) を 指定します。

コンストラクターはドル記号 ($) で囲む点に注意してください。変数の名前 をドル記号で囲む必要があるように、Java メソッドの呼び出しも ドル記号で囲む必要があります (これは、ドル記号で囲むことにより、 項目を評価する必要があることをマクロ・ランタイムに示すためです)。

「インポート」ポップアップ・ウィンドウに戻ると、 「インポート済みタイプ」リスト・ボックスを使用して タイプを新規に作成でき、すでに作成済みのタイプを編集または削除することも できます。タイプを新規に作成するには、リストの最後にある 「<新規インポート済みタイプ>」 をクリックします。タイプを編集するには、「インポート済みタイプ」リスト・ボックス からタイプを選択し、「クラス」と「短縮名」の 入力フィールドで値を変更します。タイプを除去するには、 タイプを選択して「除去」をクリックします。

短縮名を指定する際には、特定の制限のもとで任意の名前を使用でき ます (変数名とタイプ名を参照)。

ソース表示でのインポート済みタイプの作成については、 Java クラスのインポート済みタイプの作成を参照してください。

アクションの操作

以下のセクションでは、AME を使用して追加または編集できるすべてのアクションについて 説明します。マクロ・アクションおよび各アクションについて詳しくは、マクロ・アクションを参照してください。

通信待機アクション

通信状態

「接続状態」リスト・ボックスにリストした 状態のいずれかを指定できます。表 23 に、それぞれの状態の名前と重要度をリスト します。

表 23. 通信状態
通信状態: 重要度:
接続開始済み 初期状態。通信の開始が実行された。
接続アクティブ保留中 ソケット接続の要求。
接続アクティブ ソケット接続済み。ホストとの接続。
接続作動可能 Telnet 折衝が開始された。
接続装置名作動可能 装置名が折衝された。
接続ワークステーション ID 作動可能 (Connection Workstation ID Ready) ワークステーション ID が折衝された。
接続非アクティブ保留中 通信の停止が実行された。
接続非アクティブ ソケットがクローズされた。ホストとの接続なし。

安定状態 (つまり、通常は数秒間よりも長く持続する状態) には次のものがあります。

「接続状況」リスト・ボックスで 「<式>」を選択した場合は、 <commwait> エレメントの value 属性に指定されている ことをマクロ・ランタイムが予期する、いずれかのキーワードに解決される式を 指定する必要があります (<commwait> エレメントを参照)。例えば、CONNECTION_READY に解決される変数 $strCommState$ を指定できます。

詳しくは、通信待機アクション (<commwait> エレメント)を参照してください。

条件付きアクション

条件の指定

条件」フィールドに、マクロ・ランタイムに評価させる条件式を指定します。 条件式には論理演算子と条件演算子を指定でき、 また演算式、即時値、変数、および Java メソッドの呼び出しを含む 項を指定できます (条件演算子と論理演算子および式を参照)。

条件が真 (<if> エレメント)

条件が真として評価された場合に実行するアクションを指定するには、 「条件が真」タブを使用します。

「条件が真」タブには、「アクション」タブ のコントロールとほとんど同一のコントロールがあります。具体的には、次のとおりです。

「条件が真」タブにあるこれらのコントロールを使用して、 条件が真の場合にマクロ・ランタイムが実行するアクションを作成および編集します。

条件が偽 (<else> エレメント)

条件が偽として評価された場合に実行するアクションを指定するには、 「条件が偽」タブを使用します。

「条件が真」タブと同様、「条件が偽」タブには、「アクション」タブ のコントロールとほとんど同一のコントロールがあります。「条件が偽」タブにあるこれらのコントロールを使用して、 条件が偽の場合にマクロ・ランタイムが実行するアクションを作成および編集します。

詳しくは、条件アクション (<if> エレメントおよび <else> エレメント)を参照してください。

抽出アクション

テキストのキャプチャー

抽出アクションの最も一般的な用途は、ホスト端末に表示されているテキストのキャプチャーです。

次に、行う手順の概要を示します。その後のサブセクションで、各ステップ について詳しく説明します。

  1. 「連続抽出」オプションを設定する (必要な場合)。
  2. キャプチャーするホスト端末上の領域を指定する。
  3. 抽出名を指定する。
  4. データ平面として TEXT_PLANE を指定する。
  5. テキストを格納する変数を指定する。
注:
値を抽出して、抽出によって設定されているグローバル変数に割り当て、 そのグローバル変数の値をプロンプトに使用するには、 promptall 属性を false に設定する必要があります。 promptall 属性が true に設定されていると、 プロンプトの値が取り出されるまで抽出アクションは実行されません。このため、プロンプトによって使用されるグローバル変数には値が入っていません。 HATS で記録されるマクロは、デフォルトで promptall=true になっています。 promptall 属性について詳しくは、promptall 属性を参照してください。
「連続抽出」オプションを設定する

テキストの長方形ブロックをキャプチャーする場合は、 「連続抽出」オプションを false に 設定します (これがデフォルト値です)。詳しくは、ホスト端末上の長方形領域のキャプチャーを参照してください。

これに対し、行から行に折り返すテキストの連続シーケンスをキャプチャーする 場合は、「連続抽出」オプションを true に設定します。 詳しくは、ホスト端末からのテキスト・シーケンスのキャプチャーを参照してください。

ホスト端末上の領域を指定する

キャプチャーするホスト画面上の領域を指定するには、 「抽出アクション」ウィンドウの「行」フィールドと「列」フィールドに、テキスト域の行と列の座標を入力します。

マクロ・ランタイムは、「連続抽出」オプションが false と true のどちらに 設定されているかによって、入力された値を異なった方法で解釈します (「連続抽出」オプションを設定するを参照)。

1 組目の行と列の値 (「抽出アクション」ウィンドウの「上角 (Top Corner)」) に 1 組目の行と列の座標を入力し、2 組目の行と列の値 (「下角 (Bottom Corner)」) に 2 組目の座標を入力します。 ホスト画面のテキスト・カーソルを補助的に使用して、 必要な座標を決定できます。

「終了行」入力フィールドに -1 を入力すると、ホスト画面のデータ域の最終行を指定することができます。この機能は、ユーザーがさまざまな高さ (25 行、43 行、50 行など) のホスト画面を使用しており、かつ画面のデータを最終行までキャプチャーする必要がある場合に便利です。同様に、「終了列」入力フィールドでも、-1 を入力すると、ホスト画面のデータの最終列を指定することができます (行または列の負の値の意味を参照)。

抽出名を指定する

抽出名 (例えば 'Extract1') を指定する必要があります。

データ平面として TEXT_PLANE を指定する

「データ平面」リスト・ボックスの「TEXT_PLANE」をクリックします。これはデフォルトです。

テキストを格納する変数を指定する

チェック・ボックス「テキスト平面の変数への割り当て」を設定し、テキストを格納する変数の名前を入力します。テキストはストリングとして戻されます。ほとんどの場合、 マクロ内の他のアクションがストリングを処理できるように、 ストリングはストリング変数に格納する必要があります。

ただし、他の標準データ・タイプ (boolean、integer、double) を指定した場合、 マクロ・ランタイムは可能ならストリングを変数のフォーマットに変換します。 例えば、画面のテキストが 1024 で、変数が整変数の場合、 マクロ・ランタイムはストリング 1024 を整数の 1024 に変換し、 整変数に値を格納します。 フォーマットが無効でストリングを変数のデータ・タイプに変換できない場合、 マクロ・ランタイムはランタイム・エラーを出してマクロを終了します。データ変換について詳しくは、自動データ・タイプ変換を参照してください。

入力アクション

入力ストリング

「ストリング」フィールドは、アクションに実行させるキー・シーケンスを 指定するための入力フィールドです。

文字を表示するキー (a、b、c、#、& など) を指定するには、 そのキー自体を入力します。

キーを「アクション・キー」リスト・ボックスから 指定するには、目的のキー ([backspace] など) までリストを スクロールし、「アクション・キーの挿入」をクリックします。 「ストリング」フィールドの次の入力位置に、キーの名前が 大括弧で囲まれて表示されます。「アクション・キー」 リスト・ボックスにあるキーは、アルファベット順にリストされていないので 注意してください。必要なキーを見つけるために、リストをスクロールし続ける必要が生じる ことがあります。

別の方法として、単に名前自体を大括弧で囲んで入力 フィールドに入力する (例: [backspace]) ことにより、 アクション・キーを指定することもできます。

3270 ディスプレイ・セッションの「アクション・キー」リストには、 次のコピー・アンド・ペースト・キーが表示されます。

[copy]                  [mark right]
[copyappend]            [mark up]
[cut]                   [paste]
[mark down]             [pastenext]
[mark left]             [unmark]

HATS はディスプレイ・セッション (Host On-Demand 端末) を作成しないため、これらのキーは HATS によってサポートされていません。

その他のキーについては、入力アクションの略号キーワードを参照してください。

詳しくは、入力アクション (<input> エレメント)を参照してください。

マウス・クリック・アクション

マウス・クリック・アクションは、ユーザーによるホスト端末上でのマウス・クリックをシミュレートします。実際のマウス・クリックと同様に、クリックが行われたときに マウス・アイコンが指していた行と列の位置にテキスト・カーソルがジャンプします。

行と列の指定

アクション・タブの下部領域で、マウス・クリックを発生させるホスト端末上の位置 (行と列) を指定します。または、 ホスト端末をクリックします。これにより、マクロ・エディターの 「行」フィールドと「列」フィールドの値が 更新され、テキスト・カーソルの新しい位置が反映されます。

詳しくは、<mouseclick> エレメントを参照してください。

一時停止アクション

一時停止アクションは、指定されたミリ秒数の間だけ待機した後、終了します。

具体的には、マクロ・ランタイムは <pause> エレメントを検出し、 期間の値を読み取って、指定されたミリ秒数だけ待機します。 その後、マクロ・ランタイムは次の項目の実行に進みます。

このアクションは次の場合に使用します。

期間」入力フィールドには、 ミリ秒数を入力します。デフォルトは 10000 ミリ秒 (10 秒) です。

詳しくは、<pause> エレメントを参照してください。

実行アクション

実行アクションは、インポートした Java クラスに属するメソッドを 呼び出します (Java クラスのインポート済みタイプの作成を参照)。

メソッドの呼び出し

「実行するアクション」フィールドにメソッド呼び出しを 入力します。変数と同じように、メソッド呼び出しをドル記号 ($) で囲む必要があります (メソッド呼び出しの構文を参照)。 マクロ・ランタイムがメソッドを呼び出します。 マクロ・ランタイムが呼び出し先メソッドを検索する方法も参照してください。

詳しくは、実行アクション (<perform> エレメント)を参照してください。

Playmacro アクション

PlayMacro アクションは、別のマクロを起動します。

ターゲット・マクロのファイル名と開始画面

「マクロ名」フィールドを使用して、ターゲット・マクロの 名前を指定します。

「開始画面名」リスト・ボックスは、 マクロ・ランタイムがターゲット・マクロ内で最初に処理する マクロ画面を選択するために使用します。

詳しくは、PlayMacro アクション (<playmacro> エレメント)を参照してください。

プロンプト・アクション

プロンプト・アクションは、ユーザーによる直接のキーボード入力を 3270 また は 5250 アプリケーションに送るか、変数に格納するための強力な機能を 備えています。

プロンプト・ウィンドウの表示

プロンプト・ウィンドウの各部分

プロンプト・テキスト (「パスワードを入力してください: ('Please type your password:')」など) は、「プロンプト・テキスト」フィールドではなく 「プロンプト名」フィールドに入力する必要があります。(「プロンプト・テキスト」フィールドは、特定のプロンプト・アクション の詳細を説明するメモの保管に使用できるオプションのフィールドです。)

マクロ・ランタイムが表示するプロンプト・ウィンドウには、 次の特性があります。

デフォルトの応答

「デフォルトの応答」フィールド (オプション) には、 プロンプト・ウィンドウが表示されたときに、 プロンプト・ウィンドウの入力フィールドに表示したいデフォルト応答のテキスト を入力できます。 ユーザーがプロンプト・ウィンドウの入力フィールドに キーボードで入力せず、単に「OK」をクリックして入力完了を指示した場合、 マクロ・ランタイムは入力フィールドに入っているデフォルト応答を処理します。

例えば、ユーザーが通常は ApplicationA を使用し、ときどき ApplicationB を 使用する場合は、「デフォルトの応答」フィールド に ApplicationA と入力できます。マクロ・ランタイムがプロンプト・アクションを実行すると、 入力フィールドにテキスト ApplicationA が すでに表示された状態で、プロンプト・ウィンドウが表示されます。 「OK」をクリックするか (この場合、マクロは入力フィールドの 内容として ApplicationA を処理します)、 入力フィールドに ApplicationB と入力して「OK」をクリックできます (この場合、 マクロは入力フィールドの内容として ApplicationB を処理します)。

パスワードの応答

「パスワードの応答」リスト・ボックスで true を 選択した場合 (デフォルトは false)、プロンプト・ウィンドウの入力フィールド にキー入力するたびに、マクロ・ランタイムはそのキーに関連した文字の代わりに アスタリスク (*) を表示します。

例えば、「パスワードの応答」リスト・ボックス を true に設定すると (または実行時に true に解決されると)、 ユーザーが 'Romeo' と入力した場合に、マクロ・ランタイムは 入力フィールドに ***** を表示します。

応答が必要

「応答が必要 (Require Response)」リスト・ボックスを true (デフォルトは false) に 設定すると、以下のようになります。

このように、「応答が必要 (Require Response)」を true に設定すると、処理を続行する前に 応答が必要であることを (入力フィールドの右側に (必須 (required)) を表示することによって) エンド・ユーザーに知らせ、「OK」をクリックする前に入力フィールドにテキストを入力することを (入力フィールドにテキストが入れられるまで「OK」を使用不可にすることによって) エンド・ユーザーに要求する、 という効果があります。ただし、プロンプト・アクションにデフォルトの応答が組み込まれていると「OK」は 使用可能になり、そのデフォルトの応答が入力フィールドに表示されます。

「応答が必要 (Require Response)」リスト・ボックスで false を選択すると、以下のようになります。

このように、「応答が必要 (Require Response)」を false に設定すると、プロンプトの 入力フィールドがブランクであっても「OK」をクリックすることによってマクロの 処理を続行できる、という効果があります。

<HAScript> エレメント (または <actions> エレメント) の promptall 属性が true に設定されていて、「応答が必要 (Require Response)」が true に設定されている マクロ (またはマクロ画面) にいくつかのプロンプト・アクションがあれば、マクロ再生の開始時 (またはマクロ画面の再生の開始時) に、マクロ・ランタイムがプロンプト入力フィールドのすべてを 1 つのプロンプト・ウィンドウに表示すると、すべての入力フィールドにテキストが入るまで、 マクロ・ランタイムはプロンプト・ウィンドウの「OK」ボタンを使用可能にしません (promptall 属性を参照)。

注:
プロンプトの値が抽出によって設定されたグローバル変数に基づいていて、 promptall 属性が true に設定されている場合、プロンプトの値が取り出されるまで 抽出アクションは実行されません。 このため、プロンプトによって使用されるグローバル変数には値が入っていません。 グローバル変数を extracts および prompts とともに使用する場合、promptall 属性を false に 設定する必要があります。HATS で記録されるマクロは、デフォルトで promptall=true になっています。

入力フィールドの内容の処理

応答の長さ

「応答の長さ」フィールドの値は、 入力フィールドのサイズではなく、マクロ・ランタイムが ユーザーに許可する入力フィールドへの入力文字数を指定します。

例えば、「応答の長さ」フィールドを 10 に設定すると、 マクロ・ランタイムは、入力フィールドへの入力を 10 文字のみユーザーに許可します。

アクション・キーとホスト・アクション・キーの変換

マクロ作成者 (「デフォルトの応答」入力フィールド) と ユーザー (「プロンプト」ウィンドウの入力フィールド) の両方が、 入力アクションの「ストリング」フィールドの場合と同様に (入力ストリングを参照)、 アクション・キー ([enterreset]、[copy] など) を使用できます。

「ホスト・アクション・キーの変換」リスト・ボックス とその効果は、入力アクションの「ホスト・アクション・キーの変換」リスト・ボックスとまったく同じです (ホスト・アクション・キーの変換 (xlatehostkeys 属性)を参照)。 このリスト・ボックスを true (デフォルト値) に設定すると、 マクロ・ランタイムはアクション・キー・ストリング ([enter] など) を リテラル・ストリングとしてではなくアクション・キーとして解釈します。

ホスト端末での入力シーケンスの処理

マクロ・ランタイムが入力シーケンスの入力を開始する位置となるホスト端末上の位置 (行と列) を指定するには、「行」フィールドと「列」フィールドを使用します。マクロ・ランタイムにテキスト・カーソルの現在位置から入力シーケンスの入力を開始させるには、「行」フィールドと「列」フィールドの一方または両方を 0 に設定します。入力アクションの場合と同様に、この行と列の位置は、アクション実行時に 3270 入力フィールドまたは 5250 入力フィールドの中になければなりません。この条件を満たしていない場合、ホスト端末は入力を禁止し、エラー・シンボルをオペレーター情報域に表示します。この応答は、入力が実際のユーザーのキーボード入力である場合の応答と同じです。

「ホスト・フィールドの消去」リスト・ボックスを true に 設定すると、マクロ・ランタイムは入力開始前に入力フィールドの内容を 消去します。

「カーソルを入力の終わりに移動」フィールドには、 入力アクションの同名のボタンと同じ機能と効果があります (入力の末尾へカーソルを移動 (movecursor 属性)を参照)。

「画面に書き込まないでください」リスト・ボックスを true に 設定すると、入力フィールドに入力シーケンスを表示しないように マクロ・ランタイムに指示できます。このフィールドは、「変数への割り当て」チェック・ボックス が選択されている場合にのみ使用可能になります。

変数への入力シーケンスの割り当て

「変数への割り当て」チェック・ボックスにチェック・マークを付ける と、マクロ・ランタイムが入力シーケンスを変数に格納するようにできます。

リスト・ボックスで <新規の変数> エントリーを クリックして、新規変数を作成します。新規変数を指定するためのポップアップ・ウィンドウで、 現行マクロが別のマクロから継承する変数の名前を指定でき、 また現行マクロ内で作成する新規変数の名前を指定することもできます。 現行マクロ内で新規変数を作成する場合は、「このマクロで変数を作成します」チェック・ボックスを 選択し、新規変数のタイプを選択します。

マクロ・ランタイムは入力シーケンスをストリングとして保管するので、 ストリング変数を入力を受け取る変数に指定できます。 ただし、変数がストリング以外のタイプである場合、マクロ・ランタイムは 通常の規則に従って、入力データをターゲット変数のデータ・タイプに変換しようと します (自動データ・タイプ変換を参照)。

SQLQuery アクション

SQLQuery アクションは、非常に便利で強力なアクションです。これにより、SQL ステートメントをホスト・データベースに送信し、SQL ステートメントによって出力される任意のデータを検索して、そのデータを Host On-Demand マクロ変数に書き込むことができます。

SQL ステートメントを手動で作成、または SQL ステートメントを SQL ウィザードで作成およびテストすることができます。

ステートメント・セクションと結果セクション

「SQLQuery アクション」ウィンドウにはステートメント・セクションと 結果セクションの 2 つのメイン・セクションがあります。

ステートメント・セクションはウィンドウの上部の領域にあり、ここにはフィールド 「データベース URL」、「ドライバー ID」、 「ドライバー・クラス」、「ユーザー ID」、「パスワード」、および 「ステートメント」があります。このセクションの情報は、以下の 2 つの方法で変更できます。

またすべてのフィールドは、そのフィールドに入力することによって、いつでも編集できます。

結果セクションはウィンドウの下部の領域にあり、ここには 残りのフィールドの「結果の出力先 (Output Result To)」($HMLSQLUtil$ マクロ変数) があります。

SQL ウィザードの使用

SQL ウィザードを使用すると、SQL ステートメントを作成してテストできます。 SQL ウィザードのグラフィカル・ユーザー・インターフェースを使用すると、 SQL ステートメントのテキスト全体を AME の「ステートメント (Statement)」フィールドに入力することに比べて、 はるかに簡単に SQL ステートメントを作成できます。 また SQL ウィザードでは、操作している SQL ステートメントを実行して、その結果を 表示することもできます。

  1. 「SQL ウィザード」をクリックしてウィザードを開始します。
  2. SQL ウィザードを使用すると、SQL ステートメントを作成してテストできます。
  3. マクロを変更しないで SQL ウィザードをクローズするには、「キャンセル」をクリックします。
  4. SQL ステートメントをマクロに保存するには、以下のいずれかのアクションを行ってください。 AME は、SQL ウィザードで作成された情報をステートメント・セクションの 該当するフィールドに書き込みます。 ステートメント・セクションのフィールドにあった既存の情報は、すべて上書きされます。 AME がフィールドに書き込む情報がストリングなら (例えば、「データベース URL (Database URL)」フィールドに書き込まれる情報)、 AME は自動的に、基本マクロ・タイプに基づいてストリングを 正しく形式設定します。 以下のフィールドが更新されます。
  5. 「キャンセル」をクリックして SQL ウィザードを閉じます。

ステートメント・セッションのフィールドの使用

SQL ステートメントを SQL ウィザードで作成する 代わりに、情報をステートメント・セクションのフィールドに直接入力することもできます。 また、SQL ステートメントを作成した後も、どのフィールドにも入力できます。

データベース URL

「データベース URL」フィールドに、データベースへのアクセスを提供するデータベース・サーバーの データベース URL を入力します。データベース URL の形式は、データベースにアクセスするために使用する Java Database Connectivity (JDBC) ドライバーのタイプによって異なります (ドライバーについて詳しくは、ドライバー ID とドライバー・クラスを参照)。

リモート・サーバーは、アプリケーション・セッションが接続されている ホスト以外のホスト上にあってもかまいません。例えば、 SQLQuery アクションは、同じ SQLQuery アクションが System z® ホストに接続された 3270 ディスプレイ・セッションで実行されているマクロの一部であっても、IBM® i ホストを指定できます。

データベース URL の正しい形式については、そのドライバーのベンダーが提供する 文書を調べてください。

ドライバー ID とドライバー・クラス

SQLQuery アクションでデータベースに アクセスするために使用する JDBC ドライバーは、リモート・ホスト上のサーバー・プログラムと通信するために HATS アプリケーションが使用する、 Java クライアント・パッケージです。リモート・ホスト上のこのサーバー・プログラムが、データベースへのアクセスを提供します。

JDBC ドライバーが必要であれば、リモート・データベース・サーバーの管理者に連絡し、 ドライバーを入手してください。

マクロ・エディターの「SQLQuery アクション」ウィンドウにある 「ドライバー ID (Driver Identifier)」リスト・ボックスで、「その他」を選択します。

「ドライバー ID (Driver Identifier)」リスト・ボックスで「その他」を選択すると、ドライバーの完全修飾クラス名を「ドライバー・クラス (Driver Class)」フィールドに入力する必要があります。 完全修飾クラス名が分からない場合は、ドライバーの提供元に連絡してください。 名前の入力では大/小文字が区別される ことに注意してください (例えば、com と COM は異なる)。

ユーザー ID とパスワード

データベース接続にユーザー ID とパスワードが必要なら、ユーザー ID を 「ユーザー ID」フィールドに、パスワードを「パスワード」フィールドに入力してください。

HATS は、「パスワード」フィールドに入力されたキー・シーケンスを 暗号化します。この暗号化は、「パスワード」チェック・ボックスが入力アクションで選択されているときに行われる 暗号化とまったく同様に動作します (encrypted 属性を参照)。注:

注:
プロンプトのデフォルト値は、暗号化されずにマクロ・ファイルに保管されます。デフォルト値は、マクロ・エディターでプロンプトを編集するときにはプレーン・テキストで表示されます。したがって、プロンプトを使用してパスワードを指定する方法を実行するのは適切ですが、セキュリティー上の理由から、パスワードのデフォルト値は指定しないようにします。
ステートメント

SQL ステートメントを「ステートメント (Statement)」フィールドに貼り付けるか、入力します。既に SQL ステートメントが「ステートメント」フィールドに入っていれば、 (その SQL ステートメントが SQL ウィザードで 作成されたものであっても) 編集できます。

AME は、SQL ステートメントの形式の妥当性を検査しません。 形式が無効である場合、マクロ・ランタイムが SQLQuery アクションを実行するときに ランタイム・エラーが発生します。

SQL ステートメントを複数行にわたって書き込むことも、すべてを 1 行に書き込むことも できます。図 77 および図 78 は、同じ SQL ステートメントが複数行に わたって書き込まれている場合と、1 行に書き込まれた場合を示します。 どちらも正しい方法です。

図 77. 複数行にわたって書き込まれた SQL ステートメント
SELECT
   *
FROM
   SQLTEST.EX01
WHERE
   (
      ( SQLTEST.EX01.DESCRIPT is not null )
   )

図 78. 同じ SQL ステートメントを 1 行に書き込んだ例
SELECT * FROM SQLTEST.EX01 WHERE((SQLTEST.EX01.DESCRIPT is not null))

拡張マクロ形式を使用している場合、SQL ステートメントを単一引用符で 囲まなければならないこと、また特殊文字の規則に従わなければならないことに注意してください。 ここで、図 79 および図 80 は、同じ SQL ステートメントを基本マクロ形式と 拡張マクロ形式で作成した場合を示します。

図 79. 基本マクロ形式で作成された SQL ステートメント
select * from hodtest.ex01 where
      ((hodtest.ex01.descript='Edit Products'))

図 80. 同じ SQL ステートメントを拡張マクロ形式で作成した例
'select * from hodtest.ex01 where
      ((hodtest.ex01.descript=\'Edit Products\'))'

予約語 (例えば select)、およびデータベース名とフィールド (例えば hodtest.ex01.descript) には大文字も小文字も使用できますが、 マッチング・ストリング (例えば 'Edit Products') には大/小文字を 正しく使用する必要があります。 つまり、図 81 の 2 つの SQL ステートメントは同等です。

図 81. 大/小文字が同等なステートメントの例
select * from hodtest.ex01 where
      ((hodtest.ex01.descript='Edit Products'))
SELECT * FROM HODTEST.EX01 WHERE
      ((HODTEST.EX01.DESCRIPT='Edit Products'))

結果セクションの使用

結果セクションのフィールドは、SQL ステートメントから生成されたデータを SQLQuery アクションが どのように使用するかを制御します。 データは、 Host On-Demand マクロ変数に書き込むことができます。

データをマクロ変数 ($HMLSQLUtil$) に保管

SQLQuery アクションで生成されたデータのデフォルト宛先は、 Host On-Demand マクロ変数 $HMLSQLUtil$ です。Host On-Demand ランタイムは、常に この変数を正しく完了した SQLQuery アクションの結果で更新します。

データを $HMLSQLUtil$ に保管するには、 「結果の出力先 (Output Result To)」リスト・ボックスを展開して $HMLSQLUtil$ をクリックします。

$HMLSQLUtil$ に保管されているデータを後続のマクロ・アクションで使用するには、$HMLSQLUtil$ に 関連する Host On-Demand マクロ・ユーティリティー・ライブラリー (HML ライブラリー) から メソッドを呼び出す必要があります。 $HMLSQLUtil$を参照してください。

SQLQuery アクションを双方向言語で使用

双方向言語 (アラビア語およびヘブライ語) の場合、SQLQuery が正しく機能するためには、一部の 特定のパラメーターを設定する必要があります。 AME には、オプションにアクセスするための「拡張」ボタンがあります。 この「拡張」ボタンは、ワークステーションが双方向言語用に構成されている場合のみ、表示されます。

追加のプロパティーは以下のとおりです。

ホスト・ファイル・タイプ (Host-File Type)
ホスト・ファイルが論理形式と可視形式のどちらで保存されるかを指定します。 デフォルトは「可視」です。
ローカル・ファイル・タイプ (Local-File Type)
ローカル・ファイルが論理形式と可視形式のどちらかを指定します。 デフォルトは「論理 (Logical)」です。
ホスト・ファイルの方向 (Host-File Orientation)
ホスト・ファイルを「左から右」形式と「右から左」形式のどちらで保存するかを指定します。 デフォルトは「左から右」です。
ラーム/アリフ拡張 (Lam-Alef Expansion)
ラーム/アリフ文字の動作を指定します。 アラビア語データを SQL ウィザード・ステートメントでホストから受信するとき、ラーム/アリフ文字は 2 つの文字に拡張され、 ラーム/アリフ文字の後にスペースがあれば、ラームの後にアリフが続きます。
ラーム/アリフ圧縮 (Lam-Alef Compression)
ラーム/アリフ文字の動作を指定します。 アラビア語データを SQL ウィザード・ステートメントでホストに送信するとき、 アリフが後に続くラーム文字は 1 つの文字に圧縮され、ラーム/アリフ文字の後にスペースが 追加されます。このオプションは、アラビア語のシステムでのみ使用可能です。 デフォルトは「オン」です。
数表示形状 (Numerals Shape)
SQL ウィザード・ステートメントでのホスト・ファイル上の 数表示の形状を指定します。 数表示形状は NOMINAL、NATIONAL、または CONTEXTUAL です。このオプションは、アラビア語のシステムでのみ使用可能です。 デフォルトは NOMINAL です。
ラウンド・トリップ (Round Trip)
数表示の動作を指定します。 アラビア語/ヘブライ語の文字が前にあれば、数表示の取り消しを不可にします。 デフォルトは「オン」です。
対称スワッピング (Symmetric Swapping)
大括弧などの対称文字の動作を指定します。 画面を逆向きにすると、双方向文字はその相手側と代わります。 デフォルトは「オン」です。

詳しくは、SQLQuery アクション (<sqlquery> エレメント)を参照してください。

トレース・アクション

トレース・アクションは、指定のトレース宛先 (HATS Toolkit コンソールや WebSphere® コンソールなど) にトレース・メッセージを送ります。 また、HATS はマクロ・トレースを HATS ランタイム・トレースに追加します。

トレースの仕様

「トレース・ハンドラー」リスト・ボックスを使用して、 トレース・メッセージを送信する宛先を指定します。

トレース宛先に送るストリングを指定するには、「トレース・テキスト」入力フィールドを使用します。

詳しくは、トレース・アクション (<trace> エレメント)を参照してください。

変数更新アクション

変数更新アクションは、変数に値を格納します。 マクロの実行中に、マクロ・ランタイムはアクションを 実行して、指定の値を指定された変数に格納します。

次の項目を指定する必要があります。

詳しくは、変数更新アクション (<varupdate> エレメント)を参照してください。