Menu item 2: Add an entry to the archive (ADDARCHIVE)
This command is used to add files to an archive.
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 specifix file-system -shown by "- only for FS(*IFS)" and "- only for FS(*DB2)" -, that is only shown if it was chosen before
The command to add entries to an archive is
ADDARCHIVE| Parameter | Description | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| FS | Name of the file-system where the archive is located.
| ||||||||||||||||||||||||||||||
| ARCPATH | only for FS (*IFS) Complete path (i.e. /usr/usrlib1/test.zip) for the archive-file. Following variables are available in any combination. The according path is generated automatically:
| ||||||||||||||||||||||||||||||
| ARCFILE | Only for FS(*DB2) The qualified name of the archive-file.
| ||||||||||||||||||||||||||||||
| ARCASP | Specifies the auxiliary storage pool (ASP) device name where storage is allocated for the library containing the object to be used (the ARCFILE parameter). If the library is in an ASP that is not part of the thread's library name space, this parameter must be specified to ensure the correct object is used. | ||||||||||||||||||||||||||||||
| FORMAT | The format the archive was created in
| ||||||||||||||||||||||||||||||
| CMPTYPE | The method with which the archive is to be compressed. The selection depends on the selected archive-format. When using the special value *DEFAULT the system selects the default mmethod according to the selected archive type. Possible special values for Tar, Ar and Cpio:
| ||||||||||||||||||||||||||||||
| DTATYP | Sets, which type of files should be added to the archive. *FILE *SPOOL | ||||||||||||||||||||||||||||||
| INFS | Sets, from which file-system the files are chosen. *DB2 *IFS | ||||||||||||||||||||||||||||||
| FILE | Only for DTATYP(*SPOOL) The file name of the Spool-file or one of the following special values. *SELECT *generic Part of the file name may be substituted with an asterisk (*). Please enter the first part of a file or file group name followed by (*) to select all files, whose name begins with the first part entered. | ||||||||||||||||||||||||||||||
| JOBNAM | Only for DTATYP(*SPOOL) Mit der Angabe eines qualifizierten Jobnamens können Sie die Selektion der zu archivierenden Spooleinträge weiter spezifizieren. Geben Sie hier einen bestehenden Jobnamen an, um nur Spooleinträge dieses Jobs zu archivieren. *ALL *CURRENT | ||||||||||||||||||||||||||||||
| SPLNBR | Only for DTATYP(*SPOOL) The numbers of the devices on which the printed editions are created are usable for the selection. | ||||||||||||||||||||||||||||||
| USER | Only for DTATYP(*SPOOL) Users that created entries can be added to the selection of spool entries. *ALL *CURRENT | ||||||||||||||||||||||||||||||
| OUTQ | Only for DTATYP(*SPOOL) Name of the outcoming-queue(s) from where entries are processed. *ALL | ||||||||||||||||||||||||||||||
| FORM | Only for DTATYP(*SPOOL) The spool-entreis can also be selected by form-names. *ALL *STD | ||||||||||||||||||||||||||||||
| USRDTA | Only for DTATYP(*SPOOL) The spool-entry "user data" can be used for the selection as well. *ALL | ||||||||||||||||||||||||||||||
| STATUS | Only for DTATYP(*SPOOL) With this setting you set, how the printed editions are to be selected depending on their current status in the system. *ALL *CLOSED *DEFERRED Only spooled files with the status *DEFERRED will be selected. *SENDING Only spooled files with the status *SENDING will be selected. *FINISHED Only spooled files with the status *FINISHED will be selected. *HELD Only spooled files with the status *HELD will be selected. *MESSAGE Only spooled files with the status *MESSAGE will be selected. *OPEN Only spooled files with the status *OPEN will be selected. *PENDING Only spooled files with the status *PENDING will be selected. *PRINTING Only spooled files with the status *PRINTING will be selected. *READY Only spooled files with the status *READY will be selected. *SAVED Only spooled files with the status *SAVED will be selected. *WRITING Only spooled files with the status *WRITING will be selected. | ||||||||||||||||||||||||||||||
| DEVICE | Only for DTATYP(*SPOOL) The names of the devices on which the printed editions are created are usable for the selection. *ALL | ||||||||||||||||||||||||||||||
| PERIOD | Only for DTATYP(*SPOOL) If parameter spoolfile is set to *SELECT, this parameter specifies the time period for the spoolfiles to be selected. The time period is defined by naming a start and ending time. Element 1: Start time of day Element 2: Start date *FIRST Element 3: End time of day. | ||||||||||||||||||||||||||||||
| FRMPATH | Only for INFS(*IFS) The name of the path in the IFS-file-system, from which files are read and added to the archive. I.E. „/usr/usrlib/lib1". Separator between the paths is a simple "/". A separator in the end is not neccessary. | ||||||||||||||||||||||||||||||
| FRMIFSFILE | Only for INFS(*IFS) The name of the entry-file to be used in the entry-path. By using „*" and „?" multiple files can be chosen. * Replaces any number of characters in the file name. ? Replaces exactly one character in the file name. | ||||||||||||||||||||||||||||||
| NEWFILES | Only for INFS(*DB2) The qualified name of the file that is to be added. *ALL Library *LIBL *CURLIB Member | ||||||||||||||||||||||||||||||
| NEWFILEASP | Specifies the auxiliary storage pool (ASP) device name where storage is allocated for the library containing the object to be used (the ARCFILE, NEWFILES parameter). If the library is in an ASP that is not part of the thread's library name space, this parameter must be specified to ensure the correct object is used. *CURASP *SYSBAS *CURASP Name DSpecify the name of the primary or secondary ASP device to be searched to find the library. The primary or secondary ASP must have been activated (by varying on the ASP device) and have a status of 'Available'. The system ASP (ASP 1) and defined basic user ASPs (ASPs 2-32) will not be searched.
| ||||||||||||||||||||||||||||||
| CREATE | If the selected archive does not exist yet, you can choose here if a new archive should be created automatically. *YES *NO | ||||||||||||||||||||||||||||||
| REPLACE | If the files that are to be added should already exist in the archive, this parameter says what has to happen with the file that exists in the archive. When searching for redundant files the parameter NAMEFMT () should be taken care of. The build up of the pathname and therefore the name of the eventually already existing entry in the archive depends on these values. *ADD *REPLACE | ||||||||||||||||||||||||||||||
| NAMEFMT | For creating a pathname that is entered in the archive, following patterns can be used. The file MYLIB/MYFILE (MYMEMBER) is placed as shown in the patterns. The selection of the pattern is oriented on the aimed system on which the file shall be reproduced: *FILE *MEMBER *NAMEFMT0 *NAMEFMT1 The name of the archive file is created according to the rules for the name format "1. " The unspecified sample file contains the name: „QSYS.LIB/MYLIB.LIB/MYFILE.FILE/MYMEMBER.MBR" | ||||||||||||||||||||||||||||||
| SPEED | Only for FORMAT(*GZ) oder COMPRESS(*GZ) i-effect is able to vary the algorithm in different stages from "fast but barely compressed" to "slow but highly compressed". By choosing 1 the program reaches its highest speed, choosing 9 leads to the highest compression but is significantly slower. The user can use his prefered setup and take different machine-resources into account. | ||||||||||||||||||||||||||||||
| ARCENAME | One or many entries that are placed in the archive by this command get their entry-name based on these settings. You can use *DEFAULT for the scheme used in the parameter NAMEFMT () to create an entry-name based on the name of the entered file or name it yourself in this parameter. *DEFAULT The registration name will be created from the input file name. The name format set by NAMEFMT ( ) will be used for the file *NAMEONLY The original entry file name is used as entry name to the archive. When using DB2 archive entries, this is the name of the member file. When using IFS for archive entries, this is the file name without the path name. By using *NAMEONLY, the entry in NAMEFMT ( ) is not considered. | ||||||||||||||||||||||||||||||
| CRLFINSERT | Only for INFS(*DB2) While compressing, i-effect can add a line insertion control character in the end of every read data record. If this parameter is given with *YES, i-effect adds the end of every read data record with the character CRLF (carriage return - line feed (X'oD25?)). If *NO is selected, NO additional control characters appear. This function could be helpful if the receiver of the files has to reproduce the original syntax of the files (text files). In this case the usage of the parameter with *YES is needed. *YES *NO | ||||||||||||||||||||||||||||||
| BLANKCOMP | Only for INFS(*DB2) Together with the parameter "enter wordwrap", the "suppress following blank characters" can be used to modify the files ahead of the compression. If following blank spaces of a data record shall not be taken into the compressed file, you can do this by entering *YES, so i-effect deletes these blank spaces. If you use CRLFINSERT(*YES) simultaniousely the blankspaces are deleted BEFORE a line insertion control character us added.. *YES *NO No characters will be removed. | ||||||||||||||||||||||||||||||
| FRMCCSID | The given information for CCSID (Coded character set identification) if the source file is used by i-effect to implement the character set during the processing. Here you can enter EBCDIC- and ASCII-character sets. If source- and target-CCSID are the same, nothing is implemented. *JOB 1-65535 | ||||||||||||||||||||||||||||||
| TOCCSID | The given information for CCSID (Coded character set identification) of the target files uses i-effect for implementing the character sets during the processing. Here you can enter EBCDIC- and ASCII-Character sets. If the source- and target-CCSID are the same, nothing is implemented. *JOB 1-65535 | ||||||||||||||||||||||||||||||
| ENCRYPT | Only for FORMAT(*ZIP) The parameter Encryption is used to encrypt and decrypt ZIP archive entries according to the AES standard. This allows entries to be protected against unauthorized access by entering a key up to 256 bits long. Such a protected archive can also be edited by AES compatible applications like WinZip(R) V9. *NONE The archive entry is not encrypted CCSID of the password The specification of the CCSID (Coded character id), in which the password was originally entered. With *DFT we use the standard ASCII code page 819. encryption strength The size of the key to be used. You can choose between 128, 192 and 256 bits. | ||||||||||||||||||||||||||||||
| PASSWORD | Only for FORMAT(*SEVENZIP) The Encryption parameter is used to encrypt and decrypt 7z archive entries. *NONE | ||||||||||||||||||||||||||||||
| DELETE | After processing a file, the original can be deleted if desired. *YES The successfully processed input member is deleted. If the file does not contain any other members, the file is also deleted. *NO No meber/files are deleted. | ||||||||||||||||||||||||||||||
| NULLCOMP | A file to be compressed may contain fill characters with the value X'00' at the end of the file. This is done, for example, by transferring data from other systems via FTP to the DB/2 file system of the Power Systems. However, it is also possible that these characters are a mandatory part of the data to be compressed. This parameter can be used to specify whether the characters described above are to be compressed at the end of the file or not. Alternatively (this is necessary for certain applications) the number of x'00' fill characters can also be filled to an even number of fill characters. *ALLNULL All characters with the value X'00' at the end of the last data record of a physical file are processed and compressed. *NONULL All characters with the value X'00' at the end of the last data record are ignored and NOT compressed. *EVENNULL i-effect ignores all characters with the value X'00' at the end of the last data set of a physical file, but inserts ONE X'00' characters if the total number of bytes to be compressed is odd. This ensures that the number of bytes in the file after decompression is always an even number. (This may be necessary for certain software products on other systems.) | ||||||||||||||||||||||||||||||
| ENTRYCCSID | The CCSID (Coded character set identification) of the entry name can be set with this parameter in case of detection problems. The contents of the files are not affected. *AUTO Reads the CCSID from the archive (recommended). | ||||||||||||||||||||||||||||||
| RCDLEN | Specifies the length (in bytes) of the data records stored under the physical file. A value in the range from 1 to 32766 bytes for the record length can be specified. The default record length is 80 bytes. | ||||||||||||||||||||||||||||||
| SIZE | Specifies the initial number of records in each part file of the file, the number of records for each extension that is added to the part file, and the number of repetitions in which the extension is automatically applied. The number of records for each part file is specified as the total number of records that can be stored there (including deleted records). *NOMAX The number of records that can be added to each part file of the file is not limited by the user. The system determines the maximum number of data | ||||||||||||||||||||||||||||||
| STMFCODPAG | Mit dem Parameter STMFCODPAG (Stream File Code Page) können Sie Folgendes festlegen die Art und Weise, wie i-effect Daten aus dem Format konvertiert, in dem sie gespeichert sind wird auf der iSeries (typischerweise EBCDIC) in einem geeigneten Format gehalten in die Stream-Datei (typischerweise ASCII). Sie können einen der speziellen Werte verwenden: *ISOASCII |
to 7z format: If an encrypted 7z archive is modified by adding (ADDARCHIVE) or deleting (DLTARCHIVE) an entry, then the archive is completely decrypted. This is because the complete archive has to be written again and the *ZIP module only supports decryption, but no encryption.