[AIX Solaris HP-UX Linux Windows][z/OS]

Intelligent Management: ランタイム操作ユーザー設定管理用タスク

Jacl および Jython スクリプト言語を使用して、wsadmin ツールを使用した設定の複製作成、設定、 および取得を行うことができます。UserPreferences グループでコマンドおよびパラメーターを使用します。

ユーザー設定は、各リソース・タイプのセル・コンテキストの下、または、コンテキスト内に保管されています。以下のリスト は、セル・レベルおよび各リソース・レベルでの例を示したものです。
  • cells/myCell/preferences/User_1/preferenceset.xml
  • cells/myCell/applications/TestAppA.ear/preferences/User_1/preferenceset.xml
  • cells/myCell/nodes/myNode/servers/myServer/preferences/User_1/preferenceset.xml
  • cells/myCell/clusters/myCluster/preferences/User_1/preferenceset.xml
  • cells/myCell/serviceclasses/Platinum/preferences/User_1/preferenceset.xml
ランタイム操作の設定に関する処理は、 以下のコマンドを使用します。

例えば、Jython を使用して設定オブジェクトと対話するには、Jython 設定オブジェクト・コマンドを参照してください。

clonePreference

clonePreference コマンドは、 あるユーザーまたはロールから他のユーザーまたはロールに設定をコピーします。

ターゲット・オブジェクト

親の configID

必須パラメーター

-name 複製する設定の名前を指定します。(ストリング、必須)

オプション・パラメーター

  • -scope: 設定の複製が作成されるときに保存する設定のスコープを指定します。スコープを指定しない場合は、configID のスコープが使用されます。(ストリング、オプション) スコープは以下の値から 1 つ選択できます。
    • Applications
    • Servers
    • Clusters
    • ServiceClasses
  • -touser: 設定を取得するユーザーを指定します。この値を指示しない場合、 デフォルトで、コマンドが実行されているセッションのユーザー ID が使用されます。(ストリング、オプション)
  • -torole: 設定を取得するロールを指定します。-touser パラメーターを指定した場合、この値は無視されます。(ストリング、オプション)
  • -fromuser: 設定のコピーを取得するユーザーを指定します。1 つのリスト内に複数のユーザー名を入れることによって、複数のユーザーを指示することができます。 例えば、user1,user2,user3 のようにします。リスト内にはスペースを入れないでください。(ストリング、オプション)
  • -fromrole: 設定のコピーを取得するロールを指定します。(ストリング、オプション)

バッチ・モードの使用例

  • Jython を使用:
    cellid= AdminConfig.getid("/Cell:myCell")
    AdminTask.clonePreference(cellid, '[-name ChartGroups -fromuser user1 -touser user2,user3,user4,user5]')
    AdminConfig.save()
  • Jacl を使用:
    $AdminTask clonePreference cells/dabtcCell02|cell.xml#Cell_1 {-name ChartGroups -fromuser user1 -touser user2,user3,user4,user5}

対話モードの使用例

  • Jython の使用:
    AdminTask.clonePreference('[-interactive]')
  • Jacl を使用:
    $AdminTask clonePreference {-interactive}

getPreferences

getPreferences コマンドは、ロールまたはユーザー名で 引き渡すことによって指定する設定文書に基づいて、設定のコレクションを返します。特定のユーザーまたはユーザー・ロールの設定を取得するには、 管理者特権を持っている必要があります。

ターゲット・オブジェクト

親の configID

必須パラメーター

  • -name: 設定の名前を指定します。(ストリング、必須)

オプション・パラメーター

  • -scope: 設定のスコープを指定します。 以下の有効値のいずれかから選択できます。
    • Applications
    • Servers
    • Clusters
    • ServiceClasses
    デフォルトのスコープは空、つまり未定義です。スコープが空の場合、スコープは文書が読み取られる場所から 派生します。例えば、文書がセル・スコープ内にある場合、スコープはセル・スコープです。文書が特定のサーバー・コンテキストにある場合、 スコープは、そのサーバーに適用されるとみなされます。(ストリング、オプション)
  • -user: 設定を取得するユーザー名を指定します。ユーザーを指示しない場合、デフォルトで、スクリプトを実行しているユーザー名を使用します。(ストリング、オプション)
  • -role: 設定を取得するユーザー・ロールを指定します。(ストリング、オプション)

戻り値

コマンドは、設定が格納された DescriptivePropertyGroup オブジェクトを返します。設定が見つからなかった場合、ヌルを返します。

バッチ・モードの使用例

  • Jython ストリングを使用:
    cellid= AdminConfig.getid("/Cell:myCell")
    AdminTask.getPreferences(cellid, '[-name ChartGroups -user user1]')
  • Jacl を使用:
    $AdminTask getPreferences cells/dabtcCell02|cell.xml#Cell_1 {-name Reports -user user1}

対話モードの使用例

  • Jython ストリングを使用:
    AdminTask.getPreferences('[-interactive]')
  • Jacl を使用:
    $AdminTask getPreferences {-interactive}

setPreference

setPreference コマンドは、設定文書内の 特定の設定を設定します。特定のユーザーまたはユーザー・ロールの設定を設定するには、 管理者特権を持っている必要があります。

ターゲット・オブジェクト

親の configID

必須パラメーター

  • -name: 設定の名前を指定します。(ストリング、必須)
  • -propertyLongName: プロパティー・グループ内のプロパティーへの完全修飾パスをスラッシュ (/) 文字で区切って指定します。 プロパティーがルート・プロパティー・グループ内に直接格納されている場合、プロパティーのショート・ネームはロング・ネームと完全に等しいので、 ショート・ネームを使用できます。(ストリング、必須)
  • -propertyValue: 設定に対して設定する新しい値を指定します。(ストリング、必須)

オプション・パラメーター

  • -scope: 設定の複製が作成されるときに保存する設定のスコープを指定します。スコープを指定しない場合は、configID のスコープが使用されます。(ストリング、オプション) スコープは以下の値から 1 つ選択できます。
    • Applications
    • Servers
    • Clusters
    • ServiceClasses
  • -user: 設定を保存するユーザーを指定します。ユーザーを指示しない場合、デフォルトで、スクリプトを実行しているユーザー名を使用します。(ストリング、オプション)
  • -role: 設定を保存するユーザー・ロールを指定します。(ストリング、オプション)

バッチ・モードの使用例

  • Jython ストリングを使用:
    AdminTask.setPreference(cellid, '[-name myChartGroup -propertyLongName defaultChartSize -propertyValue large]')
  • Jacl の使用:
    $AdminTask setPreference cells/dabtcCell02|cell.xml#Cell_1 {-name Reports -user user1 -propertyLongName defaultChartSize -propertyValue large}

対話モードの使用例

  • Jython ストリングを使用:
    AdminTask.setPreference('[-interactive]')
  • Jacl を使用:
    $AdminTask setPreference {-interactive}

Jython 設定オブジェクト・コマンド

Jython コマンドを使用して、設定オブジェクトと対話するには、 以下の例を使用します。

ユーザーごとの設定をリストするには、以下のようにします。

prefSets = AdminConfig.list("PreferenceSet")
print prefSets

ユーザーの設定を削除するには、以下のようにします。

prefid = AdminConfig.getid("/PreferenceSet:User_1")
AdminConfig.remove(prefid)
AdminConfig.save()

すべてのユーザーの設定を、ユーザーをグループ化してリストするには、以下のようにします。

prefs = AdminConfig.list("Preferences")
print prefs

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwve_xadmuserprefs
ファイル名:rwve_xadmuserprefs.html