コマンドの記述形式
ここでは,コマンドの記述形式として,コマンドの指定方法と,コマンドの文法の説明に使用する記号について説明します。
コマンドの指定方法
コマンドの指定形式を次に示します。
![[図データ]](figure/zui21010.gif)
(1)を「オプション」と呼びます。(2)を「引数」と呼びます。
次に,引数の指定方法を説明します。
- 最初にオプションを指定し,次にジョブネットワーク要素名などの任意名を指定します。オプションの前に任意名を指定すると,システムは指定内容をすべて任意名として処理します。
- オプションを複数指定する場合,指定順序は任意です。
- 一つのオプションに対し,値を複数指定する場合は,値間を「,(コンマ)」で区切ります。
- 値のないオプションは連続して指定できます。
- (例)
- 「-a-b-c」を,「-abc」と指定できます。
-
- 値のない2バイトのオプションは,連続して指定できません。
- (例)
- 「-a-ab」を,「-aab」と指定したり,「-cd -cf」を,「-cdcf」と指定したりすることはできません。
-
- オプションを連続して指定する場合,最後のオプションには値を指定できます。
- (例)
- 「-abc xyz」の「xyz」は,オプションcの値となります。
-
- 値を持たないオプションに値を指定した場合,システムはその値以降をすべて任意名として処理します。
- 期待しないオプションを指定した場合,エラーになります。
- 任意名にユニット名を指定する場合の注意事項については,後述の「ユニット名の指定方法」を参照してください。
- 任意名に総称名を指定する場合の注意事項については,後述の「総称名の指定方法」を参照してください。
- 最初の任意名(上記のコマンド指定例の場合,「任意名X」)に「-」で始まる文字列を指定したい場合は,「--△1任意名X」と指定します(システムは,--△1以降を任意名として処理します)。なお,2番目以降の任意名には,--△1の指定は不要です。
- (例)
- 二つの任意名(「-jobA」および「-jobB」)を続けて指定する場合は,「-- -jobA -jobB」と指定します。
-
- 任意名には正規表現が使用できます。
- 期待する数以上の任意名を指定した場合,エラーになります。
- 引数に指定する文字は,大文字・小文字が区別されます。大文字・小文字の使い分けに注意してください。
ユニット名の指定方法
コマンド引数の任意名としてユニット名を指定する方法について説明します。
ユニット名の指定形式を次に示します。
- 論理ホスト名を指定できるコマンドの場合(他ホストのユニットにリモートアクセスする場合)
[[論理ホスト名:][スケジューラーサービス名]:]ジョブネットワーク要素名[:@実行ID]
- 論理ホスト名を指定できないコマンドの場合(自ホストのユニットにローカルアクセスする場合)
[[スケジューラーサービス名]:]ジョブネットワーク要素名[:@実行ID]
次に,各項目について説明します。
- 論理ホスト名
- 論理ホスト名を指定できるコマンドと,指定できないコマンドがあります。詳細は各コマンドの説明を参照してください。
- 自ホスト内に複数の論理ホスト名を持つ場合,スケジューラーサービス名と環境変数JP1_HOSTNAMEの指定によって該当する論理ホスト名が特定されます。したがって,論理ホスト名を指定する必要はありません。指定した場合,自ホスト内であってもTCP/IPプロトコルによる通信が発生するため,認証の設定が必要になります。
- 論理ホスト名を省略した場合,指定したスケジューラーサービス名の先頭に環境変数AJSMANAGERHOSTの内容が補われます。
- 環境変数AJSMANAGERHOSTを設定していない場合,自ホスト内として扱われ,環境変数JP1_HOSTNAMEに指定した論理ホスト名のサービスとします。
- 環境変数JP1_HOSTNAMEを指定していない場合,JP1/Baseの環境設定で定義した,自ホストの論理ホスト名が仮定されます。なお,「論理ホスト名」に「JP1_HOSTNAME_DEFAULT」が設定されている場合,システムのホスト名(gethostname)が仮定されます。
- スケジューラーサービス名
- スケジューラーサービス名を省略した場合,-Fオプションに指定したスケジューラーサービス名が仮定されます。-Fオプションを省略した場合,指定したジョブネットワーク要素名の先頭に環境変数AJSCONFの内容が補われます。環境変数AJSCONFを設定していない場合は,デフォルトのスケジューラーサービス名が仮定されます。
- ジョブネットワーク要素名
- ジョブネットワーク要素名には,ジョブグループ名,ジョブネット名,ジョブ名を指定します。これらは完全名で指定することもできます。
- 完全名は,先頭が「/」で,ルートジョブグループからそのジョブネットワーク要素までの名称を「/」で区切って指定したものです。ジョブネットワーク要素の完全名は,JP1/AJS2の中で一意に管理されています。
- ジョブネットワーク要素名を完全名で指定しなかった場合,指定した名称の先頭に環境変数AJSPATHの内容が補われます。環境変数AJSPATHを設定していない場合は,指定した名称の先頭に「/」が補われます。
- 実行ID
- 実行IDを指定できるコマンドと,指定できないコマンドがあります。詳細は各コマンドの説明を参照してください。
- 実行IDは,ジョブネットを登録するとき,最上位ジョブネットの実行予定の一つに対して一つ割り振られる番号のことで,JP1/AJS2 - Viewやajsshowコマンドで確認できます。実行IDを指定できるコマンドで,実行IDの指定を省略すると,各コマンドが操作の対象とする世代を自動的に判定します。ジョブネットの世代の自動判定については,マニュアル「JP1/Automatic Job Management System 2 解説 4.2 ジョブネットの世代管理」を参照してください。
総称名の指定方法
任意名を指定する場合に,総称名(「*」や「?」など)で指定できる場合があります。
例えば,ジョブネット(net1)中にジョブ(job1,job2,job3,job4)が定義されている場合,ジョブネット(net1)中のすべてのジョブを操作対象にしたいときは,「net1/*」と指定できます。
任意名に総称名を指定できる場合と,できない場合があります。詳細は各コマンド,ジョブの説明を参照してください。
コマンドの文法の説明に使用する記号
コマンドの文法の説明に使用する記号を次の表に示します。
表20-1 コマンドの文法の説明に使用する記号
記号 | 意味と例 |
---|
| (ストローク) | 複数の項目に対して項目間の区切りを示し,「または」の意味を示します。
- (例)
- 「A|B|C」は,「A,B,またはC」を示します。
|
{ } (波括弧) | この記号で囲まれている複数の項目の中から,一組の項目を必ず選択します。項目と項目の区切りは「|」で示します。
- (例)
- 「{A|B|C}」は,「A,B,またはCのどれかを必ず指定する」ことを示します。
|
[ ] (角括弧) | この記号で囲まれている項目は,任意に指定できます(省略できます)。
- (例)
- 「[A]」は,「必要に応じてAを指定する」ことを示します(必要でない場合は,Aを省略できます)。
- 「[B|C]」は,「必要に応じてB,またはCを指定する」ことを示します(必要でない場合は,BおよびCを省略できます)。
|
... (点線) | この記号の直前に示された項目を繰り返して複数指定できます。なお,項目を複数指定する場合は,項目の区切りに1バイトの空白文字(半角スペース)を使用します。
- (例)
- 「A B...」は,「Aのあとに,Bを複数指定できる」ことを示します。
|
_ (下線) | 括弧で囲まれているすべての項目を省略したときに,システムが採用する値を示します。
- (例)
- 「[A|B]」は,「AおよびBを指定しなかった場合,システムはAを採用する」ことを示します。
|
コマンド共通の注意事項
デーモンの文字コードと異なる文字コードでコマンドを実行すると,統合トレースログにそれぞれの文字コードでメッセージが出力されます。
コマンド実行時の環境変数
論理ホストのJP1/AJS2サービスに対するコマンドを実行する場合は,環境変数JP1_HOSTNAMEに論理ホスト名を指定してください。
ジョブネットやジョブを操作するコマンドでは,ジョブネットワーク要素のアクセス権限を,コマンド実行時のOSユーザー名で判断します。OSユーザー名とJP1ユーザー名が異なる場合は,環境変数JP1_USERNAMEにJP1ユーザー名を設定してください。
コマンド実行時に使用される環境変数については,表20-2を参照してください。