WRKOBJの使い方|AS400でオブジェクトとライブラリを取り違えない確認手順

WRKOBJは、AS400 / IBM i でオブジェクトを確認する時によく使うコマンドです。単に「存在するか」を見るだけでなく、どのライブラリのオブジェクトを見ているのか、同名オブジェクトがないか、本番と検証を取り違えていないかを確認するために使います。

WRKOBJは、オブジェクト名やライブラリを確認する基本コマンドです。コマンドの意味だけでなく、現場で取り違えを防ぐ使い方まで整理します。

WRKOBJで見ること

確認見る理由
オブジェクト名プログラム、ファイル、データエリアなど対象が正しいかを見る
ライブラリ名本番、検証、開発、退避の取り違えを防ぐ
オブジェクトタイプ*PGM、*FILE、*DTAARAなど種類を確認する
*LIBL指定ライブラリリスト上でどのオブジェクトが優先されるかを見る
権限存在するのに使えない場合の切り分けにつなげる

現場で多い使い方

  • プログラムが見つからない時に、対象ライブラリへ存在するか確認する
  • 同じ名前のプログラムが本番と検証の両方にないか確認する
  • ファイル変更後に、正しいライブラリへ反映されているか確認する
  • ジョブログに「オブジェクトが見つからない」と出た時に対象を探す
  • *LIBL指定で想定外のオブジェクトを参照していないか確認する

WRKOBJで事故を防ぐ見方

AS400の保守では、同じオブジェクト名が複数ライブラリに存在することがあります。開発用を直したつもりが本番を見ていた、検証で確認したつもりが退避ライブラリだった、という取り違えは珍しくありません。

WRKOBJを使う時は、オブジェクト名だけで判断せず、ライブラリ名、タイプ、作成日、変更日、権限まで確認します。特に本番作業前は、F4でパラメータを確認し、対象ライブラリを声に出して確認するくらいでちょうどよいです。

最初に確認すること

  • ライブラリ名とオブジェクト名が正しいか
  • オブジェクトタイプが *FILE、*PGM、*SRVPGM、*DTAARA などで合っているか
  • DSPOBJDで存在、所有者、作成日、変更日を確認したか
  • WRKOBJで同名オブジェクトが複数ライブラリにないか
  • 実行ジョブのライブラリリストと権限を確認したか

CPF2105や見つからない系の切り分け

CPF2105のような見つからない系のメッセージでは、オブジェクト名だけでなく、ライブラリ、ライブラリリスト、オブジェクトタイプ、権限を確認します。*LIBL指定で実行している場合は、ジョブごとのライブラリリストが原因になることがあります。

ライブラリリストの確認は AS400ライブラリの確認方法、CPF系全体は AS400メッセージID・エラーコード索引 を確認してください。

調査メモに残す内容

  • 対象オブジェクト名、ライブラリ名、オブジェクトタイプ
  • DSPOBJDで見た所有者、作成日、変更日
  • WRKOBJで見えた同名オブジェクトの有無
  • 実行ジョブ、実行ユーザー、ライブラリリスト
  • 直前の変更、リストア、コンパイル、ライブラリ切替

AS400のオブジェクト調査は、名前だけを見ると迷いやすくなります。DSPOBJD、WRKOBJ、DSPLIBL、ジョブログを組み合わせて、どの環境の何を見ているかをそろえることが近道です。

関連コマンドとの使い分け

コマンド使いどころ
WRKOBJオブジェクトの存在とライブラリを確認する
DSPOBJD作成日、変更日、属性など詳細を見る
DSPOBJAUTオブジェクト権限を見る
DSPLIBLライブラリリストの順番を見る

ライブラリとオブジェクトの基本は、AS400ライブラリとオブジェクト入門、目的別のコマンド整理はAS400コマンド一覧の現場ガイドも確認してください。

ここまでの要点

WRKOBJは、AS400でオブジェクトとライブラリを取り違えないための基本コマンドです。障害調査でも本番作業でも、対象が正しいかを確認する入口になります。コマンドを打つだけでなく、どのライブラリの何を見ているかまで説明できる状態を目指しましょう。

WRKOBJで見るべき現場ポイント

WRKOBJでは、存在確認だけでなく、どのライブラリにあるか、同名オブジェクトがないか、更新対象を間違えていないか、権限や所有者に違和感がないかを見ます。改修前の初動確認としてよく使います。

WRKOBJで検索して来た方へ

WRKOBJは、AS400 / IBM iでオブジェクトの存在確認をする時によく使います。現場では、オブジェクト名だけでなく、対象ライブラリを間違えないこと、同名オブジェクトが別ライブラリにないかを見ることが重要です。

オブジェクトの存在確認で見る順番

まずライブラリ名、オブジェクト名、オブジェクトタイプを確認します。次に、テスト環境と本番環境で同じ名前のオブジェクトを見ていないか、ライブラリリストの順番で別物を参照していないかを確認します。

WRKOBJで検索して来た人が、間違えやすいポイント

WRKOBJは、オブジェクトがどのライブラリに存在するかを確認する時によく使います。ただし、AS400 / IBM i では同じ名前のオブジェクトが複数ライブラリに存在することがあります。名前だけで判断せず、ライブラリ、オブジェクトタイプ、作成日、所有者、テスト環境と本番環境の違いを確認します。

現場で多いのは、テスト環境のつもりで本番ライブラリを見ている、ライブラリリストの順番で別オブジェクトを参照している、改修対象と実行対象が違う、というパターンです。WRKOBJで存在確認したら、DSPFFD、DSPPGMREF、ジョブログと合わせて影響範囲を見ます。

WRKOBJの確認を、影響調査の入口にする

WRKOBJでオブジェクトとライブラリを確認したら、次はどのプログラム、どのジョブ、どの業務に影響するかを見ます。RPG/CLソースやジョブログ、DSPFFD、DSPPGMREFと組み合わせて確認すると、外部パートナーや業務担当者へ説明しやすくなります。こうした調査手順をCodexで整理したい場合は、AS400 / IBM i 現場向け Codex実戦研修も入口になります。

参考:IBM公式ドキュメント(WRKOBJ)

本記事で扱った WRKOBJ の全パラメーターと表示項目の定義は、IBM公式ドキュメントで確認できます。指定できる値や既定値はOSリリースによって異なるため、本番環境では自社のリリースに合わせて確認してください。