Menu item 3: Extract entry from archive (EXTARCHIVE)

This command extracts an entry from the archive.

Choose in the "i-effect Compression tasks" menu the item 3 „Extract entry from the archive" . Also you can enter the command EXTARCHIVE directly.
The display that is now shown enables choosing further parameters that are to be used for decompressing and extraction. Enter the parameters after the following explanation.

It is possible in i-effect to extract files out of DB2- as well as IFS-archives as needed in the DB2 of IFS-data-system.

The display on this screen depends on the entry of the previous parameters. This is shown by the addition of "- only for...". For example are parameters, that depend on a specific data-system - shown by "- only forFS(*IFS)" and "- only for FS(*DB2)" - only visible if this is previousely selected.

Data-system (FS)

Name of the data-system where the archive is located.
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 there is no specification needed to extract an entry. For Tar, Ar and Cpio the method has to fit to the existing archive, if one was entered during the creation. For the 7z-format the method should be selected that was chosen for the creation because otherwise the archive will be converted.
Possible special calues 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:

For the Zip-format, no specification is needed while extracting an entry.

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

The qualified name for the archive-file.

Library

Name of the library where the archive-file 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-path (ARCPATH) - only for FS (*IFS)

Complete path (z.B. /usr/usrlib1/test.zip) to the archive-file.
The following variables are not bound to any specific combination. The fitting 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.

Following number or name (NAMEPOS)

A file can be found on two ways inside the archive. One is by using the relative position in the archive, the other one uses the exact file-/path-name of the file as well as the creation date and time. You can select the type of search in this parameter.
Possible special values:

*POS	The file choice is made according to the specific order of appearance in the archive.
*NAME	The file choice is made according to the name and creation date/time.

Following number (FOLGE) - nur bei NAMEPOS(*POS)

Enter the position number in the archive.
Possible special values:

*ALL	All entries from the archive are chosen.

Path (FILEPATH) - only for NAMEPOS(*NAME)

If you chose the selection by name, in this parameter the exact pathname is expected. it has to fit EXACTLY with the pathname in the archive to be selected.

Date (FILEDATE) - only for NAMEPOS(*NAME)

If you chose the selection by name you can additionally give the date with this parameter. The entry in the archive has to be assigned with this date so the search is successful.
Possible special values:

*ANY	Any date will be used for file selection.

Time (FILETIME) - only for NAMEPOS(*NAME)

If you chose the selection by name you can additionally give the time with this parameter. The entry in the archive has to be assigned with this time so the search is successful.
Possible special values:

*ANY	Any time will be used for file selection.

File-system for the output (OUTFS)

Type of the file system where the output files are deposed. It is possible to decompress files from IFS to DB2 and the other way round.
The following values are possible:

*IFS	The data will be extracted into the IFS file system.
*DB2	The data will be extracted into the DB2 file system.

Output library (OUTLIB) only for OUTFS(*DB2)

For selecting for the name of the output library cou can choose a name of an already existing library or give one of the following special values.
Possible special values:

*FRMPATH

The name of the output library is created from the path name of

the file in the archive. The path name must be either in the

*NAMEFMTO or *NAMEFMT1.

Examples:

"PATH/PATH/MYLIB/MYFILE.MYMEMBER" -> MYLIB will be used as the library name.

"QSYS.LIB/MYLIB.LIB/MYFILE.FILE/MYMEMBER.MBR" ->

MYLIB will be used as the library name

Writing in the special library QTEMP is not supported.

Record length output file (OUTRECL) - only for OUTFS(*DB2)

For the extraction of an entry from the archive in a physical file of the DB2-file-system a record length has to be given. It is recommendet to use the value *AUTO.
Possible special values:

*AUTO

By using *AUTO with the decompression, the decompressed data will be analysed. If control characters are found, the output file will be created with the record length which is required to

accommodate all data records (the file has the record length of the largest record found).

Output path (TOPATH) - only for OUTFS(*IFS)

The name of the path where the finished extracted files shall be copied to.
Possible special values:

*FRMPATH

The name of the output path is determined by the path of the archive file. The path must be in one of the following formats in the archive:

E.g.:path/path/path/LIBRARY/FILE.MEMBER

QSYS.LIB/LIBRARY.LIB/FILE.FILE/MEMBER.MBR

Files can be added to the archive by entering NAMEFMT(*NAMEFMT0) or NAMEFMT(*NAMEFMT1)

Replace existing files (REPLACE)

If the file that should be extracted already exists, the instruction in this parameter controls if the original file is replaced or not.
Possible special values:

*YES	The data will replace the existing data.
*NO	No extraction will take place. The existing data will be retained.

From CCSID (FRMCCSID)

The selection of the CCSID (Coded character set identification) of the source-files is used by
i-effect to work with the character sets during the processing. Here, EBVDIV- and ASCII-character sets can be used. If source- and target-CCSID are identical, nothing will happen.
A complete list of all CCSID can be found in the Appendix
Possible special values:

*JOB	The CCSID of the job will be used.

To CCSID (TOCCSID)

The selection of the CCSID (Coded character set identification) of the target-files is used by
i-effect to work with the character sets during the processing.Here, EBVDIV- and ASCII-character sets can be used.If source- and target-CCSID are identical, nothing will happen.
A complete list of all CCSID can be found in the Appendix
Possible special values:

*JOB	The CCSID of the job will be used.

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

Entries in Zip-archives that have been encoded and encrypted 7z-archives need a password to be read.
Possible special values:

*NONE

No password is used.

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

*DFT	The standard ASCII Codepage 819 is used.

Delete entries? (DELETE)

Sets, if the entries after extracting should be deleted from the archive.
Possible special values:

*YES	The entry is deleted from the archive after the extraction.
*NO	The entry stays in the archive.

Output queue (OUTQ) - only for DTATYP(*SPOOL)

Sets, in which output queue the restored spool-files are submitted. The data-type (DTATYP) is detected autamatically if this is supported by the format of the archive.
Possible special values:

*SAME

The same output queue is used from which the spool file was taken during transmission into the archive

Library Name of the library that contains the output queue.

Hold spool-file? (HOLD) - only for DTATYP(*SPOOL)

Sets, if the spool-file is held after extracting or printed automatically. The data-type is detected automatically, if this is supported by the archive-format.
The following values are possible:

*YES	Spooled files will be held (not printed) if they have *HLD status.
*NO	Spooled files will be printed if they have *RDY status.

Save the spool-file? (SAVE) - only for DTATYP(*SPOOL)

Sets, if the spool-file is saved or deleted after printing. The data-type is detected automatically, if this is supported by the archive-format.
Possible special values:

*YES	The spool-file is saved after printing.
*NO	The spool-file is deleted after printing.

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).