i-effect Manual

Menu item 4: Delete entry from archive (DLTARCHIVE)

This command deletes an entry from the archive.

  1. In the i-effect compression menu you enter item 4 "Delete an entry from archive". You can enter the command DLTARCHIVE directly aswell.

  2. The now displayed screen enables you to set further parameters that are used for deleting. Enter these parameters like in the following description.

The display on the screen depends on the previousely entered parameters. This is shown by "- only for ...". For example are parameters, that depend on a specific file system - shown by "-only for FS(*IFS)" and "- only for FS(*DB2)" -, only shown if it was marked previousely.


File system (FS)

Name of the file system where the 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 (FORMAT)

The format in which the 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 (COMPRESS)

The method of compression depends on the format. For the Zip-format there is no specification needed to delete an entry. For Tar, Ar and Cpio the method has to match with the existing archive in case it was given during the creation. For the 7z-format you should use the same method you did during the creation, otherwise the archive will be converted.
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:

For the Zip-format no specification is needed for deleting an entry.

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

The qualified name of 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-file (ARCPATH) - only for (*IFS)

Name of the complete path of the archive-file that is to be created (e.g. /usr/usrlib1/test.zip). With this name a new file is created in the end of the path you entered, whose content matches the format of an empty ZIP-archive.

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.



Hint for the 7z-format:
If an encrypted 7z-archive is modified by adding (ADDARCHIVE) or deleting (DLTARCHIVE) an entry, the whole archive is going to be decrypted afterwards. This is due to the fact that the whole archive has to be overwritten and the *ZIP module supports only decrypting, not encrypting.


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

Encrypted 7z-archives need a password to work.
Possible special values:

*NONE

No password is used.

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

*DFT

The standard ASCII Codepage 819 is used.


Following number or name (NAMEPOS)

A file can be found in the archive on two ways. You can do it by giving the relative position in the archive or by giving an exact specification of the file- and path-name as well as date and time of creation. In this parameter you choose the way you want to search.
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) - only for 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)

For selection by name you have to give the exact path name in this parameter. It has to match EXACTLY with the pathname in the archive to be found.

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

For selection by name you have to give the date of the file in this parameter. The entry in the archive has to be marked with this date to be found succesfully.
Possible special values:

*ANY

Any date will be used for file selection.


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

For selection by name you have to give the time of the file in this parameter. The entry in the archive has to be marked with this time to be found succesfully.
Possible special values:

*ANY

Any time will be used for file selection.


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