Menu item 5: Convert archiv (CVTARCHIVE)

This command converts an archive into another archive-format.

In the "i-effect compression tasks" choose item 5 „Convert archive" . You can enter the command CVTARCHIVE directly aswell.
The now displayed screen enables further specification of the parameters that are used for convertion. Enter these parameters like in the following explanation.

The screen depends on the previousely entered parameters. This depends on the previousely entered parameters. It is visible by the addition of "- only for...". For example are parameters that depend on a specific file-system - marked by "- only for "FS(*IFS)" and "-only for FS(*DB2)" - only visible if this was selected before.

File-system (FS)

Name of the file-system in which the archive was created.
Possible values:

*DB2	The archive will be created as a physical file, with a member.
*IFS	The archive will be created as a file in a path.

Archive-format (FORMAT)

The format in which the archive was created.
Possible special values:

AR CPIO *TAR	Archive-formats. They have no compression, therefore they are mostly combined with a compressor. The following can be selected: BZIP2, GZ, PACK200, XZ, *LZMA.
*ZIP	Archive-format. The compression can be set up for every entry individually.
*JAR	Java archive (also called JAR-file) is a ZIP-file, that can contain additional meta-data in a file "META-INF/MANIFEST.MF". JARs are mostly used for Java programs.
*SEVENZIP	7z-archive-format.For the whole archive, different compressions can be chosen: COPY, LZMA2, DEFLATE, BZIP2
ARJ DUMP	Archive-formats. The compression is determined by the format.
BZIP2 GZ PACK200 XZ	Compressor-formats. Mostly used together with archive-formats (c.f. archive formats), can also be used to compress single files.

Method of compression (COMPRESS)

The meaning of the method of compression depends on the format. For the Zip-format as the source-archive for compression there is no specification needed for converting. For Tar, Ar and Cpio the method has to match with the source-archive if one was entered during the creation. For the 7z-format as source-archive there is no specification needed for converting.
Possible special values for Tar, Ar and Cpio:

*BZIP2	A really good but slow compression. Most often used because it is free of patents.
*GZ	The well known and commonly used Gzip compression
*PACK200	Developed and optimized for the Jar-format.
*XZ	Compression-format.

Possible special values for 7zip:

For the 7z-format as source-archive there is no specification needed for converting.

Possible special values for Zip:

For the Zip-format as source-archive there is no specification needed for converting.

Archive-file (ARCFILE) - only for FS(*DB2)

The qualified name of the archive-file.

Library

Name of the library where the source-archive is located.
Possible special values:

*CURLIB	The archive file will be created in the current library.
*LIBL	The archive file will be created in the current library.

Part-file

Name of the part-file in the archive-file.
Possible special values:

*FIRST

The first part-file is selected.

Archive-file (ARCPATH) - only for FS (*IFS)

Complete path (z.B. /usr/usrlib1/test.zip) for the archive-file.

The following variables are available in any combination. The path is generated automatically:

%TMP%	Default value. The output path "/TMP" is used.
%HOME%	Using this option, i-effect searches for the home path ("/HOME/USERNAME") of the current user.
%CURDIR%	Current directory.
%USER%	Name of current user.
%DATE%	Current date DD.MM.YYYY.
%YEAR%	Current year YYYY.
%YEAR2%	Current year YY.
%MONTH%	Current month MM.
%MONTHNAME%	Name of current month.
%DAY%	Current day.
%WEEKDAY%	Current day of week, e.g. 'Friday'.
%TIME%	Current time HH:MM:SS.
%TIMESTAMP%	Current time stamp, YYYY-MM-DD-HH.MM.SS.MSMSMS
%DEFAULTPATH%	This variable inserts the standard path value from the standard settings of the *ZIP module.

Password (PASSWORD) - only for FORMAT(*SEVENZIP) or FORMAT (*ZIP)

Encrypted 7z-archives need a password to work.
While converting a Zip-archive all passwords of all encrypted entries have to match. If a password does not match, the process is cancelled. All previous entries with matching passwords or without a password are taken over into the new archive.
Possible special values:

*NONE

No password is used.

CCSID The codepage where the password is entered.
Possible special values:

*DFT	The standard ASCII Codepage 819 is used.

File-system output (OUTFS)

Name of the file-system where the new archive is to be created.
Possible values:

*DB2	The archive will be created as a physical file, with a member.
*IFS	The archive will be created as a file in a path.

Archive-format output (OUTFORMAT)

The format in which the new archive is to be created in.
Possible special values:

AR CPIO *TAR	Archive. Archive formats. They have no compression, therefore they are mostly combined with a compressor. You can choose between the following: BZIP2, GZ, PACK200, XZ, *LZMA
*ZIP	Archive. The compression can be created individually for every single entry.
*JAR	Java archive (also called JAR-file) is a ZIP-file that can contain additional meta-data in the file "META-INF/MANIFEST.MF". JARs are mostly used for Java-programs.
*SEVENZIP	Sevenzip archive. For the whole archive you can choose between these compressions: COPY, LZMA2, DEFLATE, BZIP2
BZIP2 GZ PACK200 XZ	Compressor. Mostly used with an archive-format (c.f. individual archive-formats), but can compress single files aswell.

Method of compression output (OUTCOMPRESS)

The method with which the new archive (or rather its entries) are to be compressed. The selection depends on the chosen archive-format.
Possible special values for Tar, Ar and Cpio:

*BZIP2	A really good but slow compression. Most often used because it is free of patents.
*GZ	The well known and commonly used Gzip compression
*PACK200	Developed and optimized for the Jar-format.
*XZ	Compression-format.

Possible special values for 7zip:

*COPY	There is no compression happening. The file is copied into the archive in the original size.
*LZMA2	The standard compression in the 7zip format. Significantly better than other formats.
*DEFLATE	The well known compression of Zip-formats is used.
*BZIP2	A very good but slow compression. Mostly used because it is free of patents.

Possible special values for Zip:

*COPY	No compression is happening. The file is copied into the archive in its original size.
*DEFLATE	The standard-method for compression in a Zip-archive.

Stage of compression output (OUTSPEED) - only for OUTFORMAT(*GZ), OUTFORMAT(*ZIP) or OUTCOMPRESS(*GZ)

i-effectcan vary the algorithm in 9 different stages from "fast and barely compressed" to "slow but highly compressed". By choosing 1 reaches its highest speed, by choosing 9 it reaches its highest compression but the time is prolonged. The user can choose his own preferred values and take the machine-ressources into account.

Archiv-file output (OUTARCFILE) - only for OUTFS(*DB2)

The qualified name of the archive-file to be created. With this name a physical file is created in the library that matches the empty archive of the chosen format.

Library

Name of the library where the file should be created.
Mögliche SonderwertePossible special values:

*CURLIB

The archive file will be created in the current library.

Part-file

Name of the part-file in the archive-file.
Possible special values:

*FIRST

The name of the member with the archive data corresponds to the name of the file.

Writing in the special library QTEMP is not supported.

Archiv-file output (OUTARCPATH) - only for OUTFS (*IFS)

Name of the archive-file as a complete path (e.g. /usr/usrlib1/test.zip). With this name a file is created under the given path, that matches the empty archive of the entered format.

Following variables are available in any combination. The matching path is generated automatically:

%TMP%	Default value. The output path "/TMP" is used.
%HOME%	Using this option, i-effect searches for the home path ("/HOME/USERNAME") of the current user.
%CURDIR%	Current directory.
%USER%	Name of current user.
%DATE%	Current date DD.MM.YYYY.
%YEAR%	Current year YYYY.
%YEAR2%	Current year YY.
%MONTH%	Current month MM.
%MONTHNAME%	Name of current month.
%DAY%	Current day.
%WEEKDAY%	Current day of week, e.g. 'Friday'.
%TIME%	Current time HH:MM:SS.
%TIMESTAMP%	Current time stamp, YYYY-MM-DD-HH.MM.SS.MSMSMS
%DEFAULTPATH%	This variable inserts the standard path value from the standard settings of the *ZIP module.

Encryption (ENCRYPT) - only for OUTFORMAT(*ZIP)

The entries on the Zip-archives can be encrypted. Therefore you have to set following parameters.

Password

The passowrd with which entries can be decrypted afterwards.
Possible special values:

*NONE

No encryption is happening.

CCSID

The codepage that is used for entering the password.
Possible special values:

*DFT	The standard ASCII Codepage 819 is used.

Strength

The stage on which AES encrypts.
Possible special values:

128	AES uses a key length of 128 bit.
192	AES uses a key length of 192 bit.
256	AES uses a key length of 256 bit.

Method

The method that is used for the encryption.
Possible special values:

*STD	The standard encryption method is used.
*AES	The AES encryption method is used.

CCSID of entry name (ENTRYCCSID)

This parameter can set the entry name CCSID (Coded character set identification) if a detection problem occurs. The content of the files is not affected.
A complete list of all CCSID can be found in the Appendix
Possible special values:

*AUTO

Reads the CCSID from the archive (recommended).