次に、すべてのアクションのリストを機能別にグループ分けして示します。
マクロ・ランタイムによるマクロ画面の処理方法で説明したとおり、 マクロ・ランタイムが新しい現行マクロ画面を選択した場合、 マクロ・ランタイムは、そのマクロ画面の <actions> エレメントにある アクションの実行を即時に開始します。
すべてのアクションを実行した後、マクロ・ランタイムは、 次に処理するマクロ画面を判別する次のステップにすぐに進みます。
単一のマクロ画面内では、マクロ・ランタイムは <actions> エレメント内での 出現順にアクションを実行します。 この順序は、 「アクション」 リストで設定したアクションの順序と同じです。
マクロ画面のアクションの作成は必須ではありません。 <actions> エレメントがない場合、または <actions> エレメントが空の場合は、 マクロ・ランタイムはただちにマクロ画面処理の次のセクションに移り、次に処理するマクロ画面を選択します。
一般に、アクションのパラメーターを指定する際には、 特定の標準データ・タイプの即時値を受け入れるコンテキストはすべて、 同じデータ・タイプのエンティティーをどれでも受け入れることに 注意してください。 例えば、ある入力フィールドがストリング値を受け入れる場合、 そのフィールドは、ストリングに評価される式、ストリングに変換される値、 ストリング変数、またはストリングを戻すインポート済みメソッドの呼び出しも 受け入れます (等価を参照)。
ただし、変数を使用できないフィールドがいくつかあります (変数が保持する値の使用を参照)。
VME を使用したアクションの指定方法については、アクションの操作を、AME を使用した指定方法については、アクション・タブを参照してください。
通信待機アクションは、セッションの通信状況がアクションに指定した 状態に変わるまで待ちます。例えば、セッションが完全に接続状態になるまで 待つ通信待機アクションを作成できます。
このアクションは、VME ではソース・タブを使用して、 AME ではアクション・タブを使用して指定することができます。通信待機アクションを参照してください。
マクロ・ランタイムが通信待機アクションの実行を開始すると、 ランタイムは通信待機アクションに指定された通信状況を注視し、 セッションの実際の通信状況と比較します。2 つの状況が一致した場合、 マクロ・ランタイムは通信待機アクションが完了したと判断し、 マクロ・ランタイムは次のアクションの実行に進みます。
ただし、2 つの状況が一致しない場合、マクロ・ランタイムは他の処理を 行わず、通信待機アクションに指定された通信状況がセッション内で実際に 発生するまで単に待ちます。
タイムアウト値の有効期間が切れるとマクロ・ランタイムが通信待機アクション を終了するように、通信待機アクションにミリ秒単位のタイムアウト値を指定できます。 つまり、マクロ・ランタイムが待っている通信状況にならなくても、 タイムアウト値の有効期限が切れるとマクロ・ランタイムは アクションを終了します。
通信待機アクションの後、抽出アクションなど他のアクションを 使用してアプリケーション画面の特性を検査して、 セッションが実際に目的の通信状況になったのか、それとも通信待機アクション がタイムアウトのために終了したのか、判別が必要になる場合があります。
通常、セッションの接続または切断時には、通信状況はいくつかの状態を素早く 通過してから (例えば、保留アクティブ、アクティブ、作動可能の順に)、 安定した状態を一定期間保つ特定の状態 (CONNECTION_WORKSTATION_ID_READY など) に 達します。 ほとんどの場合、その永続的な終了状態を通信待機アクションに指定する必要 があります。
代わりに保留アクティブなどの過渡的な状態を指定した場合、 マクロ・ランタイムが通信待機アクションを実行する機会を得る前に、 セッションがその状態を通過して次の状態に進む可能性があります。このため、マクロ・ランタイムが通信待機アクションを実行すると、 すでに発生した状態をいつまでも待つことになります。
図 14 に、Telnet セッションのネゴシエーションが開始されるまでか、または Telnet ネゴシエーション・セッションが行われずに 10 秒が経過するまでのうち、どちらかの状況が先に生じるまで待機する通信状態の指定例を示します。
<commwait value="CONNECTION_READY" timeout="10000" />
詳しくは、<commwait> エレメントを参照してください。
条件アクションには次の項目があります。
条件アクションには、if 文または if-else 文の機能があります。
このアクションを指定するには、VME を使用する (Evaluate (If) アクションを参照) 方法と、 AME を使用する (条件付きアクションを参照) 方法があります。
マクロ・エディターでは、条件アクションを別の条件アクションの中に 作成できません。このため、別の if 文の中にネストされた if 文や、else 文の中に ネストされた if 文に相当するものは使用できません。
次のコードは、ユーザーに入力を指示します。 入力ストリングが true ストリングの場合、コード・フラグメントにより「You typed TRUE」というメッセージがホスト画面に表示されます。入力ストリングがそれ以外のストリングの場合は、コード・フラグメントにより「You typed FALSE」というメッセージが表示されます。この例では、アクションとしてプロンプト・アクション、条件アクション、および入力アクションが使用されています。
本書のコードをシステム・クリップボードにコピーして、システム・クリップボードから ソース表示にコピーできます。 このコードは該当する部分のみであり、既存のマクロ・スクリプトのマクロ画面にコピーする必要があります。 また、ストリング変数 $strData$ も作成する必要があります。 この変数を作成するには、以下の行を <HAScript> 開始タグと最初の <screen> エレメントの 間に追加してください。
<vars> <create name="$strData$" type="string" value="" /> </vars>
スクリプトはマクロ・エディターで保存した後、マクロ・エディターまたは ソース表示で編集できます。
この例については、次の点に注意してください。
<actions>
<prompt name="’Type true or false’" description="" row="0" col="0"
len="80" default="" clearfield="false" encrypted="false"
movecursor="true" xlatehostkeys="true" assigntovar="$strData$"
varupdateonly="true" />
<if condition="$strData$" >
<input value="'You typed TRUE'" row="0" col="0" movecursor="true" xlatehostkeys="true" encrypted="false"/>
</if>
<else>
<input value="'You typed FALSE'" row="0" col="0" movecursor="true" xlatehostkeys="true" encrypted="false"/>
</else>
</actions>詳しくは、<if> エレメントを参照してください。
抽出アクションは、ホスト端末からデータを抽出し、 オプションでそのデータを変数に格納します。このアクションは非常に有用で、アプリケーション・データの読み取り用にマクロ・オブジェクトが提供する基本的な方法です (ツールキットのプログラミング API の使用に代わるものです)。
このアクションを指定するには、VME を使用する (抽出アクションを参照) 方法と、 AME を使用する (抽出アクションを参照) 方法があります。
TEXT_PLANE から取り込まれたテキストには、表示されないヌル (0x00) またはその他の文字は含まれていません。ブランク・スペース文字が入って 表示されている表示画面の文字セルは、ブランク・スペース文字として キャプチャーされます。
continuous 属性が false の場合 (これが デフォルト値です)、マクロ・ランタイムは 2 組の行と列の値をテキストの長方形ブロックの左上隅と 右下隅 (隅を含む) として扱います。長方形ブロックは、最小で 1 文字、最大でアプリケーション・ウィンドウ全体 にすることができます。
マクロ・ランタイムは、次の処理を行います。
例えば、ホスト端末の行 16、17、および 18 の先頭 40 文字が次のとおりであるとします。
.8..Outlist.....Display, delete, or prin .9..Commands....Create/change an applica .10.Reserved....This option reserved for
さらに、マクロ・ランタイムが、次の設定値で抽出アクションを実行しようとしているとします。
continuous 属性が false のため、 マクロ・ランタイムは行と列の組をテキストの長方形ブロックのマーキング として扱い、左上隅は行 16、列 5、右下隅は行 18、列 12 とします。
マクロ・ランタイムは、結果ストリングを空ストリングに初期化します。 その後、マクロ・ランタイムはテキストの長方形ブロックを 一度に 1 行ずつ読み取り ('Outlist.'、'Commands'、'Reserved')、 それぞれの行を結果ストリングに連結します。 最後に、マクロ・ランタイムは結果ストリング全体を結果変数 $strTmp$ に 格納します。これにより、変数 $strTmp$ には次のストリングが格納されます。
'Outlist.CommandsReserved'
continuous 属性が true の場合、 マクロ・ランタイムは、2 組の行と列の値を、テキストの連続シーケンスの 開始位置と終了位置 (これらの位置を範囲に含む) として扱います。 テキストは、開始位置から終了位置にいたるまでに必要ならば行間で折り返します。 テキストのシーケンスは、最小で 1 文字、最大でアプリケーション・ウィンドウ全体 にすることができます。
マクロ・ランタイムは、次の処理を行います。
例えば、ホスト端末の行 21 と 22 に次のテキストがあるとします (各行は 80 文字)。
........Enter / on the data set list command field for the command prompt pop-up or ISPF line command............................................................
さらに、マクロ・ランタイム が次の設定値を指定して抽出アクションを実行するとします。
continuous 属性が true のため、 マクロ・ランタイムは行と列の組をテキスト・シーケンスの 開始と終了のマーキングとして扱い、開始位置は (21, 9)、 終了位置は (22, 20) とします。
マクロ・ランタイムは、結果ストリングを空ストリングに初期化します。 その後マクロ・ランタイムは、テキスト・シーケンスを 最初から最後まで読み取り、行 21 の最後の文字から行 22 の 最初の文字に折り返します。 最後に、マクロ・ランタイムは結果ストリング全体を結果変数 $strTmp$ に 格納します。変数 $strTmp$ には、次に示す 92 文字のストリングが格納 されます (次に示すテキストは、本書のページに収めるために行末ハイフン 付けが行われていますが、実際にはハイフンなしの 1 つのストリングを 表します)。
'Enter / on the data set list command field for the com- mand prompt pop-up or ISPF line command'
これに対し、この例で continuous 属性を false に 設定した場合、$strTmp$ には 24 文字のストリング 'Enter / on tline command' が格納されます。
このオプションは、continuous 属性が false または true のどちらに設定されていても使用できます。
unwrap 属性を true に設定すると、マクロ・ランタイムは、「抽出」ウィンドウの行と列の組のみでなく、ホスト端末のフィールド境界も使用して、収集するデータを判別します。マクロ・ランタイムは、ストリングの配列 (ツールキットを 使用している場合)、または単一の連結ストリング (ツールキットを使用しない 場合) を戻します。
unwrap 属性を、 ストリング記述子のラップ属性 と混同しないでください。ラップ属性は、フィールドでなく テキストの長方形ブロックを基にしています (マクロ・ランタイムが長方形域を検索する方法 (Wrap 属性)を参照)。
continuous 属性が false の場合、 行と列の組はテキストの長方形ブロックの隅を表します。 unwrap 属性 を true に設定すると、 マクロ・ランタイムはテキストの長方形ブロックの各行を読み取り、 行内の各フィールドを次のように処理します。
unwrap 属性の目的は、フィールドが行から次の行へと折り返している場合でも、フィールドの内容全体を 1 つのストリングとしてキャプチャーすることです。
例えば、ホスト端末の幅が 80 文字で、ホスト端末の行 9、10、11、および 12 が次のとおりであるとします。
...............................................Compress or print data set....... ..............................................................Reset statistics.. ..............................................................Catalog or display information of an entire data set...............................................
さらに、上記の行の中で次のテキスト域がフィールドであるとします。
Reset statistics Catalog or display information of an entire data set
最後に、次のように仮定します。
マクロ・ランタイムは、個々のストリングを連結し、単一のストリングとして、「抽出アクション」ウィンドウに指定されている変数に格納します。この例では、マクロ・ランタイムはストリング 'Reset statisticsCatalog or display information of an entire data set' を 変数に格納します。
continuous 属性が true の場合、2 組の行と列は、 行間で折り返す (必要な場合) 連続したテキスト・シーケンスの開始位置と終了位置 を表します。このときに unwrap 属性を true に設定すると、 マクロ・ランタイムは連続したテキスト・シーケンスを次のように処理します。
詳しくは、<extract> エレメントを参照してください。
入力アクションは、キー・ストロークのシーケンスをホスト端末に送ります。 このシーケンスには、文字 (a、b、c、#、& など) を表示するキーのみでな く、アクション・キー ([enter] など) も含めることができます。
このアクションは、実際のユーザーからのキーボード入力をシミュレートします。
このアクションを指定するには、VME を使用する (「入力」アクションを参照) 方法と、 AME を使用する (入力アクションを参照) 方法があります。
入力シーケンスの開始位置となるホスト端末上の位置 (行と列) を指定するには、 「行」と「列」のフィールドを 使用します。例えば、入力アクションに行 23、列 17 を指定し、入力アクションのストリング値として Hello world を指定した場合、指定した位置が入力フィールド内にあれば、マクロ・ランタイムはキー・シーケンス Hello world をホスト端末の行 23、列 17 から入力します。
行または列の位置を 0 に指定した場合、マクロ・ランタイムは、該当の入力アクションを実行するとき、ホスト端末上の、実際にテキスト・カーソルが置かれている行と列の位置から、キー・シーケンスを入力します。テキスト・カーソルの位置が関係ないコンテキストの場合、またはテキスト・カーソルの位置が予測可能な場合 (例えば、直前のマウス・クリック・ アクションによってテキスト・カーソルが特定の位置に移動した場合や、 アプリケーションがアプリケーション画面を表示する際にテキスト・カーソル の位置を指定した場合) を除いては、行または列に 0 を指定しないでください。
ホスト端末は、マクロ再生時も、実際のユーザーがキーを入力した場合と同様にキー入力エラーに対応します。
例えば、入力アクションが文字を表示するキー (a、b、c、#、& など) を セッションに送った場合に、テキスト・カーソルが 3270 または 5250 入力フィールドの中に なければ、実際のユーザーが入力したキー・ストロークとまったく同様に、セッションはキー入力を禁止し、オペレーター情報域に エラー・シンボルを表示します。
xlatehostkeys 属性は、入力シーケンスにある アクションキー名 ([copy]、[enter]、[tab] など) をアクション・キーとして解釈するか、リテラル文字シーケンスとして解釈するかを マクロ・ランタイムに指示します。デフォルトは true です (アクション・キー名をアクション・キーとして解釈)。
例えば、入力キー・シーケンスが '[up][up]Hello world' で、テキスト・カーソルが行 4、列 10 にあるとします。 xlatehostkeys 属性が true の場合は、この入力シーケンスを実行すると、 マクロ・ランタイムはテキスト・カーソルを上方向に 2 行移動してから、 行 2、列 10 から Hello world を入力します。これに対し、 xlatehostkeys 属性が false の場合、マクロ・ランタイムは 行 4、列 10 から [up][up]Hello world を入力します。
movecursor 属性が true (デフォルト) の場合、 マクロ・ランタイムは、実際のユーザーがキーボード入力を行っている場合と 同じようにテキスト・カーソルを移動します。例えば、キーが 'a' などのテキスト文字の場合、マクロ・ランタイムはこの文字をホスト端末に入力した後、入力した 'a' の後にある最初の文字位置にテキスト・カーソルを移動します。同様に、キーが [tab] の場合、マクロ・ランタイムは テキスト・カーソルを次のタブ位置に移動します。
これに対し、movecursor 属性 の値が false の場合、マクロ・ランタイムはテキスト・カーソルをまったく移動しません。 テキスト・カーソルは、マクロ・ランタイムが 入力アクションを実行する前にあった同じ位置に残ります。
encrypted 属性を使用すると、value 属性 (「ストリング」フィールド) に 含まれる入力キー・シーケンスを 暗号化できます。value 属性の内容が暗号化されると、 Host On-Demand は入力キー・シーケンスの暗号化バージョンのみを マクロ・スクリプト (<input> エレメント) に保管し、 その入力キー・シーケンスのプレーン・テキスト (暗号化されていない) ・バージョンは保存しません。
例えば 図 16 は、暗号化されていない入力キー・シーケンス ('myPassword') が入っている <input> エレメントを示します。
input value="’myPassword’" row="20" col="16" movecursor="true"
xlatehostkeys="true" encrypted="false" />これに対し、図 17 は、暗号化された入力キー・シーケンス (I7xae6rSVlVFF6qzhWRfKw==) が入っている同じ <input> エレメントを示します。 この例では、<input> エレメントの encrypted 属性が true に設定されていることに注意してください。
input value="I7xae6rSVlVFF6qzhWRfKw==" row="20" col="16"
movecursor="true" xlatehostkeys="true" encrypted="true" />マクロ・エディターでは、暗号化された入力キー・シーケンスはアスタリスクで 表示されます (例えば 'myPassword' の暗号化バージョンは、I7xae6rSVlVFF6qzhWRfKw== ではなく ************************ と「ストリング」フィールドに表示されます)。
暗号化によって、パスワードのような機密データを表示することなく入力アクションに 組み込むことができます。 許可のないユーザーが、テキスト・エディターやマクロ・エディターによるマクロ・スクリプトの表示から、またはソースの表示から、機密データを見つけることはできません。
入力キー・シーケンスが暗号化されると Host On-Demand は、ユーザー自身や他のユーザーがマクロ・エディターまたは ソース表示を使用して暗号化解除できないようにします。 マクロ・ランタイムがマクロ再生中に入力アクションを処理するまで、Host On-Demand は 暗号化された入力アクションの入力キー・シーケンスを暗号化解除しません。 マクロ・ランタイムは入力アクションを処理するとき、暗号化された入力キー・シーケンスを 暗号化解除し、暗号化されていないバージョンを指定された行および 列の位置からセッション・ウィンドウに入力します。
特に 3270 または 5250 環境では、パスワードのような機密入力キー・シーケンスの ために、ホスト・アプリケーションは入力キー・シーケンスの宛先として非表示入力フィールドを 作成するため、プレーン・テキストでなくブランクまたはアスタリスク (*) が表示されます。
ただし、略式すぎる表示にマクロ・スクリプトが公開された場合、機密漏れの可能性が残ります。 悪意のあるユーザーがマクロ・スクリプトのコピーにアクセスする権限を持つと、マクロの実行中にマクロ・ランタイムが暗号化解除された入力キー・シーケンスを標準の表示可能フィールドに入力するよう入力アクションの「行」および「列」フィールドを編集し、オリジナルの 暗号化されていない入力キー・シーケンスを見つけることが可能になります。
セキュリティーを強化するには、入力アクションの代わりにプロンプト・アクションを 使用できます。 プロンプト・アクションを使用すると、入力キー・シーケンスは、たとえ暗号化された形式でも マクロ・スクリプトに保管されることはありません。 その代わり、マクロの再生中にプロンプト・アクションを処理するとき、マクロ・ランタイムは入力 フィールドと、入力キー・シーケンスを入力するようエンド・ユーザーに指示するメッセージが 入ったウィンドウをポップアップ表示します。 エンド・ユーザーが入力キー・シーケンスを入力して「OK」をクリックすると、マクロ・ランタイムは ポップアップ・ウィンドウを消去し、その入力キー・シーケンスをセッション・ウィンドウの 指定された行および列の位置に入力します。
入力アクションを使用すると、エンド・ユーザーの介入なしでマクロの再生中にマクロ・スクリプトを 自動的に実行する、という利点があります。 ただし、機密データが変更される (例えば、パスワードの期限が切れ、新しい別のパスワードが 必要になる) と、新しい入力キー・シーケンスで入力アクションを更新する必要があります。
マクロ記録中、3270 ディスプレイおよび 5250 ディスプレイ・セッションの場合のみ、HATS は パスワード入力シーケンスを暗号化された入力キー・シーケンスで、入力アクションとして自動的に記録します。
入力キー・シーケンスがマクロ記録中に自動的に暗号化された場合、マクロ・エディターで 入力アクションを調べると、「暗号化ストリング」(VME) または「パスワード」 (AME) チェック・ボックスが選択され、「ストリング 」フィールドに、暗号化された入力キー・シーケンスを表す数個のアスタリスク (例えば ******) が入っていることが分かります。
これに対し、入力キー・シーケンスがマクロ記録中に自動的に暗号化されなかった (多くの場合、セッションが 3270 または 5250 ディスプレイ・セッションではなかったか、入力フィールドが 非表示入力フィールドではなかったことが原因で) 場合、チェック・ボックスはクリアされ、 「ストリング」フィールドには暗号化されていない入力キー・シーケンスが入ります。
入力キー・シーケンスがマクロ記録中に自動的に暗号化されなかった場合は、マクロ・エディターで 暗号化できます。 入力キー・シーケンスを暗号化するには、以下のステップに従ってください。 まず、チェック・ボックスがクリアされていない場合、そのチェック・マークを外してください。
暗号化された入力キー・シーケンスを作成する場合、その入力キー・シーケンスが暗号化されず、 「ストリング」フィールドに入力したとおりの形式で表示されることを回避するには、以下の 手順に従ってください。
入力キー・シーケンスが暗号化された後、それを暗号化しないか、変更するかを 決定できます。
入力キー・シーケンスが暗号化されていて、それを暗号化しないことにした場合、以下のステップに 従ってください。
入力キー・シーケンスが暗号化されていて、それを変更することを決定した場合、以下のステップに 従ってください。
暗号化された入力キー・シーケンスを変更するため、「ストリング」フィールドのアスタリスクのストリング (*******) に文字を上書きまたは 挿入することはできません。これを行うと、暗号化されていない状態で変更を加えることによって、暗号化された 入力キー・シーケンスを壊してしまうことになります。 この場合、マクロ・エディターは暗号化されていないストリングが入力されたものと 想定し、壊れているシーケンスを再び暗号化します。 その結果、マクロの再生中にマクロ・ランタイムが入力アクションを処理するとき、暗号化解除された シーケンスは、ユーザーの意図した入力キー・シーケンスになりません。 (また、拡張マクロ形式を使用しているときに、壊れた入力キー・シーケンスを単一引用符で 囲まないと、マクロ・エディターはエラー・メッセージを表示します。)
ソース表示は、入力キー・シーケンスの暗号化について、マクロ・エディターと同じ規則に従っています。
ソース表示では常に、以下のアクションのいずれかを実行できます。
またソース表示を使用している間、encrypted 属性の値 (暗号化をアクティブ化または非アクティブ化する) を true から false に、または false から true に変更することもできます。
ただし、ソース表示を使用して value 属性 (暗号化された、または暗号化されていない入力キー・シーケンスが入っている) の値を 変更する場合、encrypted 属性が true に設定されていれば、 (value="" になるように) 暗号化された入力キー・シーケンスを完全に削除し、暗号化する 新しい入力キー・シーケンスを入力してください。
入力キー・シーケンスを変更するために、value 属性の暗号化された入力キー・シーケンスに文字を上書きまたは 挿入することはできません。 これを行うと、暗号化されていない状態で変更を加えることによって、暗号化された 入力キー・シーケンスを壊してしまうことになります。
変数名 (例えば $var1$) をマクロ・エディターの「ストリング」フィールドに (またはソース表示の value 属性の値の部分に) 入力し、その変数の名前を (標準の入力キー・シーケンスを暗号化するときと同じステップで) 暗号化できますが、この方法は通常 お勧めしません。変数名を暗号化すると、変数名を構成している文字だけが暗号化されるからです。 変数それ自身の内容は暗号化されません。
マクロの再生中、マクロ・ランタイムは暗号化されたテキストを暗号化解除して プレーン・テキスト (例えば $var1$) に変え、そのプレーン・テキストが 変数名であると判断して変数を通常どおりに処理します。
詳しくは、<input> エレメントを参照してください。
マウス・クリック・アクションは、ユーザーによるホスト端末上でのマウス・クリックをシミュレートします。実際のマウス・クリックと同様に、クリックが行われたときに マウス・アイコンが指していた行と列の位置にテキスト・カーソルがジャンプします。
このアクションを指定するには、VME を使用する (「カーソル位置を設定」アクションを参照) 方法と、 AME を使用する (マウス・クリック・アクションを参照) 方法があります。
詳しくは、<mouseclick> エレメントを参照してください。
一時停止アクションは、指定されたミリ秒数の間だけ待機した後、終了します。
具体的には、マクロ・ランタイムは <pause> エレメントを検出し、 期間の値を読み取って、指定されたミリ秒数だけ待機します。 その後、マクロ・ランタイムは次の項目の実行に進みます。
このアクションは次の場合に使用します。
このアクションを指定するには、VME を使用する (「一時停止」アクションを参照) 方法と、 AME を使用する (一時停止アクションを参照) 方法があります。
詳しくは、<pause> エレメントを参照してください。
実行アクションは、インポートした Java クラスに属するメソッドを 呼び出します。
このアクションを指定するには、VME を使用する (「実行」アクションを参照) 方法と、 AME を使用する (実行アクションを参照) 方法があります。
実行アクション以外にも、さまざまなコンテキストでメソッドを呼び出すことができます。 ただし実行アクションは、例えば値を戻さないメソッドを呼び出したい 場合などのシナリオでは便利です。
実行アクションのほかに、メソッドを呼び出すことができるコンテキストは 次のとおりです。
一般に、実行アクションの外部では、メソッドから戻される値が有効である すべてのコンテキストでメソッドを呼び出すことができます。
図 18 では、実行アクションを使用してメソッドを呼び出す方法を示します。これらの例については、 次のことに注意してください。
<actions>
<!-- Example 1 -->
<perform value="$importedVar.update( 5, 'Application', $str$)$" />
<!-- Example 2 -->
<perform value="$MyClass.myInit('all')$" />
<!-- Example 3 -->
<perform value="$fip.close()$" />
<!-- Example 4 -->
<perform value="$zis.createZipEntry( $name$ )$" />
<!-- Example 5 -->
<perform value="$ht.clear()$" />
</actions>詳しくは、<perform> エレメントを参照してください。
PlayMacro アクションは、別のマクロを起動します。
このアクションを指定するには、VME を使用する (「マクロを実行」アクションを参照) 方法と、 AME を使用する (Playmacro アクションを参照) 方法があります。
マクロ・ランタイムが PlayMacro アクションを実行すると、 現行マクロ (PlayMacro アクションを指定したマクロ) は終了し、 ターゲット・マクロの指定されたマクロ画面の処理が開始されます。 この処理はチェーニングと呼ばれ、 呼び出し側マクロをターゲット・マクロに「チェーニングする」といいます。 呼び出し側マクロへの戻りはありません。
PlayMacro アクションには、ターゲット・マクロの名前を指定する必要があり、 またオプションで、マクロ・ランタイムが最初に処理する ターゲット・マクロ内のマクロ画面の名前を指定します。
呼び出し側マクロからターゲット・マクロにすべての変数とその内容を 転送するように、マクロ・ランタイムに指示できます。
条件エレメント外では、マクロ画面に PlayMacro アクションを 1 つだけ追加することができ、その PlayMacro アクションは、マクロ画面のアクション・リスト (<actions> エレメント) の最後のアクションでなければなりません。
条件エレメントの中に追加する場合:
マクロには必要な数の条件エレメントを使用でき、 それぞれの条件エレメントの真のブランチ に 1 つの PlayMacro アクション、偽のブランチ に 1 つの PlayMacro アクションを指定できます。
マクロ・エディターがこれらの規則を実行します。
ターゲット・マクロにプロンプト値が必要な場合は、チェーンの最初のマクロで必須値を求めるプロンプトを出します。例えば、呼び出し側の MacroA からターゲットの MacroB にチェーニングし、MacroB にユーザーからのアカウント番号が必要な場合は、アカウント番号のプロンプト・アクションを MacroA に追加します。応答をマクロ変数に割り当てるには、<prompt> アクションの assigntovar 属性を使用します。 呼び出し側の MacroA の <playmacro> アクションで、transferVars="Transfer" を設定して、変数がターゲット・マクロに転送されることを指定します。 ターゲット・マクロでは、プロンプト・アクションを使用した場所でマクロ変数を使用します。例えば、プロンプト・アクションの代わりに入力値としてマクロ変数を指定して <input> アクションを使用します。チェーン内にいくつかのマクロがある場合は、すべてのプロンプトが最初のマクロで発生する必要があります。例えば、MacroA から MacroB、次に MacroC にチェーニングし、MacroC にプロンプト値が必要な場合は、MacroA で MacroC の値のプロンプトを出し、チェーンに沿ってこの値を渡します。
マクロにプロンプトがあるマクロ変数を使用する場合は常に、マクロの <HAScript> タグに値 promptall=true を指定する必要があります。これは、属性のデフォルト値です。呼び出し側マクロ (チェーンのすべてのプロンプトが含まれている) が、promptall に値 true を使用していることを確認してください。
transferVars 属性を「転送」に設定することにより (デフォルトは「転送しない」)、 呼び出し側マクロに属する変数すべて (これらの変数の内容を含む) を ターゲット・マクロに転送するようにマクロ・ランタイムに指示できます。
このように変数とその内容を転送することにより、 変数を使用して呼び出し側マクロからターゲット・マクロにパラメーターを 渡すことができます。
ターゲット・マクロに制御が渡された後、ターゲット・マクロは、 自身が宣言した変数の読み書きと同じように、転送変数を読み書き できます。
例えば、MacroA に現在 2 つの整変数 StartRow と StartCol があり、 その値が 12 と 2 である場合に、MacroA が PlayMacro アクションを 使用して MacroB を起動すると、MacroB には値が 12 と 2 の変数 StartRow と StartCol が最初に与えられます。
転送変数がインポート済みタイプに属していて Java オブジェクトを 含んでいる場合でも、ターゲット・マクロは転送変数を 参照して Java オブジェクトのメソッドを呼び出すことができ、 またその転送変数に他のオブジェクトを書き込むこともできます。
ターゲット・マクロは、拡張マクロ形式を選択している必要が あります (基本マクロ形式と拡張マクロ形式を参照)。
次の制約事項は、転送変数のすべてのタイプに適用されます。ターゲット・マクロに定義された変数の「初期値」フィールドの転送変数は使用できません。
ターゲット・マクロが、転送変数と同名、同タイプの変数を作成した 場合、マクロ・ランタイムは転送変数ではなく作成された変数を 使用します。
ターゲット・マクロ内で、インポート済みタイプに属する 転送変数を使用したい場合は、同じタイプをターゲット・マクロにインポート する必要はありません。 タイプをインポートする必要がない操作の例は、次のとおりです。
ただし、インポート済みタイプの名前をターゲット・マクロ内で使用したい 場合は、そのタイプをインポートする必要があります。 タイプをインポートする必要がある操作の例は、次のとおりです。
次に、PlayMacro アクションの例を示します。
<actions>
<playmacro name="TargetMacro" startscreen="*DEFAULT*"
transferVars="Transfer" />
</actions> 詳しくは、<playmacro> エレメントを参照してください。
プロンプト・アクションは、ユーザーによる直接のキーボード入力を 3270 また は 5250 アプリケーションに送るか、変数に格納するための強力な機能を 備えています。
このアクションを指定するには、VME を使用する (「プロンプト」アクションを参照) 方法と、 AME を使用する (プロンプト・アクションを参照) 方法があります。
プロンプト・アクションは、ホスト端末の前面にプロンプト・ウィンドウを表示します。 このウィンドウには、メッセージ、入力フィールド、および 3 つのボタン (「OK」、「キャンセル」、「ヘルプ」) があります。ユーザーが入力フィールドにテキストを入力して「OK」をクリックすると、 プロンプト・アクションはその入力データを使用して、次のどちらかまたは両方を 行います。
このアクションの代表的な用途は (ただしこの用途だけではありません)、 ユーザーによるパスワードの入力を可能にすることです。 マクロがホストにログオンしたり、アクセスにパスワードを必要とする アプリケーションを開始したりしなければならないシナリオはよくあります。 パスワードは機密データであり、また通常はときどき変更されるため、 パスワードを即時値としてマクロにコーディングすることは適切でない ことがよくあります。
プロンプト・アクションを使用して、ユーザーにパスワードの入力を促し、 入力フィールドにパスワードを入力するようにユーザーに指示するメッセージを 表示できます。 ユーザーが「OK」をクリックすると、ホスト端末上の指定の行と列の位置に、マクロ・ランタイムによって入力データが入力されます。入力シーケンスには、[enter] などのアクション・キーを含めることが できるので、ユーザーが MyPassword[enter] と 入力した場合、マクロ・ランタイムはパスワードをパスワード・フィールドに 入力できるのみでなく、ログオンまたはアクセスのアクションを完了する キーを入力することもできます。 (また、プロンプト・アクションの直後の入力アクションに アクション・キーを組み入れることもできます)
すべての <prompt> エレメントのポップアップ・ウィンドウ を 1 つの大きいプロンプト・ウィンドウに結合し、 マクロの実行開始時にこの大きなプロンプト・ウィンドウを表示するように、 マクロ・ランタイムに指示できます。このためには、 <HAScript> エレメントの promptall 属性を true に 設定します (<HAScript> エレメントを参照)。
<actions> エレメントの promptall 属性 も同様に機能します (<actions> エレメントを参照)。
詳しくは、<prompt> エレメントを参照してください。
SQLQuery アクションは、非常に便利で強力なアクションです。これにより、SQL ステートメントをホスト・データベースに送信し、SQL ステートメントによって出力される任意のデータを検索して、そのデータを Host On-Demand マクロ変数に書き込むことができます。
このアクションは、VME ではソース・タブを使用して、 AME ではアクション・タブを使用して指定することができます。SQLQuery アクションを参照してください。
マクロをサポートするすべてのタイプの セッション (3270 ディスプレイ、5250 ディスプレイ、または VT ディスプレイ) で、SQLQuery アクションを使用できます。
接続するデータベース・サーバーは、アプリケーション・セッションを実行しているホスト上で なくても構いません。
SQLQuery アクションは、タイプ Select の SQL ステートメントのみサポートします。 タイプ Insert、Update、または Delete の SQL ステートメントはサポートしていません。
SQLQuery アクションでは、SQLQuery アクションを使用して HATS Toolkit 環境と特定の HATS アプリケーションの両方にアクセス可能なデータベース・ドライバーを必要とします。データベース・ドライバーはアクセス先のデータベースに固有です。このドライバーは、データベース管理者から入手します。
HATS Toolkit 内で SQL ウィザードが正しく機能するには、データベース・ドライバー・ファイルを、 Rational® Software Delivery Platform によって使用される Java ランタイム環境 (JRE) の lib\ext ディレクトリー (例えば、RAD_INSTALL_DIR\jre\lib\ext) に格納します。 データベース・ドライバーを JRE の格納場所にコピーした後は、Rational Software Delivery Platform (アクティブだった場合) を再始動する必要があります。
HATS アプリケーションは、デプロイされるときに、データベース・ドライバー・ファイルへのアクセス権も必要とします。HATS Web アプリケーションの場合は、 データベース・ドライバー・ファイルを EAR レベルに追加してください。ファイルが EAR レベルに追加されると、SQLQuery アクションを使用する HATS アプリケーション内の WAR はそれぞれ、データベース・ドライバー・ファイルが組み込まれるよう、その META-INF/MANIFEST.MF ファイルを更新する必要があります。MANIFEST.MF ファイルの更新が正しく行われていることを確認するには、JAR 依存関係エディターで編集してください。HATS リッチ・クライアント・アプリケーションの場合、データベース・ドライバー・ファイルは、 ターゲット・デプロイメント環境 (Eclipse リッチ・クライアント、Lotus Notes®、または Lotus® Expeditor Client) によって使用される JRE の lib\ext ディレクトリーに追加する必要があります。
詳しくは、<sqlquery> エレメントを参照してください。
トレース・アクションは、指定のトレース宛先 (HATS Toolkit コンソールや WebSphere® コンソールなど) にトレース・メッセージを送ります。 また、HATS はマクロ・トレースを HATS ランタイム・トレースに追加します。
このアクションは、VME ではソース・タブを使用して、 AME ではアクション・タブを使用して指定することができます。トレース・アクションを参照してください。
図 20 の例は、トレース・メッセージを HATS Toolkit コンソールに送信する方法を示しています。この例では、トレースと変数更新のアクション・エレメントを使用します。
ここで示すマクロ・スクリプトのテキストは、本書からシステム・クリップボードにコピーして、システム・クリップボードからソース表示にコピーすることができます (サンプルを参照)。このスクリプトを マクロ・エディターに保存した後、編集できます。
この例については、次の点に注意してください。
<HAScript name="TRACE" description=" " timeout="60000" pausetime="300"
promptall="true" author="" creationdate="" supressclearevents="false"
usevars="true" ignorepauseforenhancedtn="false"
delayifnotenhancedtn="0">
<vars>
<create name="$strData$" type="string" value="’Original value’" />
</vars>
<screen name="Screen1" entryscreen="true" exitscreen="false" transient="false">
<description>
<oia status="NOTINHIBITED" optional="false" invertmatch="false" />
</description>
<actions>
<trace type="SYSOUT" value="’The value is ’+$strData$" />
<varupdate name="$strData$" value="’Updated value’" />
<trace type="SYSOUT" value="’The value is ’+$strData$" />
</actions>
<nextscreens timeout="0" >
</nextscreens>
</screen>図 20 のスクリプトを実行すると、マクロ・ランタイムは次のデータを送ります。
The value is +{$strData$ = Original value}
The value is +{$strData$ = Updated value}上記のトレース出力の中で、$strData$ の値を単に表示する代わりに、デバッグ・アクションが変数の名前とその値の両方を中括弧の中に表示している点に注意してください。
詳しくは、<trace> エレメントを参照してください。
<varupdate> エレメントは、変数に値を格納します。 マクロの実行中に、マクロ・ランタイムはアクションを 実行して、指定の値を指定された変数に格納します。
次の項目を指定する必要があります。
このアクションを指定するには、VME を使用する (「変数の更新」アクションを参照) 方法と、 AME を使用する (変数更新アクションを参照) 方法があります。
<description> エレメント内で変数更新アクションを使用することも できます (説明内の変数更新アクションの処理を参照)。
値には演算式を使用でき、また変数とインポートしたメソッドの呼び出しを 値に含めることができます。 値が式の場合、マクロの再生中にマクロ・ランタイムは式を評価し、 結果の値を指定の変数に格納します。
変数更新アクションは、プログラミング言語の代入ステートメントと 同様に機能します。 Java プログラムでは、次のような代入ステートメントを書くことができます。
boolVisitedThisScreen = true; intVisitCount = intVisitCount + 1; dblLength = 32.4; strAddress ="123 Hampton Court";
変数更新アクションでは、マクロ・エディターの 「変数名」フィールドに式の左側 (変数) を入力し、「値」 フィールドに式の右側 (値) を入力します。 上述の Java 代入ステートメントに相当するステートメントを作成するには、 表 11 に示されている値を使用します。
| 「変数名」フィールド: | 「値」フィールド: |
|---|---|
| $boolVisitedThisScreen$ | true |
| $intVisitCount$ | $intVisitCount$+1 |
| $dblLength$ | 32.4 |
| $strAddress$ | '123 Hampton Court' |
指定する値は、コンテキストに応じた正しいデータ・タイプ、またはその タイプに変換可能なデータ・タイプ (自動データ・タイプ変換を参照) に 属している必要があります。
変数更新アクションが便利な理由は次のとおりです。
式について詳しくは、データ・タイプ、演算子、および式を参照してください。
変数更新アクションを使用したフィールド変数の更新は、ホスト端末上の 3270 フィールドまたは 5250 フィールドの内容を読み取って変数にストリングとして格納できる便利な方法です。
フィールド変数は、ストリング変数の一種です。フィールド変数はマクロ・スクリプトの <vars> エレメントで定義されますが、初期値を持ちません。次のサンプルには、フィールド変数の例が含まれています。
<vars> <create name=$intUpdate$" type="integer" value="3"/> <create name="$strData$" type="string" value="'hello'"/> <create name="$fieldVar$" type="field" /> </vars>
フィールド変数は、 ストリング変数と同様にストリングを格納し、ストリング変数が有効である すべてのコンテキストでフィールド変数を使用できます。 ただし、フィールド変数にストリングが格納される方法について、 フィールド変数とストリング変数は異なっています。 フィールド変数に格納されるストリングは、常に、マクロ・ランタイムが現行ホスト端末上の 3270 フィールドまたは 5250 フィールドから読み取ったストリングになります。
変数更新アクションを使用してストリング変数を更新する際には、 次の情報を指定します。
マクロ・ランタイムが変数更新アクションを実行すると、 マクロ・ランタイムは次の処理を行います。
その後、ストリングが有効であるすべてのコンテキストでフィールド変数を 使用できます。例えば、次のようにフィールド変数を別のストリングと 連結できます。
'The field¥'s contents are'+ $fldPrintOption$
例えば、次の特性を持つ 3270 フィールドまたは 5250 フィールドがホスト端末上にあるとします。
次の値を指定して変数更新アクションをセットアップします。
マクロ・ランタイムがこの変数更新アクションを実行すると、 マクロ・ランタイムはフィールドの内容全体を読み取り、内容を ストリングとして $fldData$ に格納します。 これで、フィールド変数 $fldData$ にはストリング 'Print VTOC information' が格納されます。
変数更新アクションにフィールド変数を使用する場合に、2 つの位置を 含む位置ストリングを指定できます。 この機能は、フィールドの内容の一部のみを読み取りたい場合に使用します。
「値」フィールドに、最初の位置と 2 番目の位置をコロン (:) で 区切って入力します。例えば、最初の位置が 5,14 で 2 番目の位置が 5,17 ならば、'5,14:5,17' と 入力します。
2 つの位置を指定する場合には、次のようになります。
例えば、次の特性を持つ 3270 フィールドまたは 5250 フィールドがホスト端末上にあるとします。
さらに、次の値を指定して変数更新アクションをセットアップするとします。
マクロ・ランタイムがこの変数更新アクションを実行すると、 マクロ・ランタイムはストリング 'VTOC' をフィールド から読み取り (最初の位置ストリングによって指定した位置から始まり、2 番目の 位置ストリングによって指定した位置まで続く)、ストリング 'VTOC' を $fldData$ に格納します。
2 番目の位置がフィールドの最後を越えている場合、マクロ・ランタイムは 最初の位置からフィールドの最後までストリングを読み取ります。 その後マクロ・ランタイムは、このストリングをフィールド変数に格納します。
詳しくは、<varupdate> エレメントを参照してください。