実行登録したはずのジョブが、設定した時間になっても「キューイング状態」となり、正常に開始されなかった経験はありませんか？今回は、JP1/AJS2(V8以前)やJP1/AJS3(V9以降)のジョブがキューイング状態となる、以下5つのケースと対処方法をご紹介します。

トラブルシュートセミナーのご紹介

ジョブがキューイングする5つの原因と対処方法

JP1/AJS3(JP1/AJS2)のジョブがキューイング状態になった場合は、以下5つのケースに該当しないか確認してください。

1.マネージャーホストとエージェントホスト間で名前解決が出来ていない

● 原因

JP1/AJS3(JP1/AJS2)は、ホスト名からIPアドレスで名前解決できる環境で動作します。特にマネージャーホストとエージェントホスト間の通信においては、それぞれのマシンの「ホスト名」を使用するため、互いのホスト名が正しく名前解決されていないとジョブがキューイング状態となります。

● 対処方法

DNS運用をしている場合は、ホスト名のIPアドレスがFQDN形式で正しく名前解決されるよう設定してください。

※論理ホスト名には、FQDN形式のホスト名が使用できません。

2.実行先ホストのJP1/AJS3およびJP1/AJS2サービスが起動していない

● 原因

JP1/AJS3(JP1/AJS2)は、エージェントホスト上の処理をマネージャーホストから実行できます。エージェントホストへジョブを配信する場合、配信先のJP1/AJS3(JP1/AJS2)サービスが正常起動している必要がありますが、サービスが停止していると、マネージャーホストはジョブを受信できずにキューイング状態となります。

● 対処方法

ジョブの実行先となるエージェントホストのJP1/AJS3(JP1/AJS2)サービスを起動してください。

3.ファイアウォールがJP1で使用するポートを遮断している

● 原因

JP1/AJS3(JP1/AJS2)は、ファイアウォールを挟んでJP1/AJS3 - Manager(JP1/AJS2 - Manager)と、JP1/AJS3 - Agent(JP1/AJS2 - Agent)またはJP1/AJS3 - View(JP1/AJS2 -View)を接続するシステム構成に対応しています。ただし、JP1サーバ間にてファイアウォールを透過し、通信可能であることが前提となります。そのため、JP1で使用するポートがファイアフォール側で遮断されていると、マネージャーホストとエージェントホスト間の通信が遮断されてジョブがキューイング状態となります。

● 対処方法

ファイアウォールを経由するネットワーク環境下でJP1を運用する場合、パケット・フィルタリングやNATへJP1/AJS3(JP1/AJS2)が使用するIPアドレスとポート番号を定義する必要があります。開放するポート番号や通信方向は以下の通りです。ジョブがキューイングする場合、まずは★印のポートをご確認ください。

※1 JP1/AJS3とJP1/AJS2でともに使用するポート番号です。
※2 JP1/AJS3のみで使用するポート番号です。

4.ジョブ実行多重度を超えている

● 原因

JP1/AJS3(JP1/AJS2)では実行エージェントに同時実行ジョブ数（ジョブ実行多重度）を制限できます。そのため、指定したジョブ実行多重度を「0」で指定している場合や、設定値を超えてしまうと、ジョブはエージェントホストへ配信されずにキューイング状態となります。

● 対処方法

下記コマンドを実行して、ジョブ実行多重度を確認してください。

jpqagtshowコマンド実行結果

※出力内容
AGENT：エージェントホスト名を示します。
CUREXECHGNUM：現在のジョブ実行多重度を示します。
EXECUTING：現在実行中のジョブ数を示します。

Windowsの場合(V9以降)

> ajsagtshow –l
UNIXの場合(V9以降)

# /opt/jp1ajs2/bin/ajsagtshow –l

※クラスタ環境の場合はコマンドオプションに -h 論理ホスト名 を付与してください。

ajsagtshowコマンド実行結果

※出力内容
AGENT：実行エージェント名を示します。
STATUS：実行エージェントの受付配信制限の状態を示します。
HOST：実行ホスト名を示します。
CON-EXE：ジョブ実行多重度を示します。
QUE：キューイング中のジョブの数を示します。
JOB：実行中ジョブの数を示します。
EVENT：実行中のイベントジョブ数を示します。
DESCRIPTION：追加・変更時に設定した実行エージェントに対するコメントを示します。

必要に応じて、jpqagtalt(V8以前)やajsagtalt(V9以降)コマンドからジョブ実行多重度を変更してください。

5.キューの受付口や取出口が開いていない（V8以前）

● 原因

V8以前のJP1/AJS2は、JP1/AJS3とは「キュー」の概念が異なります。キューの受付口が閉じている場合、実行先ホストへジョブは配信されません。また、キューの取出口が閉じている場合も、マネージャーにジョブ実行結果を返すことができず、ジョブはキューイング状態となります。

● 対処方法

コマンド「Jpqqueshow」を実行して、受付口および取出口が開いているか確認してください。閉じている場合は「jpqqueopen」を実行して、受付口および取出口を開いてください。

ENTRYSTATUSやEXITSTATUSが「CLOSE」と表示された場合は、ジョブの受付口および取出口が閉じているため、下記コマンドを実行します。

Windowsの場合

> jpqqueopen -ah エージェント名 -en

UNIXの場合

# /opt/jp1ajs2/bin/jpqqueopen -ah エージェント名 -en

なお、コマンドでエージェントを追加した直後はキューの受付口は閉じます。そのため、ジョブの登録を行う際はjpqqueopenコマンドを使用して、キューの受付口を開いてください。

まとめ

JP1/AJS3(JP1/AJS2)のジョブがキューイング状態となる事例をご紹介しました。ジョブがキューイングする原因が分からない場合は、本ブログでご紹介した5つの事象に該当しないかご確認をお願いします。

JP1ブログをご覧いただいているみなさまへご案内

いつもJP1サポート技術者ブログをご覧いただきありがとうございます。

本ブログの執筆を担当しているアシストJP1サポートセンターは、「JP1認定技術者」の資格を持つサポート技術者の対応が支持され、お客様満足度は10年連続90%以上を維持しています。

紹介サイトでは、サポートセンターが誇る3つの特徴とJP1の最新情報満載の提供サービスを、お客様の声とともにご紹介しています。是非ご覧ください。

また、アシストとJP1保守契約を締結されている方は、Webサポートセンター「AWSC-2」をご利用いただけます。本ブログサイトではご紹介しきれない2,000件以上のFAQを公開していますので、是非ご利用ください。詳細は、下記リンクよりご確認ください。