5.38.5 ADD

ADDコマンドは、ZipServiceの現行インスタンスの現在のアーカイブ(CREATEコマンドやOPENコマンドを使用して最後に正常に開いたアーカイブ)にファイル、ディレクトリ、子ディレクトリを追加します。
PATHキーワードまたはFILEキーワードのいずれかを指定する必要があります。両方のキーワードを指定した場合、処理されるのはPATHキーワードのみです。
PATHキーワードかFILEキーワードを使用して、追加するフォルダまたはファイルを指定します。キーワードごとに、1つのフォルダやファイルを指定したり、追加するエントリーのリストを指定したりすることができます。
構文:

コマンド

キーワード

開発者用メモ

ADD

FILE

条件付。
FILE または PATH のいずれかのキーワードを指定します。両方のキーワードを指定した場合、処理されるのは PATH キーワードのみです。
現在のアーカイブに追加する1つ以上のディレクトリまたはファイルのパスを指定します。このキーワードは以下の2つのうちのいずれかの方法で指定できます。
ファイル・パスは、現在のアーカイブに追加する1つのディレクトリまたはファイルのパスを指定します。

 

 

*LIST

コマンドで提供される作業リストを指定します。このリストには、現在のアーカイブに追加する1つ以上のディレクトリまたはファイルのパスが含まれます。
作業リストでは1つまたは2つのフィールドを使用できます: 最初のフィールドは、ディレクトリやファイルのパスを含めるようになっています。 オプションの 2 番目のフィールドを使用すると、リスト・エントリーで特定されるディレクトリやファイルに適用されるベース値(<BASE>を参照)を指定できます。 2 番目のフィールドを指定しない場合や、指定したとしてもブランクの場合、BASE 値は *NONE が前提となります。
相対パス、を指定した場合、ZipService は、JSM インスタンス・ディレクトリに相対的なディレクトリやファイルを検索します。

 

PATH

現在のアーカイブに追加する1つ以上のディレクトリまたはファイルのパスを指定します。このキーワードは以下の2つのうちのいずれかの方法で指定できます。
ファイル・パスは、現在のアーカイブに追加する1つのディレクトリまたはファイルのパスを指定します。
PATHキーワードかFILEキーワードのいずれかを指定します。両方のキーワードを指定した場合、処理されるのはPATHキーワードのみです。

 

 

*LIST

コマンドで提供される作業リストを指定します。このリストには、現在のアーカイブに追加する1つ以上のディレクトリまたはファイルのパスが含まれます。
作業リストでは1つまたは2つのフィールドを使用できます。最初のフィールドは、ディレクトリやファイルのパスを含めるようになっています。オプションの2番目のフィールドを使用すると、リスト・エントリーで特定されるディレクトリやファイルに適用されるBASE値(<BASE>を参照)を指定できます。2番目のフィールドを指定しない場合や、指定したとしてもブランクの場合、BASE値は*NONEが前提となります。
相対パス、を指定した場合、ZipService は、JSM インスタンス・ディレクトリに相対的なディレクトリやファイルを検索します。

 

BASE

 

このキーワードは、PATH キーワードと組み合わせて使用されます。BASEキーワードは、Zipアーカイブのエントリーごとにパス情報が保管される方法を制御します。
このキーワードに適切な値を指定すると、Zipエントリーごとにファイル・パスが保存されることを避けることができます。代わりに、保存されたパスが共通のルート・パスの相対パスになるよう指定できます。これは、ソース・マシンとはディレクトリ構造が異なるシステムでZipアーカイブの内容を解凍する場合に役立ちます。
Zipアーカイブに複数の ADD コマンドを追加する場合、ADD コマンドの各インスタンスで一貫した矛盾のない値を指定するように注意してください。これは、結果の Zip アーカイブのパス構造が一致するようにするためです。

 

 

path

Zip アーカイブ内の全ファイルの相対パスとして使用されるパスを指定します。

 

 

*CURRENT

Zipファイルに保管されているパスは、Zipファイルに追加するエントリーを含むディレクトリの相対パスになります。

 

 

*PARENT

Zipファイルに保管されているパスは、Zipファイルに追加するエントリーを含むディレクトリの親の相対パスになります。

 

 

*NONE

Zipアーカイブに保管されているパスは修正されません。 デフォルト値です。

 

TREE

*NO

このキーワードは、PATH キーワードと組み合わせて使用され、子ディレクトリが Zip アーカイブに含まれる必要がある場合に指定します。 子ディレクトリとそのコンテンツは追加されません。

 

 

*YES

指定したディレクトリの子ディレクトリとそのコンテンツが現在のアーカイブに追加されます。子ディレクトリ自体にさらにディレクトリが含まれる場合、そのディレクトリとコンテンツも追加され、指定したディレクトリのすべての子孫が追加されるまで続きます。 これがデフォルトです。


ADD FILE(*LIST) #WRKLST(NAME)
 
ADD FILE(/folder/file.pdf) BASE(tick)
 
ADD FILE(/folder/file.pdf) BASE(*CURRENT)
 
ADD FILE(/folder/file.pdf) BASE(/folder)
 
ADD PATH(/folder/folder) BASE(*NONE)