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