# 要求受付履歴削除コマンド

要求受付履歴は、送信要求、再送要求などの要求受付ごとに1件のデータが蓄積されます。不要になったデータは定期的に削除してください。

## プログラムインターフェイス

    CALL ライブラリー名/UTLOBSRM PARM(['LIB=ライブラリー名'] 'S=service|A'
       {['FROM=DATE1'] ['TO=DATE2'] ['I']|
       ['DAY=day']|['LASTWEEK']|['LASTMONTH']}
       ['G'] ['OUTPUT=filename'] ['EXIT' CL変数名])

## パラメーター説明

LIB=ライブラリー名

  HULFTがインストールされているライブラリー名（省略時値 HULFT）

  先頭英字の10バイト以内の英数字で指定します。

S=service|A

  削除対象のサービス名（省略不可）

  8バイト以内の英数字で指定します。

  S=service

    : 指定したサービス名

  A

    : すべてのサービス名

  パラメーター「I」を指定した場合のみ省略することができます（パラメーター「I」と同時には指定できません）。

  サービス名に関する詳細は、以下を参照してください。

  HULFT10 for IBMi アドミニストレーション マニュアル : 要求受付定義の設定について

FROM=DATE1 TO=DATE2

  削除対象の日付（省略可）

  8バイトの数字で指定します。

  「FROM=」を省略した場合、「TO=」で指定した日付までのすべての日付が対象となります。

  「TO=」を省略した場合、「FROM=」で指定した日付以降のすべての日付が対象となります。

  どちらも省略した場合はすべての日付が対象となります。日付はシステム動作環境設定の日付形式（DATEFMT）に設定した形式で、「DATE1<=DATE2」の範囲で指定する必要があります。

  指定した“DATE1”、“DATE2”も削除の対象に含まれます。

I

  対話形式（省略可）

  表示されるメッセージにしたがって、サービス名と日付の範囲を入力してください。

DAY=day

  削除対象外とする日数（省略可）

  “1”から“366”までの間で指定します。

  現日付より過去の指定日数分の履歴を残し削除します。

LASTWEEK

  前週までの履歴削除（省略可）

  前週の土曜以前の履歴を削除します（土曜日の履歴を含めて削除）。

LASTMONTH

  前月までの履歴削除（省略可）

  前月の月末以前の履歴を削除します（月末日の履歴を含めて削除）。

G

  要求受付履歴削除コマンドが出力するエラーメッセージの表示抑制（省略可）

  省略するとエラーメッセージが表示されます。

OUTPUT=filename

  要求受付履歴削除コマンドが出力するエラーメッセージの出力先（省略可）

  「ライブラリー名/ファイル名(メンバー名)」の形式で指定します。

  省略するとエラーメッセージは出力されません。

  ログファイルのレコード保持件数は無制限です。

EXIT CL変数名

  要求受付履歴削除コマンドが出力するエラーコードの受け取りとCL変数名（省略可）

  EXITとCL変数名は連続して指定してください。

  異常終了の場合のみ、エラーコードをCL変数へセットします。

  省略するとエラーコードはセットされません。

= 備考 =

- 日付関連パラメーター（「FROM=」/「TO=」、「DAY=」、「LASTWEEK」、「LASTMONTH」）は複数指定する事はできません。

- 対話処理指定（「I」）は、日付関連パラメーターのうち「FROM=」/「TO=」指定のみ使用できます。

## コマンドインターフェイス

    UTLOBSRM SERVICE( ) FROM( ) TO( ) DAY( ) INTERACT( )
       LIBRARY( ) MSG( ) FILE( ) MBR( )

## パラメーター説明

SERVICE

  削除対象のサービス名（省略不可）

  8バイト以内の英数字で指定します。

  “*ALL”を指定すると、すべてのサービスが対象となります。

FROM TO

  要求受付履歴削除対象の日付（省略可）

  8バイトの数字で指定します。

  「FROM」を省略すると「TO」で指定した日付までの全ての日付が対象となります。

  「TO」を省略すると「FROM」で指定した日付以降の全ての日付が対象となります。

  どちらも省略した場合はすべての日付が対象となります。

  日付はシステム動作環境設定の日付形式（DATEFMT）に設定した形式で、「FROM<=TO」の範囲で指定する必要があります。指定した日付も削除の対象に含まれます。

DAY

  削除対象外とする日数（省略時値 *NO）

  “1”から“366”までの間で指定します。

  現日付より過去の指定日数分の履歴を残し削除します。

  “*LW”を指定すると、前週の土曜以前の履歴を削除します（土曜日の履歴を含めて削除）。

  “*LM”を指定すると、前月の月末以前の履歴を削除します（月末日の履歴を含めて削除）。

INTERACT

  対話形式（省略時値 *NO）

  表示されるメッセージにしたがって、サービスと日付の範囲を入力してください。

  *NO

    : 対話形式で削除を行わない

  *YES

    : 対話形式で削除を行う

LIBRARY

  HULFTがインストールされているライブラリー名（省略時値 HULFT）

  先頭英文字の10バイト以内の英数字で指定します。

MSG

  エラーメッセージの表示抑制（省略時値 *YES）

  *NO

    : エラーメッセージを表示しない

  *YES

    : エラーメッセージを表示する

FILE

  エラーメッセージ出力先ファイルのライブラリー名とファイル名（省略可）

  「ライブラリー名/ファイル名」の形式で指定します。

  それぞれ先頭英字の10バイト以内の英数字で指定します。

  省略するとエラーメッセージは出力されません。ログファイルのレコード保持件数は無制限です。

MBR

  エラーメッセージ出力先ファイルのメンバー名（省略時値 *FILE）

  先頭英字の10バイト以内の英数字で指定します。

## 対話形式での入力例

- サービス名の入力

  削除対象のサービス名を省略して起動した場合、次のメッセージが出力されますので、削除対象のサービス名を入力してください。

      PLEASE INPUT SERVICE NAME.(DEFAULT IS ALL)
      >サービス名

  省略したい場合は、［実行］キーのみを押してください。

  省略するとすべてのサービス名が削除の対象となります。

- 日付範囲の入力

  削除対象の日付単位を省略して起動した場合、次のメッセージが出力されますので、削除対象の日付範囲を入力してください。

      FROM (DEFAULT IS OLDEST)
      >日付(YYYYMMDD)
      TO (DEFAULT IS LATEST)
      >日付(YYYYMMDD)

  省略したい場合は、［実行］キーのみを押してください。

  省略するとすべての日付が削除の対象となります。

  サービス名、日付範囲が正しく入力されていれば次の確認メッセージを出力します。

      SURE ? (Y/N)

  削除してもよい場合は、"Y"を入力してください。

  削除を中止したい場合は、"N"を入力してください。

  指定されたデータが要求受付履歴ファイル中に存在しない場合は、次のメッセージを出力し、処理を終了します。

      UTLOBSRM  :HUL1253 OBJECT RECORD NOT EXIST

  = 備考 =

  日付の形式はシステム動作環境設定の日付形式（DATEFMT）の設定によって変わります。

  詳細は、以下を参照してください。

  HULFT10 for IBMi アドミニストレーション マニュアル : グローバル関連設定