Hitachi

JP1 Version 12 JP1/Client Process Automation 構築・運用ガイド


8.3.2 任意のイベント監視(イベントモニターアイテム)

〈この項の構成〉

(1) 機能概要

コマンドを定期的に実行し,コマンドの終了コードを監視します。

(2) 指定項目一覧

名称

必須

形式

引き継ぎ情報指定可否

コマンド名

文字列(1〜255バイト)

パラメーター

×

文字列(0〜512バイト)

イベント検知とみなす終了コード

文字列(1〜512バイト)

形式:数値[,数値...]

数値は0〜4,294,967,295

異常終了とみなす終了コード

×

文字列(0〜512バイト)

形式:数値[,数値...]

数値は0〜4,294,967,295

打ち切り時間(分)

×

数字(0〜1440)

仮想ユーザー名

×

文字列(0〜512バイト)

可(プロフィール情報は指定否)

(凡例)

○:必須

×:省略可

(3) 指定内容

コマンド名

監視のために定期的に実行するコマンドのファイル名を指定します。

パラメーター

実行コマンドに対するパラメーターを指定します。

イベント検知とみなす終了コード

イベント検知とみなす終了コードを指定します。複数の終了コードをコンマで区切って指定できます。

異常終了とみなす終了コード

異常終了とみなす終了コードを指定します。複数の終了コードをコンマで区切って指定できます。

打ち切り時間(分)

任意のイベント監視を打ち切る時間を指定します。指定を省略した場合や「0」を指定した場合は,任意のイベント監視を打ち切りません。

なお,打ち切り時間に到達した場合は異常終了(ENDE)となります。

仮想ユーザー名

アイテムを実行するWindowsユーザー名にマッピングされた仮想ユーザー名を指定します。仮想ユーザー名を指定しなかった場合,アイテムはCPAのジョブ実行サービスのアカウントで実行されます。

仮想ユーザー名のマッピングは,cpasetumapコマンドで行います。cpasetumapコマンドについては,「9. コマンド」の「cpasetumap」を参照してください。

(4) 戻り値

内容

-1

強制終了。

0

次のどれかの場合。

  • コマンドを実行した結果がイベント検知とみなす終了コードと一致し,任意のイベント監視が終了した。

  • 打ち切り時間に到達したため,監視が打ち切られた。

  • アイテムに仮想ユーザー名を指定している場合は,アイテムに指定した仮想ユーザー名が不正,または登録されていないため,監視を行えなかった。

【対処】
  • 正しい仮想ユーザー名を指定してください。

  • 仮想ユーザー名を登録してください。

2

リソース不足,処理負荷が高い状況にある。

【対処】

アイテム実行時のOSリソースを確認してください。

3

システムコールに失敗した。

【対処】

インストールが正しくできているか,アイテム実行時のOSの環境に問題がないか確認してください。

4

指定したパラメーターに誤りがある。

【対処】

指定可能な値で再定義してください。

21

コマンドを実行した結果が異常終了とみなす終了コードと一致し,イベント監視が終了した。

22

指定したコマンドの実行に失敗した。

【対処】
  • デスクトップヒープが不足していないか確認してください。

  • アイテムに仮想ユーザー名を指定している場合は,次のことを確認し,対処してください。

    ・仮想ユーザー名にひも付いているWindowsユーザーにユーザー権利が正しく与えられているか

    ・仮想ユーザー名にひも付いているWindowsユーザーのパスワードの期限が満了していないか

    ・仮想ユーザー名にひも付いているWindowsユーザーのパスワードが誤っていないか(アカウントロックされていないか)

    ・Net Logonサービスが起動されているか

(5) 使用例1

特定のプロセスが存在した場合にイベントを検知し,存在しない場合は監視を継続する

コマンド名

cmd

パラメーター

/c tasklist|findstr プロセス名

イベント検知とみなす終了コード

0

異常終了とみなす終了コード

(凡例)

−:指定を省略

(6) 使用例2

特定のプロセスが存在した場合にイベントを検知し,存在しない場合は異常終了する

コマンド名

cmd

パラメーター

/c tasklist|findstr プロセス名

イベント検知とみなす終了コード

0

異常終了とみなす終了コード

1

(7) 終了コードについて

イベント検知とみなす終了コードと異常終了とみなす終了コードに同じ値を指定した場合,異常終了します。