Menu item 7: Simple GZIP compression (STRGZIP COMPRESS(*COMP))

1) From the i-effect Compression menu enter menu item 7 "Simple GZIP Compression". The command STRGZIP COMPRESS (*COMP) can also be used.

2) Fill in the fields as required and press enter. i-effect will start working and will show its progress in the display.

The screen content will vary, depending on whether the archive is from the DB2 or IFS file system, and whether it is to be extracted into the DB2 or IFS files system.

File System Entry (FS)

The files can be compressed in the DB2 file system (a physical file will be created) or in the IFS file system (the "Root" file system of IBM System i). Enter the choice of data system and press enter to move to the next display.

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

Input File (FRMFILE) - Only with FS (*DB2)

The files/member files are indicated by a qualified name. Either one member file of a file, or all of a file's members, or all member files of all files can be edited. i-effect can search a library for the desired files as member files. The entry consists of three components (member/library/file).

File

Either a specific file can be entered or the following special value can be used to determine which files will be used.werden.
Possible Special Value:

*ALL	All files will be used. For every file found exactly one output file will be created.

Library

Name of the input library.
Possible Special Value:

*CURLIB

The required files will be sought in the current library.

Member

To determine the member files, a specific member file or the following special value can be indicated.
Possible Special Value:

*ALL	All member files will be edited. For every member file found, exactly one compressed output file will be created.

Input Path (FRMPATH) - only with FS (*IFS)

The name of the path in the IFS files system, from which the files will be read and compressed, e.g. "/usr/usrlib/lib1. " The separating mark between the paths is a simple backslash. A backslash at the end of path entry is not needed.

Input File (FRMIFSFILE) - only with FS (*IFS)

The name(s) of the input file(s) in the input path. By using the wild cards "*" and "?" several files can be chosen at once.
Possible Special Characters:

*	Replaces any number of characters in the file name.
?	Replaces exactly one character in the file name.

File System Output (OUTFS)

The file system type in which the output files are copied. It is possible to compress files in and out of the IFS, and in and out of DB2 systems respectively.
Possible Special Values:

*FRMINPUT	The files will be put into the same file system that they came from.
*IFS	The data will be put into the IFS file system.
*DB2	The data will be put into the DB2 file system.

Output File (TOFILE) - only with OUTFS (*DB2)

The name of the target file can be created from the name of the input file by entering *GZNAME. The name will have the ending .GZ. The file SALES would be named SALES.GZ, for example. The user can enter the desired output file name in this field as well.
Possible Special Values:

*GZNAME	The name of the output file will be created with the name of the input file and ".GZ."
*FRMFILE	The name of the output file is the same as the name of the input file.

Output Member File (TOMBR) - only with OUTFS (*DB2)

The name of the target member file can be created from the name of the input member file by entering *GZNAME. The name will contain the ending .GZ. The member file SALES07 will become SALES07.GZ, for example. The user can enter the output member file's name in the field.
Possible Special Values:

*GZNAME	The name of the output member file will be created with the name of the input file and ".GZ."
*FRMFILE	The name of the output member file is the same as the name of the input file.

Output Library (TOLIB) - only with OUTFS (*DB2)

The name of the output library must be entered. By entering *FRMLIB, the data will be exported into a file which will be put in the same library in which the input file was opened.
Possible Special Value:

*FRMLIB

The name of the output library corresponds to the input library.

Output Path (TOPATH) - only with OUTFS (*IFS)

Name of the path in which the compressed files are put, e.g. "/usr/userlib1."
Possible Special Value:

*FRMPATH

The name of the output path corresponds to the name of the input path.

Output File (TOIFSFILE) - only with OUTFS (*IFS)

The name of the output file. If only one file is to be compressed, the name can be defined here.
Possible Special Value:

*GZNAME

The name of the output file will be created by adding the gzip ending "GZ" to the name of the input file, e.g. /tmp/test.dat becomes /temp/test.dat.gz

Record Length Output File (OUTRECL) (*DB2)

The record length of the output file can be directly determined here, or automatically determined by i-effect. If *AUTO is entered in this parameter, i-effect uses the record length of the input file for the output file.
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).

Action (COMPRESS)

Tells the program which processes are to be executed.
Possible Special Values:

*COMP	The data of the input file(s) will be compressed by using this parameter.
*DECOMP	The compression of the data in the specified input files will be removed.

Rate of Compression (SPEED)

i-effect can vary its compression speed at 9 different levels. With level 1 the program has the maximum speed, however without maximum compression. Level 9 has maximum compression, but the program runs more slowly. Users can set their own values depending on their needs and variables such as storage space, processor speed, etc.

Use Original Name (NAME)

If needed, the name of the input file can be used in the compressed data. The receiver of the compressed data can save the file under the same name or use the information over the original file name for editing. With *Yes the function is activated. The option *NO stops the adding and later expanding of the name.
Possible Values:

*YES	The original name of the input file will be added.
*NO	The original name will not be entered.

Naming (ENAME)

If the insertion of the original name into the gzip file is desired, this parameter determines how the name will be provided. The name can be created by entering *DEFAULT from the name of the input file/member, or path name, or the name which has been entered in this parameter will be used.
Possible Special Values:

*DEFAULT

The name will be created from the input member file or the input file without the path name.

Insert CRLF (CRLFINSERT)

i-effect can insert form feed characters at the end of every data record. When *YES is specified in this parameter, i-effect completes the end of every data record read with the character CRLF (carriage return - line feed (X'0D25')). If *NO is given, then NO further insertion of control characters follows. This function can be required when the recipient of the data has to restore the original record structure in the file (text data). In this case, using the parameter *YES is required.
Possible Special Values:

*YES	The EBCDIC control character for CRLF will be inserted at the end of the record.
*NO	No additional characters will be inserted.

Delete Subsequent Blanks (BLANKCOMP)

The parameter BLANKCOMP(to delete subsequent blanks) can be used along with CRLFINSERT to modify the data before compression. When the subsequent blanks of a data record should not be included in the compressed file, i-effect^® can remove these blanks if *YES has been entered. Simultaneous use of CRLFINSERT (*YES) will remove the blanks BEFORE the line feed control character is inserted.
Possible Special Values:

*YES	All blanks (Blanks, X'40') at the end of a data record will be re-moved.
*NO	No characters will be removed.

From CCSID (FRMCCSID)

i-effect uses the indicated CCSID (Coded Character Set Identification) of the source data to translate fonts during processing. EBCDIC and ASCII fonts can be indicated. There will be no translation if the source and target CCSID are identical.
A complete list of all the CCSID can be found in Chapter 14 "Appendix"
Possible Special Value:

*JOB	The CCSID of the job will be used.

To CCSID (TOCCSID)

i-effect uses the indicated CCSID (Coded Character Set Identification) of the target data to translate fonts during processing. EBCDIC and ASCII fonts can be indicated. There will be no translation if the source and target CCSID are identical.
A complete list of all the CCSID can be found in Chapter 14 "Appendix"
Possible Special Value:

*JOB	The CCSID of the job will be used.

Delete after Editing (DELETE)

If desired, the original file can be deleted after it has been edited.
Possible Special Values:

*YES	The input member file will be deleted after it is processed. If the file has no more members, then the whole file will be deleted.
*NO	The input member file will be deleted after it is processed. If the file has no more members, then the whole file will be deleted.

Handle X'00' at EOF (NULLCOMP)

Files to be compressed may have the filling character with the hexadecimal value of 00. This can happen if files are transferred from other systems via FTP into the DB2 data system of Power Systems. It is possible that these characters are part of the data that will be compressed.
This parameter can specify if these characters should be compressed or not.
The number of X'00' filling characters can be adjusted to an even number, which may be required by certain applications.
Possible Special Values:

*ALLNULL	All characters with the value X'00' at the end of the last data record of a physical file will be processed and compressed.
*NONULL	All characters with value X'00'at the end of the last data record of a physical file are to be disregarded and NOT compressed.
*EVENNULL	i-effect ignores all characters with the value X'00' at the end of the last data record of a physical file, inserts however ONE X'00' character, in case the total number of bytes to be compressed is odd. This guarantees that the number of bytes of the file after decompression will always be an even number, which may be required by certain applications.

When compression is finished a status message will appear and the job protocol will give a detailed summary of the number of compressions, errors, and overread files.
The job protocol contains detailed information:

The last diagnostic message contains the total number of processed files.