Interstage Job Workload Server セットアップガイド

4.2.2.1 ファイルパスの論理化機能の設定

ファイルパスの論理化機能の設定について説明します。
論理ファイルとして使用するファイルシステムを、“論理ディレクトリ定義ファイル”に指定します。

■論理ディレクトリ定義ファイルのコピー

論理ディレクトリ定義ファイルを以下のとおりコピーしてください。

• コピー元
  /opt/FJSVibsbx/sample/filepath.conf
• コピー先
  /etc/opt/FJSVibsbx/filepath.conf

• コピー元
  Interstage Job Workload Serverのインストールディレクトリ\ijob\etc\sample\filepath.conf
• コピー先
  Interstage Job Workload Serverのインストールディレクトリ\ijob\etc\FJSVibsbx\filepath.conf

■論理ディレクトリ定義ファイルの編集

下記の形式に従って、サンプルを修正してください。

オペランドの記述形式の詳細を説明します。

[define_logical_directory]

この記述以降の記述を“論理ディレクトリ定義セクション”と呼びます。
論理ディレクトリ定義セクションの始まりに記述します。
論理ディレクトリ定義ファイルに1回だけ記述できます。

default_logical_directory_name=デフォルト論理ディレクトリ名

ファイルを格納するディレクトリを論理化した名前を定義します。
後述するdirectoryオペランドと対で指定してください。（このオペランドとdirectoryオペランドを合わせて"デフォルト論理ディレクトリ"と呼びます）
デフォルト論理ディレクトリは、論理ディレクトリ定義の中でひとつだけ指定できます。
デフォルト論理ディレクトリの指定は省略することもできます。
資源定義の[デフォルト論理ディレクトリを使用する]を指定した場合に、ファイルを本オペランドで定義したデフォルト論理ディレクトリに格納します。

デフォルト論理ディレクトリ名は、半角英文字で始まる64文字以内の半角英大文字、半角英小文字、半角数字、および半角記号("_"と"-")で指定します。

デフォルト論理ディレクトリ名は、半角英文字で始まる64文字以内の半角英文字、半角数字、および半角記号("_"と"-")で指定します。

logical_directory_name=論理ディレクトリ名

ファイルを格納するディレクトリを論理化した名前を定義します。
後述するdirectoryオペランドと対で指定してください。（このオペランドとdirectoryオペランドを合わせて"論理ディレクトリ"と呼びます）
論理ディレクトリは、デフォルト論理ディレクトリと合わせて最大1000個まで定義できます。
論理ディレクトリ名（デフォルト論理ディレクトリ名も含む）は一意であり、同じ論理ディレクトリ名を重複して指定することはできません。
論理ディレクトリの指定は省略することもできます。
資源定義の[論理ディレクトリを使用する]を指定した場合に、ファイルを本オペランドで定義した論理ディレクトリに格納します。

論理ディレクトリ名は、半角英文字で始まる64文字以内の半角英大文字、半角英小文字、半角数字、および半角記号("_"と"-")で指定します。

論理ディレクトリ名は、半角英文字で始まる64文字以内の半角英文字、半角数字、および半角記号("_"と"-")で指定します。

directory=絶対パス

ファイルを割り当てるディレクトリの絶対パスを指定します。
default_logical_directory_nameオペランドまたはlogical_directory_nameオペランドと対で指定してください。
存在するディレクトリを指定する必要があります。

絶対パスは、255文字以内の半角英大文字、半角英小文字、半角数字および半角記号("_",".","/","@") で指定してください。また、先頭文字は"/"のみが指定可能です。指定できない文字を指定した場合は、エラーとなります。

絶対パスは、255文字以内で以下の形式で指定してください。指定できない文字を指定した場合は、エラーとなります。

• ローカルドライブの指定形式
  “ドライブ文字:\ディレクトリ名”
• ネットワーク上のディレクトリの指定形式
  “\\マシン名\ディレクトリ名”

ディレクトリ名に指定可能な文字は、半角英文字(大文字／小文字の区別なし)、半角数字、半角空白、半角記号("_",".","\","@")です。
マシン名に指定可能な文字は15文字以内の半角英文字(大文字／小文字の区別なし)、半角数字、および半角ハイフン("-")です。

ネットワーク上のファイルを利用する場合は必ず、“バッチアプリケーションが使用するファイルにネットワーク上のファイルを利用する場合”を参照してください。

[select_logical_directory]

この記述以降の記述を“論理ディレクトリ選択セクション”と呼びます。
論理ディレクトリ選択セクションの始まりに記述します。
論理ディレクトリ定義ファイルに1回だけ記述できます。
論理ディレクトリ定義セクションを記述した後に、記述する必要があります。
論理ディレクトリ選択セクションは省略することができます。この場合“[select_logical_directory]”の記述も省略してください。

select_file 選択ファイル名=論理ディレクトリ名

ファイル名の表現と使用する論理ディレクトリを定義します。（このオペランドを“論理ディレクトリ選択”と呼びます）
資源定義の[デフォルト論理ディレクトリを使用する]を指定した場合に、選択ファイル名の表現に一致するファイルを、本オペランドで定義した論理ディレクトリに格納します。
本オペランドは、最大1000個まで定義できます。

“選択ファイル名=論理ディレクトリ名”の記述形式について以下に説明します。

選択ファイル名
ファイル名として指定可能な文字、および“*”で255文字以内で指定してください。
選択ファイル名には、任意の長さの文字を表す"*"が使用できます。
なお、“*”は、長さ0の文字も含みます。
“*”は選択ファイル名の任意の位置に1箇所だけ指定できます。
ファイル名がfileABCの場合、“file*”、“file*C”および“fileABC*”などと指定した選択ファイルに一致します。

論理ディレクトリ名
論理ディレクトリ定義セクションで定義した論理ディレクトリ名を指定します。

#(半角シャープ)

コメント行を記述できます。コメント行は、行の先頭に“#”記号を指定して記述します。

• 空行が指定された場合は無視します。
• オペランド、オペランド値および“=”の前後に指定した空白、タブは無視します（select_fileの後ろの空白は除く）。
• オペランドを記述した行には、オペランド以外の文字を記述しないでください。コメントを記述する場合は、コメント行に記述します。
• 一時ファイルと非一時ファイルのパスは、最大255バイトです。このため、絶対パス名の長さとファイル名の長さの合計が、255バイトになるように設定してください。ジョブ実行時に、絶対パス名の長さとファイル名の長さの合計が確認されます。
• 一時ファイルのファイル名の長さは、最大215バイトになります。ファイル管理機能で管理できるファイルのパスは、最大255バイトであるため、絶対パス名と一時ファイル名の長さの合計が255バイトを超えないように、絶対パス名を設定してください。

• 以下の場合、ジョブ実行時にエラーとなります。
  • 資源定義の[論理ディレクトリを使用する]を指定した場合に、資源定義で指定した論理ディレクトリ名が論理ディレクトリ定義ファイルに記述されていない場合(デフォルト論理ディレクトリや論理ディレクトリ選択を使用して動作しません。)
  • 資源定義の[デフォルト論理ディレクトリを使用する]を指定した場合、デフォルト論理ディレクトリと論理ディレクトリ選択セクションを省略している場合
  • デフォルト論理ディレクトリを省略し、論理ディレクトリ選択セクションのどの選択ファイル名にも一致しない場合
• 以下の場合、バッチ実行サービスの開始に失敗します。また、btfwupdlogicdirdefコマンドを実行すると失敗します。
  • 絶対パスに、存在しないディレクトリを指定した場合
  • 論理ディレクトリ定義セクション（[define_logical_directory]）または論理ディレクトリ選択セクション（[select_logical_directory]）の中にオペランドが定義されていない場合
  • その他、論理ディレクトリ定義ファイルの記述形式に誤りがある場合
• 論理ディレクトリ定義ファイルの記述がコメント行および空白行のみの場合は、バッチ実行サービスの開始時に警告メッセージを出力します。また、btfwupdlogicdirdefコマンドを実行すると失敗します。
• “*”1文字で選択ファイル名の指定が表現できない場合は、資源定義で[論理ディレクトリを使用する]を指定してください。

論理ディレクトリ定義ファイルの設定内容は、バッチ実行サービスの開始時または、btfwupdlogicdirdefコマンドの実行により有効となります。

btfwupdlogicdirdefコマンドの詳細は、“Interstage Job Workload Server リファレンス”を参照してください。

論理ディレクトリ定義ファイルの記述例を以下に示します。

#
# logical directory definition
#
[define_logical_directory]
default_logical_directory_name=GROUP1
directory=/work1/
logical_directory_name=GROUP2
directory=/work2/
#
# select logical directory
#
[select_logical_directory]
select_file file2008*=GROUP1
select_file *.dat=GROUP2

#
# logical directory definition
#
[define_logical_directory]
default_logical_directory_name=GROUP1
directory=d:work\
logical_directory_name=GROUP2
directory=e:\All Users Folder\
#
# select logical directory
#
[select_logical_directory]
select_file file2008*=GROUP1
select_file *.dat=GROUP2

■オペランドの組合せ

定義可能なオペランドの組合せは、以下のとおりです。

default_logical_directory_name	directory	logical_directory_name	directory	select_file
○	○
		○	○
○	○	○	○
		○	○	○
○	○	○	○	○
○	○			○

■デフォルト論理ディレクトリを使用する場合のディレクトリ決定順位

資源定義の[デフォルト論理ディレクトリを使用する]を指定した場合、ファイルを格納するディレクトリは以下のように決定されます。

1. 論理ディレクトリ選択の検索
   論理ディレクトリ選択の上からの記述順に一致する定義を検索します。
   最初に一致した選択ファイル名に対応して定義した論理ディレクトリに決定されます。
   
2. デフォルト論理ディレクトリに決定
   論理ディレクトリ選択の定義がない場合および論理ディレクトリ選択に一致する定義がなかった場合は、デフォルト論理ディレクトリに決定されます。