UPDATE コマンド
アプリケーションまたはサービス・プロバイダーをインポートした後、一部のメタデータ情報がインポート先の環境のメタデータ情報と一致しない場合があります。 UPDATEコマンドを使って、このメタデータ情報をリポジトリ内で直接更新し、新しい環境のメタデータ情報と一致させる。
目的
UPDATEコマンドは、ランタイム・アプリケーションとIBM® InfoSphere® Information Server接続のメタデータ情報を更新する。 メタデータ更新操作のスコープは、エージェントのホスト名、アプリケーション名、または接続名を検索することによって決定される。 メタデータの「UPDATEコマンドを入力するごとに、「-agenthost、「-application、「-cname」のいずれかのキーを指定しなければならない。
構文
指定したアプリケーションのメタデータ情報を更新する:
ISDAdmin -action update [-user <user name>
[-password <user password>] | -authfile <file name>]
-a <application name> -s <service name> -o <operation name>
-key <key for the metadata attribute to be updated>
-subkey <job parameter argument you want to modify>
-oldvalue <old value of the attribute you want to modify>
-newvalue <new value for the attribute that you are modifying>
-dsproject <project name> -dsjob <job name> -providerUser <service provider>
指定したエージェントサーバーホストのメタデータ情報を更新します:
ISDAdmin -action update [-user <user name>
[-password <user password>] | -authfile <file name>]
-agentHost <agent host name> -providerType <DS, Db2. ORA, or Db2.F>
-providerHost <service provider server host name>
-key <key for the metadata attribute to be updated>
-subkey <job parameter argument you want to modify>
-oldvalue <old value of the attribute you want to modify>
-newvalue <new value for the attribute that you are modifying>
-dsproject <project name> -dsjob <job name> -providerUser <service provider>
指定した接続のメタデータ情報を更新する:
ISDAdmin -action update [-user <user name>
[-password <user password>] | -authfile <file name>]
-cname <connection name> -key <key for the metadata attribute to be updated>
-oldvalue <old value of the attribute you want to modify>
-newvalue <new value for the attribute that you are modifying>
アプリケーション・メタデータ・パラメーター
UPDATEコマンドは以下のパラメーターを使用する。 このコマンドを使用するには、3つのパス(アプリケーション、エージェントホスト、接続名)があります。 それぞれのパスには、異なる必須オプションとオプションがある。 メタデータ「UPDATEコマンドを入力するごとに、以下のオプションのいずれかを指定する必要がある: -agenthost 、 '-application 、または '-cname 。
| パラメーター名 (ショート・ネーム) | 説明 |
|---|---|
| -action (-act) | 必須 タイプupdate. |
| -authfile (-af) | オプション コマンド・プロンプトや'-userおよび'-passwordパラメーターで資格情報を提供する代わりに使用する、ユーザーとパスワードの資格情報を含む認証ファイル。 |
| -user (-ur) | オプション IBM InfoSphere Information ServerのユーザーID。 -authfileパラメータが使用されていない場合、ユーザーIDを入力するプロンプトが表示されます。 |
| -password (-pw) | オプション IBM InfoSphere Information Serverのパスワード。 -authfileパラメータが使用されていない場合、パスワードの入力を求めるプロンプトが表示されます。 |
| -application (-a) | オプション 特定のアプリケーションの範囲内でメタデータの更新を適用したい場合は、「-aパラメータを使用する。 メタデータを更新するアプリケーションの名前を入力します。 アプリケーション名を使用して、操作とプロバイダのメタデータ更新を修飾または制限できます。 |
| -agentHost (-ahost) | オプション 特定のエージェントの範囲内でメタデータの更新を適用したい場合は、'-ahostパラメータを使用します。 注:エージェントホストは、その値を更新する必要がある場合、キーとして使用することもできる。
エージェントサーバーのホスト名を入力します。 |
| -cname (-c) | オプション メタデータの更新をInfoSphere Information Server接続の範囲内で適用する場合は、「-cパラメータを使用します。 サービス・プロバイダとInfoSphere Information Server 間の接続に割り当てられる名前を入力します。 |
| -key (-k) | 必須 更新するキーを入力します。 たとえば、DataStage®のパスワードを更新するには、次のように入力しますDS_PASSWORD.キーが他のオプションとリンクしている場合は、キーの後にそれらのオプションのパラメータを入力する。 サポートされるキーと、他のオプションとの依存関係の詳細については、このトピックの後の表で説明する。 |
| -subkey (-sk) | オプション -subkey使用してジョブパラメータ設定を更新する。 変更したい設定の引数を入力します。 |
| -service (-s) | オプション メタデータを更新するアプリケーションのサービス名を入力します。 このパラメータは「-applicationパスの一部である。 |
| -operation (-o) | オプション メタデータを更新するサービスの操作名を入力します。 このパラメータは、「-application」と「-serviceパスの一部である。 |
| -oldvalue (-ov) | オプション メタデータ属性の更新に以下のいずれかのキー値を使用する場合は、「-oldvalue使用する:
注:このパラメータは、複数の可能な値が付加されているキーに対して特定の値を指定する必要がある場合に必要となる。 更新するキーの値が1つしかない場合、このパラメータは省略可能である。 そのため、これらのシナリオでは値を指定する必要はない。
更新する項目の既存の値を正確に入力してください。 |
| -newvalue (-nv) | 必須 更新するメタデータ属性に割り当てる新しい値を入力します。 -keyパラメータの値がパスワード (DS_PASSWORD,Db2.PASSWORD, ORA_PASSWORD,Db2.F_PASSWORD, PASSWORD など) の場合、 '-newvalueパラメータの値は encrypt コマンドで暗号化された文字列とすることができる。 |
| -providerType (-prType) | オプション 以下のサービスプロバイダのいずれかを更新する場合は、「-providerType 」を使用する必要があります:
|
| -providerUser (-pUr) | オプション サービスプロバイダのパスワードを更新する場合は、「-providerUser使用する必要があります。 サービスプロバイダーのユーザー名を入力します。 |
| -dsproject (-dsp) | オプション このパラメータは、ジョブ名が更新されるときに使用できる。 メタデータを更新するプロジェクトの名前を入力します。 注:このパラメータは、ジョブのパラメータを更新する際に、オペレーションにアタッチされている特定のプロジェクトを識別するために使用することもできます。
|
| -dsjob (-dsj) | オプション メタデータを更新するジョブの名前を入力します。 注:このパラメータを使用すると、ジョブのパラメータを更新するときに、操作にアタッチされている特定のDataStageジョブを識別できます。
|
| -providerHost (-pHost) | オプション Db2データベース名、Db2ポート、Db2ユーザーID、またはDb2パスワードを更新する場合は、'-pHostを使用しなければならない。 サービスプロバイダのホストサーバ名を入力します。 |
| -verbose (-v) | オプション 詳細な実行時出力を表示する(実行時ロギングメッセージではない)。 |
| -results (-res) | オプション すべてのランタイム出力を指定されたファイルにプリントする。 |
| -log (-l) | オプション すべてのランタイム・ロギング・メッセージを指定されたファイルにプリントする。 このオプションは '-loglevel と一緒に使う。 |
| -logerror (-error) | オプション 「エラー」および「致命的」のすべてのランタイム・ロギング・メッセージを指定されたファイルに出力します。 |
| -loginfo (-info) | オプション 「情報」、「警告」、「デバッグ」、および「トレース」のすべてのランタイム・ロギング・メッセージを指定されたファイルに出力します。 |
| -loglevel (-level) | オプション 表示するロギング・レベルを以下のいずれかに指定する:all、trace、debug、info、warn、error、fatal、off。 |
| -help (-?) | オプション このコマンドのヘルプを表示します。 |
操作キー
以下のキーの値を変更することで、操作のメタデータを更新することができる。 これらのキーは、他のパラメータとの依存関係はない。
| キー名 | 説明 |
|---|---|
| MAX_QUEUESIZE | 同時に操作キューに入れられるサービス要求の最大数。 |
| MAX_QUEUEWAIT | サービスリクエストを操作キューで待機させる最大時間。 |
| MAX_RETRIES | サービス・リクエストがサーバーに到達するまでの最大試行回数。 この設定は、リクエストを送信するASBエージェントが複数ある場合にのみ適用されます。 |
| LOAD_BALANCER | 複数のサービスプロバイダが同じオペレーションにアタッチされている場合に、サーバーにサービスリクエストを送信するために使用されるメソッド。 |
一般的なプロバイダー・キー
以下のキーの値は、共通プロバイダーのメタデータを更新するために変更することができる。 これらのキーは、他のパラメータとの依存関係はない。
| キー名 | 説明 |
|---|---|
| ACTIVATION_DELAY | サービスプロバイダが別のジョブまたはサーバー接続を開始する前に、指定された数のサービス要求(「ACTIVATION_THRESHOLD」で設定される)が操作キューになければならない時間の長さ(ミリ秒単位)。 |
| ACTIVATION_THRESHOLD | サービスプロバイダが別のジョブまたはサーバー接続を開始する前に、指定された長さ(「ACTIVATION_DELAY」で設定される)の間操作キューに存在しなければならないサービス要求の数。 操作キュー内のサービスリクエスト数のみに適用され、パイプライン内のサービスリクエスト数は含まれない。 |
| AGENT_HOST | サービス・プロバイダーと通信するエージェント・サーバーのホスト名。 |
| AGENT_PORT | サービス・プロバイダーへのアクセスに使用されるエージェント・サーバーのポート番号。 |
| MAX_ACTIVE | 同時にアクティブにできるジョブ・インスタンスまたはサーバー接続の最大数。 サービス・プロバイダーは、最大数に達した後、新しいジョブや接続を開始することはできない。 |
| MAX_IDLE | ジョブ・インスタンスまたは接続を停止するまでのアイドル状態の最大時間(秒)。 ジョブまたは接続がアイドルである時間の長さに既知の制限がある場合、最大アイドル時間を設定することができます。 |
| MAX_RUNTIME | ジョブがサービス要求の処理に使用する最大時間。 ジョブは、最大実行時間に達したときにパイプラインにあるリクエストを処理するが、 そのジョブはそれ以降のリクエストには使用できない。 |
| MIN_ACTIVE | 同時にアクティブにできるジョブ・インスタンスまたはサーバー接続の最小数。 最小数は、少なくとも1つのジョブまたはサーバー接続が常に実行されていることを意味する。 |
| MIN_IDLE | ジョブインスタンスまたは接続が停止するまでのアイドル状態の時間(秒)。 |
| REQUEST_LIMIT | ジョブ・インスタンスが同時に処理するサービス・リクエストの最大数。 この機能を持っているのは、InfoSphere DataStageなど一部のサービスプロバイダーだけである。 |
| STUCK_TIMEOUT | サービスプロバイダがエラーを返す前に操作を処理する時間の長さ(秒単位)。 |
IBM InfoSphere DataStageプロバイダー・キー
以下のキーの値を変更して、InfoSphere DataStageプロバイダのメタデータを更新できます。 これらのキーのいくつかは、依存するオプションと一緒に使わなければならない。
| キー名 | 説明 |
|---|---|
| DS_PROJECT_NAME | メタデータを更新する新しいIBM InfoSphere DataStageプロジェクトの名前。 |
| DS_JOBNAME | メタデータを更新する新しいInfoSphere DataStageジョブの名前。 |
| DS_USERID | InfoSphere Information Serverエンジンのユーザー ID。 |
| DS_PASSWORD | InfoSphere Information Serverエンジンのパスワード。 あなたのログインユーザーIDである'-providerUserと一緒に使用してください。 |
| DS_HOST | InfoSphere Information Serverエンジンのホスト名またはサーバー名。 |
| DS_PORT | InfoSphere Information Serverエンジンへのアクセスに使用するポートの番号。 |
| JOB_PARAMETER | メタデータを更新するジョブパラメータ名。 |
IBM Db2プロバイダー・キー
| キー名 | 説明 |
|---|---|
| DB2_USERID | Db2サーバーのユーザーID。 -providerHost と共に使用する。 |
| DB2_PASSWORD | Db2サーバーのパスワード。 あなたのDb2ユーザーIDである'-providerUserと共に使用する。 |
| DB2_HOST | Db2サーバーのホスト名またはサーバー名。 |
| DB2_PORT | Db2サーバーへのアクセスに使用されるポートの番号。 |
| DB2_DATABASE | Db2データベースの名前。 |
Oracleのプロバイダー・キー
以下のキーの値を変更することで、Oracleのメタデータを更新できる。
| キー名 | 説明 |
|---|---|
| ORA_USERID | OracleデータベースサーバーのユーザーID。 |
| ORA_PASSWORD | Oracleデータベースサーバーのパスワード。 あなたのOracleIDである'-providerUserと一緒に使用してください。 |
| ORA_HOST | Oracleサーバのホスト名またはサーバ名。 |
| ORA_PORT | Oracleへのアクセスに使用されるポート番号。 |
| ORA_DATABASE | Oracleデータベースの名前。 |
IBM InfoSphere Classic Federation Server for z/OSサーバー・メタデータ・キー
以下のキーの値を変更して、InfoSphere Classic Federation Server for z/OS®のメタデータを更新できます。
| キー名 | 説明 |
|---|---|
| DB2CF_USERID | InfoSphere Classic Federation Server for z/OSのユーザー ID。 |
| DB2CF_PASSWORD | InfoSphere Classic Federation Server for z/OSのパスワード。 あなたのクラシック連盟のユーザーIDである'-providerUserと一緒に使用してください。 |
| DB2CF_HOST | InfoSphere Classic Federation Server for z/OSのホスト名またはサーバー名。 |
| DB2CF_PORT | InfoSphere Classic Federation Server for z/OSサーバーへのアクセスに使用されるポート番号。 |
| DB2CF_DATABASE | InfoSphere Classic Federation Server for z/OSのデータベース名。 |
接続メタデータ・キー
以下のキーの値を変更することで、InfoSphere Information Server接続のメタデータを更新できます。
| キー名 | 説明 |
|---|---|
| USER | DataStageまたはDb2サーバーのユーザーID。 |
| PASSWORD | DataStageまたはDb2サーバーのパスワード。 あなたのプロバイダーのユーザーIDである'-providerUserと一緒に使用してください。 |
| HOSTNAME | Db2接続のみ。 Db2サーバーのホスト名またはサーバー名。 |
| PORT | DataStageまたはDb2サーバーへのアクセスに使用されるポート番号。 |
| DBNAME | Db2接続のみ。 Db2データベースの名前。 |