JP1/Base 運用ガイド
機能
コマンド実行環境を設定,参照するためのコマンドです。引数には,マネージャーホスト(JP1/IM - Managerインストールホスト)でだけ指定すればよいもの,コマンド実行先ホストでだけ指定すればよいものがあります。これらについては以降の引数の説明で説明します。
形式
jcocmddef [ [-show] | [-default] [-rsptime 応答監視時間] [-record レコード数] [-group ホストグループ定義ファイル名] [-loaduserprofile {ON|OFF}] [-queuenum コマンド先行入力数] [-execnum コマンド同時実行数] [-open {ON|OFF}] [-flush {ON|OFF}] [-cmdevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}] [-actevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}] [-actresult {ON|OFF}] [-host 論理ホスト名] [-runevinterval 経過時間イベント発行間隔] [-actlimit {ON [転送データ量(行数)] | OFF}] [-cmdlimit {ON [転送データ量(行数)] | OFF}] [-queuethreshold コマンド先行入力数の閾値] ]
実行権限
Windowsの場合:Administrators権限(WindowsのUAC機能が有効な場合は管理者コンソールから実行)
UNIXの場合:スーパーユーザー権限
格納先ディレクトリ
- Windowsの場合
Baseパス\bin\
- UNIXの場合
/opt/jp1base/bin/
引数
-show
現在の定義内容を表示します。このオプションはほかのオプションと併用はできません。なお,このオプションを省略し,かつ,ほかのオプションも省略した場合は,このオプション指定時と同じく,現在の定義内容を表示します。
-default
-rsptime,-record,-loaduserprofile,-queuenum,-execnum,-open,-flush,-cmdevent,-actevent,-actresult,-runevinterval,-actlimit,-cmdlimit,および-queuethresholdの設定をデフォルトに戻します。ほかのオプションを同時に指定した場合は,-defaultオプションが有効になります。
-rsptime 応答監視時間
このオプションはマネージャーホスト(JP1/IM - Managerインストールホスト)で設定します。
実行コマンドの応答監視時間を秒単位で指定します。指定できる値は0〜600(秒)です。0を指定した場合は監視しません。デフォルトは60秒です。
実行したコマンドが応答監視時間以内に応答がない場合は,KAVB2002-Iメッセージが出力されます。
このオプションで指定した値は,JP1/Baseを再起動したあとに有効になります。
-record レコード数
このオプションはマネージャーホスト(JP1/IM - Managerインストールホスト)で設定します。
JP1/IM - Viewの[コマンド実行]画面,および自動アクションで実行したコマンドの実行履歴を保存するファイルの上限値をレコード数で指定します。
指定できる値は,1〜196,600です。デフォルトは20,000レコードです。
1回のコマンド実行で使用するレコード数は,(実行コマンドの出力行数+3)レコードです。1レコードは6,520バイトです。レコードサイズは変更できません。
レコード数が少ないと,自動アクションのアクション結果が正しく表示されないことがあります。
変更したレコード数は,コマンド実行履歴ファイルを削除したあとに有効になります。コマンド実行履歴ファイルを削除すると,過去の自動アクション,コマンド実行による履歴はすべて失われますので,注意してください。コマンド実行履歴ファイルの削除手順,および削除する際の注意事項については,マニュアル「JP1/Integrated Management - Manager システム構築・運用ガイド」(トラブルシューティングの章,トラブルへの対処方法にある「レコード数の上限値を変更する」)を参照してください。
-group ホストグループ定義ファイル名
このオプションはマネージャーホスト(JP1/IM - Managerインストールホスト)で設定します。
コマンド実行先ホストを定義したホストグループ定義ファイルを指定します。定義ファイルの形式は,マニュアル「JP1/Integrated Management - Manager リファレンス」(定義ファイルの章)を参照してください。
ホストグループ定義ファイルで,ホストグループを定義していない場合は,そのホストグループが削除されます。
-loaduserprofile {ON|OFF}
このオプションはコマンド実行先ホストで設定します。
コマンド実行時にOSユーザーのプロファイルを読み込むかどうかを指定します。プロファイルを読み込む場合はON,読み込まない場合はOFFを指定します。ONまたはOFFの大文字・小文字は,区別されません。デフォルトは,OFFです。
このオプションで指定した値は,JP1/Baseを再起動したあとから有効になります。
このオプションは,Windowsの場合にだけ使用できます。
-queuenum コマンド先行入力数
このオプションはコマンド実行先ホストで設定します。
自動アクション機能を使用してコマンドを実行する場合に,コマンド実行先ホストで実行待ちにできるコマンドの最大値を指定します。指定できる値は,0〜65,535です。デフォルトは1,024です。0を指定した場合は,コマンド実行先ホストに複数のコマンドを同時に投入できません。
実行待ちの自動アクションがコマンド先行入力数を超えた場合は,KAVB2058-Eメッセージが出力されます。
このオプションで指定した値は,JP1/Baseを再起動したあとから有効になります。
-execnum コマンド同時実行数
このオプションはコマンド実行先ホストで設定します。
自動アクション機能を使用してコマンドを実行する場合に,コマンド実行先ホストで同時に実行できるコマンド数の最大値を指定します。指定できる値は,1〜48です。デフォルトは1です。コマンドを実行するホストごとに異なる値を指定できます。
このオプションで指定した値は,JP1/Baseを再起動したあとから有効になります。
このオプションは,実行終了までに長時間かかるコマンドを実行した場合に後続のコマンドの実行開始を早めたいときや,同時に大量の自動アクションが発生した場合に処理性能を向上させたいときなどに指定してください。
なお,このオプションで2以上の値を指定した場合は,複数のコマンドが同時に実行されるため,先に実行されたコマンドが必ずしも先に終了するとは限りません。したがって,自動アクションの終了順序を考慮した運用をしている場合は,このオプションを指定しないでください。
-open {ON|OFF}
このオプションはマネージャーホスト(JP1/IM - Managerインストールホスト)で設定します。
コマンド実行履歴ファイルを常時オープンした状態で実行履歴の出力を行うかを設定します。ONの場合,常時オープンした状態で出力を行います。OFFの場合,常時オープンせずに出力を行います。デフォルト設定はOFFです。自動アクション用コマンド実行履歴にだけ有効な設定で,JP1/IM - Viewの[コマンド実行]画面用コマンド実行履歴では有効になりません。
-openの設定を有効にするには,JP1/Baseの再起動が必要です。
-flush {ON|OFF}
このオプションはマネージャーホスト(JP1/IM - Managerインストールホスト)で設定します。
コマンド実行履歴1行ごとにディスクへ書き込みを行うかを設定します。この設定を有効にすると,突然のシャットダウンが発生した場合でも1行ごとにディスクへ実行履歴が書き込まれているため,再起動後に実行履歴データを参照することができます。ONの場合,1行ごとにディスク中のファイルに書き込みを行います。OFFの場合,システムでバッファリングを行うため,1行ごとにディスク中のファイルへの書き込みを行いません。デフォルト設定はOFFです。
なお,-flushを有効にした場合,1行ごとにディスク中のファイルへ書き込みを行うため,自動アクションおよびコマンド実行の性能が劣化する場合があります。
-flushの設定を有効にするには,JP1/Baseの再起動が必要です。
-cmdevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}
このオプションはマネージャーホスト(JP1/IM - Managerインストールホスト)で設定します。
コマンド実行操作をした際にコマンド実行操作に関係するイベントを発行したい場合に,どのイベントを発行するかを指定します。次に示す発行レベルのどれかを指定します。デフォルトは0です。
表13-1 イベント発行レベル(コマンド実行操作)
発行レベル 発行するイベントのイベントID 説明 0 なし コマンド実行操作に関係するイベントを発行しない 1 00003FA0 コマンド実行開始イベントを発行する 2 00003FA1 コマンド実行終了イベントを発行する 3 00003FA0,00003FA1 コマンド実行開始イベント,コマンド実行終了イベントを発行する 4 00003FA2 コマンド実行異常終了イベントを発行する 5 00003FA0,00003FA2 コマンド実行開始イベント,コマンド実行異常終了イベントを発行する 6 00003FA1,00003FA2 コマンド実行終了イベント,コマンド実行異常終了イベントを発行する 7 00003FA0,00003FA1,00003FA2 コマンド実行開始イベント,コマンド実行終了イベント,コマンド実行異常終了イベントを発行する このオプションで指定した値は,JP1/Baseを再起動したあとから有効になります。
-actevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}
このオプションはマネージャーホスト(JP1/IM - Managerインストールホスト)で設定します。
アクションの状態が変化した際にアクション状態通知に関係するイベントを発行したい場合に,どのイベントを発行するかを指定します。次に示す発行レベルのどれかを指定します。デフォルトは0です。
表13-2 イベント発行レベル(自動アクション状態通知)
発行レベル 発行するイベントのイベントID 説明 0 なし アクション状態通知に関係するイベントを発行しない 1 000020E0,000020E3 アクション状態が送信中・キューイング・実行中になった際にイベントを発行する 2 000020E1,000020E4 アクション状態が終了・キャンセル・強制終了になった際にイベントを発行する 3 000020E0,000020E1,000020E3,000020E4 アクション状態が送信中・キューイング・実行中または終了になった際にイベントを発行する 4 000020E2,000020E5 アクション状態が実行不可・実行失敗になった際にイベントを発行する 5 000020E0,000020E2,000020E3,000020E5 アクション状態が送信中・キューイング・実行中または実行不可・実行失敗になった際にイベントを発行する 6 000020E1,000020E2,000020E4,000020E5 アクション状態が終了・キャンセル・強制終了または実行不可・実行失敗になった際にイベントを発行する 7 000020E0,000020E1,000020E2,000020E3,000020E4,000020E5 アクション状態が送信中・キューイング・実行中,終了・キャンセル・強制終了,または実行不可・実行失敗になった際にイベントを発行する このオプションで指定した値は,JP1/IM - Managerを再起動したあとから,またはjco_spmd_reloadコマンドでリロードしたあとから有効になります。
なお,アクション状態通知に関係するイベントは,アクション情報ファイルを参照して発行されます。アクション情報ファイルの上限値に達して,上書きされた場合には,上書きされる以前のアクション情報を参照できなくなるため,アクション状態通知に関係するイベントを発行できません。このような場合には,警告イベント(000020E6または000020E7)またはエラーイベント(000020E8)が発行されます。
-actresult {ON|OFF}
このオプションはマネージャーホスト(JP1/IM - Managerインストールホスト)で設定します。
自動アクションによるコマンド実行の実行結果をコマンド実行履歴に保存するかどうか指定します。保存する場合はON,保存しない場合はOFFを指定します。
ONまたはOFFの大文字・小文字は,区別されません。デフォルトは,ONです。コマンドの実行結果の詳細を知りたい場合は,必ずONを指定してください。
OFFを指定すると,コマンド実行履歴ファイルへの出力を抑止するため,JP1/Base制御部の処理速度を向上させることができます。ただし,自動アクションによるコマンドの戻り値以外の情報をすべて破棄するため,コマンドの実行結果の詳細は出力されません(JP1/IM - Viewの[アクション結果詳細]画面の[メッセージ]に出力される情報がすべて「KAVB2401-I」のメッセージ情報になります)。
このオプションで指定した値は,JP1/IM - Managerを再起動したあとから有効になります。
-host 論理ホスト名
クラスタシステムで運用している場合に,論理ホスト名を指定します。このオプションを省略した場合,環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合,物理ホスト名が仮定されます。
このオプションを指定して,実行系サーバまたは待機系サーバの設定を変更した場合は,必ずもう一方のサーバでも同様の設定をしてください。
-runevinterval 経過時間イベント発行間隔
このオプションはコマンド実行先ホストで設定します。
JP1/IM - Viewの[コマンド実行]画面,および自動アクションで実行したコマンドの経過時間を通知する,イベント発行間隔を指定します。指定できる値は,0〜86,400(単位:秒)です。デフォルトは600秒(10分)です。
指定した時間が経過するたびにイベントID 00003FA3(実行経過時間通知イベント)が発行され,KAVB2402-Wメッセージが出力されます。0を指定した場合,イベントは発行されません。
このオプションで指定した値は,JP1/Baseを再起動したあとから有効になります。
-actlimit {ON [転送データ量(行数)] | OFF}
このオプションはコマンド実行先ホストで設定します。
自動アクションで実行したコマンドの実行結果をマネージャーに転送する場合に,転送するデータ量を抑止するかどうか,また,抑止する場合はその上限値を指定します。指定できる値は0〜196,600です。デフォルトはON(抑止する)で値は1,000です。
コマンド実行結果のデータ量を抑止する場合には,ONを指定し,転送するデータ量の上限値を行数(1行256バイト)で指定します。行数の指定を省略した場合は,1,000行が設定されます。
コマンド実行結果のデータ量の転送を抑止しない場合には,OFFを指定します。
自動アクションの実行結果として大量の出力データを必要としない場合,実行したコマンドが動作不正で無限ループした場合など,大量のデータの出力を抑止する目的で使用してください。
コマンド実行結果が上限値を超えた場合は,KAVB2070-Wメッセージが出力されます。
-actlimitの設定を有効にするには,JP1/Baseの再起動が必要です。
- 注意事項
- バージョン08-00以降のJP1/Baseを新規インストールした場合だけ,デフォルトで1,000行が設定されます。
- コマンド実行先ホストのJP1/Baseのバージョンが07-51以前の場合,またはバージョン07-51以前から08-00以降にバージョンアップした場合,デフォルトはOFF(抑止しない)です。
-cmdlimit {ON [転送データ量(行数)] | OFF}
このオプションはコマンド実行先ホストで設定します。
JP1/IM - Viewの[コマンド実行]画面から実行したコマンドの実行結果をマネージャーに転送する場合に,転送するデータ量を抑止するかどうか,また,抑止する場合はその上限値を指定します。指定できる値は0〜196,600です。デフォルトはON(抑止する)で値は1,000です。
コマンド実行結果のデータ量を抑止する場合には,ONを指定し,転送するデータ量の上限値を行数(1行256バイト)で指定します。行数の指定を省略した場合は,1,000行が設定されます。
コマンド実行結果のデータ量を抑止しない場合には,OFFを指定します。
JP1/IM - Viewの[コマンド実行]画面から実行したコマンドの実行結果として,大量の出力データを必要としない場合,実行したコマンドが動作不正で無限ループした場合など,大量のデータの出力を抑止する目的で使用してください。
コマンド実行結果が上限値を超えた場合は,KAVB2070-Wメッセージが出力されます。
-cmdlimitの設定を有効にするには,JP1/Baseの再起動が必要です。
- 注意事項
- バージョン08-00以降のJP1/Baseを新規インストールした場合だけ,デフォルトで1,000行が設定されます。
- コマンド実行先ホストのJP1/Baseのバージョンが07-51以前の場合,またはバージョン07-51以前から08-00以降にバージョンアップした場合,デフォルトはOFF(抑止しない)です。
-queuethreshold コマンド先行入力数の閾値
このオプションはコマンド実行先ホストで設定します。
自動アクション機能を使用してコマンドを実行し,コマンド実行先ホストで実行待ちになるコマンド数(キューイング数)を監視したい場合に,コマンドの先行入力数の閾値を指定します。指定できる値は,0〜65,535です。デフォルトは10です。
0を指定すると閾値監視をしません。
0以外を指定すると,その値に達した時点で警告のJP1イベントが発行され,KAVB2071-Wメッセージが出力されます。また,先行入力数が0に戻った時点で回復のJP1イベントが発行され,KAVB2072-Iメッセージが出力されます。
閾値監視をすると,JP1/Baseのキューにアクションが蓄積しているのを検知できます。そのため,実行遅延に対して事前に対処することができます。
-queuethresholdの設定を有効にするには,JP1/Baseの再起動が必要です。
出力形式
jcocmddefコマンドを実行すると,設定変更したパラメーターだけでなく,ほかのパラメーターも表示されます。出力形式を次に示します。
図13-1 jcocmddefコマンドの出力形式
戻り値
0 正常終了 -1 異常終了
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.