開発者は、Host Access Transformation Services (HATS) Toolkit を使用して、HATS アプリケーションにマクロを組み込むことができます。「HATS ユーザーと管理者のガイド」では、HATS でのマクロの使用法を紹介し、基本マクロの作成および変更方法を説明しています。 このマニュアルでは、Visual Macro Editor (VME) と 拡張マクロ・エディター (AME) を使用してマクロに組み込むことが可能な拡張マクロ機能について説明します。これらのツールにはグラフィカル・ユーザー・インターフェースが組み込まれており、これを使用してユーザーは、各画面のホスト・アプリケーションとの対話を変更したり、機能を追加したりすることができます。
これらのエディターを使用して、HATS マクロに対して次の変更のいずれかを行います。
このマニュアルでは、Host On-Demand マクロの言語とその使用法を説明します。内容は、「Host On-Demand Macro Programming Guide Version 10」から抽出したもので、各セクションには、HATS 内でのマクロのインプリメンテーションとエディターの使用法に適合するように、変更が加えられています。このセクションでは、HATS 内で使用するために Host On-Demand マクロを適合させる方法を説明します。
Host On-Demand 環境でのマクロは通常、ユーザーのワークステーションで実行されます。マクロは、HATS リッチ・クライアント環境では通常、ユーザーのワークステーションで実行されますが、HATS Web 環境では通常、集中サーバーで実行されます。 このような違いにより、HATS ではマクロで使用するデータについてのプロンプトを出す方法も別にする必要があります。このマニュアルでは、ユーザーのワークステーションでプロンプト・パネルを開く方法について説明しますが、HATS では行われません。代わりに HATS は、HATS グローバル変数、ユーザー・リスト、HATS 統合オブジェクトの入力プロパティー、またはユーザーのワークステーションに送信される HTML 入力フォームを使用してユーザーから、マクロ・プロンプトのデータを検索します。同様に、ホスト画面から抽出されたデータは、HATS ユーザーのワークステーション上に即座に表示することはできません。その代わりデータは、HATS グローバル変数にコピー、HATS 統合オブジェクトの出力プロパティーにコピー、または HTML ページ内でユーザーのワークステーションに送信されます。 HATS ランタイムのマクロ・エンジンによってこれら追加のマクロ対話機能を提供できるようにするため、HATS Toolkit は、HATS Toolkit とランタイムにマクロ・スクリプトについての追加情報を提供する XML の別のレイヤーで各 Host On-Demand マクロ・スクリプトをカプセル化します。
このマニュアルで説明する Host On-Demand マクロ・スクリプトは、<HAScript> タグで始まり、</HAScript> タグで終わります。HATS では、各 Host On-Demand マクロ・スクリプトが <macro> 開始タグと </macro> 終了タグの内側にラップされます。<macro> タグには、次の 4 つのエレメントがあります。
次の例は、2 つの prompts と 1 つの extracts を含む単純なマクロの構造を示しています。
<?xml version="1.0" encoding="UTF-8"?>
<macro>
<associatedConnections default="main">
<connection name="main"/>
</associatedConnections>
<extracts>
<extract handler="default.jsp" index="-1" indexed="false"
name="displayID" overwrite="true" save="true" separator=""
showHandler="false" variableName="displayID"/>
</extracts>
<prompts>
<prompt handler="default.jsp" name="password" separator=""
source="handler" value="" variableIndex="0"
variableIndexed="false" variableName="" welApplID="" welIsPassword="false"/>
<prompt handler="default.jsp" name="userID" separator=""
source="handler" value="" variableIndex="0"
variableIndexed="false" variableName="" welApplID="" welIsPassword="false"/>
</prompts>
<HAScript author="" blockinput="false" creationdate=""
delayifnotenhancedtn="0" description=""
ignorepauseforenhancedtn="false" name="SignOn" pausetime="300"
promptall="true" supressclearevents="false" timeout="60000" usevars="false">
<screen entryscreen="true" exitscreen="false" name="Screen1" transient="false">
<description uselogic="1 and 2">
<oia invertmatch="false" optional="false" status="NOTINHIBITED"/>
<string casesense="false" col="35" invertmatch="false"
optional="false" row="1" value=" Sign On "/>
</description>
<actions>
<extract assigntovar="" continuous="false" ecol="79"
erow="4" name="displayID" planetype="TEXT_PLANE"
scol="70" srow="4" unwrap="false"/>
<prompt assigntovar="" clearfield="false" col="53"
default="" description="" encrypted="false" len="10"
movecursor="true" name="userID" required="false"
row="6" title="" varupdateonly="false" xlatehostkeys="true"/>
<mouseclick col="53" row="7"/>
<prompt assigntovar="" clearfield="false" col="53"
default="" description="" encrypted="true" len="10"
movecursor="true" name="password" required="false"
row="7" title="" varupdateonly="false" xlatehostkeys="true"/>
<input col="0" encrypted="false" movecursor="true"
row="0" value="[enter]" xlatehostkeys="true"/>
</actions>
<nextscreens timeout="0">
<nextscreen name="Screen2"/>
</nextscreens>
</screen>
<screen entryscreen="false" exitscreen="true" name="Screen2" transient="false">
<description uselogic="1 and (2 and 3 and 4)">
<oia invertmatch="false" optional="false" status="NOTINHIBITED"/>
<cursor col="7" invertmatch="false" optional="false" row="20"/>
<numinputfields invertmatch="false" number="1" optional="false"/>
<string casesense="false" col="32" invertmatch="false"
optional="false" row="1" value=" i5/OS Main Menu " wrap="false"/>
</description>
<actions/>
<nextscreens timeout="0"/>
</screen>
</HAScript>
</macro>図 1 のサンプル・マクロは、マクロを実行するエンジンに応じて異なる方法でその環境と対話します。
HATS Toolkit では、複数の異なる方法でマクロを操作できます。
このマニュアルで使用されている用語をいくつか定義します。
| 用語 | 定義 |
|---|---|
| アクション | アクションは、マクロの再生時にマクロ・ランタイムが実行しなければならないアクティビティー (ホストへの一連のキーの送信、ポップアップ・ウィンドウでのプロンプトの表示、画面からのテキスト・ブロックの取り込みなど) を指定した命令です。マクロ・アクションを参照してください。
注:
マクロに含まれるアクションは、HATS イベントによって起動されるアクションと同じものではありません。 |
| アプリケーション画面 | アプリケーション画面は、ホスト・アプリケーションによってホスト端末上に表示される、意味のある文字配置です。 アプリケーション画面を参照してください。 |
| 記述子 | 記述子は、アプリケーション画面の 1 つの特性を記述する命令です。 記述子は、画面認識基準とも呼ばれています。 画面記述を参照してください。 |
| ホスト端末 | マクロの記録や実行に使用される、HATS Toolkit からホスト・アプリケーションへの接続です。 |
| マクロ・ランタイム | マクロ・ランタイムは、マクロが開始時にマクロを再生するプログラム・モジュールです。具体的には、マクロ・ランタイムは、現行のマクロ・スクリプトの内容を読み取り、マクロの再生を生成します。 |
| マクロ画面 | マクロ画面は、特定のアプリケーション画面の個々のアクセスを管理する方法をマクロ・ランタイムに指示する、1 組の命令です。マクロ画面を参照してください。 |
| マクロ・スクリプト | マクロ・スクリプトは、マクロが保管される先の XML スクリプトです。 マクロを再生すると、マクロ・ランタイムがスクリプト内の命令を実行します。マクロ・スクリプトを参照してください。 |
| ソース表示 | ソース表示は、マクロの XML ソースを表示するものです。 |
| 有効な次画面 | 有効な次画面は、マクロの再生時に処理対象の次のマクロ画面になる、有効なマクロ画面候補です。 マクロ画面の処理ステージを参照してください。 |
本書に記載されているマクロ・スクリプトをコピーして、新しいマクロを作成することができます。 このセクションでは、開始指定子 <HAScript> から開始し、終了指定子 </HAScript> で終了する、マクロ・スクリプト全体をコピーすることを想定しています。この方法で新しいマクロを作成するには、次のステップを実行します。
マクロは、どの HATS マクロ・エディターを使用しても、さらに編集できます。