jbsgetopinfo
機能
稼働情報を採取し,定義ファイルの記述形式に変換して標準出力に出力します。稼働情報として採取できるのは,イベント転送の定義情報,ログファイルトラップの定義情報,SSL通信の設定情報,およびイベントログトラップの定義情報です。
形式
jbsgetopinfo [-h 論理ホスト名 | イベントサービス名] [-o 稼働情報名,...] [-i ID番号 | -a 監視名]
実行権限
Windowsの場合:Administrators権限(WindowsのUAC機能が有効な場合は管理者コンソールから実行)
UNIXの場合:スーパーユーザー権限またはJP1/Base管理者権限
格納先ディレクトリ
- Windowsの場合
-
インストール先フォルダ\bin\
- UNIXの場合
-
/opt/jp1base/bin/
引数
-h 論理ホスト名
稼働情報を採取したい論理ホスト名またはイベントサービス名を指定します。このオプションを省略した場合,環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合,物理ホスト名が仮定されます。
-o 稼働情報名,...
採取したい稼働情報名を指定します。このオプションを省略した場合,すべての稼働情報名を指定したと仮定されます。複数の稼働情報名を指定する場合,「,」で区切って指定します。
指定できる稼働情報名を次に示します。
-
forward
稼働している転送設定ファイルの定義情報を出力します。転送設定ファイルの記述形式については,「16. 定義ファイル」の「転送設定ファイル」を参照してください。
-
logtrap
jevlogstartコマンドおよびJP1/AJSのログファイル監視ジョブで起動したすべてのログファイルトラップのうち,稼働しているログファイルトラップ動作定義ファイルの定義情報を出力します。-hオプションで論理ホストまたはイベントサービスを指定した場合,物理ホストの稼働情報を採取します。ログファイルトラップ動作定義ファイルの記述形式については,「16. 定義ファイル」の「ログファイルトラップ動作定義ファイル」を参照してください。
-
evttrap
稼働しているイベントログトラップ動作定義ファイルの定義情報を出力します。-hオプションで論理ホストまたはイベントサービスを指定した場合,物理ホストの稼働情報を採取します。この稼働情報名は,Windowsの場合にだけ指定できます。イベントログトラップ動作定義ファイルの記述形式については,「16. 定義ファイル」の「イベントログトラップ動作定義ファイル(Windows限定)」を参照してください。
-
SSL
稼働しているSSL通信定義ファイルの定義情報を出力します。SSL通信定義ファイルの記述形式については,「16. 定義ファイル」の「SSL通信定義ファイル」を参照してください。
-i ID番号 | -a 監視名
このオプションは,稼働情報名にlogtrapを指定した場合にだけ指定できます。ID番号には,稼働情報を採取したいログファイルトラップのID番号を指定します。監視名には,稼働情報を採取したいログファイルトラップの監視名を指定します。ID番号と監視名のどちらか一方を指定します。稼働情報名にlogtrapを指定して,このオプションを省略した場合は,稼働しているすべてのログファイルトラップの定義情報が採取されます。
注意事項
-
指定した稼働情報名の定義情報が存在しない場合,エラーになります。複数の稼働情報名を指定した場合は,存在する定義情報を出力します。
-
指定したID番号または監視名のログファイルトラップが存在しない場合,ログファイルトラップの定義情報は出力されません。
-
SSL定義が未設定の場合,稼働情報名にSSLを指定するとイベントサービスまたはプロセスの稼働情報を出力します。
戻り値
0 |
正常終了 |
1 |
引数エラー |
2 |
稼働情報なし |
248 |
稼働情報ファイルが壊れている |
249 |
指定した論理ホスト名が存在しない |
250 |
リロード未反映 |
251 |
他でアクセス中 |
252 |
実行権限なし |
253 |
UACエラー |
254 |
メモリー不足 |
255 |
そのほかのエラー |
出力形式
設定情報の出力形式を次に示します。定義内容の出力順序はSSL通信定義モデルファイルの記載順序に合わせています。
物理ホスト名,論理ホスト名またはイベントサービス名の稼働情報(SSL)を表示します。
<プロセス名※1> "ENABLE"※2="ENABLEラベルの指定値" "SSLPROTOCOL"※3="SSLPROTOCOLラベルの指定値" "CACERTIFICATEFILE"※3="CACERTIFICATEFILEラベルの指定値" "CERTIFICATEFILE"※3="CERTIFICATEFILEラベルの指定値" "PRIVATEKEYFILE"※3="PRIVATEKEYFILEラベルの指定値" "SSLCIPHERS"※3="SSLCIPHERSラベルの指定値" "BASESSL"※4="0"または"1"
- 注※1
-
制御するプロセス名を出力します。表示順序は次の通りです。
<jbssessionmgr>:認証サーバ
<jbsroute>:構成管理
<jcocmd>:コマンド実行
<jbsplugind>:プラグインサービス
<jbscomd>:プロセス間通信
<jevservice>:イベントサービス
- 注※2
-
常に出力されます。
- 注※3
-
ENABLEおよびBASESSLが1の場合だけ出力されます。パラメーター名が未定義の場合は,空文字が出力されます。
- 注※4
-
ENABLEが1の場合だけ出力されます。SSLが有効な場合は,dword:00000001,SSLが無効な場合は,dword:00000000が出力されます。
使用例
出力例を次に示します。