AS400のPC移行チェックリスト|5250は開くのにSQLツールがつながらないとき

PCを買い替え、IBM i Access Client Solutions(ACS)を起動できた。それでも、いつものSQLツールからIBM iへ接続できない。PC移行では、アプリが起動することと、業務で使える状態に戻ることの間に見落としが生まれます。

移行前に整理したいのは、ACSの設定、ODBCのドライバーと接続定義、SQLツールの設定、資格情報は、それぞれ確認する場所が違うという点です。

この記事では、Windows PCでAS/400の系譜を継ぐIBM iを利用する方向けに、移行前の棚卸しから移行後の確認までを一つの表にまとめます。特定企業の構成ではなく、移行時の確認を整理したチェックリストです。

「ACSをコピーしたら全部戻る」と考えない

IBMは、ACSのJavaベースの基本パッケージと、Windows向けのODBCドライバーなどを含むWindows Application Packageを分けて案内しています。ACSのエミュレーターを起動できても、別のWindowsアプリで必要になるODBCドライバーまで導入済みとは判断できません。IBM:ODBC Driver for IBM i Access Client Solutions

移行対象は、次の4層に分けると整理しやすくなります。

層 何を残すか 移行後に何を確かめるか
ACS 利用機能、版、構成のエクスポート、個別ファイルの所在 必要な接続や利用機能が戻っているか
ODBC ドライバー、ビット数、DSNの種類と設定 利用アプリに合うドライバー・定義があるか
SQLツール・画面アプリ 接続方式、アプリの版、設定、必要な外部ファイル アプリから目的の環境へ接続できるか
資格情報 ユーザー、認証方式、安全な保管先・再発行先 その利用者の認証方法で接続できるか

構成を管理する台帳には、パスワードそのものではなく、認められた保管先や管理者への連絡経路を書きます。バックアップファイルに秘密情報が含まれないと確認できるまでは、接続先などを含む非公開の設定資料として扱います。

移行前に埋める棚卸し表

まず、旧PCが動く間に次の表を作ります。例は説明用で、実在の接続情報ではありません。

項目 記録例 確認する理由
利用アプリ SQLクライアント、表計算、画面アプリ ODBCを使うアプリを把握するため
アプリのビット数 64ビット Windowsのビット数と混同しないため
ACSの版・起動方法 利用中の版と配置場所を記録 別のコピーを起動する取り違えを防ぐため
Windows Application Package 製品の版と導入元 ACS基本パッケージと区別するため
ODBCドライバー IBM i Access ODBC Driver、版を記録 ドライバー不足を見つけるため
DSN DEV_SAMPLE、ユーザーDSN 名前だけでなく範囲も復元するため
接続先・環境 開発用、テスト用など 意図しない環境への接続を防ぐため
接続オプション 命名方式、必要なライブラリー設定など 接続後のSQLの動作も合わせるため
通信と認証 VPN、TLS、証明書、認証方式 アプリ以外の依存関係を見落とさないため
SQL・個別ファイル 保存場所、参照するパス アプリ設定に含まれないファイルを拾うため

最初からあらゆる項目を集める必要はありません。使っているアプリから逆にたどり、「そのアプリで接続するために何が必要か」を埋めていきます。

ACS:構成を書き出し、戻し方も記録する

ACSには構成のエクスポート・インポート機能があります。IBMのGetting Startedでは、メイン画面の「File → Export Configuration」と、コマンドラインのバックアップ機能が案内されています。IBM:ACS Getting Started、9.1.1 Backup・9.1.2 Restore

英語表記は公式資料に合わせたものです。日本語版の表示名は利用中の画面で対応する項目を確認してください。

作業では、書き出した日時、ファイル名、利用したACSの版を記録します。端末セッションなどの個別ファイルを別の場所へ保存している場合は、その所在と必要性も確認します。「エクスポート完了」という通知だけで、使っている全ファイルが含まれたとは判断しません。

新PCにすでに設定がある場合は、取り込む前に新PC側も退避します。IBMはRestoreについて、バックアップに含まれない既存構成が失われると説明しています。最初はほかの利用設定がない環境で試すと、比較が容易です。IBMのRestoreの説明

ここでのエクスポートはACSの構成を扱う手順です。これをWindowsのODBCや、すべてのSQLツールの設定まで含む一括バックアップとして扱わないようにします。

ODBC:32ビットと64ビットを最初に確認する

Windowsが64ビットでも、利用アプリが32ビットなら、それに対応するODBCドライバーが必要です。Microsoftは、64ビット版Windowsにある2種類のODBC管理ツールと、アプリに合うビット数を使う必要性を説明しています。Microsoft:ODBCドライバーのインストール確認

利用アプリ 確認に使う管理ツール
64ビット C:\Windows\System32\odbcad32.exe
32ビット C:\Windows\SysWOW64\odbcad32.exe

フォルダー名は直感と逆に見えますが、ファイル名はどちらも同じです。アプリのビット数と、開いた管理ツールをセットで記録します。

もう一つの落とし穴は、ユーザーDSNが両方の管理ツールに表示される場合があることです。DSNが一覧に見えたことだけでは、対応ドライバーを読み込める証明になりません。一方、システムDSNは32ビット・64ビットで分かれます。Microsoft:32ビットと64ビットのDSN表示

旧PCでは「ドライバー」タブの版を記録し、DSNの各設定を確認します。新PCでは正式なパッケージから対応するドライバーを導入し、必要なDSNを設定します。ドライバーのDLLだけを旧PCから持ってくる方法は避けます。IBMも関連DLLへの依存があるため、サポートの指示なしにODBCのDLLを単独でコピーしないよう案内しています。IBM:ODBCドライバーの版の確認

SQLツール:保存設定と認証は別に戻す

接続一覧を戻せても、保存パスワードを新PCで利用できるとは限りません。A5:SQLなどで保存情報の復号エラーが出た場合、保存情報を読み戻す段階の失敗と、接続先が資格情報を拒否した認証エラーを区別します。

設定を消す前に未保存SQLと接続設定を保全し、アプリの版・利用モード・実際の設定保存先を記録します。正式な資格情報を確認できる接続1件だけで再入力し、通常終了・再起動後も選んだ保存方針どおりに使えるかを確認します。復号失敗を理由にサーバーのパスワードを勝手に変更したり、認証を繰り返したりしません。

設定のバックアップと、資格情報の安全な保管・再発行手段は別に用意します。旧PCで自動入力できるだけの状態で、旧PCを初期化しないでください。

新PCでは「入れた順」ではなく「依存する順」で確認する

接続テストの失敗を切り分けやすくするため、次の順序で確認します。

  1. 接続経路:必要な社内ネットワークやVPN、名前解決が使える。
  2. 必要な部品:アプリに合ったドライバーや実行環境がある。
  3. 接続定義:DSNやアプリの接続先、認証方式が意図どおり。
  4. 利用者の認証:正式な資格情報で接続できる。
  5. アプリの動作:許可された読取り確認を行い、期待どおりの結果が返る。

認証が通らない状態で何度も再試行すると、アカウントのロックにつながることがあります。正しい情報が確認できない場合は、試行を増やさず管理者へ確認します。

SQLの疎通だけを確認する例として、IBM iでは次のような式の評価を利用できます。環境でSQL実行が許可されていることを確認してから行ってください。

VALUES CURRENT DATE;

これは業務表を更新せずにSQL実行を確認するための例です。IBMのSQLプログラミング資料にも、日付を評価するVALUES式の例が掲載されています。成功しても、業務の表やライブラリーへの権限、文字の扱い、画面アプリの動作まで正常と確認できたわけではありません。

移行完了の判定表

「接続できた」の一言で終わらせず、確認範囲を残します。結果欄には「成功/失敗/対象外/未確認」を記入してください。

確認項目 結果 何を確認できたか
ACSを起動できる ACSの起動環境
必要なACS接続・機能を利用できる ACS側の構成と利用経路
利用アプリとドライバーのビット数が一致する ODBC部品の組み合わせ
必要なDSN・接続定義がある 設定の存在と内容
SQLツールから接続できる そのツールの接続・認証
許可された読取りを確認した 確認対象のSQLと権限
必要な文字・日付を正しく扱える 実際に使うデータ表現の一部
アプリを再起動しても使える 設定の保存・再読込み
通常利用するWindowsアカウントで使える 利用者ごとの設定・権限
旧PCなしで資格情報を確認・再発行できる 旧PCへの依存を外せたか

使わない機能は「対象外」にします。確認していない機能を「全部OK」に含めず、移行後に残っている作業が見える状態にします。

旧PCを初期化する前に残す、復元メモ

このメモは非公開の管理用です。記事のコメント欄などに実際の接続情報を貼らないでください。

対象アプリ・版:
利用アプリの32/64ビット:
ACS構成のバックアップ場所・作成日:
個別セッション・SQLファイルの所在:
Windows Application Package・ODBCドライバーの版:
DSNの名前・種類・対応アプリ:
必要なネットワーク・VPN:
認証方式・資格情報の保管先または管理窓口:
新PCで確認した範囲:
未確認・対象外の機能:
旧PCを停止してよいと判断した日:

バックアップが存在することと、バックアップから業務環境を戻せることは別です。旧PCを利用できる間に、新PCで必要な機能を一つずつ確認し、戻し方を記録してから移行を完了させましょう。

移行失敗を切り分ける小さな確認例

以下は架空の検証用構成で組み立てた例です。接続試験は未実施です。期待結果は、移行の合否を決めるための目標であり、実測結果ではありません。

準備:一つのアプリと一つの接続に絞る

64ビットのSQLツールから、検証用IBM iへ接続する想定にします。接続定義の説明名はDEV_SAMPLEとします。ホスト名・利用者・資格情報は記事へ書かず、管理者が認めた方法で用意します。旧PCはまだ利用できる状態にし、新PCに既存設定があれば先に保全します。

確認手順と期待結果

  1. 旧PCで使うSQLツールのビット数とODBCドライバーの版を記録します。新PCでは、対応するビット数のODBC管理ツールでドライバーと定義を確認します。
  2. ACSの5250を起動できても、それをODBCの合格に含めません。SQLツール自身から検証用の接続を一度確認します。
  3. 認証が通った場合だけ、許可された環境で本文のVALUES CURRENT DATEを確認します。期待する形は日付の1行です。日付はサーバーの現在日付が基準で、PCの日付との一致を前提にしません。
  4. ツールを通常終了し、普段使うWindowsアカウントで起動し直します。接続定義と保存方針が維持されるかを確認します。
観測した状態 次に確認する場所 ここでは実施しないこと
DSNは見えるがドライバーを読み込めない アプリとドライバーのビット数・導入状態 パスワードの再試行
接続操作より前に保存情報の復号エラー ツールの保存設定・モード IBM iの利用者設定の変更
接続がタイムアウトする 経路・名前解決・通信許可 認証エラーと決めつける
SQLは通るが業務表を読めない 対象環境・権限・命名方式 強い権限の一括付与

移行完了の記録には「ACS起動○、ODBC接続○、式の評価○、業務表確認は未実施」のように範囲を残します。式が1行返っただけで、業務アプリの更新や帳票まで合格にしないことが、この例の到達点です。

関連する確認手順