UPDATE コマンド

アプリケーションまたはサービス・プロバイダーをインポートした後、一部のメタデータ情報がインポート先の環境のメタデータ情報と一致しない場合があります。 UPDATEコマンドを使って、このメタデータ情報をリポジトリ内で直接更新し、新しい環境のメタデータ情報と一致させる。

制限事項一度に更新できるメタデータ属性は1つだけです。 複数のメタデータ属性を更新する必要がある場合は、メタデータ属性ごとに別の「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

表 1. アプリケーション・メタデータのパラメータ
パラメーター名 (ショート・ネーム) 説明
-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使用する:

  • DS_USERID
  • DS_JOBNAME
  • ds_project_name
  • DB2_HOST
  • DB2_DATABASE
  • DB2_PORT
  • DB2_USERID
注:このパラメータは、複数の可能な値が付加されているキーに対して特定の値を指定する必要がある場合に必要となる。 更新するキーの値が1つしかない場合、このパラメータは省略可能である。 そのため、これらのシナリオでは値を指定する必要はない。

更新する項目の既存の値を正確に入力してください。

-newvalue (-nv) 必須

更新するメタデータ属性に割り当てる新しい値を入力します。 -keyパラメータの値がパスワード (DS_PASSWORD,Db2.PASSWORD, ORA_PASSWORD,Db2.F_PASSWORD, PASSWORD など) の場合、 '-newvalueパラメータの値は encrypt コマンドで暗号化された文字列とすることができる。

-providerType (-prType) オプション
以下のサービスプロバイダのいずれかを更新する場合は、「-providerType 」を使用する必要があります:
  • DataStage,の場合は、次のように入力しますDS
  • Db2®の場合は、次のように入力しますDb2
  • Oracleの場合は、次のように入力しますORA
  • Classic Federation Serverの場合は、次のように入力しますDB2CF
-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 (-?) オプション

このコマンドのヘルプを表示します。

操作キー

以下のキーの値を変更することで、操作のメタデータを更新することができる。 これらのキーは、他のパラメータとの依存関係はない。

表 2. オペレーション・メタデータのキー
キー名 説明
MAX_QUEUESIZE 同時に操作キューに入れられるサービス要求の最大数。
MAX_QUEUEWAIT サービスリクエストを操作キューで待機させる最大時間。
MAX_RETRIES サービス・リクエストがサーバーに到達するまでの最大試行回数。 この設定は、リクエストを送信するASBエージェントが複数ある場合にのみ適用されます。
LOAD_BALANCER 複数のサービスプロバイダが同じオペレーションにアタッチされている場合に、サーバーにサービスリクエストを送信するために使用されるメソッド。

一般的なプロバイダー・キー

以下のキーの値は、共通プロバイダーのメタデータを更新するために変更することができる。 これらのキーは、他のパラメータとの依存関係はない。

表 3. 一般的なプロバイダーのキー
キー名 説明
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プロバイダのメタデータを更新できます。 これらのキーのいくつかは、依存するオプションと一緒に使わなければならない。

表4. 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プロバイダのメタデータを更新することができる。 これらのキーのいくつかは、依存するオプションと一緒に使わなければならない。
制限事項 UPDATEコマンドは、Db2が単一インストールされているコンピューターでのみ使用できる。
表5. IBM Db2サーバー・プロバイダ・キー
キー名 説明
DB2_USERID Db2サーバーのユーザーID。 -providerHost と共に使用する。
DB2_PASSWORD Db2サーバーのパスワード。

あなたのDb2ユーザーIDである'-providerUserと共に使用する。

DB2_HOST Db2サーバーのホスト名またはサーバー名。
DB2_PORT Db2サーバーへのアクセスに使用されるポートの番号。
DB2_DATABASE Db2データベースの名前。

Oracleのプロバイダー・キー

以下のキーの値を変更することで、Oracleのメタデータを更新できる。

制限事項 UPDATEコマンドは、Oracleが1つだけインストールされているコンピュータでのみ使用できます。
表6. 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®のメタデータを更新できます。

表7. 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接続のメタデータを更新できます。

表8. 接続メタデータのキー
キー名 説明
USER DataStageまたはDb2サーバーのユーザーID。
PASSWORD DataStageまたはDb2サーバーのパスワード。

あなたのプロバイダーのユーザーIDである'-providerUserと一緒に使用してください。

HOSTNAME Db2接続のみ。

Db2サーバーのホスト名またはサーバー名。

PORT DataStageまたはDb2サーバーへのアクセスに使用されるポート番号。
DBNAME Db2接続のみ。

Db2データベースの名前。