拡張マクロの紹介

開発者は、Host Access Transformation Services (HATS) Toolkit を使用して、HATS アプリケーションにマクロを組み込むことができます。「HATS ユーザーと管理者のガイド」では、HATS でのマクロの使用法を紹介し、基本マクロの作成および変更方法を説明しています。 このマニュアルでは、Visual Macro Editor (VME) と 拡張マクロ・エディター (AME) を使用してマクロに組み込むことが可能な拡張マクロ機能について説明します。これらのツールにはグラフィカル・ユーザー・インターフェースが組み込まれており、これを使用してユーザーは、各画面のホスト・アプリケーションとの対話を変更したり、機能を追加したりすることができます。

これらのエディターを使用して、HATS マクロに対して次の変更のいずれかを行います。

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

HATS で使用する場合の Host On-Demand マクロの適応

このマニュアルでは、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 を含む単純なマクロの構造を示しています。

図 1. 単純なマクロ構造
<?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 でのマクロの操作

HATS Toolkit では、複数の異なる方法でマクロを操作できます。

用語の定義

このマニュアルで使用されている用語をいくつか定義します。

表 1. 用語の定義
用語 定義
アクション アクションは、マクロの再生時にマクロ・ランタイムが実行しなければならないアクティビティー (ホストへの一連のキーの送信、ポップアップ・ウィンドウでのプロンプトの表示、画面からのテキスト・ブロックの取り込みなど) を指定した命令です。マクロ・アクションを参照してください。
注:
マクロに含まれるアクションは、HATS イベントによって起動されるアクションと同じものではありません。
アプリケーション画面 アプリケーション画面は、ホスト・アプリケーションによってホスト端末上に表示される、意味のある文字配置です。 アプリケーション画面を参照してください。
記述子 記述子は、アプリケーション画面の 1 つの特性を記述する命令です。 記述子は、画面認識基準とも呼ばれています。 画面記述を参照してください。
ホスト端末 マクロの記録や実行に使用される、HATS Toolkit からホスト・アプリケーションへの接続です。
マクロ・ランタイム マクロ・ランタイムは、マクロが開始時にマクロを再生するプログラム・モジュールです。具体的には、マクロ・ランタイムは、現行のマクロ・スクリプトの内容を読み取り、マクロの再生を生成します。
マクロ画面 マクロ画面は、特定のアプリケーション画面の個々のアクセスを管理する方法をマクロ・ランタイムに指示する、1 組の命令です。マクロ画面を参照してください。
マクロ・スクリプト マクロ・スクリプトは、マクロが保管される先の XML スクリプトです。 マクロを再生すると、マクロ・ランタイムがスクリプト内の命令を実行します。マクロ・スクリプトを参照してください。
ソース表示 ソース表示は、マクロの XML ソースを表示するものです。
有効な次画面 有効な次画面は、マクロの再生時に処理対象の次のマクロ画面になる、有効なマクロ画面候補です。 マクロ画面の処理ステージを参照してください。

サンプル

本書に記載されているマクロ・スクリプトをコピーして、新しいマクロを作成することができます。 このセクションでは、開始指定子 <HAScript> から開始し、終了指定子 </HAScript> で終了する、マクロ・スクリプト全体をコピーすることを想定しています。この方法で新しいマクロを作成するには、次のステップを実行します。

  1. HATS Toolkit で、HATS プロジェクトを選択し、ホスト端末をオープンする。
  2. スクリプトのホルダーとして使用する単純なマクロを記録する。
    1. 「マクロの記録」アイコンをクリックする。 「マクロの記録」ウィザードが開く。
    2. 「完了」をクリックしてデフォルト値を受け入れる。「画面認識基準の定義」ウィザードが開く。
    3. 「完了」をクリックしてデフォルト値を受け入れる。ホスト端末ウィンドウのタイトル・バーに、「記録中...」と表示される。
    4. 「マクロの停止」アイコンをクリックする。 「画面認識基準の定義」ウィザードが開く。
    5. 「完了」をクリックしてデフォルト値を受け入れる。
    6. 「マクロを保存」アイコンをクリックする。
  3. 記録したマクロを編集する。
    1. HATS プロジェクト表示の「マクロ」フォルダーで、記録したマクロの名前をダブルクリックする。
    2. エディターの下部にある「ソース (Source)」タブをクリックして、ソース表示をオープンする。
    3. ソース表示で、<HAScript> で始まり </HAScript> で終わる行を削除する。
    4. このマニュアルから、マクロ・スクリプトのテキスト全体をシステムのクリップボードにコピーする。
    5. コピーしたマクロ・スクリプトをソース表示に貼り付ける。
    6. 「ファイル」 > 「保存」をクリックして (または Ctrl+S を押して)、 マクロ・スクリプトを保存する。

マクロは、どの HATS マクロ・エディターを使用しても、さらに編集できます。

注:
このマニュアルのサンプルの中には、不完全なマクロ・スクリプトもあります。完全なマクロ・スクリプトは、<HAScript> エレメントで開始および終了し、省略符号は含まれていません (省略符号は、サンプル内の未表示情報を示します)。他のサンプルはマクロ・コード・スニペットであり、既存の完全なマクロ内部の適切な場所に貼り付ける必要があります。