AS400のデータエリア設定確認|DSPDTAARAで環境差と参照先を調べる

AS400/IBM iの検証環境で、プログラムとファイルを移したのに本番の設定が使われる場合、データエリアも確認対象になります。ライブラリ名を変えても、その中に保存された文字列まで自動的に検証用になるとは考えません。

データエリアには、環境区分、業務日付、処理の状態、参照先などを保持する作りがあります。ただし用途と値の意味はアプリごとに異なります。この記事は架空の通常データエリアを例に、値を変更する前に、どのジョブが何を読むのかを確かめる手順を整理します。

同じ名前でも、どのライブラリのものかを確認する

架空のTESTCFG/APPENVとPRODCFG/APPENVがあるとします。オブジェクト名が同じでも別物であり、プログラムがライブラリを固定して読む場合と、ライブラリリストで探す場合では確認する場所が変わります。

まず呼出し元のCLやRPG、本番オブジェクトと対応するソースの版、実行ジョブの参照条件を照合します。文字列検索で名前が見つからなくても、変数で名前を組み立てる処理や、別プログラム経由の参照がないとは断定できません。CLのRTVDTAARAやRPGのデータエリア操作など、値を読む箇所と更新する箇所の両方を追います。

DSPDTAARAで表示する前に、値の機密性を確かめる

DSPDTAARAは指定したデータエリアの属性と値を表示するコマンドです。内容には接続情報や業務情報が含まれる可能性があるため、閲覧権限と共有範囲を先に確認します。画面やスプールを、そのままチャット・メール・公開資料へ貼り付けないでください。

以下は、許可された検証環境にある架空の通常データエリア(このシステム内のライブラリにあるもの)を表示する例です。例の名前を実環境へそのまま適用せず、対象を照合してから使います。DDMなどリモート参照が関わる対象は、この例の範囲外です。

DSPDTAARA DTAARA(TESTCFG/APPENV)

表示結果では、所在ライブラリ、型、長さ、説明、値を確認します。型や長さが想定と違えば、別オブジェクトを見ている可能性も調べます。仕様と必要権限はIBM公式:DSPDTAARAを参照してください。

DSPDTAARAも処理中は読取り用のロックを使います。表示が失敗した時に、ほかの処理のロックを解除して先へ進めず、メッセージと競合の有無を管理者と確認します。

値だけでなく、読む時点と書き換える処理を調べる

確認すること確認する場所見落としやすい点
値の意味対応するソース、項目説明、承認された仕様文字の位置や桁を推測して、別項目まで変更する
読み取り時点ジョブ開始時、処理ごとの再取得、呼出し先現在値を表示できても、動作中のプログラムは以前取得した値を使っている
更新する処理初期化CL、日付更新、運用メニュー、後続バッチ手動で直しても、次の起動時に元の値へ戻される
共有範囲対象ジョブ、利用プログラム、更新タイミング一つの試験用と思って変更すると、別の処理にも影響する
ほかの設定元引数、設定ファイル、IFS、転送製品などデータエリアだけを直して、別の宛先設定を見落とす

たとえば、架空の環境区分がTESTであっても、送信先が別の設定ファイルにあるなら、それだけで検証用通信とは判断できません。環境区分と、実際の接続先・到達制限を別々に確認します。

通常のデータエリアと、ジョブのローカルデータエリアを分ける

*LDAはジョブに関連付けられるローカルデータエリアです。自分の対話ジョブで表示した内容を、別のバッチジョブの状態と見なしてはいけません。SBMJOBで投入したジョブには、投入時点の呼出し側の*LDAの値がコピーされます。コピー後は別の領域なので、呼出し側を変更しても投入先へ継続的に同期されるとは考えません。通常のライブラリ内のデータエリアと混同せず、どのジョブの、どの時点の情報かを記録します。詳しい仕様はIBM公式:データエリアの使用と、対象処理の設計を確認してください。

設定差分は、値を伏せても判断できる形で残す

記録項目架空の記入例
対象検証環境のAPPENV。実際の所在は権限を制限した台帳で管理
確認結果環境区分は検証用。参照ライブラリの設定に差異がある
根拠対応確認済みの初期化CLと、試験ジョブの取得タイミングを照合
未確認別の定期処理から同じ項目を書き換える可能性を調査中
次の判断更新元と利用ジョブを確定するまで、設定変更と業務試験を保留

台帳に実際の値が必要な場合は、社内規程で認めた保管先と閲覧範囲に限定します。公開する説明資料には、架空値か、項目名と一致・不一致の判定だけを使います。匿名化した情報でも、外部提供の許可が別に必要な場合があります。

差異を見つけても、すぐ変更しない

値の変更は、対象・意味・更新元・影響するジョブを確定し、変更前の記録、戻し方、必要な承認、反映後の確認をそろえてから行います。アプリが値を保持している場合など、変更の反映方法も設計次第です。強制終了や一括再起動を、定型の解決策にしません。

同時に更新される値では、調査時の記録をそのまま上書きの根拠にせず、実行直前の再確認や排他の扱いを個別手順で決めます。変更後は表示値だけでなく、実際の対象ジョブの参照先と業務結果まで確認します。

ライブラリリストの確認は環境差による障害の調べ方、実行前の対象・承認・戻し方は本番作業チェックリストを参照してください。この記事には、値を書き換えるコマンドや、本番の設定値は掲載していません。

ローカルデータエリアの引継ぎはIBM Local data area、表示時のロックはIBM:データエリアのロックと割振りを参照してください。表示例は読解用で、実機での実行結果を掲載したものではありません。