transform_updateユーティリティーを使用する

transform_updateユーティリティーを使用し、ジョブページカウントまたは完了したページ数について、InfoPrint Managerを更新します。

%u 変換オプションを使用すると、文書ページカウントまたはジョブのpages-completed属性を更新できる更新ファイルにアクセスできます。%uで識別されるファイルには直接アクセスしないでください。変換では、transform_updateユーティリティーだけを使用する必要があります。InfoPrint Managerは、変換の実行中とその完了直後にのみ、更新がないかをチェックします。transform_updateユーティリティーは、変換の実行中に1回または複数回呼び出すことができます。変換から戻ると、InfoPrint Managerは更新ファイルを削除します。

transform_updateユーティリティーには、以下の戻りコードがあります。

1
以下に示す、基本的な問題についての英語メッセージです。
Invalid option specified.
No option or option value specified.
No status file name specified.
Cannot open status file named ____.
Cannot read status file named ____.
0
更新が成功しました。
-1
状況ファイルの更新に失敗しました。
transform_update [-t delta_pages_transformed]
                    [-d delta_pages_delivered]
                    update_file
-t
変換された文書ファイルが最後に更新されてからの追加ページ数を指定します。InfoPrint Managerはこの情報を使用して、ジョブのjob-page-count属性を再計算します。このオプションが渡す値の合計が2,147,483,647を超えることはありません。
-d
最後に更新されてからの変換によって配信された追加ページ数を指定します。InfoPrint Managerはこの情報を使用して、ジョブのpages-completed属性を更新します。このオプションが渡す値の合計が2,147,483,647を超えることはありません。

多くの場合は、pages-completed属性は、ジョブに実際に印刷またはスタックされたページ数を示すため、変換の更新は不要です。 この属性は、InfoPrint Managerの印刷バックエンドによって、印刷されたページ数で更新されます。ここで参照されたページは、以後の処理のためにInfoPrint Managerに返されたファイルから削除されます。

update_file
%uオプションによって変換に渡すファイルです。
    注意:
  1. 変換がtransform_updateユーティリティーを複数回呼び出す場合は、各呼び出しでは、累積値ではなく、最後の呼び出し以降の変更を示す値を戻す必要があります。
  2. InfoPrint Managerがファイルを開くことも読み取ることもできない場合は、エラーがログに記録されて処理は続行されます。
  3. 変換を使用してjob-page-count属性を更新する場合は、文書のページカウントを指定してください。変換で提供されるページカウント情報は、変換された文書の単一部数のページ数にしてください。
  4. 変換がpages-completed属性を更新して印刷用にジョブを戻す場合は、実宛先が完了するページ数が、変換が完了を報告したページ数に追加されます。