Campaign Server Manager コマンド (unica_svradm)

Cap (Distributed Marketing)

Cap

Cap コマンドを使用すると、Distributed Marketing フローチャートが追加で開始されないようにしつつ、現在実行中のフローチャートを完了できるようにします。設定解除する場合は、uncap コマンドを使用します。

Changeowner

Changeowner -o <olduserid> -n <newuserid> -p <policyid>

Changeowner コマンドを使用すると、ユーザーのキャンペーン・オブジェクトの所有者を変更することができます。このコマンドは例えば、ユーザーを削除または無効にし、そのユーザーのキャンペーン・オブジェクトの所有権を新規ユーザーに再び割り当てる場合に使用できます。コマンドを実行するには、オブジェクト/フォルダーの変更権限が必要です。

接続

unica_svradm を実行するとき、コマンド・ライン・プロンプトは、接続先のリスナーのサーバーとパーティションを示します。別のリスナーに接続する場合は、connect コマンドを使用します。一度に 1 つのサーバーにしか接続できません。

次の情報は、クラスター化リスナー環境にのみ関連があります。

• クラスター化リスナー環境で unica_svradm を実行する場合、デフォルトの接続先はマスター・リスナーです。
• マスター・リスナーに接続している場合、次のコマンドは、クラスターのすべてのノードに影響します。Loglevel、 Refresh、Shutdown、 Status、 Version。例えば、Status コマンドは、クラスターのすべてのノードのステータスを表示します。
• 単一のリスナーにのみ影響を与えるには、Connect -s を使用して特定のノードに接続し、必要なコマンドを実行します。
• マスター・リスナーに接続しており、マスター・リスナーに対して Connect -s を実行する場合は、非マスター・リスナー・モードで再接続されます。これ以降のコマンドはそのノードにのみ影響を与えます。マスター・リスナー・モードに戻るには、disconnect コマンドを使用します。

切断

切断

Disconnect コマンドは、サーバーから切断します。このコマンドは、サーバーと接続されている場合のみ使用できます。

単一ノード環境では、このコマンドを使用して切断してから、connect コマンドを使用して別のサーバーに接続します。また、最初に切断する代わりに、connect に -f パラメーターを指定して実行することもできます。

終了

終了

Exit コマンドを使用すると、ユーザーは Campaign Server Manager からログアウトします。

ヘルプ

ヘルプ

Help コマンドは、使用可能なコマンドを表示します。

強制終了

Kill -p pid [-h hostname]

このコマンドを使用して、リスナーに関連付けられたランナウェイ・プロセスを終了します。Kill コマンドは、指定されたプロセス ID に対して "kill-p" を発行します。Windows NTでは、Windows NTで相当するものが発行されます。プロセス ID (PID) を取得する必要がある場合は、Status コマンドを使用します。

クラスター化リスナー環境では、以下のようになります。

• kill コマンドは、単一のリスナー・ノードにのみ影響を与えます (クラスターのすべてのノードに伝搬されることはありません)。
• 非マスター・リスナーに接続している場合、ホスト名を省略できます。コマンドは、そのノードにのみ影響を与えます。
• マスター・リスナーに接続している場合、マスター・リスナーを実行しているサーバーの名前を指定する必要があります。以下に例を示します。kill -p 1234 -h HostABC

Loglevel

Loglevel [high | low | medium | all]

リスナーのロギング・レベルを表示するには、loglevel コマンドを引数なしで入力します。

リスナーのロギング・レベルを設定するには、loglevel コマンドの後に必要なロギング・レベルを指定して入力します。All は最も詳細なレベルで、トラブルシューティング状況の場合を除き、使用しないでください。

変更は即時に有効になるため、このコマンドを入力した後にリスナーを再始動したりリフレッシュしたりする必要はありません。

終了

終了

Quit コマンドを使用すると、ユーザーは Campaign Server Manager からログアウトします。

最新表示

最新表示

Refresh コマンドは、クラスター化リスナー構成で使用します。単一ノード・リスナーの場合、このコマンドは効果がありません。

Refresh コマンドは、マスター・リスナーに構成の変更を通知し、マスター・リスナー・ノードの構成データをリフレッシュします。これにより、再起動が必要なくなり、リフレッシュ・イベントが発生したときに制御する方法を提供します。

次の状況では、Refresh コマンドを実行する必要があります。

• Campaign|unicaACListener|node[n]|serverPort を調整した後。
• Campaign|unicaACListener|node[n]|masterListenerPriority を調整した後。
• Campaign|unicaACListener|node[n]|loadBalanceWeight を調整した後。
• Campaign|unicaACListener|node[n] でリスナー・ノードを追加または削除した後。
  重要: リスナー・ノードを構成から削除する前に、各クラスター化リスナー・ノードで svrstop ユーティリティーを使用する必要があります。つまり、すべてのノードを停止して、ノードを削除してから、リフレッシュする必要があります。そうしないと、削除されるリスナーの既存のセッションが引き続き実行されますが、マスター・リスナーは削除されたリスナーにコンタクトできなくなります。これは予期しない結果をもたらすことがあります。

Refresh コマンドは、Web アプリケーション・サーバーを更新しません。ほとんどの場合、マスター・リスナーのみの更新で十分ですが、Web サーバーの再始動が必要な場合もあります。

再開

Resume {-s flowchart_name |-p pid |-a} [-h hostname]

Resume コマンドは、1 つ以上の中断状態のフローチャートの実行を再開します。

• フローチャートを名前で再開するには、-s を使用します。すべてのキャンペーンとセッション内のこの名前を持つフローチャートが、すべて影響を受けます。このため、フローチャートの名前を指定するときは、相対フローチャート・パスを使用するのが良いでしょう。
• 指定されたプロセス ID を再開するには -p を使用します。(PID を取得するには、Status コマンドを使用します。)
• 中断されているすべてのフローチャートを再開するには -a を使用します。

単一ノード (非クラスター化) リスナー環境では、ホスト名を省略できます。

クラスター化リスナー環境では、マスター・リスナーに接続している場合は、リスナーのホスト名が必要です。以下に例を示します。Resume -a -h Hostname。非マスター・リスナーに接続している場合、ホスト名を省略できます。

実行

Run -p relative-path-from-partition-root -u MarketingPlatform_user_name [-h partition] [-c catalogFile] [-s] [-m]

Run コマンドは、フローチャート・ファイルを開いて実行します。 その際、相対フローチャート・パスおよびファイル名、パーティション、カタログ・ファイル、およびユーザー名を指定します。

以下の構文を使用します。

[-S dataSource -U db_User -P db_Password]*

Run コマンドには、次のオプションがあります。

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
		                      <UserVariables>
	                        	 <UserVar Name="UVAcctType">
									 <Values>
										 <Option>Gold<Option>
	                    			</Values> 
	                             </UserVar>
	                          </UserVariables>

保存

Save {-s flowchart_name|-p pid|-a}-h hostname

Save コマンドは、アクティブ・フローチャートの現在の状態を保存します。クラスター化リスナー環境では -h hostname は必須で、それ以外の場合は無視できます。

設定

Set [variable[=value]]

Set コマンドは、環境変数を表示および設定します。現在の値を表示する場合は値を省略し、特定の変数を設定する場合は値を指定します。

シャットダウン

Shutdown [-f]

Shutdown コマンドは、リスナーをシャットダウンします。

システムは、実行されているフローチャートがないか検査します。実行されているフローチャートが見つかった場合、シャットダウンの確認を求める警告メッセージが表示されます。

To override and force shutdown, use -f.

状態

Status [-d |-i] [-u] [-v | -c]]

status コマンドは、アクティブ、中断状態、および Distributed Marketing のフローチャートに関する情報を提供します。情報には、フローチャートの所有者 (ユーザー名)、プロセスのステータス、プロセス ID、ポート、フローチャート名、ファイル名などの詳細が含まれます。切断されたプロセスや、孤立したプロセスを特定するには、このコマンドを使用します。また、PID を引数として受け入れるコマンドで指定するプロセス ID を取得する場合も、このコマンドを使用します。

Status コマンドは、プロセスを次のように識別します。

• c - 接続 (クライアントは、リスナー・プロセスに接続されています。 クライアントは実行されている場合とそうでない場合があります。)
• d - 切断 (クライアントは閉じていますが、フローチャートはバックグラウンドで実行されています。)
• o - 孤立 (クライアントはフローチャートに接続されておらず、バックグラウンドでも実行されていません。このプロセスは既に存在せず、リスナーに再接続できません。 ユーザーがそれにログインできるよう、強制終了する必要があります。)

停止

Stop [-f] {-s flowchart_name |-p pid |-a} [-h hostname]

Stop コマンドは、指定されたフローチャートについて、アクティブ・クライアントの有無を検査し、存在する場合は警告を出して (これは -f 強制オプションでオーバーライドできます)、IBM サーバー・プロセスを停止します。

単一ノード (非クラスター化) リスナー環境では、ホスト名を省略できます。

クラスター化リスナー環境では、マスター・リスナーに接続している場合は、リスナーのホスト名が必要です。以下に例を示します。Stop -a -h Hostname。非マスター・リスナーに接続している場合、ホスト名を省略できます。

中断

Suspend [-f] {-s flowchart_name | -p pid |-a} [-h hostname]

Suspend コマンドを使用すると、実行中のフローチャートを「静止」し、対応するコマンド Resume を使って後で再始動するために状態を保存します。システムは、現在実行されているプロセスの実行すべてを終了し、その後にプロセスが開始されないようにします。現在出力プロセスを実行しているフローチャートはデータ・エクスポート・アクティビティーを完了します。それからフローチャートは中断状態で保存され、中断されているフローチャートのリストに書き込まれます。これにより、失われる作業量が可能な限り少なくなり、出力ファイルのデータ保全性が保持されます。

フローチャートを即時に停止する必要がある場合、Save コマンドに続いて、Stop を発行します。

Uncap (Distributed Marketing)

Uncap

Uncap コマンドは、Cap (Distributed Marketing) コマンドを取り消します。

バージョン

バージョン

このコマンドは、リスナー・プロセス (unica_aclsnr) と Campaign Server Manager (unica_svradm) のバージョンを表示します。このコマンドを使用すると、バージョン不一致エラーのトラブルシューティングに役立ちます。例えば、クラスターとして動作する複数のリスナー・ノードがある場合、各リスナー・ノードが同じバージョンのソフトウェアを実行している必要があります。