Systemwalker Operation Manager リファレンスマニュアル - UNIX共通 -

3.2.7 qsub ジョブの投入コマンド

■記述形式

qsub [options] [job_file] [parameters]

■機能説明

qsubはジョブを投入するコマンドです。

■オプション (options)

qsubコマンドで指定可能なオプションを以下に示します。

^[EE]
◆-sys サブシステム番号

複数サブシステム運用をしているシステムで、操作対象のサブシステムを指定するためのオプションです。操作対象とするサブシステム番号を、0から9の範囲で指定します。このオプションを省略した場合、サブシステム番号0が操作対象となります。

◆-C comment

ジョブにコメントを付加します。511文字以内で指定します。コメントに空白文字を含む場合、コメントを半角のダブルクォーテーション(”)で囲む必要があります。以下に例を示します。

-C "This is a comment."

本オプションの指定がない場合、ジョブ実行制御は環境変数JC_COMMENTを検索します。この環境変数が存在していれば、JC_COMMENTで記述されている文字列をコメントとみなします。

コメント内にダブルクォーテーションを記述する場合は、ダブルクォーテーションの直前に“\”を指定することでダブルクォーテーションを文字として扱うことが可能です。なお、直前に“\”を記述したダブルクォーテーションは、コメント全体を括るためのダブルクォーテーションとして扱われません。以下に例を示します。

-C "This is a \"client listing\""

◆-ch client-hostname

ジョブの依頼元のホスト名を特定するためのクライアントホスト名を指定します。

クライアントホスト名の最大は、64文字です。

◆-cu client-username

ジョブの依頼元のユーザ名を特定するためのクライアントユーザ名を指定します。クライアントユーザ名の最大は64文字です。

このオプションは、システム管理者(スーパ・ユーザ)のみ指定できます。

◆-dp dispatch-priority

起動するプロセスの実行優先度を-20〜19の整数で指定します。

実行優先度は19が最も低く、-20が最も高くなります。

本オプションが省略された場合、[キューの作成／編集]ウィンドウで指定する“優先順位の省略値を指定する”(queueパラメタのdfltdprtyオペランド)の定義値が設定されます。

◆-e [path-name] stderr-file

ジョブの実行で生じる標準エラー出力をpath-nameに指定したパス名にstderr-fileというファイル名で出力します。

path-nameの指定がない場合、パス名はジョブを投入した時のカレントワーキングディレクトリとみなします。

指定されたパスに出力できない場合、カレントワーキングディレクトリに出力します。

本オプションが省略された場合、標準エラー出力ファイル名は“ジョブ名.eジョブ番号”になります。ジョブ名がKEISAN、ジョブ番号が20であるジョブの標準エラー出力ファイル名は、“KEISAN.e20”になります。

本オプションは-eoオプションと同時に指定することはできません。

◆-eo

標準エラー出力を標準出力ファイルに出力します。

-eオプションと同時に指定することはできません。

◆-ld HHMM

ジョブの打ち切り時刻を指定します。本オプションを指定したジョブは、打ち切り時刻を迎えると強制終了されます。終了コードは“0x40000322”です。

“HH”は"00〜23"(時)、"MM"は"00〜59"(分)の表記です。

本オプションは-ltオプションおよび[登録−ジョブ]ウィンドウ−[詳細情報]シートの[実行予測時間]と同時に指定できません。

◆-j job-name

ジョブ名を指定します。job-nameの長さには制限はありませんが、有効となるのは先頭64文字までです。

本オプションを指定しなかった場合、ジョブファイル名(ただし、パス名および、拡張子を取り除いたもの)をジョブ名とみなします。ジョブファイル名も指定しない場合、STDINをジョブ名とみなします。

job-nameの先頭に数字が指定された場合、ジョブ実行制御はジョブ名の先頭に“J”を付加します。

UTF-8コードの環境では日本語コードを使用しないでください。

◆-lt limittime

ジョブ実行経過時間の制限値を指定します。

経過時間は秒単位で、1〜99999999の範囲の値を指定します。

本オプションが省略された場合、[キューの作成／編集]ウィンドウで指定する“ジョブ経過時間を制限する”(queueパラメタのlimittimeオペランド)での定義値が設定されます。

本オプションは-ldオプションと同時に指定できません。

◆-nr

ジョブの再実行を禁止します。

本オプションを付けて投入されたジョブは、そのジョブが実行中にシステムダウンが発生した場合、ジョブ実行制御の再立ち上げ時に再実行されません。

◆-o [path-name] stdout-file

ジョブの実行で生じる標準出力をpath-nameに指定したパスにstdout-fileというファイル名で出力します。

path-nameの指定がない場合、パス名はジョブを投入した時のカレントワーキングディレクトリとみなします。

指定されたパスに出力できない場合、カレントワーキングディレクトリに出力します。

本オプションが省略された場合、標準出力ファイル名は“ジョブ名.oジョブ番号”になります。ジョブ名がKEISAN、ジョブ番号が20であるジョブの標準出力ファイル名は、“KEISAN.o20”になります。

◆-p priority

ジョブのキュー内のプライオリティを0〜63の整数で指定します。

プライオリティは0が最も低く、63が最も高くなります。

本オプションで指定したプライオリティは、キュー上のジョブの実行順位を決めるためのもので、実行プライオリティを決定するものではありません。

ジョブをキューイングする場合、ジョブ実行制御は、キュー内に存在するジョブのキュー内プライオリティを調べます。新たに投入されたジョブは、キューイングされているプライオリティの低いジョブの前にキューイングされます。

また、新規ジョブと同じプライオリティのジョブが存在する場合、そのジョブの後ろに新規ジョブをキューイングします。

本オプションが省略された場合、[運用情報の定義]ウィンドウの“優先順位の省略値を指定する”(queueパラメタのdfltprtyオペランド)での定義値が設定されます。定義されていない場合には、-1が表示されます。

◆-q queue-name

ジョブをキューイングするキュー名を指定します。

本オプションの指定がない場合、ジョブ実行制御は環境変数QSUB_QUEUEを検索します。この環境変数が存在していれば、QSUB_QUEUEで記述されている文字列をキュー名とみなします。

本オプションの指定がなく、環境変数QSUB_QUEUEも存在していない場合、システム管理者がデフォルトキューを設定していれば、そのキューにキューイングされます。

本オプションの指定がなく、環境変数QSUB_QUEUEもなく、デフォルトキューも設定されていない場合、“not specify"と表示され、ジョブはキューイングされません。

◆-R resource-name[,resource-type]

ジョブが使用するリソース名および排他属性を指定します。resource-nameは最大64文字です。resource-typeには以下のいずれかを指定します。

sh

リソースを他のジョブと共有します。

ex

リソースを占有します。

resource-nameとresource-typeの間の区切りには“,”を用います。

resource-typeが省略された場合はshが指定されたものとします。

リソース名 RDBを、排他属性を占有とする場合の指定を以下に示します。

-R RDB,ex

◆-rh hostname

本オプションを指定したジョブは指定されたサーバ上で実行されます。ジョブの標準出力ファイルおよび標準エラー出力ファイルは、投入元サーバに作成されます。

なお、本オプションを指定するときは以下の点に注意してください。

• ジョブがJCLだった場合は本オプションは無視されます。
• 本オプションを指定して分散実行キューにジョブを投入した場合、投入が拒否されます。

ジョブが実行されるキューは以下の手順で決定されます。

1. 投入元ジョブの実行キュー(投入時に指定したキュー名、または省略値)と同一名のキュー名。
2. 同一のキュー名が存在しない場合は、ジョブを依頼する他サーバで[運用情報の定義]ウィンドウの“ジョブ投入先のキューの省略値を指定する”(systemパラメタのdfltqueueオペランド)に定義されたキュー名。
3. [運用情報の定義]ウィンドウで“ジョブ投入先のキューの省略値を指定する”(systemパラメタのdfltqueueオペランド)が指定されていない場合は、“not specify"と表示され、ジョブの投入に失敗します。

◆-jft

ジョブファイルを-rhオプションで指定したサーバまたは分散実行サーバへ転送して実行します。

本オプションは以下の条件を満たした場合にのみ有効です。

• ジョブファイルがJCL以外である。
• -rhオプションを指定している、または、分散実行キューにジョブを投入するとき。

本オプションを指定しない場合は、-rhオプションで指定したサーバ上、または分散実行サーバ上に存在するジョブファイルを実行します。

◆-x

ジョブ投入時に存在するすべての環境変数をジョブ実行環境で利用できるようにします。

◆-z

ジョブを投入した時、メッセージを表示しません。

本オプションを指定した場合、ジョブの投入が成功してもジョブの投入が成功したことを知らせるメッセージを表示しません。

ただし、ジョブの投入が失敗した場合、本オプションの指定の有無に関係なく、常にエラーメッセージを表示します。

本オプションを省略した場合、ジョブの投入が成功した時に以下に示す形式のメッセージを表示します。

Job job submitted to queue: queue-name

jobは、以下の形式で表示されます。

なお、各表示項目についての説明および注意事項については、“qjalter ジョブの属性変更コマンド”を参照してください。

job-name(jobno.hostname)

queue-nameは、ジョブがキューイングされたキュー名を示します。

◆-r retrycount

ネットワークジョブの実行依頼中に回線異常が発生した場合にリトライを行います。この時のリトライ回数を、1〜20の範囲で指定します。

なお、以下の場合には、リトライは行われません。

• 本オプションを省略した場合
• ジョブの実行依頼処理が終了した後の、ジョブの実行完了を待っている状態において回線異常が発生した場合

■オペランド

◆job_file

実行するジョブファイルを指定します。指定可能なファイルは以下のとおりです。

• シェルスクリプト、またはコマンド(拡張子が、「JCL」「swt」以外のファイル)
• JCLファイル(ジョブ実行制御が提供する業務手続き言語(JCL)によって作成した、拡張子が「JCL」のファイル)
• Systemwalkerスクリプトファイル(Systemwalkerスクリプト言語によって作成した、拡張子が「swt」のファイル)

UTF-8コードの環境で、指定するファイル名に日本語を含む場合は、必ず-jオプションを併用して日本語コードを含まないジョブ名になるようにしてください。

◆parameters

シェルスクリプト、SystemwalkerスクリプトまたはJCLに渡すパラメタを指定します。

ジョブファイルにjob.sh、そのファイルに渡すパラメタとして0822および1000を指定する場合は、以下のように記述します。

qsub job.sh 0822 1000

なお、パラメタに*?[]などのシェルによって特別な意味を持つ文字を使用する場合は、文字列全体を一対の引用符(''または””)で囲んでください。ジョブファイルに/usr/bin/ls、パラメタとして-l、/home/guest/*および/home/guest/work/???を指定する場合は、以下のように記述します。

qsub /usr/bin/ls -l '/home/guest/*' '/home/guest/work/???'

■備考

• job_fileを省略した場合、標準入力ファイル(STDIN)からジョブとして実行されるコマンドを読み込みます。標準入力がコンソールである場合、コマンドの入力を終了するには、[Ctrl-D]を入力します。
• job_fileは、qsubコマンドを投入した時に、ジョブ実行制御のスプールへ作業ファイルとしてコピーされる場合があります([運用情報の定義]ウィンドウの[旧互換]シートの[ジョブ登録時に指定したスクリプトファイルをスプールに複写し、実行する]を有効にした場合)。その場合は、ジョブ実行制御は、その作業ファイルを参照してジョブを実行するため、キューイングした後にjob_fileの内容を変更してもその変更内容は、ジョブの実行には反映されません。

■復帰値

0：	ジョブの投入処理が正常に終了しました。
0以外：	ジョブの投入処理が正常に終了しませんでした。エラーメッセージが出力されます。

■コマンド格納場所

Solaris版	/opt/FJSVMJS/usr/bin
HP版	/opt/FHPMJS/usr/bin
AIX版	/opt/FAIXMJS/usr/bin
Linux版/Linux for Itanium版	/opt/FJSVMJS/usr/bin