7.1.1　ワークグループ情報を収集するためのワークグループファイルの設定

(a)　パラメーター指定の書式

パラメーターを指定する際の書式について説明します。

パラメーターの書式は次のようになります。

 workgroup=ワークグループ名
［users=UNIXユーザー名］    または  ［users_02=UNIXユーザー名］
［groups=UNIXグループ名］   または  ［groups_02=UNIXグループ名］
［programs=プログラム名］    または  ［programs_02=プログラム名］
［arguments_02=監視プログラムの引数］
［regexp=監視条件］

注意

• 各ファイルパラメーターの終端は改行です。

• workgroupパラメーターは，必ず先頭に指定してください。それ以外のパラメーターの順序は任意です。

• [ ]で囲まれているパラメーターは省略できます。ただし，workgroupパラメーターのほかに1つ以上のパラメーターを指定する必要があります。

• 各パラメーターの大文字小文字は区別しません。

• 「=」の前後に空白文字やタブ文字を挿入しないでください。

• 1つのパラメーターが複数行にわたる場合，行の末尾にコンマ「,」を記述してください。

• コメント行を挿入する場合は，行の先頭に「#」を記述してください。

• パラメーターの指定に正規表現を使用できます。正規表現については，各OSのマニュアルを参照してください。また，正規表現を使った指定例については，「(3)　ワークグループファイルの指定例」を参照してください。

• workgroup以外のパラメーターでは，複数の指定値を設定できます。各指定値は区切り文字を使って区切ります。区切り文字は，通常コンマや空白文字を使いますが，arguments_02，groups_02，programs_02，およびusers_02の各パラメーターで，指定値の先頭に「"」を指定して監視対象を指定する場合だけ，区切り文字として「",」を，終端文字として「"\n（改行）」を使用します。詳細は「パラメーターの詳細」を参照してください。

• arguments_02，groups_02，programs_02，およびusers_02のパラメーターで，指定値の先頭に「"」を指定して監視対象を指定する場合，対になる区切り文字が存在しないときは，文字列の範囲指定ができないため監視対象として認識されません。

• arguments_02，groups_02，programs_02，およびusers_02の各パラメーターで，指定値の先頭に「"」を指定して監視対象を指定する場合，対になる区切り文字との間に単独で存在する「"」は無視されます。「"」を監視対象に含みたい場合は「""」と記述してください。

• arguments_02，groups_02，programs_02，およびusers_02の各パラメーターでは，指定値の先頭に「"」を指定して監視対象を指定する指定法と指定値の先頭に「"」を指定しない指定値を混在させることもできます。

• 末尾がスペースのコマンドラインを監視するときは，regexpパラメーターを使ってください。

指定例

監視対象とするコマンドライン	ワークグループの指定方法
"command1△arg1△arg2△arg3"	arguments_02="command1△arg1△arg2△arg3"
"command1△arg1△arg2△arg3△"	regexp={arguments_02="command1△arg1△arg2△arg3△"}
"command1△arg1△arg2△arg3△△・・・"	regexp={arguments_02="command1△arg1△arg2△arg3*"}

注：△は半角スペースを表します。

(b)　パラメーターの詳細

各パラメーターについて説明します。パラメーターの設定例は「(3)　ワークグループファイルの指定例」を参照してください。

workgroup=ワークグループ名

監視するワークグループの名前を英数字で指定します。名前に使用できる文字列の上限は改行文字を含めて2,037バイトです。ただし，Storeデータベースに記録されるのは29バイトまでです。同じワークグループ名を複数指定した場合，あとに指定された条件（行番号が大きい方のワークグループ条件）が有効となります。

ワークグループ名は，必ず指定してください。

users=UNIXユーザー名

ワークグループとして情報を収集するUNIXユーザーを名前で指定します。改行文字を含めて2,041バイト以内の半角英数字で指定します。ただし，Storeデータベースに記録されるのは29バイトまでで，最後の文字は「>」となります。

複数のUNIXユーザー名を指定する場合，それぞれの名前を1つ以上のコンマまたは空白文字で区切ってください。指定したすべてのユーザーが監視対象になります。

ここで指定した値は，Workgroup Summary（PI_WGRP）レコードのUsers（USERS）フィールドに表示されます。

ここには，Process Detail（PD）レコードのReal User（REAL_USER_NAME）フィールドに格納される値を指定します。

users_02=UNIXユーザー名

ワークグループとして情報を収集するUNIXユーザーを名前で指定します。このパラメーターはusersパラメーターを拡張して指定するためのものです。

指定値の先頭に「"」を付けた場合，次の区切り文字（「",」または「"\n（改行）」）までが指定値と認識されます。例えば，usersパラメーターでの区切り文字である空白文字やコンマも指定値に含めることができます。「"」を付けない場合は，usersパラメーターと同じ動作をします。拡張した指定方法を使用した場合，「",」はパラメーターの区切り文字，「"\n（改行）」はパラメーターの終端文字として扱われます。拡張した指定方法で「"」文字を指定値にする場合は，「""」と入力してください。改行文字を含めて2,038バイト以内の半角英数字で指定します。ただし，Storeデータベースに記録されるのは29バイトまでで，最後の文字は「>」となります。

ここで指定した値は，Workgroup Summary（PI_WGRP）レコードのUsers（USERS）フィールドに表示されます。

ここには，Process Detail（PD）レコードのReal User（REAL_USER_NAME）フィールドに格納される値を指定します。

groups=UNIXグループ名

ワークグループとして情報を収集するUNIXグループ名を，名前で指定します。改行文字を含めて2,040バイト以内の半角英数字で指定します。ただし，Storeデータベースに記録されるのは29バイトまでで，最後の文字は「>」となります。

複数のUNIXグループ名を指定する場合，それぞれの名前を1つ以上のコンマまたは空白文字で区切ってください。指定したすべてのグループが監視対象になります。

ここで指定した値は，Workgroup Summary（PI_WGRP）レコードのGroups（GROUPS）フィールドに表示されます。

ここには，Process Detail（PD）レコードのReal Group（REAL_GROUP_NAME）フィールドに格納される値を指定します。

groups_02=UNIXグループ名

ワークグループとして情報を収集するUNIXグループ名を，名前で指定します。このパラメーターはgroupsパラメーターを拡張して指定するためのものです。

指定値の先頭に「"」を付けた場合，次の区切り文字（「",」または「"\n（改行）」）までが指定値と認識されます。例えば，groupsパラメーターでの区切り文字である空白文字やコンマも指定値に含めることができます。「"」を付けない場合は，groupsパラメーターと同じ動作をします。拡張した指定方法を使用した場合，「",」はパラメーターの区切り文字，「"\n（改行）」はパラメーターの終端文字として扱われます。拡張した指定方法で「"」文字を指定値にする場合は，「""」と入力してください。改行文字を含めて2,037バイト以内の半角英数字で指定します。ただし，Storeデータベースに記録されるのは29バイトまでで，最後の文字は「>」となります。

ここで指定した値は，Workgroup Summary（PI_WGRP）レコードのGroups（GROUPS）フィールドに表示されます。

ここには，Process Detail（PD）レコードのReal Group（REAL_GROUP_NAME）フィールドに格納される値を指定します。

programs=プログラム名

ワークグループとして情報を収集する，プロセスによって実行されているプログラム名を指定します。改行文字を含めて2,038バイト以内の半角英数字で指定します。ただし，Storeデータベースに記録されるのは29バイトまでで，最後の文字は「>」となります。

複数のプログラム名を指定する場合，それぞれの名前を1つ以上のコンマまたは空白文字で区切ってください。指定したすべてのプログラムが監視対象になります。

ここで指定した値は，Workgroup Summary（PI_WGRP）レコードのPrograms（PROGRAMS）フィールドに表示されます。

ここには，Process Detail（PD）レコードのProgram（PROGRAM_NAME）フィールドに格納される値を指定します。

programs_02=プログラム名

ワークグループとして情報を収集する，プロセスによって実行されているプログラム名を指定します。このパラメーターはprogramsパラメーターを拡張して指定するためのものです。

指定値の先頭に「"」を付けた場合，次の区切り文字（「",」または「"\n（改行）」）までが指定値と認識されます。例えば，programsパラメーターでの区切り文字である空白文字やコンマも指定値に含めることができます。「"」を付けない場合は，programsパラメーターと同じ動作をします。拡張した指定方法を使用した場合，「",」はパラメーターの区切り文字，「"\n（改行）」はパラメーターの終端文字として扱われます。拡張した指定方法で「"」文字を指定値にする場合は，「""」と入力してください。改行文字を含めて2,035バイト以内の半角英数字で指定します。ただし，Storeデータベースに記録されるのは29バイトまでで，最後の文字は「>」となります。

ここで指定した値は，Workgroup Summary（PI_WGRP）レコードのPrograms（PROGRAMS）フィールドに表示されます。

ここには，Process Detail（PD）レコードのProgram（PROGRAM_NAME）フィールドに格納される値を指定します。

arguments_02=監視プログラムの引数

このワークグループの一部として監視するプログラムの引数を指定します。改行文字を含めて2,034バイト以内の半角英数字で指定します。ただし，Storeデータベースに記録されるのは29バイトまでで，最後の文字は「>」となります。複数の引数を指定する場合，それぞれの引数を1つ以上のコンマまたは空白文字で区切ってください。指定したすべての引数が監視対象となります。

また，このパラメーターは拡張して指定することもできます。指定値の先頭に「"」を付けた場合，次の区切り文字（「",」または「"\n（改行）」）までが指定値と認識されます。例えば，区切り文字である空白文字やコンマも指定値に含めることができます。

指定値の先頭に「"」を付けない場合，通常のパラメーターと同じ動作をします。拡張した指定方法を使用した場合，「",」はパラメーターの区切り文字，「"\n（改行）」はパラメーターの終端文字として扱われます。拡張した指定方法で「"」文字を指定値にする場合は，「""」と入力してください。

ここで指定した値は，Workgroup Summary（PI_WGRP）レコードのArgument Lists（PI_ARGUMENT_LISTS）フィールドに表示されます。ここには，Process Detail（PD）レコードのArgument List（ARGUMENT_LIST）フィールドに格納される値を指定します。

regexp=監視条件

このワークグループの一部として監視するプロセスを，arguments_02，groups，groups_02，programs，programs_02，users，およびusers_02の条件を使って指定します。指定する際に，正規表現を使用できます。この条件は部分一致でプロセス監視をします。

複数の式を指定した場合は，ORステートメント（論理和）と見なされます。

改行文字を含めて2,040バイト以内の半角英数字で指定します。ただし，arguments_02，groups，groups_02，programs，programs_02，users，およびusers_02の各条件式に30バイト以上の文字を指定した場合，Storeデータベースに記録されるのはそれぞれ29バイトまでで，最後の文字は「>」となります。

拡張正規表現については，各OSのマニュアルを参照してください。

POSIX（Portable Operating System Interface for UNIX）でも指定できます。サフィックス「/i」を使用すると，大文字と小文字を区別しないで定義情報をWorkgroup Summary (PI_WGRP)レコードに格納します。

指定例は「(3)　ワークグループファイルの指定例」を参照してください。