Hitachi

JP1 Version 12 JP1/Script(Windows(R)用)


8.5.23 CatFiles (ファイルを統合する)

機能

ファイルを統合します。

JP1/Script 07-50以降では,ラージファイルが使用できます。

形式
CatFiles ( PathName , 〔Option〕 , FilePath1 , 〔FilePath2〕 〔, FilePath3 , …〕 )
指定項目
PathName

統合したファイルを格納するフォルダ名,またはファイル名を,文字列,または値を格納した変数名で,指定します。指定したファイル名がすでに存在している場合は上書きします。

Option

オプションを指定します。

この値には次の値を指定できます。

意味

Delete

ファイルを統合後,FilePathnで指定されたファイルを削除します。

FilePathn

統合するファイルのフルパスを文字列,または値を格納した変数名で指定します。ファイル名にワイルドカードを指定することもできます。

ファイル名は最大10個指定でき,指定した順序で統合します。

JP1/Script 06-00以降では,複数のファイルのフルパスの文字列を一つずつ格納した一次元の配列変数を変数名で指定することもできます。この場合は,11個以上のファイル名を指定することができます。

ファイル名にワイルドカードが指定された場合は,該当するファイル名を昇順にソートして統合します。

説明

指定したファイルを統合し,統合したファイルを指定されたフォルダに格納します。コマンドが正常に実行された場合は真(True)を,エラーが発生した場合は偽(False)を,コマンドの実行結果として返します。

補足
  • 環境変数ProgramFiles(通常はシステムドライブのProgram Filesフォルダ),またはWinDir(通常はシステムドライブのWindowsフォルダ)に設定されているフォルダ下のファイル,またはフォルダを指定する場合,注意が必要です。詳細は,「1.8.2 コマンドの動作」を参照してください。

  • 統合したファイルを格納するファイルを新規に作成する場合に,アクセス権限を設定できます。設定するアクセス権限は,あらかじめ次に示すレジストリキーに設定しておいてください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE\SOFTWARE\Hitachi\JP1/Script\SPTX\Option

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0:設定しない

1:「上位フォルダのアクセス権を継承する」を設定する。

2:「Everyone:フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は,デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

重要

OSのファイルシステムでは,次のファイル名が使用されます。

  • ユーザが任意の文字列を指定したロングファイル名

  • OSが自動的に生成するショートファイル名(8.3形式)

そのため,JP1/Scriptで,ファイル名にワイルドカードを指定した場合,OSが自動的に生成するショートファイル名も対象になります。また,ファイル名にワイルドカードを指定しない場合,該当ファイルのショートファイル名と同一パスに存在する別ファイルのショートファイル名とが合致し,意図しないファイルが対象になるときがありますのでご注意ください。

' FDに格納されたファイル"A:\FDCOPY.TXT.*"を統合して,
' "C:\SCRIPT\FDCOPY.TXT"を作成する。
Dim  dir1 ,file1
dir1 = "C:\SCRIPT\"
file1 = "FDCOPY.TXT"
CatFiles ( dir1+file1 , ,"A:\"+file1+"*" )
対象バージョン

JP1/Script 05-10以降