保留と保留解除の期限切れ/削除

オンライン編集

特定のデータを保留にする必要のある保留アクションあるいは進行中の アクションに応じて、特定のアーカイブ・オブジェクトの削除および期限切れを 保留することができます。 データにアクセスする必要のあるアクションが開始された場合は、そのアクションが完了して、プロセスの一部としてのデータへのアクセスが不要になるまで、そのデータを使用可能にしておく必要があります。 中断不要 (保留解除) と判別されると、通常の削除と期限切れのタイミングが、元の保存期間で再開されます。

始めに

テスト dsmRetentionEvent 呼び出しを発行して、サーバーがライセンス交付を受けていることを確認します。
  1. 保留にする 1 つのオブジェクトについて照会し、ID を取得します。
  2. dsmBeginTxn、 Hold、および dsmEndTxnを指定して dsmRetentionEvent を発行します。
  3. サーバーのライセンス交付を受けていない場合、打ち切りと断定され、理由コード DSM_RC_ABORT_LICENSE_VIOLATION を受け取ります。
制約事項:
  1. 1 つのトランザクションで、dsmRetentionEvent 呼び出しを複数回行うことはできません。
  2. 既に保留状態であるオブジェクトに対して保留を出すことはできません。

手順

  1. オブジェクトを保留するには、以下のステップを実行します。
    1. 保留状態にするすべてのオブジェクトについて、サーバーに照会します。 各オブジェクトのオブジェクト ID を取得します。
    2. dsmBeginTxn を発行し、次にオブジェクトのリストで を発行し、続いて ： dsmRetentionEvent dsmEventTypeeventHoldObj コールを発行する。 オブジェクト数が maxObjPerTxn の値を超える場合は、複数のトランザクションを使用します。
    3. dsmGetNextQObj 関数呼び出しで qryRespArchiveData 応答を使用して、オブジェクトが保留状態になっていることを確認します。 qryRespArchiveDataの objHeld の値を確認します。
  2. オブジェクトを保留状態から解放するには、以下のステップを実行します。
    1. 保留状態を解除するすべてのオブジェクトについて、サーバーに照会します。 各オブジェクトのオブジェクト ID を取得します。
    2. dsmBeginTxn を発行し、次にオブジェクトのリストで を発行し、続いて ： dsmRetentionEvent dsmEventTypeeventReleaseObj コールを発行する。 オブジェクトの数が maxObjPerTxnの値を超える場合は、複数のトランザクションを使用します。
    3. qryRespArchiveData 。 dsmGetNextQObj 関数呼び出しのレスポンスを使用して、オブジェクトが保留から解放されたかどうかを確認する。 の値をチェックする。 objHeldqryRespArchiveDataの値をチェックする。