2026/07/08

IBM i運用で必須のコマンド活用ガイド

記事イメージ
※画像はイメージです。本文と直接の関係はありません

IBM i運用で必須のコマンド活用ガイド

序章　目的と効果

IBM i の運用作業は、適切なコマンドを迅速に呼び出すことで作業時間を大幅に短縮できます。本稿では、コマンド検索から日常操作、障害診断、作業自動化までの一連の流れを示し、実務ですぐに活用できる手順を提供します。

第1章　コマンドの探し方（検索の基本）

1‑1　命名規則の把握

IBM i の CL コマンドは多くが「動詞（3 文字）＋対象（3 文字程度）」の形です。WRKACTJOB や DSPLOG など例外もあるため、例外があることを前提に検索すると目的のコマンドにたどり着きやすくなります。

1‑2　実用的な検索手順

  • GO CMDCRT
    「CRT」で始まる作成系コマンド（CRTLIB、CRTPF など）を一覧表示します。削除系（DLT）や変更系（CHG）も同画面に含まれます。

  • GO CMDPF
    物理ファイルに関係する CRTPF、CHGPF などを絞り込んで検索できます。

  • GO CMDDBF（データベースファイル全般）
    物理ファイルだけでなく、論理ファイルやその他のデータベースオブジェクトも対象にした検索が可能です。

  • F4（コマンド行が空の状態）
    主要コマンドの番号メニューが表示され、名前が思い出せないときに便利です。

    5250 エミュレータの下部に「F4 ヘルプ」ボタンがあり、画面構成やパラメータの説明を即座に確認できます。

ファンクションキーの概要（詳細は第6章参照）

  • F1 … 常にヘルプを表示します。エラーメッセージ上で押すと詳細情報が出ます。
  • F4 … コマンド行が空のときはコマンドメニュー、入力中はパラメータ入力画面を呼び出します。

第2章　日常的に頻繁に使う基本系コマンド

2‑1　システム全体の把握

  • WRKACTJOB … 実行中ジョブの一覧と CPU 使用率、待機状態を確認します。

    • ポイント：F10 で統計をリセットし、数秒待ってから F5 で画面更新すると、リセット後の平均 CPU 使用率が算出されます。ページ移動は PageUp / PageDown、表示切替は F7 が割り当てられていることが多いです。

  • WRKSYSSTS … CPU、メモリ、ディスク使用率などシステム全体のステータスを表示します。

    • 補足：F5 で画面を更新した直後の CPU 使用率は「前回の更新からの平均」になるため、数秒置いてから再度 F5 を押すとより正確な数値が得られます。

  • DSPLOG … システムログを期間や出力形式を指定して表示します。

    • 補足：期間指定は開始日時と終了日時の両方を指定できます。例 

      DSPLOG PERIOD(('2024-07-01-00.00.00' '2024-07-07-23.59.59'))

      また、*CURRENT などの特殊値を用いると「現在の日付まで」や「直近 24 時間」など柔軟に指定できます。

2‑2　オブジェクト・ライブラリの確認

  • WRKLIB … ライブラリ一覧を表示します。
  • WRKOBJ … 指定ライブラリ内のオブジェクトを検索・操作できます。
  • DSPOBJD … オブジェクトの詳細情報を表示します。
  • DSPFD … ファイル定義を確認します。
  • DSPFFD … フィールド定義を確認します。

2‑3　スプール・出力キューの確認

  • WRKOUTQ … 出力キューと紐付くスプールファイルを確認します。
  • WRKSPLF … ユーザーが所有するすべてのスプールファイルを一覧表示します。
  • WRKUSRJOB … 指定ユーザーが実行中のジョブと関連スプールを同時に確認でき、ユーザー単位の作業把握に便利です。

実務シナリオ
障害発生時はまず WRKACTJOB で異常ジョブを特定し、続いて DSPLOG でエラーメッセージを取得、必要に応じて WRKOUTQ でスプールを確認します。

第3章　トラブル時に必須の診断フロー

3‑1　異常ジョブの判定基準（例）

CPU 使用率が高い、または待機状態が長くなるジョブは「異常ジョブ」とみなします。実際の判定は業務要件に合わせて設定してください。

3‑2　診断手順

  1. WRKACTJOB で異常ジョブを抽出します。
  2. WRKJOB で対象ジョブの詳細情報を確認します。
  3. DSPLOG で該当ジョブに関連するエラーメッセージを取得します。
  4. DSPMSG でジョブが保有しているメッセージを確認し、メッセージ待ち状態の原因を把握します。
  5. 必要に応じて ENDJOB でジョブを終了します。
    • オプション例：ENDJOB JOB(ジョブ名) OPTION(*IMMED) とすれば即時終了できます。

注記
診断系コマンドは障害原因の特定と復旧に直結します。スケジューラ登録コマンド（例：ADDJOBSCDE）は診断フローには含めません。

第4章　自動化・スケジューリングと電源・ネットワーク管理

4‑1　バックアップジョブの自動化例

/* 毎朝 08:00 にバックアップジョブを実行 */
ADDJOBSCDE CMD('CALL PGM(MYLIB/BACKUP)') SCDTIME('08:00')

このジョブは WRKJOB で実行状況を随時確認できます。

4‑2　ネットワーク設定の確認

  • NETSTAT … 接続状況を表示します。OPTION パラメータで表示項目を絞り、アクティブな TCP 接続を確認できます。
  • CFGTCP … TCP/IP の構成を設定します。CFGTYPE で対象（IP アドレス、DNS など）を指定し、変更時は設定内容を必ず確認してください。

4‑3　電源スケジュールの変更手順

  • CHGPWRSCD … 電源オン・オフのスケジュールを変更します。日時は TIME('08:00') DATE('2025/01/01') のように指定します。夜間の自動シャットダウンや週末の自動起動設定が可能です。変更前に DSPPWRSCD で現在の設定を確認し、メンテナンスウィンドウ内で実施してください。
  • PWRDWNSYS … システムを安全にシャットダウンします。OPTION(*IMMED) を付けると即時停止が可能です。

夜間メンテナンスは CHGPWRSCD で自動電源オフを設定し、翌朝は自動電源オンに任せます。手動で起動が必要な場合は、管理者が適切な手順で電源を入れます。

第5章　シェルコマンドと外部連携

IBM i では、UNIX 系シェルである Q シェル（STRQSH）と AIX 互換の PASE 環境（QP2TERM）を利用できます。

5‑1　PASE での system 呼び出し例

/* PASE 環境でシステムステータスを取得し、テキストファイルに保存 */
system('WRKSYSSTS > /home/user/sysstat.txt');

注意
system コマンドでリダイレクトを行う際、CCSID（文字コード）の違いによりファイルが文字化けすることがあります。必要に応じて環境変数 QIBM_PASE_DESCRIPTOR_STDIO などを設定してください。Q シェルでも同様に 

system "WRKSYSSTS > /home/user/sysstat.txt"

と記述できますが、柔軟なリダイレクトが必要な場合は PASE を推奨します。

5‑2　SSH によるリモート実行

SSH でリモートから IBM i に接続し、上記シェルコマンドを実行できます。公開鍵認証を利用し、パスワード認証は無効化するなど、最低限のセキュリティ対策を講じてください。

第6章　ファンクションキー活用（5250 エミュレータ）

  • F1 … 常にヘルプを表示します。エラーメッセージ上で押すと詳細情報が出ます。
  • F4 … コマンド行が空のときはコマンドメニュー、入力中はパラメータ入力画面を呼び出します。
  • F5 … 画面更新に使用します。WRKACTJOB や WRKSYSSTS では手動で最新情報に更新できます。
  • F9 … 直前に実行したコマンドを再表示します。連続で押すと、直近の履歴が順に表示されます。
  • F10 … 統計のリセットや特定画面の再描画に利用されます。
  • F13 （Shift + F1） … 多くの WRK 系画面で「全選択/全解除」や「詳細表示の切り替え」に使われ、大量のジョブやスプールを扱う際に有効です。

これらのキーを組み合わせることで、コマンド名が思い出せなくてもスムーズに作業が進みます。

第7章　カスタムコマンドと検索ツール

7‑1　カスタム CL コマンド

ユーザーが作成した制御言語コマンドオブジェクトを任意のライブラリに配置すれば、ライブラリ名/コマンド名 の形で呼び出せます。社内独自のバッチ処理や定型作業を自作コマンドにまとめると、作業手順が統一されます。

7‑2　検索ツール（応用編）

  • GO CMDWRK … ジョブ管理系コマンドの一覧を表示します。
  • GO CMDPF … 物理ファイル系コマンドの一覧を表示します。
  • GO CMDDBF … データベースファイル全般（物理・論理ファイル）を対象にしたコマンド一覧を表示します。

ポイント
他のカテゴリ（例：ネットワーク系、セキュリティ系）にも同様の GO CMD… 系コマンドが用意されており、目的に合わせて検索できます。

まとめと次のアクション

  1. バックアップジョブの自動化 

    ADDJOBSCDE CMD('CALL PGM(MYLIB/BACKUP)') SCDTIME('08:00')

    を実行し、WRKJOB でジョブの状態を確認します。

  2. 障害発生時の迅速な対応手順

    • WRKACTJOB で異常ジョブを特定（F10 で統計リセット、数秒待って F5 で更新、PageUp / PageDown でページ移動）
    • DSPLOG → F4 でエラーメッセージの詳細取得（期間指定は PERIOD パラメータで開始・終了日時、*CURRENT などの特殊値も利用可）
    • DSPMSG でジョブメッセージを確認
    • WRKOUTQ でスプールファイルを確認し、必要に応じて ENDJOB JOB(ジョブ名) OPTION(*IMMED) でジョブを即時終了

  3. ネットワークと電源の定期点検

    • NETSTAT と CFGTCP で接続状態と設定を確認
    • CHGPWRSCD で電源スケジュールを設定し、夜間メンテナンスを自動化

  4. 外部シェルとの連携

    • PASE 環境で system コマンドを利用し、システムステータスをテキスト化（CCSID の違いに注意）
    • SSH では公開鍵認証を使用し、セキュリティを確保した上でリモート実行

  5. ファンクションキーの習慣化

    • F4、F5、F9、F10、F13 を日常的に使い、コマンド入力や画面更新、全選択操作の手間を削減します。

  6. 自作コマンドで業務標準化

    • 社内で頻繁に使う手順を CL コマンド化し、GO CMDWRK などで検索しやすくします。

上記のアクションを実践すれば、作業時間の短縮とトラブル対応の迅速化が実現します。ぜひ業務フローに取り入れ、IBM i の運用効率を高めてください。

時刻:
ラベル: