ヘッダーをスキップ
Oracle Secure Backupリファレンス
リリース10.1
B28441-02
  目次
目次
索引
索引

戻る
戻る
 
次へ
次へ
 

lsjob

用途

lsjobコマンドは、スケジュール・バックアップ/リストア・ジョブのステータスを取得する場合に使用します。表示するジョブを、日付、ステータスおよび表示の詳細度別に選択できます。

各ジョブには、ログイン・ユーザーのユーザー名、スラッシュおよび一意の数値IDで構成されるIDが割り当てられます。ジョブIDの例は、admin/15のようになります。

lsjobコマンドでは、アクティブなジョブおよび保留中のジョブがすべて、1行に1ジョブで表示されます。

Job-ID   Sched time  Contents   State


関連項目:

関連コマンドについては、「ジョブ用コマンド」を参照してください。

前提条件

別のユーザーのジョブをリストするには、所有者を問わないジョブのリスト(list any job, regardless of its owner)権を備えている必要があります。自身のジョブをリストするには、ユーザーが所有するジョブのリスト(list any jobs owned by user)権を備えている必要があります。

構文

lsjob::=

lsj•ob [ --active/-a ] [ --complete/-c ] [ --pending/-p ]
[ --inputrequest/-i ] [ --all/-A ]
[ { [ --from/-f date-time ] [ --to/-t date-time ] } |
  [ --today/-T ] ]
[ --timescheduled/-e ] [ --type/-Y job-type[,job-type]... ]...
[ --host/-h hostname ] [ --dataset/-D dataset-name ]
[ --system/-y | { --username/-u username } | --me/-m ]
[ --superseded/-S ] [ --subjobs/-j | --primary/-P ]
[ { --short/-s [ --oneperline/-1 ] } | --long/-l ]
[ --noheader/-H ] [ --results/-r ] [ --requires/-R ]
[ --times/-C ] [ --log/-L ]
job-id ...

意味

次のオプションを使用して、表示するジョブを選択します。状態を使用するオプションを指定しなかった場合は、obtoolにより、アクティブなジョブおよび保留中のジョブのみが表示されます。追加式のオプションが複数あります。

状態を使用したジョブ・オプション

このオプションを使用して、ステータス別にジョブをフィルタ処理します。実例は例2-59を参照してください。

--active/-a

アクティブ・ジョブ、すなわち、現在実行されているジョブが表示されます。デフォルトではlsjobコマンドにより、アクティブなジョブと保留中のジョブが表示されます。

--complete/-c

正常終了または異常終了したジョブが表示されます。

--pending/-p

保留中のジョブ、すなわち、実行されておらず将来実行されるようにスケジュールされているジョブが表示されます。デフォルトではlsjobコマンドにより、アクティブなジョブと保留中のジョブが表示されます。

--inputrequest/-i

現在、入力をリクエストしているジョブが表示されます。ジョブが入力を要求するのは、たとえば、スタンドアロンのテープ・ドライブを使用しながらマルチボリュームのボリューム・セットからバックアップをリストアしようとする場合や、リストア操作に必要なボリュームがライブラリにない場合です。

--all/-A

すべての状態のジョブが表示されます。

job-id ...

ステータスを取得するスケジュール・バックアップ/リストア・ジョブのジョブIDを指定します。

時間を使用したジョブ・オプション

次のオプションを使用して、ジョブの状態が更新された時期かまたはジョブが実行されるようにスケジュールされていた時期によって、ジョブをフィルタ処理します。実例は例2-60を参照してください。

--from/-f date-time

date-time以降に状態が更新されたジョブのみが表示されます。たとえば、昨日保留中からアクティブに更新されたジョブが表示されます。date-timeプレースホルダの詳細は、「date-time」を参照してください。

--to/-t date-time

date-time以前に状態が更新されたジョブのみが表示されます。たとえば、昨日以前に保留中からアクティブに更新されたジョブが表示されます。date-timeプレースホルダの詳細は、「date-time」を参照してください。

--today/-T

今日状態が更新されたジョブのみが表示されます。

--timescheduled/-e

選択基準としてジョブ変更時間ではなくスケジュール時間が使用されます。date-timeの範囲を選択するには、--todayまたは--fromを使用します。どちらのオプションも指定しない場合は、date-timeの範囲には制限が適用されません。

タイプ/ホスト名/データセットを使用したジョブ・オプション

次のオプションを使用して、ジョブ・タイプ、ホスト名またはデータセットIDによってジョブをフィルタ処理します。実例は例2-61を参照してください。

--type/-Y job-type[,job-type]...

指定されたタイプのジョブ・エントリのみが表示されます。デフォルトでは、obtoolによりすべてのタイプが表示されます。job-typeプレースホルダの詳細は、「job-type」を参照してください。

--host/-h hostname

指定されたホストに関連したジョブ・エントリのみが表示されます。

--dataset/-D dataset

指定されたデータセット・ファイルに関連したジョブ・エントリのみが表示されます。データセット・ファイル情報を表示するには、lsdsコマンドを実行します。

ユーザー名を使用したジョブ・オプション

次のオプションを使用して、ジョブを開始者によってフィルタ処理します。実例は例2-62を参照してください。

--system/-y

Oracle Secure Backupによってスケジュールされたジョブが表示されます。

--username/-u username

usernameが所有者であるジョブが表示されます。すべてのOracle Secure Backupユーザーを表示するには、lsuserコマンドを実行します。

--me/-m

自分が現在ログインに使用しているユーザーが所有者となっているジョブが表示されます。自分が現在使用しているOracle Secure Backupユーザーを表示するには、idコマンドを実行します。

その他のジョブ・オプション

次のオプションを使用して、その他の基準によってジョブをフィルタ処理します。実例は例2-63を参照してください。

--superseded/-S

実行される前に無効にされたジョブが表示されます。

特定のジョブを実行する機会がある場合に、その後、同じジョブがスケジュールされると、初めのジョブは無効となります。たとえば、毎晩9時に増分バックアップをスケジュールしているとします。水曜日の朝になって、火曜日夜のバックアップが、ライブラリに使用可能なテープがなかったために実行されていなかったことがわかります。この場合、水曜日にスケジュールされているバックアップが前の晩のバックアップに優先します。

--subjobs/-j

選択されたジョブに下位ジョブが含まれていれば表示されます(デフォルト)。たとえば、lsjob --primaryにより、sbt/25のみでなく、sbt/25.1sbt/25.2およびsbt/25.3も表示されます。

--primary/-P

各プライマリ・ジョブのみが表示されます。たとえば、lsjob --primaryにより、sbt/25.1sbt/25.2およびsbt/25.3ではなく、sbt/25が表示されます。

形式制御ジョブ・オプション

次のオプションを使用して、ジョブ情報の表示を制御します。実例は例2-64を参照してください。

--short/-s

ジョブIDのみが表示されます。

--long/-l

列形式においてではなくラベル付きで情報が表示されます。

--noheader/-H

列ヘッダーが表示されません。

--oneperline/-1

--shortオプションとともに使用して、1行に1つのジョブIDを表示します。

コンテンツ・レベルのジョブ・オプション

次のオプションを使用して、含まれているコンテンツの量によってジョブをフィルタ処理します。実例は例2-65を参照してください。

--results/-r

--completedオプションと組み合せて使用して、完了したジョブの結果を表示します。たとえば、結果は次のようになります。

saved 3.4 MB to VOL000003 (tag ADE202), file 12
ok:   /home
--requires/-R

各ジョブの実行に必要なリソースが表示されます。たとえば、どのようなデバイスを使用しても実行できるジョブは、「必要なデバイスは任意です。」と表示されます。

--times/-C

各ジョブの関連する時間がすべて表示されます。ジョブの時間の例を次に示します。

introduced 2005/03/21.16:59, earliest exec 03/23.00:00, last update
2005/03/21.16:59, expires never
--log/-L

各ジョブのログが表示されます。ログには、ジョブの作成時間、ジョブがディスパッチされたホスト、ジョブの完了時間などのデータが表示されます。

出力

表2-11で、lsjobコマンドの出力について説明します。

表2-11 lsjobの出力

ラベル 意味

Job ID

スケジュール・バックアップ/リストア・ジョブに割り当てられた、一意のOracle Secure Backup ID。

Type

ジョブのタイプ(datasetまたはdatabase)。

Scheduled time

ジョブの開始がスケジュールされた時間。

Contents

使用されたデータセットまたはバックアップされたホスト。

State

ジョブの状態。設定は、processedpendingcompleted successfullyまたはfailedです。

Priority

バックアップ・スケジュールの優先度レベル。1が最も高い優先度です。

Privileged op

ジョブに対する管理者権限の必要有無。

Run on host

ジョブが実行されるホスト。

Attempts

Oracle Secure Backupによりジョブの実行が試行される回数。


例2-59では、すべての状態のジョブ(active、pending、completedおよびawaiting input)を表示しています。

例2-59 状態によるジョブのフィルタ処理

                  ob> lsjob --all
Job ID           Sched time  Contents                    State
---------------- ----------- --------------------------- ---------------------------------------
admin/1          none     dataset tbrset/entire_backup   completed successfully at 2005/03/21.10:17
admin/1.1        none     backup brhost2                 completed successfully at 2005/03/21.10:17
admin/2          none     restore 1 item to brhost2      completed successfully at 2005/03/21.10:17
admin/3          none     dataset fullbackup.ds          completed successfully at 2005/03/21.10:32
sbt/1            none     database ob (dbid=1557818382)  completed successfully at 2005/03/21.10:19
sbt/1.1          none     archivelog backup              completed successfully at 2005/03/21.10:19
sbt/2            none     database ob (dbid=1557818382)  completed successfully at 2005/03/21.10:19
sbt/2.1          none     controlfile autobackup         completed successfully at 2005/03/21.10:19
sbt/3            none     database ob (dbid=1557818382)  completed successfully at 2005/03/21.10:19
sbt/3.1          none     datafile backup                completed successfully at 2005/03/21.10:19
sbt/4            none     database ob (dbid=1557818382)  completed successfully at 2005/03/21.10:21
sbt/4.1          none     restore piece '03gfrui9_1_1'   completed successfully at 2005/03/21.10:21
sbt/5            none     database ob (dbid=1557818382)  completed successfully at 2005/03/21.10:21
sbt/5.1          none     incremental backup             completed successfully at 2005/03/21.10:21

例2-60では、今日のみアクティブなジョブおよび保留中のジョブを表示しています。

例2-60 時間によるジョブのフィルタ処理

ob> lsjob --today
Job ID           Sched time  Contents                       State
---------------- ----------- ------------------------------ ----------------------
admin/13         03/23.00:00 dataset fullbackup.ds          future work

例2-61では、ホストbrhost2で実行されている、すべての状態のジョブを表示しています。

例2-61 ホストによるジョブのフィルタ処理

ob> lsjob --all --short --oneperline --host brhost2
admin/1.1
admin/2
admin/3.1
admin/4.1
admin/5.1
sbt/6.1
sbt/7.1

例2-62では、ユーザーsbtが所有者である、アクティブなジョブおよび保留中のジョブを表示しています。

例2-62 ユーザーによるジョブのフィルタ処理

ob> lsjob --user sbt
Job ID           Sched time  Contents                       State
---------------- ----------- ------------------------------ ---------------------
admin/13         03/23.00:00 dataset fullbackup.ds          future work

例2-63では、無効にされたアクティブなジョブおよび保留中のジョブを表示しています。

例2-63 無効にされたジョブの表示

ob> lsjob --superseded
Job ID           Sched time  Contents                       State
---------------- ----------- ------------------------------ ----------------------
admin/13         03/23.00:00 dataset fullbackup.ds          future work

例2-64では、アクティブなジョブおよび保留中のジョブを長い形式で表示しています。

例2-64 長い形式でのジョブ・データの表示

ob> lsjob --long
admin/13:
    Type:                   dataset fullbackup.ds
    Level:                  full
    Family:                 (null)
    Scheduled time:         03/23.00:00
    State:                  future work
    Priority:               100
    Privileged op:          no
    Run on host:            (administrative server)
    Attempts:               0

例2-65では、アクティブなジョブおよび保留中のジョブの時間関連データをすべて表示しています。

例2-65 すべての時間関連データの表示

ob> lsjob --times
Job ID           Sched time  Contents                       State
---------------- ----------- ------------------------------ ----------------------
admin/13         03/23.00:00 dataset fullbackup.ds          future work
    introduced 2005/03/21.16:59, earliest exec 03/23.00:00, last update
    2005/03/21.16:59, expires never