Power Automateのターミナルエミュレーションを使ってIBMi（旧称AS/400）を操作する

Microsoft提供のPower Automate Desktop（以降PADと表記）の「ターミナルエミュレーション」アクションはIBMiグリーンスクリーン端末（以降5250端末と表記）との連携を提供します。連携は、人間が5250端末画面をキーボード操作するのと同様に5250端末に対してカーソル移動、テキスト設定と取得、キー送信などの操作が可能です。

動画で解説

音声付き、約7分のビデオです

ターミナルエミュレーション動作概要

連携にはPADがターミナルエミュレーションを利用可能とするAPIであるEHLAPI32.dllが必要です。EHLAPI32.dllは後述するIBMサイトからダウンロードが可能です。

「ターミナルエミュレーション」アクションは下図のように、①「ターミナルセッションを開きます」の設定で、②APIのEHLAPI32.dllを用い、③指定したセッション名で紐づけた④5250端末画面を経由し⑤IBMiと連携をします。
ですので、連携にはPAD定義実行前に5250端末が起動済である必要があります。

必要なファイルを入手

今回は5250端末ソフトウエアとして「IBM i Access Client Solutions」（以降ACSと表記）、APIは「ACS EHLLAPI」（以降APIと表記）を下記URLからダウンロードしました。

https://www.ibm.com/resources/mrs/assets/DownloadList?source=swg-ia&lang=ja_JP

ダウンロードにはIBM IDが必要です。また2要素認証などの設定が必要な場合がございます。

APIの導入

ACS導入手順は本筋ではありませんので割愛いたします。
API導入はダウンロードした「acshllapi.exe」をダブルクリックし、画面の指示に従って「Next」ボタンで進めると「C:\Program Files (x86)\IBM\EHLLAPI」に導入されます。この導入先パスをPAD設定で用います。

PAD設定例

5250端末画面でのカーソル移動、文字列入力、文字列取得、キー送信の設定例として下記フローを用い①～⑪の順に解説致します。

①ターミナルセッションを開く
②～⑥サイン・オンする
⑦⑧文字列を取得する
⑨⑩サイン・オフする
⑪ターミナルセッションを閉じる

ターミナルセッションを開く

上記①では「ターミナルセッションを開きます」の「プロバイダー」から「HLLAPI」を選択します。「HLLAPI DLLパス」はacshllapi.exeの導入先「C:\Program Files (x86)\IBM\EHLLAPI」内に存在するEHLAPI32.dllを選択指定します。
セッション名は5250端末構成の「セッション名」と多少異なり「A、B、C・・・」といった値を指定します。

カーソル移動、文字列入力、文字列取得、キー送信はこの「ターミナルセッションを開きます」で生成された変数「TerminalSession」を用います。

サイン・オンする

②では①で生成された変数「TerminalSession」を用い5250端末サイン・オン画面のユーザーID入力欄の行と列位置を指定しています。

③では「テキスト」欄にユーザーIDを指定しています。「テキストを設定します」は「カーソル位置」を選択しています。

④では②同様に①で生成された変数「TerminalSession」を用い5250端末サイン・オン画面のパスワード入力欄の行と列位置を指定しています。

⑤では③同様に「テキスト」欄にパスワードを指定します。「テキストを設定します」は「カーソル位置」を選択しています。

⑥ではEnterキーを押したいので「コントロールキー」から「送信」を選択しています。

文字列を取得する

⑦では5250端末画面に表示されている文字を取得するため、取得するテキストの長さ、行、列を指定しています。今回は例として5250端末画面右上に表示しているIBMiシステム名を取得しています。取得した文字は「生成された変数」の「TerminalText1」に格納されます。

⑧では「メッセージを表示」アクションを用い、取得した文字が格納されている変数「TerminalText1」を確認表示しています。

サイン・オフする

⑨ではサイン・オフするため「テキスト」欄に「SIGNOFF」を指定しています。今回はカーソル位置がコマンドライン上に位置しているため、特にカーソル移動する必要が無いので「テキストを設定します」では「カーソル位置」を選択しています。

⑩ではEnterキーを押したいので「コントロールキー」から「送信」を選択しています。

ターミナルセッションを閉じる

⑪では①で開いたターミナルセッションを閉じています。

注意点1:ターミナルセッションは必ず閉じる

「ターミナルセッションを閉じます」アクション実行前にフローが異常終了した場合、フローを再実行すると「エミュレーターとの通信中にエラーが発生しました」のエラーになる場合がありました。
5250端末を再起動すると復帰しましたが、エラーが発生しそうな注意すべきアクションには「エラー発生時」の設定に「ターミナルセッションを閉じます」アクションを実行するサブフローの作成が可能です。下図例では別途「closeSession」というサブフローを作り、「closeSession」サブローには「ターミナルセッションを閉じます」アクションを指定しています。

注意点2:端末画面遷移の検知

PADからの5250端末操作は意図した画面遷移である事が大前提です。ですので正しく画面遷移しているのか「ターミナルセッションでテキストを待機」で確認しながらフローを組み立てるのが安全のようです。例えば今回例の場合IDとパスワードを入力後の次の画面はメインメニューです。

ですので「ターミナルセッションでテキストを待機」の「待機するテキストです」にメインメニュー画面左上の「MAIN」の指定が可能です。この文字列「MAIN」が表示されない場合は「タイムアウト」値に指定した秒数後エラーにする事が可能です。エラー処理は前述の「注意点1:ターミナルセッションは必ず閉じる」同様に「エラー発生時」内にエラー処理をするサブフローの指定等をします。

ソリューション・サービス

クラウド・サービス

IBM i 関連

ブログ