OpenVMS
DCL ディクショナリ


前へ 次へ 目次 索引


後から,ノード JADE をクラスタから削除する場合を考えます。この例で STOP/QUEUES/ON_NODE コマンドは,クラスタ全体のキュー・マネージャを終了させずに,ノード JADE のすべてのキューを終了します。これによって,自動起動キュー BATCH_1 は,フェイルオーバ・リスト内で次に使用できるノード RUBY にフェイルオーバします。 STOP QUEUES/ON_NODE コマンドが自動起動を禁止するため,後からノード JADE で自動起動キューを実行するには,再ブート時にそのノードで ENABLE AUTOSTART/QUEUES コマンドを実行しなければなりません。

/NAME_OF_MANAGER 修飾子が指定されていないため,このコマンドは,省略時の設定のキュー・マネージャ SYS$QUEUE_MANAGER に管理されるキューにだけ作用します。


STOP/ZONE

実行中の VAXft システムからゾーンを削除します。 STOP/ZONE コマンドについての詳細は, VAXft システムのドキュメントを参照してください。

VAXft システムに対してのみ適用されます。 CMKRNL(モードをカーネルに変更)特権が必要です。


形式

STOP/ZONE ゾーンid


SUBMIT

バッチ・キューに,1 つまたは複数のコマンド・プロシージャを登録します。

キューに対する登録 (S) アクセス権が必要です。


形式

SUBMIT ファイル指定[,...]


パラメータ

ファイル指定[,...]

1 つまたは複数のコマンド・プロシージャのファイル名を指定します。ワイルドカード文字 ( アスタリスク (*) とパーセント記号 (%)) は,ディレクトリ指定,ファイル指定,ファイル・タイプ指定,およびバージョン番号フィールドに使用できます。省略時のファイル・タイプは,前に指定したファイル・タイプになります。前のファイル指定で明示的にファイル・タイプが指定されていない場合には, SUBMIT コマンドは省略時のファイル・タイプとして .COM を使用します。

複数のファイルを指定する場合には,ファイル指定をコンマ (,) またはプラス記号 (+) で区切らなければなりません。

ファイル指定にノード名を含む場合には, /REMOTE 修飾子を指定しなければなりません。


説明

SUBMIT コマンドは,後で実行するために,指定ファイルをバッチ・キューに登録します。省略時の設定では,キューは SYS$BATCH です。単一の SUBMIT コマンドでキューに登録されるすべてのファイルは, 1 つのジョブとして連続的に処理されます。省略時のバッチ・ジョブの名前は, SUBMIT コマンドで指定した最初のファイルの名前になります。

キュー内のバッチ・ジョブごとに,一意なエントリ番号が割り当てられます。 SUBMIT コマンドを入力すると,省略時の設定で,ジョブ名,キュー名,エントリ番号,およびジョブの状態が表示されます。

SUBMIT コマンドが正常終了すると,システムによりローカル・シンボル $ENTRY が自動的に作成または更新されます。 $ENTRY の値は,最後にキューに登録されたジョブのエントリ番号を表す文字列です。後でジョブのエントリ番号を参照したい場合は, $ENTRY の値を別のシンボルに保存してください。

バッチ・ジョブをキューに登録すると,バッチ・ジョブを実行する前に新しいバージョンのファイルが作成されている場合でも,登録されたバージョンのファイルが処理されます。また,キューに登録されたファイルと同じ名前と同じバージョン番号を持つ別のファイルで,登録されたファイルを置き換えることはできません。

バッチ・キューに登録されたコマンド・プロシージャを実行すると,コマンドを実行するために独立プロセスが作成されます。このプロセスは,所有者のディスクとディレクトリの省略時の設定,およびログイン時に所有者の会話型プロセスに与えられたものと同じ資源制限値と特権を受け取ります。

複数のプロシージャをキューに登録する場合,エラーまたは重大 (致命的) エラー状態で終了するプロシージャがあると,ジョブはただちに終了します。

OpenVMS Cluster 環境では, OpenVMS Cluster 内のノード間でシステム時刻の差が変化することがあるので, SET TIME/CLUSTER コマンドを使用して定期的にクラスタの同期を保つ必要があります。これによって,ジョブが指定時刻より少し前または後に実行を開始することがあります。これは,バッチおよび印刷システムに組み込まれた冗長設計によって,クラスタ内の複数のジョブ・コントローラが,ジョブに対するタイマ非同期システム・トラップ (AST) を受信して,その実行をスケジューリングできるからです。

バッチ・ジョブの出力

省略時の設定では,バッチ・ジョブの各コマンド・プロシージャからのすべての出力は,ログ・ファイルに書き込まれます。バッチ・ジョブが終了すると, SYS$PRINT で印刷するために,このログ・ファイルはキューに登録されます。省略時の設定では,このログ・ファイルは印刷後に削除されます。 STOP/QUEUE/ENTRY,STOP/IDENTIFICATION,またはDELETE/ENTRY コマンドを使用してバッチ・ジョブを停止させると,ログ・ファイルは印刷用にキューに登録されません。

システムによるログ・ファイルの扱いを変更する方法については, /LOG_FILE,/PRINTER,および /KEEP 修飾子の説明を参照してください。


修飾子

/AFTER=時刻

/NOAFTER

指定した時刻までジョブを保留状態にすることを要求します。指定した時刻がすでに経過している場合には,ジョブは直ちに処理されます。

時刻には絶対時刻,または絶対時刻とデルタ時間の組み合わせを指定できます。時刻の指定方法についての詳細は,『OpenVMS ユーザーズ・マニュアル』またはオンライン・ヘルプの DCL_Tips トピック (Date_Time サブトピック) を参照してください。

OpenVMS Cluster 環境では,メンバ・システム間で時計の同期をとっていません。このため,時刻を指定してバッチ・ジョブを実行しようとした場合,実行開始時刻に多少の誤差が生じることがあります。たとえば,SUBMIT/AFTER=TOMORROW でキューに登録したジョブは,そのホスト・システムの時計では 23:58 に実行を開始するかもしれません。

バッチ / プリント・システムに組み込まれた冗長性により,ジョブの実行開始時刻を通知する非同期システム・トラップ (AST) がクラスタ内のどのジョブ・コントローラでも受信可能なため,キューに登録したマシンとジョブが実行されるマシンが同じ場合にも,この問題は起こり得ます。バッチ・ジョブが,処理終了後直ちに自分自身 (バッチ・ジョブ) を翌日実行するように再登録している場合に,この問題はより顕著になります。この場合,同じジョブがいくつも実行する可能性があります ( これは,TOMORROW が数分後であるかも知れないからです )。

この問題を回避するためには,クラスタ内のシステム間の時計の誤差よりも大きな時間で待機させるような WAIT コマンドを, SUBMIT コマンドの前に入れておくことです。各システムの時計の誤差を調べるには,SHOW TIME コマンドを使用します。クラスタ内の各システムの時計を同期させるには, SYSMAN の CONFIGURATION SET TIME コマンドを使用します。 SYSMAN コマンド CONFIGURATION SET TIME についての詳細は,『OpenVMS システム管理ユーティリティ・リファレンス・マニュアル』を参照してください。

/BACKUP

/NOBACKUP

/BEFORE または /SINCE 修飾子を適用する時刻属性を指定します。この修飾子を指定すると,最新のバックアップの日時をもとにファイルを選択します。この修飾子は他の時刻属性を指定する修飾子,/CREATED,/EXPIRED,および /MODIFIED 修飾子とは同時に指定できません。これら 4 つの修飾子のいずれも指定しない場合には,省略時の設定として /CREATED 修飾子が使用されます。

/BEFORE[=時刻]

/NOBEFORE

指定された時刻以前の時刻属性をもつファイルを選択します。絶対時刻,または絶対時刻とデルタ時間の組み合わせを指定します。また,BOOT,LOGIN,TODAY( 省略時の設定 ),TOMORROW,および YESTERDAY というキーワードも指定できます。適用する時刻属性は,/BACKUP,/CREATED( 省略時の設定 ),/EXPIRED,または /MODIFIED 修飾子のいずれかで指定します。

時刻指定の詳細は,『OpenVMS ユーザーズ・マニュアル』,またはオンライン・ヘルプの DCL_Tips トピックの Date_Time を参照してください。

/BY_OWNER[=利用者識別コード]

/NOBY_OWNER

ファイル所有者の利用者識別コード (UIC) が,指定した所有者 UIC と一致する場合にだけ,そのファイルを選択します。 UIC を指定しない場合には,現在のプロセスの UIC が省略時の値として使用されます。

UIC は,『OpenVMS Guide to System Security』に説明されている,標準的な UIC 形式を使用して指定します。

/CHARACTERISTICS=(属性[,...])

ジョブに対して必要な,1 つまたは複数の属性の名前または番号を指定します。属性でインクの色などを参照できます。属性を 1 つだけ指定する場合には,括弧を省略できます。

属性番号の範囲は,0 〜 127 までの数値です。システム上でどの属性が定義されているかを調べるためには, SHOW QUEUE/CHARACTERISTICS コマンドを使用します。また,特定のキューに対して使用できる属性を調べるには, SHOW QUEUE/FULL コマンドを使用します。

SUBMIT コマンドに /CHARACTERISTICS 修飾子を指定する場合,指定する属性はすべて,ジョブを実行するキューに対しても指定されていなければなりません。つまり,ジョブの属性はキューの属性のサブセットでなければなりません。そうでない場合には,次に示す条件のいずれかが満たされるまで,そのジョブは待ち状態のまま実行されません。

/CLI=ファイル名

ジョブを処理するときに使用する,コマンド言語インタプリタ (CLI) を指定します。ファイル指定における装置名には SYS$SYSTEM:,ファイル・タイプには .EXE(SYS$SYSTEM: ファイル名.EXE) が仮定されています。省略時の設定では,利用者登録ファイル (UAF) に定義されている CLI が使用されます。

/CONFIRM

/NOCONFIRM (省略時の設定)

各ファイルをキューに登録する前に,そのファイルに対する操作の実行を確認するためのプロンプトを表示するかどうかを指定します。システムがプロントを表示したら,次の応答のいずれかを入力します。

YES NO QUIT
TRUE FALSE Ctrl/Z
1 0 ALL
  [Return]  

単語による応答には,大文字と小文字を任意に組み合わせることができ,また 1 文字または複数の文字に短縮することもできます ( たとえば,TRUE は T,TR,TRU に短縮することができます )。ただし,応答は一意に認識できなければなりません。肯定応答は,YES,TRUE,1 です。否定応答は,NO,FALSE,0,Return です。 QUIT または Ctrl/Z は,その時点でコマンドの処理を中止することを示します。 ALL と応答すると,コマンドの処理は継続されますが,そのあとプロンプトは表示されなくなります。上記に示されていない応答を入力すると,DCL はエラー・メッセージを出力し,同じプロンプトが再度表示されます。

/CPUTIME=時間

バッチ・ジョブの CPU 時間の上限値を定義します。デルタ時間,0 または NONE,INFINITE というキーワードが指定できます。ジョブが実行されるキューに対して CPUMAXIMUN 値 (上限値) が定義されている場合は,SUBMIT コマンドで指定された値とキューの上限値とを比較して小さい方が使用されます。ジョブが実行されるキューに対して上限値が定義されていない場合は, SUBMIT コマンドで指定された値と利用者登録ファイル (UAF) に設定されている値とを比較して小さい方が使用されます。キューに対して上限値が設定されておらず,利用者登録ファイル (UAF) に CPU 上限値として NONE が設定されている場合は, 0 またはキーワード INFINITE を指定すると CPU 時間は無制限です。 NONE を指定すると,キューまたは UAF に設定された値になります。CPU 時間は,システム・パラメータ PQL_MCPULM の値よりも大きいか等しくなくてはなりません。 CPU 時間の上限値の指定についての詳細は, INITIALIZE/QUEUE コマンドの表「CPU 時間制限値と処理」を参照してください。

/CREATED (省略時の設定)

/NOCREATED

/BEFORE または /SINCE 修飾子を適用する時刻属性を指定します。この修飾子を指定すると,作成日時をもとにファイルを選択します。この修飾子は他の時刻属性を指定する修飾子,/BACKUP,/EXPIRED,および /MODIFIED 修飾子とは同時に指定できません。これら 4 つの修飾子のいずれも指定しない場合には,省略時の設定として /CREATED 修飾子が使用されます。

/DELETE

/NODELETE (省略時の設定)

位置修飾子

処理が終了したあと,コマンド・プロシージャ・ファイルを削除するかどうかを指定します。 SUBMIT コマンドのコマンド名のあとに /DELETE 修飾子を指定すると,ジョブに含まれるすべてのファイルが削除されます。ファイル指定のあとに /DELETE 修飾子を指定した場合には,対応するファイルだけが処理後に削除されます。

/DELETE 修飾子を使用するためには,ジョブをキューに登録したユーザの利用者識別コード (UIC) に対し,入力ファイルの保護コードで削除 (D) アクセスが許可されていなければなりません。削除 (D) アクセスが許可されていない,またはコマンド・パラメータ・リストの中のファイルが入力オープンできない場合には,コマンドの処理は中止されバッチ・ジョブは生成されません。

/EXCLUDE=(ファイル指定[,...])

/NOEXCLUDE

指定したファイル指定と一致するファイルを, SUBMIT 操作から除外することを指定します。ファイル指定にはディレクトリを含めることができますが,装置を含めることはできません。ファイル指定には,ワイルドカード文字 ( アスタリスク (*) とパーセント記号 (%)) を使用できます。ファイルを1つだけ指定する場合には,括弧を省略できます。

/EXPIRED

/NOEXPIRED

/BEFORE または /SINCE 修飾子を適用する時刻属性を指定します。この修飾子を指定すると,満了日時をもとにファイルを選択します ( 満了日は,SET FILE/EXPIRATION_DATE コマンドで設定します )。この修飾子は他の時刻属性を指定する修飾子,/BACKUP,/CREATED,および /MODIFIED 修飾子とは同時に指定できません。これら 4 つの修飾子のいずれも指定しない場合には,省略時の設定として /CREATED 修飾子が使用されます。

/HOLD

/NOHOLD (省略時の設定)

ジョブを直ちに処理するかどうかを指定します。 /HOLD 修飾子を指定した場合には,SET ENTRY/NOHOLD コマンド,または SET ENTRY/RELEASE コマンドを使用してジョブを解放するまで,そのジョブは処理されません。

/IDENTIFY (省略時の設定)

/NOIDENTIFY

キューに登録された時に,ジョブ名,登録したキューの名前,ジョブ・エントリ番号,およびジョブ状態を表示するかどうかを指定します。

/KEEP

/NOKEEP

ログ・ファイルを印刷したあとで,そのログ・ファイルを削除するかどうかを指定します。 /NOPRINTER 修飾子が使用されている場合を除き,省略時には /NOKEEP 修飾子が使用されます。

/LOG_FILE[=ファイル指定]

/NOLOG_FILE

ログ・ファイル名を指定します。ファイル指定には,ワイルドカード文字 ( アスタリスク (*) とパーセント記号 (%)) は使用できません。

/LOG_FILE 修飾子を使用した場合,システムはバッチ・ジョブの出力を指定したファイルに書き込みます。 /NOLOG_FILE 修飾子を使用した場合には,ログ・ファイルは作成されません。省略時の設定では,UAF で論理名 SYS$LOGIN に定義されるディレクトリに,バッチ・ジョブ名と同じファイル名でファイル・タイプが .LOG であるファイルが作成されます。

/LOG_FILE 修飾子を使用すると,別の装置にログ・ファイルを書き込むことができます。ファイル指定に含まれる論理名は,ジョブをキューに登録したプロセスのコンテキストで変換されます。バッチ・ジョブを実行しているプロセスは,ログ・ファイルが存在する装置へのアクセス権を持っていなければなりません。

/LOG_FILE 修飾子と /NAME 修飾子を指定すると, /NAME 修飾子で指定したファイルと同じファイル名を持ち,ファイル・タイプが .LOG のファイルに,ログを書き込みます。 /LOG_FILE 修飾子を省略する場合は, /NAME 修飾子で使用したファイル名値は有効なファイル名でなければなりません。

/MODIFIED

/NOMODIFIED

/BEFORE または /SINCE 修飾子を適用する時刻属性を指定します。この修飾子を指定すると,最新の変更日時をもとにファイルを選択します。この修飾子は他の時刻属性を指定する修飾子,/BACKUP,/CREATED,および /EXPIRED 修飾子とは同時に指定できません。これら 4 つの修飾子のいずれも指定しない場合には,省略時の設定として /CREATED 修飾子が使用されます。

/NAME=ジョブ名

ジョブ名を指定します (おそらくバッチ・ジョブ・ログ・ファイルのファイル名としても使用される文字列です)。ジョブ名は,1 〜 39 文字までの英数字です。名前の中で英数字,アンダースコア (_),ドル記号 ($) 以外の文字を使用する場合には,名前を引用符 (" ") で囲まなければなりません。省略時のジョブ名は,ジョブの最初の (または唯一の) ファイルのファイル名です。

/LOG_FILE 修飾子を省略している場合には,ジョブ名はファイル名として有効でなければなりません。ジョブ名は,SHOW ENTRY または SHOW QUEUE/FULL コマンドによって表示されます。

/NOTE=テキスト

255 バイト以内のメッセージ文字列を指定します。このメッセージ文字列は, SHOW QUEUE/FULL コマンドの一部として表示され,ジョブに関する情報を示すのに使用できます。この修飾子に指定されたメッセージは, (ファイルが印刷された場合は) ログ・ファイルのフラグ・ページにも印刷されます。

/NOTIFY

/NONOTIFY (省略時の設定)

ジョブの正常終了または強制終了を示すメッセージを,ログインしているターミナルに表示するかどうかを指定します。

/PARAMETERS=(パラメータ[,...])

ジョブに対して,最大8個までのパラメータをオプションとして指定します (これらのパラメータは,ジョブの各コマンド・プロシージャで, P1 〜 P8までのシンボル名に与えられる値を定義します)。シンボルは,指定されたコマンド・プロシージャ内でだけ使用できます。

各パラメータはコンマ(,)で区切ります。パラメータを1 つだけ指定する場合には,括弧を省略できます。

スペースや特殊文字,小文字を含むパラメータを指定する場合には,パラメータを引用符で囲まなければなりません。各パラメータは,1 〜 255 バイトの長さです。

/PRINTER[=キュー名](省略時の設定)

/NOPRINTER

ジョブが終了したときに,ジョブ・ログ・ファイルを印刷するためにキューに登録するかどうかを指定します。 /PRINTER 修飾子を使用すれば,特定のプリント・キューを指定できます。省略時のプリント・キューは SYS$PRINT です。 /NOPRINTER 修飾子を指定した場合は,/KEEP 修飾子も指定されていると解釈されます。

バッチ・キューおよび出力キューが同じキュー・マネージャによって管理されている場合は, SUBMIT/PRINTER コマンドで指定されたキューが出力キューかどうか,またユーザが出力キューに対してアクセス権があるかどうかをチェックします。 SUBMIT コマンドで指定されたバッチ・キュー,および /PRINTER 修飾子により指定された出力キューが異なるキュー・マネージャによって管理されている場合は,これらのチェックは行われません。

バッチ・ジョブを登録する時に,ログ・ファイルに対して明示的に出力キューを指定する場合は, /PRINTER 修飾子で指定するキューは出力キューであり,バッチ・キューでないことを確認してください。また,出力キューに対してのアクセス権を持っているかも確認してください。

/PRIORITY=n

登録したキューのスケジューリング優先順位の最高値より大きな優先順位を設定するためには,OPER (オペレータ) 特権,または ALTPRI (優先順位変更) 特権が必要です。

指定したジョブの,同一キュー内の他のジョブと比較した,ジョブ・スケジューリングにおける優先順位を指定します。優先順位の値は,0 〜 255 までの範囲です。このうち,0 はもっとも低い優先順位であり,255 は最高の優先順位です。

省略時の値は,システム・パラメータ DEFQUEPRI の値です。システム・パラメータ MAXQUEPRI の値より低い優先順位を設定する場合には,特権は不要です。

/PRIORITY 修飾子が,ジョブのプロセス優先順位に影響を与えることはありません。プロセスの実行優先順位は,INITIALIZE/QUEUE/BASE_PRIORITY コマンドによって与えられる基本の優先順位属性によって決まります。

/QUEUE=キュー名[:]

ジョブを登録する,バッチ・ジョブ・キューの名前を指定します。省略時のキューは SYS$BATCH です。

/RAD=n (Alpha のみ)

発行されたバッチ・ジョブを実行する RAD 番号を指定します。


前へ 次へ 目次 索引