用途
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を参照してください。
アクティブ・ジョブ、すなわち、現在実行されているジョブが表示されます。デフォルトではlsjob
コマンドにより、アクティブなジョブと保留中のジョブが表示されます。
正常終了または異常終了したジョブが表示されます。
保留中のジョブ、すなわち、実行されておらず将来実行されるようにスケジュールされているジョブが表示されます。デフォルトではlsjob
コマンドにより、アクティブなジョブと保留中のジョブが表示されます。
現在、入力をリクエストしているジョブが表示されます。ジョブが入力を要求するのは、たとえば、スタンドアロンのテープ・ドライブを使用しながらマルチボリュームのボリューム・セットからバックアップをリストアしようとする場合や、リストア操作に必要なボリュームがライブラリにない場合です。
すべての状態のジョブが表示されます。
ステータスを取得するスケジュール・バックアップ/リストア・ジョブのジョブIDを指定します。
時間を使用したジョブ・オプション
次のオプションを使用して、ジョブの状態が更新された時期かまたはジョブが実行されるようにスケジュールされていた時期によって、ジョブをフィルタ処理します。実例は例2-60を参照してください。
date-time以降に状態が更新されたジョブのみが表示されます。たとえば、昨日保留中からアクティブに更新されたジョブが表示されます。date-timeプレースホルダの詳細は、「date-time」を参照してください。
date-time以前に状態が更新されたジョブのみが表示されます。たとえば、昨日以前に保留中からアクティブに更新されたジョブが表示されます。date-timeプレースホルダの詳細は、「date-time」を参照してください。
今日状態が更新されたジョブのみが表示されます。
選択基準としてジョブ変更時間ではなくスケジュール時間が使用されます。date-timeの範囲を選択するには、--today
または--from
を使用します。どちらのオプションも指定しない場合は、date-timeの範囲には制限が適用されません。
タイプ/ホスト名/データセットを使用したジョブ・オプション
次のオプションを使用して、ジョブ・タイプ、ホスト名またはデータセットIDによってジョブをフィルタ処理します。実例は例2-61を参照してください。
指定されたタイプのジョブ・エントリのみが表示されます。デフォルトでは、obtool
によりすべてのタイプが表示されます。job-typeプレースホルダの詳細は、「job-type」を参照してください。
指定されたホストに関連したジョブ・エントリのみが表示されます。
指定されたデータセット・ファイルに関連したジョブ・エントリのみが表示されます。データセット・ファイル情報を表示するには、lsdsコマンドを実行します。
ユーザー名を使用したジョブ・オプション
次のオプションを使用して、ジョブを開始者によってフィルタ処理します。実例は例2-62を参照してください。
Oracle Secure Backupによってスケジュールされたジョブが表示されます。
usernameが所有者であるジョブが表示されます。すべてのOracle Secure Backupユーザーを表示するには、lsuserコマンドを実行します。
自分が現在ログインに使用しているユーザーが所有者となっているジョブが表示されます。自分が現在使用しているOracle Secure Backupユーザーを表示するには、idコマンドを実行します。
その他のジョブ・オプション
次のオプションを使用して、その他の基準によってジョブをフィルタ処理します。実例は例2-63を参照してください。
実行される前に無効にされたジョブが表示されます。
特定のジョブを実行する機会がある場合に、その後、同じジョブがスケジュールされると、初めのジョブは無効となります。たとえば、毎晩9時に増分バックアップをスケジュールしているとします。水曜日の朝になって、火曜日夜のバックアップが、ライブラリに使用可能なテープがなかったために実行されていなかったことがわかります。この場合、水曜日にスケジュールされているバックアップが前の晩のバックアップに優先します。
選択されたジョブに下位ジョブが含まれていれば表示されます(デフォルト)。たとえば、lsjob --primary
により、sbt/25
のみでなく、sbt/25.1
、sbt/25.2
およびsbt/25.3
も表示されます。
各プライマリ・ジョブのみが表示されます。たとえば、lsjob --primary
により、sbt/25.1
、sbt/25.2
およびsbt/25.3
ではなく、sbt/25
が表示されます。
形式制御ジョブ・オプション
次のオプションを使用して、ジョブ情報の表示を制御します。実例は例2-64を参照してください。
ジョブIDのみが表示されます。
列形式においてではなくラベル付きで情報が表示されます。
列ヘッダーが表示されません。
--short
オプションとともに使用して、1行に1つのジョブIDを表示します。
コンテンツ・レベルのジョブ・オプション
次のオプションを使用して、含まれているコンテンツの量によってジョブをフィルタ処理します。実例は例2-65を参照してください。
--completed
オプションと組み合せて使用して、完了したジョブの結果を表示します。たとえば、結果は次のようになります。
saved 3.4 MB to VOL000003 (tag ADE202), file 12 ok: /home
各ジョブの実行に必要なリソースが表示されます。たとえば、どのようなデバイスを使用しても実行できるジョブは、「必要なデバイスは任意です。」と表示されます。
各ジョブの関連する時間がすべて表示されます。ジョブの時間の例を次に示します。
introduced 2005/03/21.16:59, earliest exec 03/23.00:00, last update 2005/03/21.16:59, expires never
各ジョブのログが表示されます。ログには、ジョブの作成時間、ジョブがディスパッチされたホスト、ジョブの完了時間などのデータが表示されます。
出力
表2-11で、lsjob
コマンドの出力について説明します。
表2-11 lsjobの出力
ラベル | 意味 |
---|---|
Job ID |
スケジュール・バックアップ/リストア・ジョブに割り当てられた、一意のOracle Secure Backup ID。 |
Type |
ジョブのタイプ( |
Scheduled time |
ジョブの開始がスケジュールされた時間。 |
Contents |
使用されたデータセットまたはバックアップされたホスト。 |
State |
ジョブの状態。設定は、 |
Priority |
バックアップ・スケジュールの優先度レベル。 |
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