変換履歴出力コマンド（utledlist コマンド）

データ加工履歴ファイルはデータベースファイルです。そのため、このコマンドを使用してデータ加工履歴ファイルの内容を参照します。パラメータを使用して出力範囲や出力フォーマットを詳細に指定できます。結果は標準出力に出力されます。「>（リダイレクト）」を使用すると、出力結果をファイルへ出力できます。

表1.18 コマンドの実行可否

グレード

DataMagicのユーザ種別

管理情報の業務グループ設定

実行可否

DataMagic Server

スーパーユーザ

－

可能

一般ユーザ

権限の指定を省略する(*1)

可能

権限を指定する

可能(*2)

DataMagic Desktop

－

－

可能

*1

:

業務グループにユーザ権限を指定しないで、絞り込み条件として使用することを示します。

*2

:

一般ユーザが出力できる履歴を次に示します。

  • 一般ユーザ自身が所属している業務グループの履歴

  • 業務グループに所属していない履歴

該当する一般ユーザが所属していない、ユーザ権限を指定する業務グループが設定されている履歴は出力できません。

コマンド

DataMagic Serverグレードの場合

utledlist [[-f YYYY/MM/DD [hh:mm:ss]] [-t YYYY/MM/DD [hh:mm:ss]]|
　　      　 -s seqno|-b {n|thisweek|thismonth|today}] [-e {n|ok|ng}]
　      　　[-p parameter] [-d id][-u userid][-g grpid]
      　　　[format] [-k {E|S|8}] [-l max]

DataMagic Desktopグレードの場合

utledlist [[-f YYYY/MM/DD [hh:mm:ss]] [-t YYYY/MM/DD [hh:mm:ss]]|
　　      　 -s seqno|-b {n|thisweek|thismonth|today}] [-e {n|ok|ng}]
　      　　[-p parameter] [-d id][-g grpid]
      　　　[format] [-k {E|S|8}] [-l max]

パラメータ

-f YYYY/MM/DD [hh:mm:ss]

出力したい履歴の開始日時（省略可）

省略すると、履歴の先頭から出力されます。

-t YYYY/MM/DD [hh:mm:ss]

出力したい履歴の終了日時（省略可）

省略すると、履歴の最後まで出力されます。

-s seqno

出力したい変換識別子（省略可）

変換識別子は、変換履歴でレコードを識別するユニークなNo.になります。

-b {n|thisweek|thismonth|today}

履歴の出力範囲（省略可）

現時点を基点とした相対的な指定ができます。

n

: n日前からの履歴を出力します。

“1”～“9999”の範囲で指定します。

thisweek

: 今週の履歴を出力します。（日曜日から）

thismonth

: 今月の履歴を出力します。

today

: 今日の履歴を出力します。

-e {n|ok|ng}

出力したい履歴の終了コード（省略可）

n

: 終了コードnの履歴を出力します。

ok

: 正常終了の履歴をすべて出力します。

ng

: 異常終了の履歴をすべて出力します。

-p parameter

履歴のパラメータファイル名を-pで指定した文字列でワイルドカード検索をして、履歴を出力（省略可）

-d id

出力したい履歴のデータ加工ID（省略可）

省略すると、すべてのデータ加工IDの履歴を出力します。

-u userid

出力したい履歴の実行ユーザ（省略可）

省略すると、すべての実行ユーザの履歴を出力します。

-g grpid

出力したい履歴の業務グループ（省略可）

省略すると、すべての業務グループの履歴を出力します。

format

履歴の出力フォーマット（省略可）

書式文字列で指定します。

省略すると、以下の出力フォーマットで処理されます。

"%6s %03e %03d %t %T %n"

書式文字列に含まれる書式以外の文字は、変換されずにそのまま表示されます。

各書式は、以下のように変換されます。

%s

: 識別子

%n

: 処理レコード数

%N

: 総出力レコード数

%u

: 実行ユーザ

%g

: 業務グループ

%f

: パラメータファイル名

%i

: データ加工ID

%p

: 実行パラメータ

%E

: 完了メッセージ

%D

: 詳細メッセージ

%C

: コメント

%e

: 完了コード

%d

: 詳細コード

%m

: マルチスレッドの使用

%t

: 変換開始日時

%T

: 変換終了日時

%%

: %

\n

: 改行

\t

: 水平タブ

フラグ文字

: %文字の後ろに、0個以上のフラグ文字を指定できます。

  • 0:

    値をゼロでパディングします。%n（処理レコード数）、%e（完了コード）、%d（詳細コード）では、変換した値の左側に空白文字の替わりにゼロをパディングします。“0”と“-”が両方とも指定された場合は“0”が無視されます。

  • -:

    変換値をフィールド内で左揃えにします（デフォルトは右揃え）。

フィールド幅

: 最小フィールド幅を正の整数で指定します。

変換結果がフィールド幅よりも広い場合は、自動でフィールド幅が拡張され、変換結果が入ります。

= 備考 =

  • 識別子は変換履歴でレコードを識別するユニークなNo.になります。

  • 日付は、システム動作環境設定の「日付形式（datefmt）」に設定した形式で出力されます。

-k {E|S|8}

履歴の出力コード（省略可）

省略すると、以下の値で出力します。

Windowsの場合

SHIFT-JIS

ただしWindowsの文字コード（システムロケール）がUTF-8の場合はUTF-8になります。

UNIXの場合

システム動作環境設定ファイル（huledenv.conf）の「自機種のコード（knjcode）」の値

-l max

出力したい履歴の最大件数（省略可）

“1”～“999”の値を指定してください。

省略すると、すべての履歴を出力します。

= 備考 =

  • Usageの日付部は、システム動作環境設定の「日付形式（datefmt）」で設定する形式で表示されます。

  • 日付を指定する場合には、「日付形式（datefmt）」で選択している形式で指定してください。

  • パラメータで開始日時および、終了日時を指定する場合には、日付（YYYY/MM/DD）と時間（hh:mm:ss）の間に半角スペースが1つ必要です。また、指定する際には日付（YYYY/MM/DD）と時間（hh:mm:ss）を「"（ダブルクォーテーション）」で囲む必要があります。なお、日付のみ、または時間のみを指定する場合は不要です。

    （例） -f "2011/04/01 10:00:00"

  • パラメータの開始日時および終了日時には、時間だけを指定できます。日付を省略し時間だけを指定した場合は、コマンドを実行した日を日付として処理します。