rtsput
形式
〔rtsput -u{sys|srv|svc|obj} 〔-s サーバ名〕〔-v サービス名〕 〔-o 取得対象名1〕〔-b 取得対象名2〕 〔-e 項目ID〔,項目ID〕...〕 〔-f リアルタイム取得項目定義ファイル名〕〕
機能
リアルタイム統計情報サービスで統計情報を取得する対象と項目を指定します。
オプション
●-u {sys|srv|svc|obj}
取得するリアルタイム統計情報の取得対象種別を指定します。
- sys
-
システム全体の統計情報を取得します。
sysを指定した場合,リアルタイム統計情報サービス定義で指定したrts_service_maxオペランドの値は消費しません。
- srv
-
指定したサーバの統計情報を取得します。
-sオプションにユーザサーバ名を指定した場合,次に示す統計情報を取得します。
-
サーバ単位での統計情報
-
指定したユーザサーバのユーザサービス定義のserviceオペランドに定義されているすべてのサービスの統計情報
-
サービス以外の処理の統計情報
このため,取得対象の数は,serviceオペランドに指定したサービスの数に2を加えたものになります。
システムサーバやSUPなどの,サービスを持たないサーバ名を指定した場合は,サーバ単位の統計情報だけを取得します。
-
- svc
-
指定したユーザサーバのサービス単位で統計情報を取得します。
- obj
-
-oオプションと-bオプションを組み合わせて,統計情報の取得対象オブジェクトを指定します。取得対象オブジェクトとオプションの組み合わせについては,-oオプションおよび-bオプションの説明を参照してください。
●-s サーバ名
〜〈1〜8文字で先頭が英字の英数字〉
統計情報を取得するサーバの名称を指定します。
-uオプションにsrvまたはsvcを指定した場合,必ず-sオプションを指定してください。-uオプションにsysまたはobjを指定した場合,-sオプションは指定できません。
●-v サービス名
〜〈1〜31文字の識別子〉
統計情報を取得するサービスの名称を指定します。
-sオプションで指定したサーバの指定したサービスの統計情報を取得します。
-uオプションにsvcを指定した場合,必ず-vオプションを指定してください。-uオプションにsys,srv,またはobjを指定した場合,-vオプションは指定できません。
●-o 取得対象名1
〜〈1〜8文字の文字列〉
●-b 取得対象名2
〜〈1〜63文字の文字列〉
-uオプションにobjを指定した場合に,リアルタイム統計情報を取得する取得対象オブジェクト名を指定します。
-oオプションおよび-bオプションで指定できる取得対象オブジェクトを次の表に示します。-uオプションにobjを指定した場合は,必ず次の表に従って指定してください。
-oオプションの指定値 |
-bオプションの指定値 |
指定できる取得対象オブジェクト |
---|---|---|
ポート番号※ |
IPアドレス※ |
指定したサービス情報の参照先ノード |
論理端末名 |
指定を省略 |
指定した論理端末 |
指定を省略 |
サービスグループ名 |
指定したサービスグループ |
-uオプションにsys,srv,またはsvcを指定した場合,-oオプションおよび-bオプションは指定できません。
●-e 項目ID
〜〈符号なし整数〉((1000〜9999))
統計情報を取得する項目の項目IDを指定します。
項目IDについては,マニュアル「OpenTP1 運用と操作」を参照してください。
●-f リアルタイム取得項目定義ファイル名
〜〈1〜8文字の識別子〉
取得する統計情報の項目を定義したリアルタイム取得項目定義ファイルを指定します。
注意事項
-
-uオプションにsrvを,-sオプションにユーザサーバ名を指定した場合,指定されたサーバのユーザサービス定義ファイルを解析してサービス名を取得します。-sオプションにユーザサーバ名を指定する場合は,必ず対応するユーザサービス定義ファイルを準備してください。
-
rtsput定義コマンドで指定できる統計情報の取得対象は,リアルタイム統計情報サービス定義のrts_service_maxオペランドに指定した数までです。また,一つの取得対象で取得できるイベントの数は,リアルタイム統計情報サービス定義のrts_item_maxオペランドに指定した数までです。
-
-fオプションおよび-eオプションの指定を省略した場合,統計情報を取得するための領域を確保します。ただし,取得する統計情報は任意区間でのユーザサーバ実行時間の情報だけです。
-
rtsput定義コマンドは,同じサービスやサーバに対して重複して指定できます。重複して指定した場合,リアルタイム統計情報サービスは,各定義で指定した取得項目をマージして取得します。rtsput定義コマンドおよびリアルタイム取得項目定義ファイルの指定例を表3-16に,表3-16のとおりに指定した場合のリアルタイム統計情報サービスで取得する項目を表3-17に示します。
rtsput定義コマンドの定義例の詳細については,「8.2 リアルタイム統計情報の取得項目の定義例」を参照してください。
表3‒16 rtsput定義コマンドおよびリアルタイム取得項目定義ファイルの指定例 rtsput定義コマンドの指定
定義ファイルで指定した取得項目
rtsput -u srv -s SERVER_A -f 定義ファイル1
項目A,項目C
rtsput -u svc -s SERVER_A -v SERVICE_B -f 定義ファイル2
項目B
rtsput -u svc -s SERVER_A -v SERVICE_C -f 定義ファイル3
項目A,項目D
表3‒17 リアルタイム統計情報サービスで取得する項目 サーバ名
サービス名
項目A
項目B
項目C
項目D
SRVER_A
サービス全体
○
×
○
×
サービス外
○
×
○
×
SRVICE_A
○
×
○
×
SRVICE_B
○
○
○
×
SRVICE_C
○
×
○
○
- (凡例)
-
○:取得します。
×:取得しません。
-
-uオプションにsvcを指定した場合,-sオプションに指定したサーバ名や,-vオプションに指定したサービス名が存在するかのチェックは行いません。また,-uオプションにobjを指定した場合,-oオプションや-bオプションに指定した値が妥当であるかどうかのチェックは行いません。不要な取得対象を登録した場合は,rtslsコマンドを実行して取得対象の構成を確認し,-dオプションを指定したrtsstatsコマンドを実行して削除してください。
-
リアルタイム統計情報サービスの開始後にユーザサービス定義に追加または削除したサービスは,rtsput定義コマンドの-uオプションにsrvを指定している場合でも,リアルタイム統計情報の取得対象に反映されません。リアルタイム統計情報サービスの開始後に取得対象の設定を変更するには,rtsstatsコマンドを使用するか,またはリアルタイム統計情報サービス(RTSSUP)を再起動してください。
また,リアルタイム統計情報サービスの開始後に,サービス関数動的ローディング機能で追加または削除したサービスも,リアルタイム統計情報の取得対象に反映されません。リアルタイム統計情報サービスの開始後に取得対象の設定を変更するには,rtsstatsコマンドを使用するか,またはリアルタイム統計情報サービス(RTSSUP)を再起動してください。