Home

PKZIP OS400 User`s Guide 5.5.0

Contents

1. AQZ0298 40 Invalid Code Page for Spool File conversion Explanation While trying to convert a Spool File to ASCII text it was found the code page was invalid Review parameter IFSCDEPAGE for overrides Error occurred while using Page Code from amp 1 to amp 2 AQZ0299 40 Spool File Target File Cannot be named GEN1 nor GEN2 nor start with an Explanation Spool file Parameter SFTGFILE cannot have file names GEN1 and GEN2 This is to prevent mistakes by leaving off the leading SFTGFILE cannot start with an other than special names GEN1 GEN1P and GEN2 92 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0300 10 A Specific File name was specified in SFTGFILE but more than 1 spool file was selected Explanation When specifying a file name in SFTGFILE only one spool file can be selected Correct selection and re run AQZ0401 40 Memory allocation failure while processing Parameters amp 1 amp 2 Explanation A failure occurred while trying to allocate memory Check other messages in Job Log for possible causes and refer to Appendix C about memory errors If this continues please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0402 40 I O Error 6 amp 1 Explanation An I O error occurred This message will help describe a previous message Review all messages in job log to resolve problem AQZ0403 40 Open error occurred on Translate table lt amp l gt Explanati
2. AQZ0837 00 A sub field with ID amp 1 with a length of amp 2 bytes Explanation This is only used in DEBUG mode only Information with TYPE VIEW and VIEWOPT DETAIL AQZ0838 00 Explanation Displays a View file separator for reading purposes Information with TYPE VIEW and VIEWOPT DETAIL AQZ0839 00 Found amp 1 file amp 2 amp 3 bytes uncompressed amp 4 bytes compressed 6 amp 5 Explanation Displays the total number of files found in the archive amp 1 Displays the total bytes uncompressed amp 3 and the total bytes compressed amp 4 for the archive Information with TYPE VIEW and VIEWOPT DETAIL Chapter 12 Messages 113 AQZ0840 00 IFS Code Page amp l Explanation Displays the Code Page of a Integrated File System File in the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0841 00 IFS Creation Time amp 1 Explanation Displays the Creation Date and Time of a Integrated File System File in the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0842 00 IFS Access Time amp 1 Explanation Displays the Last Access Date and Time of a Integrated File System File in the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0843 00 IFS Modification Time amp 1 Explanation Displays the Last Modification Date and Time of a Integrated File System File in the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0844 00 Lib
3. TMPPATH TRAN TYPARCHFL TYPFL2ZP TYPLISTFL VERBOSE VIEWOPT HELD CLOSED SAVED PENDING DEFERRED blanks eS Job name Userr Name Job Number SPLF TEXT TEXT1 TEXT2 PDF GEN1 GEN2 GENIP path filename NO YES ALL Spool File Name ALL LAST Spool File Number 1 9999 STOREPATH ENO YES CURRENT Temporary Path INTERNAL Member Name DB IFS DB IFS DBA SPL DB PUES NORMAL NONE ALL MAX NORMAL DETAIL BRIEF COMMENT Chapter 9 PKZIP Commands 35 VIEWSORT ASIS PERCENTR DATE SIZE DATER SIZER NAME NAMER VPASSWORD Archive Verify Password PERCENT PKZIP Command Keyword Details TYPE TYPE ADD DELETE EXTRACT FRESHEN MOVEA MOVEF MOVEU UPDATE VIEW The TYPE keyword specifies the type of action PKZIP should perform on the ZIP archive The possible actions are ADD The ADD option is the default and adds a selection of files to the archive file If an archive is already present it will be written over by the new archive file UPDATE The UPDATE option updates files which are already in the archive file with a newer version and will also add newly selected files that are not present in the ar chive file FRESHEN The FRESHEN option updates ONLY the files which alr
4. 222 2 2 s s ceeeeececeeeeeeeeeeeeeceeeceeeeeeeeneeeeneenee 18 Path and Path NAMES 2 224 3 26 cee a dd ltda 18 Stream Rles 2d rra a ada a etal okies 18 Other IFS ODO US a 18 ile Sysiems inthe FS a aia ias 18 Document Library Services File System QDLS ooooooccccccccccocococoooooonnnnnnnnnnnonononnnnnos 20 Optical File System OPT around ra tada Aaa 20 Using QSYS LIB Through the Integrated File System Interface o 21 ESMAS Is 21 SAV Bre ERE OEA e da di a da dedo cat dede rad ea oo dea el do 22 Compressing a SAVE cucuta ts 22 Extracting Records into a SAVE fil 2 2022 c 2 ccccceeceeceeeeceeceeeeceeceeeecee cece 22 To overwrite a current SAVE file cece ccc ecccccecaeceeceeceeeeceecuecueceeaesaeceeeeaesaeeneentaees 22 SPOOL RES mando doc load il eld add do et be nt ind ba ne edd 23 CHAPTER 7 ZIP ARCHIVES 2 2 200c00ccesececcnecenececceescnecnecueccescessenscnecnnecescnecensceseeass 25 OLD ZIP ARCHIVE cccccccceccecececceceeeececcceceecuceaeececeaceceeceeeaeeteecauedeeceeeneeseseueeseeseseaeesees 25 TEMPORARY ARCHIVE FILE acia aa did oa ias 25 NEW ZIP ARCHIVE 3 a de ed ted too dd es dd do dd e o do 26 CHAPTER 8 EXTENDED ATTRIBUTES 0 cs ceeceecceeceecceeceeceeeceeceeceeeeeceeeeeeeeeeeees 27 STANDARD QSYS LIBRARY FILE SYSTEM ATTRIBUTES 0ccecceceeceececceccecaeceecesseeaeceseneeees 27 Physical Files both Source and Data ooooococccococococonon
5. DATEAB mmdd ADVCRYPT ZIPSTD ve i E DATETYPE NO BEFORE AES256 AFTER ARCHIVE Archive Zip File name with path DBSERVICE NO YES ARCHTEXT NONE Archive File Text description DELIM CRLF CR COMPAT NONE LF PK400 LFCR COMPRESS FAST DFTARCHREC 132 MAX decimal number STORE TERSE DIRNAMES YES NO CRTLIST NONE pathfilename DIRRECRS NONE FULL CVTDATA External Pgm Conversion Extended Data NAMEONLY 34 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 EXCLFILE EXCLUDE EXTRAFLD ERROPT FILES FILESTEXT FILETYPE FTRAN GZIP IFSCDEPAGE INCLFILE MSGTYPE PASSWORD SFUSER SFQUEUE SFFORM SFUSRDTA SFSTATUS NONE path filename file_specificationl file_specification2 file_specificationn YES NO END SKIP file_specificationl file_specification2 file_specificationn NO ALL NEW UPDATE TEXT BINARY EBCDIC FIXTEXT DETECT INTERNAL Member Name YES NO NO Code page NONE path filename PRINT SEND BOTH Archive Password CURRENT user id 1 user id 2 user id 5 ALL Library Outq ALL STD Spool File Form Type ALL Spool File User data ALL READY SFJOBNAM SFTARGET SFTGFILE STOREPATH SPLFILE SPLNBR
6. Explanation In extracting file amp 1 it was identified to be created as an EF NTSD file The EA data is missing and the file will be not be extracted AQZ0228 00 Field entry EF block length amp 1 bytes exceeds remaining EF data amp 2 bytes Explanation Inconsistent Extra Field data was found it will be ignored The extracted file data should be good AQZ0231 00 amp 1 Bad CRC for extended attributes Explanation A bad CRC was found in the extended attributes for an archive created by an OS 2 system Extended Attributes are ignored AQZ0232 00 amp 1 Unknown compression method for EAs 42 Explanation An unknown compression method found for an archive created by an OS 2 system File is not extracted Run PKUNZIP with TYPE VIEW and VIEWOPT ALL to see ar chive details AQZ0234 00 amp 1 archive amp 2 successfully processed Explanation Informational amp 1 is the number of files that were processed successfully in the archives 84 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0235 00 amp 1 archive amp 2 had warnings but no fatal error Explanation Informational amp 1 is the number of files processed in the archives that issued a warn ing Review job log for their warnings AQZ0236 00 amp 1 archive amp 2 had fatal errors Explanation There were amp 1 files in the archives that had a fatal error and could not be processed Review job log for messages of the files that failed
7. PKZIP for OS 400 User s Guide PKOU V5R5000 PKWARE Inc PKWARE Inc 9009 Springboro Pike Miamisburg Ohio 45342 Sales 937 847 2374 Support 937 847 2687 Fax 937 847 2375 Web Site http www pkzip com Sales E Mail pksales pkware com Support http www pkzip com support 5 5 Edition 2003 PKZIP for MVS PKZIP for OS 400 PKZIP for VSE PKZIP for UNIX and PKZIP for Windows are just a few of the many members in the PKZIP family PKWARE Inc would like to thank all the individuals and companies including our customers resellers distributors and technology partners who have helped make PKZIP the industry standard for Trusted ZIP solutions PKZIP enables our customers to efficiently and securely transmit and store information across systems of all sizes ranging from desktops to mainframes This edition applies to the following PKWARE of Ohio Inc licensed program PKZIP for OS 400 Version 5 Release 5 2003 PKZIP R is a registered trademark of PKWARE R Inc Other product names mentioned in this manual may be a trademark or registered trademarks of their respective companies and are hereby acknowledged Any reference to licensed programs or other material belonging to any company is not intended to state or imply that such programs or material are available or may be used The copyright in this work is owned by PKWARE of Ohio Inc and the document is issued in confidence f
8. a name plus an extension similar to a DOS file extension such as QDLS MYFLR1 MYDOC1 TXT 4 The name in each component can be up to 8 characters long and the extension if any can be up to 3 characters long The maximum length of the path name is 82 characters assuming an abso lute path name that begins with QDLS 5 The directory hierarchy within QDLS can be 32 levels deep 6 Must have proper authority within the path 7 The folders in the path must already exist 8 PKZIP will not create folders at this time For more details see the Rules for Specifying Folder and Document Names discussion in the publication CL Reference Optical File System QOPT The QOPT file system provides access to stream data that is stored on optical media Such as CDs Additionally it provides a hierarchical directory structure similar to PC operating systems such as DOS and OS 2 is optimized for stream file input output and supports data stored in stream files known as DSTMF or Distributed Stream Files Considerations and Limitations 1 QOPT converts the lowercase English alphabetic characters a to z to uppercase when used in ob ject names Therefore a search for object names using only those characters is not case sensitive For more details see the publication Optical Support 2 The path name must begin with a slash and contain no more than 294 characters The path is made up of the file system name the volume nam
9. and VIEWOPT DETAIL AQZ0863 00 Col Heading 3 al Explanation Displays the Third column heading for the field is amp 1 Information with TYPE VIEW and VIEWOPT DETAIL AQZ0864 00 MAINT amp 1 RECOVER amp 2 FRCACCPTH amp 3 ACCPTHSIZ amp 4 Order 6 amp 5 Explanation Displays the Keyed access path attributes Order Duplicate key sorting order Information with TYPE VIEW and VIEWOPT DETAIL AQZ0865 00 File text 6 amp 1 Explanation Displays the text associated with the file that has been stored in the archive Informa tion with TYPE VIEW and VIEWOPT DETAIL AQZ0866 00 Archive identified as a GZIP archive Explanation Archive identified as a GZIP archive Information with TYPE VIEW and VIEWOPT DETAIL Chapter 12 Messages 117 AQZ0867 00 VMS file attributes amp 1 octal 2 Explanation If present for a file in the archive displays VMS file attributes Information with TYPE VIEW and VIEWOPT DETAIL AQZ0868 00 Amiga file attributes amp 1 octal 4 amp 2 Explanation If present for a file in the archive displays Amiga file attributes Information with TYPE VIEW and VIEWOPT DETAIL AQZ0869 00 Unix file attributes amp 1 octal 2 Explanation If present for a file in the archive displays UNIX file attributes Information with TYPE VIEW and VIEWOPT DETAIL AQZ0870 00 Non MSDOS external file attributes 6 amp 1 hex Explanation If present for a fil
10. 100 AQZ0482 30 100 AQZ0483 40 100 AQZ0484 00 100 AQZ0485 30 100 AQZ0486 30 100 AQZ0487 30 101 AQZ0488 40 101 AQZ0489 10 101 AQZ0490 10 101 AQZ0491 40 101 AQZ0492 40 101 AQZ0493 40 101 AQZ0494 00 102 AQZ0495 00 102 AQZ0496 00 102 AQZ0498 40 102 AQZ0499 50 102 AQZ0501 20 102 AQZ0502 00 102 AQZ0503 30 103 AQZ0504 20 103 AQZ0505 10 103 AQZ0506 10 103 AQZ0508 10 103 AQZ0509 10 103 AQZ0510 10 103 AQZ0511 40 104 AQZ0512 40 104 AQZ0513 10 104 AQZ0514 30 104 AQZ0515 40 104 AQZ0516 40 104 AQZ0517 40 105 AQZ0518 00 105 AQZ0519 00 105 AQZ0520 00 105 AQZ0521 00 105 AQZ0522 00 106 AQZ0523 00 106 AQZ0525 00 106 AQZ0600 00 106 AQZ0601 40 106 AQZ0602 40 106 AQZ0603 40 107 AQZ0604 00 107 AQZ0605 40 107 AQZ0606 40 107 AQZ0607 40 107 AQZ0608 40 107 AQZ0609 00 107 AQZ0610 40 108 AQZ0611 40 108 AQZ0800 00 109 AQZ0801 00 109 AQZ0802 00 109 AQZ0803 00 109 AQZ0804 00 109 AQZ0805 00 109 AQZ0806 00 109 AQZ0807 00 110 AQZ0808 00 110 AQZ0809 00 110 AQZ0810 00 110 AQZ0811 00 110 AQZ0812 00 110 AQZ0813 00 110 AQZ0814 00 111 AQZ0816 00 111 AQZ0817 00 111 AQZ0818 00 111 AQZ0821 00 111 AQZ0822 00 111 AQZ0823 00 111 AQZ0824 00 112 AQZ0825 00 112 AQZ0826 00 112 AQZ0827 00 112 AQZ0828 00 112 AQZ0829 00 112 AQZ0830 00 112 AQZ0831 00 113 AQZ0834 10 113 AQZ0835 00 113 AQZ0836 00 113 AQZ0837 00 113 AQZ0838 00 113 AQZ0839 00 113 AQZ0840 00
11. AQZ0240 00 No Archive files found Explanation While searching for an Archive to extract from no Archive file was found Review to see that the archive exists AQZ0241 00 Cannot find archive file internal end directory in one of amp 1 or amp 2 s zip and cannot find s period Explanation The Archive file may not be an archive or it may be corrupted AQZ0242 40 Cannot find archive file amp 1 amp 2 Explanation The Archive file could not be found Review command parameters AQZ0246 00 Note 6 amp 1 may be a plain executable not an archive Explanation The Archive file amp 1 is not an archive Either it is corrupted or it could be an executable object AQZ0247 00 Warning 41 amp 2 extra bytes at beginning or within Archive File attempting to process anyway Explanation The Archive amp 1 contains extra bytes within the archive Will attempt continued extraction Verify other messages within the job log and review source of archive file If no failing message occurs the extract file should be valid Chapter 12 Messages 85 AQZ0250 00 Testing 4 amp 1 Explanation PKUNZIP Informational TYPE TEST is in the processing of testing file amp 1 AQZ0251 00 Extracting amp 1 amp 2 Explanation PKUNZIP Informational TYPE EXTRACT is in the process of extracting a Stored file amp 1 with mode of empty Binary Text Text in EBCDIC SAVF or Database File AQZ0252
12. DO CHGVAR VAR amp OUTNAME VALUE amp LIBNM TCAT TCAT amp FILENM TCAT TXT GOTO CMDLBL ENDCHG ENDDO IF amp CVTFLAGS EQ MSM Appendix D External Name Conversion Program 149 DO CHGVAR VAR amp OUTNAME VALUE 8LIBNM TCAT TCAT amp FILENM TCAT TCAT amp MBRNM TCAT TXT GOTO CMDLBL ENDCHG ENDDO AIFS IF amp CVTFLAGS EQ IFS DO CHGVAR VAR amp OUTNAME VALUE QSYS LIB TCAT amp LIBNM TCAT LIB TCAT amp FILENM TCAT FILE TCAT amp MBRNM TCAT MBR GOTO CMDLBL ENDCHG ENDDO CHGVAR VAR amp OUTNAME VALUE amp LIBNM TCAT TCAT amp FILENM TCAT TCAT amp MBRNM TCAT ENDO4MS GOTO CMDLBL ENDCHG ENDDO end of O4MS do flag FAR k i i ROA RE ARRE RAR RAE RRA RARA A RAR RARA RAR Flag set to MSO4 Change a MSDOS file dirl dir2 dirn file xxx to dir2 dirn filexxx iSeries file MSO4 COND amp CVTFLAGS EQ MSO4 THEN DO GVA VAR 8 IDX VA 0 GVA VAR amp IDXPRV VA GVA VAR amp LIBNM VA GVA VAR amp FILENM VA R R R R R AAA al GVAR VA MBRNM VA first find 1st blank and work bac FINDLST2 HGVAR VAR amp IDX VALU F COND SST INN THEN GOTO CM Note max leng VAR amp IDXPRV V VAR amp IDX VALU COND amp IDX LT N GOTO CMDLBL ENDCHG EEEF OOQ CO Find a
13. DOMBR2 HaaZ COND SST INN amp IDX 1 NE HEN GOTO CMDLBL DOMBR2 VAR 8LEN VALUE amp IDXPRV amp IDX COND amp LEN gt 11 HEN CHGVAR VA LEN VALUE 11 CHGVAR VAR amp MBRNM VALUE SST amp INNAME amp IDXPRV LEN REMOVE IF ANY AND FORCE LENGTH TO 10 R G Find a File Note max length must be 10 DOFILE2 CHGVAR VAR amp IDX VALUE amp IDX 1 F COND IDX LT 0 THEN GOTO CMDLBL SETNAME2 COND SSST amp INNAI amp IDX 1 N LANJ HEN GOTO CMDLBL DOFILE2 HGVAR VAR amp LEN VALUE amp IDXPRV amp I F COND amp LEN gt 11 THEN CHGVAR VAR amp LEN VALUE 11 CHGVAR VAR amp FILENM VALUE SST amp INNAME amp IDXPRV amp LEN Find a Library Note max length must be 10 D H DOLIB2 CHGVAR VAR amp IDX VALUE amp IDX 1 F COND amp IDX LT 0 THEN GOTO CMDLBL ENDCHG COND SSST amp INNAME amp IDX 1 N HEN GOTO CMDLBL DOLIB2 VAR amp LEN VALUE amp IDXPRV amp I COND amp LEN gt 11 HEN CHGVAR VAR amp LEN VALUE 11 CHGVAR VAR amp LIBNM VALUE SST amp INNAME amp IDXPRV amp LEN Save the new name lib file mbr SETNAME2 EE COND amp LIBNM NE THEN DO CHGVAR VAR amp LIBNM VALUE amp LIBNM TCAT 150 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 IF CONNRRPILENM NE THEN DO CHGVAR VAR FILENM VALUE
14. FILENM TCAT ENDDO I CHGVAR VAR amp OUTNAME VALUE amp LIBNM TCAT amp FILENM TCAT MBRNM TCAT ENDMSO4 GOTO CMDLBL ENDCHG ENDDO end of O4MS do flag i El kK k K kK K K K K K K K KK K K K KK K K K K K K K K K K K K KK End of CVTNAME for return ENDCHG CHGVAR VAR amp MSGVAR VALUE amp INNAME BCAT amp MUVAR Jos BCAT SOUTNAME SNDPGMMSG MSGID AQZ0000 MSGF LIBL PKZIPMSG MSGDTA amp MSGVAR TOPGMQ PRV DMPCLPGM cl dump of variable to help debug ENDEXIT ENDPGM Appendix D External Name Conversion Program 151 Appendix E List Files and their Usage The list file capabilities provided in the PKZIP and PKUNZIP commands can be a powerful tool for maintaining detailed selection and to exclude files PKZIP and PKUNZIP commands also allow creating a list of files that are located in a particular archive Creating List Files Both PKZIP and PKUNZIP can create a text format file of file names that meet criteria entered within FILES and EXCLUDE parameters In PKZIP the output files contain the names of all files in the OS 400 format depending on if the files are from the QSYS file system or IFS The PKUNZIP program will produce a list of names in the format of the archive To create an output list file place the output file name in the parameter CRTLIST The default value is CRTLIST NONE Depending on the value of the TYPLISTFL parameter the output f
15. Multiple disk information ignored Explanation PKZIP and PKUNZIP do not support Multiple disk functionality AQZ0140 00 Name lengths in local and central differ for amp 1 Explanation The archive file is corrupted The name lengths of the file name in the local directory are different than the name length in the Central directory AQZ0141 00 Names in local and central differ for amp 1 Explanation The Archive file corrupted The file name amp in the Local directory is different than the file name in the Central directory Invalid Archive Contact the Product Services Division at 1 937 847 2687 for assistance AQZ0143 00 Rename failure New archive file left as 6 amp 1 Explanation PKZIP is trying to rename the temporary name for a requested archive and has failed Review the job log for cause The archive file amp 1 is still a good archive but is saved as the temporary name Rename the temporary file manually to the requested archive name AQZ0144 40 Rename failure Tried to rename to amp l Explanation Part 2 of previous message AQZ0143 00 AQZ0145 40 PKZIP could not open file for reading amp 1 Explanation PKZIP could not open file 81 for reading to compress Review Job Log and other messages for cause AQZ0146 40 Archive file and directory with the same name 6 amp 1 Explanation PKZIP found a file and directory to be selected with the same name amp 1 will be bypassed and Job t
16. OxE6 Ox7E 0x73 0x74 0x75 0x76 0x77 0x78 a0 a7 a8 af 0x79 Ox7A OxAD OxA8 0xD4 0xD5 0xD6 OxD7 a8 af b0 b7 Ox5E 0x9C 0x9D OxFA 0x9F 0x15 0x14 OxAC b0 b7 b8 bf OxAB OxFC 0x5B 0x5D 0xE4 OxFE OxBF OxE7 b8 bf cO c7 0x7B 0x41 0x42 0x43 0x44 0x45 0x46 0x47 c0 c7 c8 cf 0x48 0x49 0xE8 0x93 0x94 0x95 OxA2 OxED c8 cf d0 d7 0x7D 0x4A 0x4B 0x4C 0x4D 0x4E 0x4F 0x50 d0 d7 d8 df 0x51 0x52 OxEE 0x96 0x81 0x97 0xA3 0x98 d8 df e0 e7 0x5C OxFO 0x53 0x54 0x55 0x56 0x57 0x58 e0 e7 e8 ef 0x59 Ox5A OxFD OxF5 0x99 OxF7 OxF6 OxF9 e8 ef 0 7 0x30 0x31 0x32 0x33 0x34 0x35 0x36 0x37 f0 7 8 f 0x38 0x39 OxDB OxFB 0x9A OxF4 OxEA OxFF f 8 ff PKZIP 400 Translate Tables end Appendix F Translation Tables 155 Appendix G Implementation Considerations PKZIP for OS 400 components have been structured and written for the iSeries platforms and iSeries Servers The code base includes support for the OS 400 operating system With any product placed into production familiarity with and verification of features is always highly recommended Below is a list of key features that users of PKZIP should thoroughly understand Key Features e The commands PKZIP and PKUNZIP contain all parameters and options required to use PKZIP for OS 400 The parameters and options are in a format that provide a migration path toward the open systems
17. User selected compression ratios e Storage capability of 65 535 files within one ZIP Archive e Compression of files of up to 4 gigabytes e A maximum ZIP Archive size of 4 gigabytes e Data integrity assurance using 32 bit CRC error detection e Translation of data to a system independent format thus providing easy file transfers within a mixed or varied file environment Invoking PKZIP for OS 400 Services There are three commands used to use PKZIP within the OS 400 operating environments The com mands are e PKZIP Compression Utility e PKUNZIP Archive Extraction Utility e PKZSPOOL Compress Utility for Spool Files All commands can be invoked interactively or they may be submitted for a batch run Help panels for each command can be activated by using the F1 help key Chapter 2 Getting Started 7 PKZIP for OS 400 Differences with other Platforms This section covers the differences between PKZIP for OS 400 and other versions and operating systems platforms Most of the differences are due to the QSYS library file type system and the iSeries object oriented base Attributes Various MS DOS options support the selection of files by file attributes such as non extended hidden read only and system These attributes are not meaningful on the OS 400 file system ANSI comments Because OS 400 does not support ANSI control codes related options are not supported When unzipping from an archive the a
18. amp 2 Chapter 12 Messages 109 AQZ0807 00 File Comment gl Explanation Displays the file comment text when the option VIEWOPT COMMENT or DETAIL is used with TYPE VIEW AQZ0808 00 Length Method Size Ratio Date Time CRC 32 Name Explanation This message displays the 1st heading in the file information listing when either of the parameters DETAIL COMMENT or NORMAL are used with the VIEWOPT option AQZ0809 00 Explanation This message displays the 2nd heading in the file information listing when either of the parameters DETAIL COMMENT or NORMAL are used with the VIEWOPT option AQZ0810 00 amp 1 amp 2 amp 3 amp 4 amp 5 amp 6 amp 7 88 Explanation This message displays the file attributes in the file information listing when either of the parameters DETAIL COMMENT or NORMAL are used with the VIEWOPT option Uncompressed file Length amp 1 Compression method used amp 2 Compressed Size amp 3 Compression Ratio amp 4 File Date Time amp 5 CRC 32 8 amp 6 for File Name amp 7 AQZ0811 00 Explanation This message displays the totals separator in the file information listing when either of the parameters DETAIL COMMENT or NORMAL are used with the VIEWOPT option AQZ0812 00 amp 1 amp 2 amp 3 amp 4 f1le amp 5 Explanation This message displays the totals in the file information listing when either of the parameters DETAIL COMMENT or
19. member name LIB Remove only the first path which in most cases could be the library EXCLFILE EXCLFILE NONE path filename This parameter specifies the file containing the list of files to be excluded This can be used with or without the EXCLUDE parameter See parameter TYPLISTFL for file system type information NONE No list file will be processed path filename Enter the file path and the name of the file to process The layout depends on which file system you want the file created Library File System The format is Library File Mbr Integrated File System IFS The format is path1 path2 pathn filename EXCLUDE EXCLUDE file_specification1 file_specification2 file_specificationn Specifies the files and file specification patterns that will be excluded from the PKUNZIP run One or more names can be specified Each name should be in the OS 400 file system format such as QSYS is library file member and IFS is directory file and can include wildcards and Note If TYPE VIEW is being used then the format for these names is the MS DOS format The PKUNZIP program can also exclude file specifications by using the list file parameter EXCLFILE with a list of names to exclude Please refer to Chapter 4 File Selection and Name Processing for details of file specification formatting The valid parameter values for the FILES keyword are as follows file specificationl file _specifica
20. record lengths PKUNZIP will still try to extract the data but the format and appearance of the data is not guaranteed Please consult the manual for more information AQZ0270 40 Password does not match the Verify Password Re enter and try again Explanation The password entered in the VPASSWORD parameter does not match than the pass word entered in the PASSWORD parameter or VPASSWORD is missing when Advanced Encryption was selected The run will be terminated Re issue the command and verify both PASSWORD and VPASSWORD contains the same values 88 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0271 40 Compressed Size Invalid for Advance Encryption Explanation File amp 1 requires Advance Encryption but has an invalid compress size of amp 2 Do a PKUNZIP TYPE VIEW VIEWOPTION DETAIL for more information about file Extract or Test will continue AQZ0272 40 Advance Encryption is invalid for GIZP Archive Explanation PKZIP is running with GZIP YES and the option ADVCRYPT is specifying Advanced Encryption other than NONE and ZIPSTD GZIP only supports ZIP Standard for OS 400 and OS 390 Note Standard GZIP on platforms other than OS 400 and OS 390 do not support Encryption AQZ0273 40 Major Error Occurred with Advanced Encryption with New File size Will Try to continue Explanation PKUNZIP failed while extracting a file with invalid advanced encryption controls The extracted size exceeds the unc
21. the same password will result in a different system generated key for each file PKZIP for OS 400 Version 5 5 implements the use of Cipher Block Chaining CBC to further enhance industry standard encryption algorithms This feature ensures that each block of data is uniquely modified further protecting the data from fraudulent access The following matrix provides information for compression compatibility of encrypted data and general encryption options available on the operating systems supported by PKZIP 2 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 More specifically the 96 bit password encryption is compatible and can be ported to and from any of the platforms list below Advanced password encryption is also available in a cross platform environment that supports the AES AES is Government requirement for password and data encryption as of May 26 2002 requirement of 128 192 and 256 bit password encryption SECURITY Generic ZIP PKZIP PKZIP for PKZIP for PKZIP for PKZIP for PKZIP for TYPES Utilities for OS 400 OS 390 VSE MVS UNIX Windows See Note See Note 1 below 2 below 96 bit X X X X X X X Encryption This is advanced encryption that is compatible with Windows PKWARE Xx Xx Certificate Based Encryption This is advanced encryption that is compatible with multiple platforms 128 192 Xx X Xx Xx Xx Xx 256 bit AES Password Enc
22. 00 amp 1 Adjusting offsets for a preamble of amp 2 bytes Explanation Information PKZIP The adjustment of the archive file being made during the fix file process Only Displays with Verbose MAX during fix option This option is not available at this time AQZ0129 40 Local header not found for amp 1 Explanation The current loaded archive file is corrupted The Local header cannot be found for the compressed file amp 1 Processing of PKZIP will not continue Review other messages If file was created using PKZIP please contact the Product Services Division at 1 937 847 2687 for assistance If the file came from another source review the creation of the file to verify if it was transferred properly to iSeries AQZ0130 00 File amp 1 42 Explanation Informational PKZIP Adjusting offsets in the archive file amp 1 for local headers Only displays with Verbose max AQZ0131 00 Zip diagnostic Deleting file amp 1 Explanation Informational PKZIP with TYPE DELETE The file amp 1 was found in the archive and removed Chapter 12 Messages 77 AQZ0132 00 Error in Deleting file al Explanation PKZIP with TYPE DELETE could not delete the file amp 1 from the Archive Review job log and other message that occurred during the PKZIP run to determine the cause AQZ0133 40 Deleting directory amp 1 if empty Explanation PKZIP with TYPE DELETE found a match and it was an empty directory The
23. 2 2 ecceccecceceeceececceceeceeceeceeaececueeeeaes 158 ALTERNATE INSTALL FROM SAVF WITH NON STANDARD LIBRARY NAME 22 02 eeceeeeees 159 RUNNING WITHOUT THE PKZIP LIBRARY IN THE LIBRARY LIST 2 2 csceeceececceeeeceeceeeeeees 159 APPENDIX I SPOOL FILES CONSIDERATION G 2 0cceeceeceececceceeceeceseeceeceeeeeees 161 SPOOL FILE SELECTIONS 0ccccccceeceececcecceececeeceeceeaecaecaecueceeaeeaecueceesesaececeeseeaeeaeeateneaees 161 SPIEF AthibUtes ccoo aa 161 PDF Gr eation AttribUtesi lt di 162 Extracting Spool files with PKUNZIP 2 22 2 cceceeeeeeeceeeceeeceeeceeeceeenenenes 162 EJE e Koy AN rA A A E EE torbe tactica 165 INDEX A Pe A ee ore eee 176 Contents 1X Chapter 1 An Introduction to PKZIP OS 400 PKZIP for OS 400 is a high performance data compression product containing two main programs PKZIP and PKUNZIP The PKZIP program is used to compress files into a ZIP format archive while PKUNZIP is used to decompress data either compressed by PKZIP at an earlier time or compressed by other file compression programs Both programs are controlled by options that allow a variety of functions to be performed Multiple levels of processing control are available through the use of customized option modules shared command lists and individual job inputs In addition to file selection features such as compression levels and performance selections can be specified Also a 32 bit
24. ASCII is required FTRAN FTRAN INTERNAL Member Name Specifies the translation table for use with translating File names comments and password from the iSeries EBCDIC character set to the character set used in the archive file normally ASCII character set A default internal table is predefined See Appendix F Translation Tables for additional information INTERNAL Use the predefined internal table for translation Using this is initially faster be cause PKUNZIP does not have to parse the override table membername Specify the member name in the file PKZTABLES that will be parsed and used to translate File names and comments files to the archive character set The member should have the exact format of member UKASCII in file PKZTABLES See Appendix F Translation Tables for defining translation tables IFSCDEPAGE IFSCDEPAGE NO Code Page If this option is set to NO PKUNZIP will write IFS files with the code page that is registered for the file or will use the default job code page if no code page is set in the file attributes Otherwise PKUNZIP will write IFS files with the specified code page Note If files are to be extracted to a case sensitive file system the case sensitive format of file names must be used before they can be selected The allowable values are NO The PKUNZIP program will read IFS files with the code page registered for the file This is the default Code Page The PKUNZIP pr
25. At least one error was detected in amp 1 Explanation PKUNZIP encountered at least 1 error while processing Review job log for messages AQZ0214 00 Caution Zero files tested in amp 1 Explanation PKUNZIP found no files to test while processing with TYPE TEST Review job log for other messages and review selection criteria Run PKUNZIP with TYPE VIEW and VIEWOPT Detail to verify archive file AQZ0215 00 Skipping 6 amp 1 unable to get password Explanation PKUNZIP is processing file amp 1 and it is encrypted but no password was entered for this run Re run PKUNZIP with a correct password for file amp 1 Processing continues with other files 82 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0216 00 Skipping 6 amp 1 incorrect password Explanation PKUNZIP is trying to process file amp 1 that is encrypted but the password entered for this run was incorrect for this file Processing Continues Re Run with a correct password AQZ0217 00 amp 1 file s skipped because of incorrect password Explanation During this run of PKUNZIP amp 1 file s were not processed due to incorrect passwords or missing passwords AQZ0218 00 May instead be incorrect password Explanation Part 2 of message AQZ0226 to remind that the failure may be due to an incorrect password Review to see if file is encrypted by running PKUNZIP with TYPE VIEW and VIEWOPT Detail for the file and verify that encryption is on for
26. Cyclic Redundancy Check CRC is a standard feature used to guarantee data integrity A ZIP archive is platform independent therefore data compressed Z PPED on one platform for example UNIX can be decompressed UNZIPPED on another platform fro example OS 400 and MVS ESA by using a compatible version of PKUNZIP Data Compression Because data compression techniques reduce file size a compressed data file will use less storage space and can be transferred in a faster more efficient manner A file can be compressed a ZIP candidate to a compact size ZIPPED file and then to use the file again it must be uncompressed or extracted to its original size UNZIPPED file One easy data compression method eliminates repeating or redundant data by replacing it with representative information that will be used when restoring the data An example of a data compression technique is the Run Length Encoding method which applies to redundant data where a repeating charac ter the run is represented as a count or value the length The compressed form is the repeated character with its count Example B2222EHHHHHHHHH Compressed B 42E 9H Note The efficiency of this method is dependent upon the amount of redundancy in the data To perform a thorough compression operation more advanced algorithms and enhanced techniques are required PKZIP for OS 400 uses just such methods to achieve maximum results ZIP Archives PKZIP for OS 400
27. Index I 3 file system 19 3270 Display Emulation 176 176 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 5250 Emulation 176 A About this Manual iii absolute path name 18 Absolute Path Name 165 AES 165 AES Key Sizes 4 Alternate Index 165 Alternate Install from SAVF with Non Standard Library Name 159 American National Standards Institute 165 American Standard Code for Information Interchange 165 ANSI 165 APAR 165 API 165 Appendix A Licensing Requirements 129 Appendix B Examples 139 Appendix C Memory Errors 146 Appendix E List Files and their Usage 152 Appendix F Translation Tables 153 Appendix G Implementation Considerations 156 Appendix H Operating Environment 158 Application Programming Interface 165 Application System 400 AS 400 166 AQZ0001 AQZ0799 Messages 68 AQZ0001 00 68 AQZ0002 40 69 AQZ0003 40 69 AQZ0004 40 69 AQZ0005 40 69 AQZ0006 40 69 AQZ0009 40 69 AQZ0010 40 69 AQZ0011 40 70 AQZ0012 40 70 AQZ0013 40 70 AQZ0014 40 70 AQZ0015 40 70 AQZ0018 40 70 AQZ0019 00 70 AQZ0020 00 71 AQZ0021 10 71 AQZ0022 40 71 AQZ0023 10 71 AQZ0025 40 71 AQZ0026 30 71 AQZ0027 30 71 AQZ0028 30 72 AQZ0029 40 72 AQZ0030 00 72 AQZ0031 00 72 AQZ0032 00 72 AQZ0034 00 72 AQZ0035 00 72 AQZ0036 00 72 AQZ0037 00 73 AQZ0038 40 73 AQZ0039 00 73 AQZ0040 10 73 AQZ0041 00 73 AQZ0099 00 73 AQZ0101 00 73 AQZ
28. It is not possible to create a GZIP Archive using PKZIP for OS 400 that does not have the file name stored in the archive Extracting e Ifafile name is present in the GZIP Archive it will be held in the ISO 8859 1 LATIN 1 character set e If there is no file name in the archive one will use the default paths defined in the EXDIR parameter e If there is more than one compressed file in the archive only the first file can be processed e When zipping a file into an archive the archive cannot already exist It is not possible to merge or update a GZIP Archive e VIEW processing may not show all of the details from the archive since some information is not stored or not stored in convenient locations in the GZIP Archive For example the compressed and uncompressed file sizes will typically be shown as zero 66 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 e To match the GZIP specifications the time stored in the archive header will be in universal time format seconds since 01 01 1970 Because of manipulation during processing this time will have only a 2 second accuracy will always be divisible by two and therefore could be one second off from the original file time e There is no standard iSeries method to set the creation date of a file As a result the time in the GZIP Archive is ignored when creating the iSeries output file It may be viewed by specifying the parameter TYPE VIEW Sample GZIP Processing C
29. KKKKKKKKKKKK KKK KKK View Single PKZIP for OS 400 TM Compression Utility Version 5 5 2002 07 12 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107X8WT Processor Group P10 KEKE KKKKK KKK KKK KKK KKK KKK KKK KKK KK KK KKKKKKKkKKkk kk A License Report requested on 07 16 01 09 01 from CPU Serial 0107X8WT This Product is Licensed to Customer 110531837 My Company Name Dayton OH KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK AAA Compression Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KOR KK KK KKK RK KK KK OK KK KK KK KK KK RK KK KK KK KK KKK Decompression Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KKEKKKKKK KKK KK KKK KKK KK KKK KKKKKKKKKKKKK KKK KKK KK GZIP Licensed on Following processors Expiration of 00 00 0000 KEK KKKKKKKKKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKK IFS File Handlers Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKkkAkk Database File Handlers Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KKEKKKKKK KKK KKK KKK KKK KKK KKK KKKKKKKKKK KKK KKK KKK Appendix A Licensing Requirements 137 View Single with Exception PKZIP for 0S 400 TM Compression Utility Version 5 5 2
30. OS 400 DIFFERENCES WITH OTHER PLATFORMS 2 c2cceeeeceeceececceceeceseeeeess 8 USE OF SAVE METHOD techni A Be A E 8 CHAPTER 3 PKZIP FOR OS 400 INSTALLATION 2 02cceceeceececcecceceececcecceceeeeeees 9 UNLOADING PKZIP FOR OS 400 FROM TAPE cccccceeceececcecceceeceeceecesaececeecesaecaeceeeneeees 9 UNLOADING PKZIP FOR OS 400 FROM A CD ROM ccccceeceececcecceeeeceeceecesaececeseueeees 9 USING FTP TO SERIES na id sce rides dd nls cede e todd A E A A tt 10 INSTALLATION PROCEDURES neina edie ot lene edd oud deat peldend d pit leud aa i oe 10 CHAPTER 4 FILE SELECTION AND NAME PROCESSING c2 ceceeceeceeeeeeeeeer 12 ZIP PROCESSING FILE SELECTION 2 2 ccccecceceeceececceccececeeceececceceeceecescecaeceeceesesesseseesees 12 PRIMARY FILE SELECTION INPUTS muire nalne nelra niio iod ra i rld ili oa lii oati 12 FILE EXCLUSION N 1U E EE E EE did 14 ARUTA P ARCA VE T EO a aE 14 CHAPTER 5 ZIP FILES 0000 is di it ii 15 DATA FORMAT TEXT RECORDS VS BINARY RECORDS cccsceececceccecceceececcucceeatenecueeeees 15 FILESAT FRIBUTES a ee or eg 0 16 vi PKZIP OS 400 5 5 User s Guide PKOU V5R5000 CHAPTER 6 OS 400 FILE PROCESSING SUPPOR Te cocccccccnnncccccccccncccnonanananancnonnnnnos 17 QSYS LIBRARY FILE SYSTEM is as 17 IPS INTEGRATED FILE SYSTEM coscestcentcesecestcestvestceseerstcestceseceseees oesteesiceseeestceseeesteeseees 17 Directories and Current Directory 2 2
31. PKZIP product which is applicable to all supported platforms It goes on to describe the OS 400 specific features of the PKZIP for iSeries product and provides a simple description of how the PKZIP for iSeries product is used to provide the compression and decompression of datasets e Chapter 2 Provides all of the general getting started information for invoking PKZIP and PKUNZIP This chapter explains the details associated with compression decompression restrictions migration and a complete view of the general PKZIP for OS 400 features e Chapter 3 Provides detailed information and guidance on Installation from tape CD ROM using FTP and general installation procedures e Chapter 4 Provides all of the general file selection and naming processing to include primary file selection exclusions and ZIP Archive files e Chapter 5 Provides a summary of the ZIP file data formats such as Text verses Binary and file attributes e Chapter 6 Provides information regarding the OS 400 file processing support for library integrated file system SAVF Save Files and Spool Files e Chapter 7 Provides detailed information regarding old ZIP files temporary archives and new ZIP archives e Chapter 8 Provides instructions for using extended attributes such as standard QSYS library file system standard IFS and database attributes Preface iii e Chapter 9 Provides a summary of all of the PKZIP commands that provides parameters wi
32. PKZIP OS 400 5 5 User s Guide PKOU V5R5000 processing PKZIP for OS 400 uses the parameter FILETYPE for Text or Binary processing When transporting archives between machines that use different character sets for text for example EBCDIC and ASCII the binary format may not be appropriate Specifying that the file is to be compressed as FILETYPE TEXT will allow PKZIP for OS 400 to perform EBCDIC to ASCIl conversion as required Specifying FILETYPE TEXT may also be useful when PKUNZIP is used on the iSeries to extract data that has been compressed on an ASCII system A GZIP Archive is similar to a ZIP archive but normally only contains one compressed file or member GZIP Archives like ZIP archives use the Lempel Ziv algorithm Inflate to compress and decompress data Unlike a ZIP archive GZIP archives do not hold a lot of information in various information blocks throughout the archive instead they contain only one information block at the beginning of the archive and locates size information at the end of the archive Some GZIP text data for example file name and comments use the ISO 8859 1 LATIN 1 character set and therefore will be converted to and from LATIN 1 as required When a GZIP Archive is created an information block is placed in the archive before the compressed version of the file This information block includes the following information about the file e The compression method used on the file e The date and ti
33. PKZIPLIB ENDPGM Appendix B Examples 141 Example 3 Creating Archive in Personal Folders QDLS The following is an example of creating and processing the archive in the Document Library Services File System QDLS First assume a folder in QDLS with a name of MYFOLDER where the archives will be stored To view the folders issue the command WRKLNK QDLS you could use WRKDOC and WRKELR but WRKLNK is better to use since PKZIP will be using QDLS Work with Object Links Directory qdls Type options press Enter 3 Copy 4 Remove 5 Next level 7 Rename 8 Display attribu 11 Change current directory Opt Object link Type Attribute Text A FLR ia FLR MYFOLDER FLR QBKBOOKS FLR Run the PKZIP command PKZIP ARCHIVE QDLS MYFOLDER MYARCH1 ZIP FILES testlib ben TYPARCHFL IFS The suffix ZIP was added to help identify the file as an archive file PKZIP for OS 400 TM Compression Utility Version 5 5 2002 08 21 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP is a registered trademark of PKWARE Inc EVALUATION Running EVALUATION Warning This license will expire in 29 days on 2002 09 20 Contact your dealer with the following information Machine ID Processor Group P05 Scanning files for match Found 1 matching files Compressing TESTLIB BEN BEESON in TEXT mode Add TESTLIB BEN BEESON Deflating 32 PKZIP Compressed 1 files in Archive QDLS MYFOLDER MYARCH1 ZIP PK
34. Review other messages with PKZIP and the iSeries for more details of why the failure occurred Chapter 12 Messages 69 AQZ0011 40 Read or Seek error amp 1 amp 2 Explanation While reading an Archive file in PKZIP an unexpected Error was encountered The file may not have been created properly or copied to completion Try running the TYPE TEST to see it can identify more information and review all other messages AQZ0012 40 PKZIP ending with Nothing to do for lt amp l gt Explanation PKZIP found no files to process Review the FILES EXCLUDE keywords for the selections This message can be monitored using MONMSG AQZ0013 40 Missing or empty archive file 4 amp 1 amp 2 Explanation An Archive file to process UPDATE FRESHEN or DELETE is empty No TYPE was processed AQZ0014 40 Error writing to a file amp 1 amp 2 Explanation An unexpected error was encountered while writing the Archive file PKZIP is terminated and the temporary archive file is corrupted Review other PKZIP message and iSeries messages to interpret why this message occurred AQZ0015 40 Could not open to write amp 1 amp 2 Explanation PKZIP could not create a list file or ARCHIVE file PKZIP is terminated Review iSeries message for reason AQZ0018 40 Could not open a specified file to read 6 amp 1 amp 2 Explanation An archive list or extracted file could not be opened for reading Review PKZIP messages and
35. SAVF to the archive AQZ0519 00 Warning File amp 1 has associated constraints Explanation PKZIP has detected that the database file being zipped has constraints associated with it PKZIP does not store constraint information in the archive See Chapter 8 Storing Database File Extended Attributes for more information This message only appears when compressing database files If you wish constraint information to be preserved first save the file to a SAVF and then add to the archive AQZ0520 00 Warning File amp 1 uses an alternative collating sequence Explanation The file being compressed uses an alternative collating sequence the ALTSEQ keyword was specified in the DDS for the file PKZIP does not store alternative collating table information in an archive When unzipped the file will not have the same access path This message only appears when compressing database files If you want to preserve the alternate sort order first save the file in a SAVE and then add to the archive AQZ0521 00 Explanation Warning File amp 1 has NULL capable fields PKZIP has detected that one or more fields in the file are NULL capable PKZIP will translate NULL numeric fields as zeros and NULL character fields as blanks See Chapter 8 Storing Database File Extended Attributes for more information This message only appears when compressing database files If you want to preserve NULL fields first save the file
36. To force PKZIP for OS 400 to perform case sensitive file name matching include double quotes around the file name within the apostrophes Example Given a command of PKZIP for atest qz example1 FILES Dir1 f the extracted file will be dir1 File from the IFS root file system but not file dir1 file File Exclusion Inputs Using similar file specification techniques as described above in Primary File Selection Inputs PKZIP for OS 400 can specify from one to many file patterns that will be used to exclude files that were selected with the FILE parameter They can be input into the command parameter EXCLUDE or into a text file that can be processed by parameter EXCLFILE Care should be taken when using wildcards excluding inputs to ensure that FILES and EXCLUDE parameters select the desired files Input ZIP Archive files During a FRESHEN or UPDATE request files contained within the old ZIP Archive are added to a candidate list Names stored previously are used to search the system catalog for viability any file names not found in the system catalog remain in the ZIP Archive 14 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Chapter 5 ZIP Files Data Format Text Records vs Binary Records Binary data is stored in a ZIPPED Archive in its original format Binary data may be graphics or numbers that are already in computer format therefore no translation is done
37. YourLIB PKZIP550 Installation Procedures The PKZIP for OS 400 product library should exist on the iSeries All objects including the library are owned by QPGMR The objects owner can be change to any valid owner with the CHGOBJOWN command The PKZIP for OS 400 library should now be added to the library list ADDLIBLE PKZ550430 In order to run PKZIP for a DEMO or trial period a license file must be established by contacting your resel ler or PKWARE Sales at 1 937 847 2374 If you already have license codes and records please use them 10 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 The PKZIP for OS 400 product is distributed with a predefined library of PKZ550vrm where vrm is the minimum OS 400 operation system release supported V4R3MO would be 430 If you would like to use another library name or would like to run PKZIP for OS 400 without it being in the library list review Appendix H Operating Environment Chapter 3 PKZIP OS 400 Installation 11 Chapter 4 File Selection and Name Processing ZIP Processing File Selection This section discusses how file selection is performed for ZIP processing with PKZIP for OS 400 The primary commands used for ZIP processing are discussed here along with some overview notes and known restrictions This section also discusses how files are selected within an OS 400 environment Remember ZIP directory entries within a ZIP archive will be defined in a system i
38. allow a user to interact with and or perform operations on a computer UTC See Universal Time Coordinated UTC shown above or Greenwich mean time Variable Length A characteristic of a file in which the individual records and or the file itself can be of varying length See also Fixed Length VTOC See Volume Table of Contents shown below Volume A storage device that can be taken off the system as an individual unit for example magnetic tape disk or diskette Volume Label A standard tape or cartridge contains a VOL1 label as the first record of the tape 80 bytes with VOL1 beginning in the first position The label is used to identify the tape volume and its owner Volume Table of Contents VTOC An area on a disk or diskette that contains descriptions for example location size and other characteristics of the files libraries and folders that exist on the disk or diskette ZIP Archive A ZIP archive is used to refer to a single file that contains a number of files compressed into a much smaller physical space by the ZIP software 3270 Display Emulation A personal computer based program that allows a PC to perform like a 5250 display station or printer The program will allow use of the various iSeries system functions 5250 Emulation A personal computer based program that allows a PC to perform like a 5250 display station or printer The program will allow use of the various iSeries system functions
39. assist customer who may want to change the owner of the object distributed When creating files PKUNZIP uses SIZE NOMAX with CRTPF to avoid constant message replies Chapter 1 Introduction to PKZIP OS 400 5 e Added the informational program WHATOSYV to distribution WHATOSV shows OS Version serial number and process group required for licensing To use CALL WHATOSV e EXDIR was expanded from 30 character to 224 characters to allow for more flexibility with the IFS e When getting the message AQZ0148 Archive file empty PKZIP will also issue the message AQZ0022 PKZIP Completed with Errors at the end of the run The AQZ0022 is a message that can be monitored The message AQZ0022 is now being issued as a diagnostic type message instead of a completion message e PKUNZIP revised to not use IFS Stat when checking the archives in the QSYS file system This was preventing authority adoption for PKUNZIP archive files PKUNZIP is now performing object and file checking e PKZIP revised random number for creation of the Temporary archive name was improved to avoid duplication The random routines now use the job number for initial seed e When extracting with PKUNZIP TYPE NEWER and the files extracting does not exist Extract the files as if they the same as newer when files exist e Improved performance extracting to a file that has a large number of members Improved Performance selecting files for compression when files has larg
40. compression you can specify whether to search recursively through the directories for file selection or to only search the currently specified directory e When extracting files with the PKUNZIP command you can drop the path of files in the archive and use only the file name This allows you to build the extracted file in new directories libraries and or files This applies to IFS and QSYS Library file systems e When using files with the product the attributes are stored in the archive to indicate how the file was stored binary text text in EBCDIC SAVF or Database Services and can be used when extracting files with FILETYPE DETECT e The PKUNZIP command allows for defining default paths and libraries for both IFS and QSYS Library file systems e File selection has been written to provide additional file filtering controls Individual file selection can be made using the FILE parameter and or the List File INCLFILE which allows a list of files to be selected 156 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 File exclusion has been written to provide additional file filtering controls Individual file exclusion can be made using the EXCLUDE parameter and or the List File EXCLFILE which allows a list of files to be excluded PKZIP for OS 400 is a licensed product and without proper licensing it can only be used to view archives Licensing allows flexibility with the product features and hardware platforms
41. contains Database File attributes in the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0852 00 AUT amp 1 MAXMBRS amp 2 DLTPCT amp 3 SIZE amp 4 amp 5 amp 6 ALLOCATE amp 7 CONTIG 8 LVLCHK amp 9 REUSEDLT amp 10 Access path type ll Explanation Displays Database File Attributes File Authority 81 Maximum no members in file 82 Max deleted records in file 83 Initial size of member 84 Size of increment 85 Max no increments 86 Information with TYPE VIEW and VIEWOPT DETAIL AQZ0853 00 Format Name amp 1 No Flds amp 2 No Key Flds amp 3 Explanation Displays Database File Field Format Attributes File Format Name amp 1 Number of fields in format Chapter 12 Messages 115 amp 2 No key fields in format 83 Information with TYPE VIEW and VIEWOPT DETAIL AQZ0854 00 Field descriptions Explanation Displays that a heading of Field descriptions will follow Information with TYPE VIEW and VIEWOPT DETAIL AQZ0855 00 Num Name Width Gen U DN V K CCSID Explanation DB Field Format Attributes Num Field Number Name Internal Field name Width Field width Number of digits characters Gen Decimal Pos Allocated Length Time or Date format U Usage B Both Input O Output N Neither D Field Datatype N Null field capable indicator V Variable length field indicator K Key Field indicator CCSID CCSID of field N A numeric fi
42. created output queue are selected Outq The outgq that will be searched Qoutq Library The library where the OUTQ resides SFFORM SFFORM ALL STD Form Type Specifies the form type that is on the spool files that will be selected The allowable values are ALL Files for all form types are selected STD Only files that specify the standard form type are selected Form Type Only spool files with this specific form type will be selected SFUSRDTA SFUSRDTA ALL User Data The user data tag associated with the spool file to select 46 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 The allowable values are ALL Files with any user data tag specified are selected User Data Only spool files with this specific user data tag will be selected SFSTATUS SFSTATUS ALL READY HELD CLOSED SAVED PENDING DEFERRED Specifies the statuses of the spool files to be selected Up to 4 statuses can be selected for one run The allowable values are ALL All Spool File status will be considered for selection READY Only spool files with a status of READY will be selected HELD Only spool files with a status of HELD will be selected CLOSED Only spool files with a status of CLOSED will be selected SAVED Only spool files with a status of SAVED will be selected PENDING Only spool files with a status of PENDING will be selected DEFERRED Only spool files with a status of DEFERRED will be se
43. current unaltered release of a program May also be used to provide an enhancement to a product before a new release of the product is available Generally PTFs are incorporated in a future release of the product PTF See Program Temporary Fix shown above QSYS The library shipped with the system that contains objects such as authorization lists and device descriptions created by a user and the system commands and other system objects required to run the system The system identifier is QSYS Qualified Name The full name of the library that contains the object and the name of the object Record A group of related data words or fields treated as a single unit such as a name address and social security number Reduced Instruction Set Computer RISC A RISC computer uses a small highly efficient subset of the instructions available on a standard computer This allows for rapid processing Reentrant A program that is serially reusable Every time the user enters the program a fresh copy of working storage is provided If any values need to be saved the user must save them in other storage areas or files Care must be taken to see that modifications to the program s code are not made thus corrupting it for the next user Glossary 173 Relative Path Name A string of characters that is used to refer to an object starting at some point in the directory hierarchy other than the root A relative path name does not begin with a
44. directory in QOPT file system If the file names are longer than 8 the file name will be changed much like you see in DOS systems It will contain an followed by a number for files found with excessive name lengths WRKLNK QOPT Work with Object Links Directory QOPT Type options press Enter 3 Copy 4 Remove 5 Next level 7 Rename 8 Display attributes 11 Change current directory Opt Object link Type Attribute Text MYTESTLABEL DDIR The above screen shows that the volume label of the CD is MYTESTLABEL Using the 5 for the next level option you can navigate through the directories You will then see the files and directories on the root of the CD For example Work with Object Links Directory QOPT MYTESTLABEL Type options press Enter 3 Copy 4 Remove 5 Next level 7 Rename 8 Display attributes 11 Change current directory Opt Object link Type Attribute Text ARCHIVE ZIP DSTMF GZIPPW GAR DSTMF OS_400 3 DOC DSTMF Appendix B Examples 143 PKZCVT 2 DOC DSTMF PKZ55 1 SAV DSTMF PKZ55 1 ZIP DSTMF To view the archive PKZ55 1 ZIP which is really the long name PKZ55430 ZIP contents use PKUNZIP with VIEW Use the command PKUNZIP ARCHIVE QOPT MYTESTLABEL PKZ55 1 ZIP TYPARCHFL IFS TYPE VIEW PKZIP for OS 400 TM Compression Utility Version 5 5 2002 08 22 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered tra
45. environment All parameters in the two commands are supported with the OS 400 help panels The parameters and options should be reviewed to understand the features supported e With the IFS long file names are supported for Files Archive files and list files e Lists files for inputting file selections and outputting selections is supported for both the QSYS Library File system and the IFS e Archive files are supported in both the QSYS Library File system and the IFS By using the archive files within the IFS performance is enhanced CPU operation is less efficient and archive files are smaller As a result elapsed run time is reduced e Provides a quick and easy method for installing on the iSeries without running under the QSECOFR user or security authority e Using the parameter MSGTYPE messages can be directed to a printer file the message queue or both e When archive files are created in the QSYS Library File System the record length can be defined to fit the customer environment e When a file is extracted to the QSYS Library File System and neither the file nor the extended attribute for the record length exists the default file s created record length can be defined externally e When compressing a file in text mode the you can define the record as a fixed length record with trail ing blanks that are based on the file s record length description in the QSYS Library file system e When selecting files in the IFS for
46. file Library File Member to MSDOS library File Member O4MS COND amp CVTFLAGS EQ O4MS OR amp CVTFLAGS EQ MSD OR amp CVTFLAGS EQ MSM OR amp CVTFLAGS EQ IFS THEN DO VAR 8 IDX VALUE 0 VAR amp IDXPRV VALUE 1 Find a Note max length must be 11 DOLIB1 VAR amp IDX VALUE amp IDX 1 COND SST amp INNAME amp IDX 1 N THEN GOTO CMDLBL DOLIB VAR amp LEN VALUE DX amp IDXP COND amp LEN gt 10 THEN CHGVAR VAR amp LEN VALUE 10 VAR amp LIBNM VALUE SSST ME amp IDXPRV amp LEN Find a Note max length must be 11 VAR amp IDXPRV VALUE amp IDX 1 DOFILE1 VAR amp IDX VALUE amp IDX 1 COND SST amp INNAME amp IDX 1 N i Ge THEN GOTO CMDLBL DOFILE1 VAR amp LEN VALUE amp IDX amp IDXP COND amp LEN gt 10 THEN CHGVAR VAR amp LEN VALUE 10 VAR amp FILENM VALUE SSST amp INNAME amp IDXPRV amp LEN Find a Note max length must be 11 VAR amp IDXPRV VALUE amp IDX 1 DOMBRL1 VAR amp IDX VALUE amp IDX 1 COND SST amp INNAME amp IDX 1 N ryt THEN GOTO CMDLBL DOMBR1 VAR amp LEN VALUE amp IDX amp IDXPRV COND amp LEN gt 10 THEN CHGVAR VAR amp LEN VALUE 10 CG R VAR amp MBRNM VALUE SSST amp INNAME amp IDXPRV amp LEN CHGVAR VAR amp OUTNAME VALUE amp INNAME Save the new name lib file mbr DOOUTI1 AMSD IF amp CVTFLAGS EQ MSD
47. flag is O4MS the program will convert an pe iSeries file name library file member to a MS DOS name with such as library file member E 3 If the flag is MSO4 the program will take a MS DOS file name dirl dir2 dir3 name xxx and make it an iSeries name such as dir2 dir3 namexxx where dir2 will be the library dir3 will be a file name and namexxx will be up to a 10 byte character member name E 4 If the flag is MSD the program will convert an iSeries file name library file member to a MS DOS cx name with suffix TXT to the file library file TXT cx 5 If the flag is MSM the program will convert an ex iSeries file name library file member to a MS DOS ery name with suffix TXT to the member name such as library file member TXT amp 6 If the flag is IFS the program will format a GAJ file name library file member formatted for the iSeries QSYS LIB Integrated File System for example Cry QSYS LIB LIBRARY LIB FILE FILE MEMBER MBR c is ay ae RY NOTE PKZIP and PKUNZIP performs no validity checking on the name that is passed back and assumes that the name is valid and unique If the name is not valid or unique open errors or missing files may occur el BORK KK KK RRR RA A RAS CVTNAME PGM PARM amp INNAME amp OUTNAME amp CVTFLAGS amp CVTDATA xe eK KK KK KR KR KK KK KK KK KK KK kK KK KK KK kK KKK Param
48. highest level or root of the directory hierarchy The absolute path name must begin with a slash which indicates that the path begins at the root This is in contrast to a Relative Path Name See also Path Name AES The Advanced Encryption Standard is the official US Government encryption stand for customer data Alternate Index An index of a file based on a key different from the base It allows the file to be processed ina secondary key order American Standard Code for Information Interchange The ASCII code American Standard Code for Information Interchange was developed by the American National Standards Institute for information exchange among data processing systems data communications systems and associated equipment and is the standard character set used on MS DOS and UNIX based operating systems In a ZIP archive ASCII is used as the normal character set for compressed text files The ASCII character set consists of 7 bit control characters and symbolic characters plus a single parity bit Since ASCII is used by most microcomputers and printers text only files can be transferred easily between different kinds of computers and operating systems While ASCII code does include characters to indicate backspace carriage return etc it does not include ac cents and special letters that are not used in English To accommodate those special characters Ex tended ASCII has additional characters 128 255 Only the first 128 chara
49. is searching for the files to process with GZIP option AQZ0099 00 amp 1l 2 Explanation PKZIP was run with FIX option This option is not available at this time AQZ0101 00 Add amp 1 amp 2 Explanation Information providing the file and the type of compression method Deflate Terse or Store along with the percent of compression Chapter 12 Messages 73 AQZ0102 00 Freshening 6 amp 1 with amp 2 Explanation Informational PKZIP running with TYPE FRESHEN is processing the file with compression method Deflate Terse or Store and the percent of compression AQZ0103 00 Updating 6 amp 1 with amp 2 Explanation Informational PKZIP running with TYPE UPDATE is processing file with compression method Deflate Terse or Store and the percent of compression AQZ0104 00 Deleting 6 amp 1 Explanation Informational Delete file amp 1 from the archive AQZ0105 00 Translating to ASCII Explanation Informational with VERBOSE max indicating that data will translated to ASCII AQZ0106 00 Zip diagnostic 6 amp 1 lt amp 2 gt Explanation Zip diagnostic amp 1 amp 2 File in archive is up to date with date amp time or the file in the archive is now missing Only when Verbose max AQZ0107 40 Attempting to restore amp 1 to its previous state Explanation A failure occurred while running PKZIP with an existing archive An attempt is being made to set the archive to a previous state prior t
50. issued at the end to indicate that an error occurred FILES FILES file_specification1 file_specification2 file_specificationn Specifies the files and file specification patterns that will be selected in the PKZIP process One or more names can be specified Each name should be in the OS 400 file system format such as QSYS is library file member and IFS is directory file and can include wildcard and Note If TYPE VIEW or TYPE DELETE is being used then the format for these names is the MS DOS format The PKZIP program can also have file specifications selections to include by using the list file parameter INCLFILE with a list of names to select Files may also be excluded See the EXCLUDE parameter Please refer to Chapter 4 File Selection Process and Name Processing for details of file specification formatting The valid parameter values for the FILES keyword are as follows file specificationl file_specification2 file specificationn FILESTEXT FILESTEXT NO ALL NEW UPDATE Specifies if PKZIP allows the editing and the type of editing performed of a file s text comments that are stored in an archive The allowable values are NO No comment editing the default ALL Add comments or edit comments for all files in the archive NEW Add comments only for new files that are added to the archive UPDATE Add or edit the comments of files that are added updated or fres
51. level provides the maximum compression possible but will also take the longest in time to process NORMAL The normal compression level provides good compression amount at a reasonable speed STORE No compression Store will also be used if the other methods tried results in a file larger than the original TERSE This selection provides a terse compression algorithm provided with the iSeries by IBM as an API This is much faster but is less efficient than FASTEST and can only be decompressed on the iSeries Do not use this option if you wish to unzip the archive on another platform CRTLIST 38 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 CRTLIST NONE path filename Specifies that PKZIP will create an output file with a list of entries that would have been compressed based upon the selection criteria in the FILES and EXCLUDE parameters See parameter TYPLISTEL for file system type NONE Default No list file will be created path filename Enter the file path and name of the file to create The layout depends on which file system you want to create the file in Library File System The format is Library File Mbr Integrated File System IFS The format is path1 path2 pathn filename CVTDATA CVTDATA External Pgm Conversion Extended Data Specifies the extended data that is passed to the external program CVTNAME When CVTFLAG is not NONE the contents of the parameter is passed to provide extended flexib
52. license with your Serial Number and Processor Group AQZ9016 00 Unregistered Hardware Found Exception 6 amp 1 Grace days allowed Explanation A Serial Number and or Processor Group was found while running PKZIP for OS 400 A temporary license will be granted for 81 days Contact your supplier to obtain a new license with your Serial Number and Processor Group AQZ9017 00 PKZIP R is a registered trademark of PKWARE R Inc Explanation Trademark notes AQZ9018 40 Beta Release Has Expired Contact PKWARE Inc for Final Beta Release Explanation You are running a Beta Version of PKZIP for OS 400 TM that has expired Contact PKWARE Inc for a newer version of PKZIP for OS 400 TM AQZ9050 50 Could not create License file aborting Explanation While running INSTPKLIC the licensing did not exist so one needed to be created An error occurred and INSTPKLIC could not be created See Job Log for more detail information Job will be terminated AQZ9051 50 Could not open License file for update aborting Explanation PKZIP for OS 400 could not open the License file for updating Job will terminate See Job Log for details AQZ9052 50 Could write License file for update aborting Explanation PKZIP for OS 400 could not write to the License file with updates Job will terminate See Job Log for details 122 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ9054 50 Input File lt
53. nnnnnnnnn Customer Number supplied by PKWARE Inc XXX XXX Customer Name supplied by customer must be alphanumeric AA 99 Feature Control Card Feature Check Expiration Hardware Code Characters Date Information Format ff CCcc yyyymmdd ssssssstttt Columns 1 2 4 11 13 20 22 33 Length 2 8 8 12 ff Feature Control Code provided by PKWARE Inc cccccccc Check Character provided by PKWARE Inc yyyy year 2001 mm month 01 12 dd day 01 31 SSSSSSS CPU serial 12345ABC tttt CPU Processing Group P10 By executing this command the LICENSE dataset will be updated and a report will be produced that will reflect the state of PKZIP for OS 400 at your location 134 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Install Demo PKZIP for 0S 400 TM Compression Utility Version 5 5 2002 11 14 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107X8WT Processor Group P05 Rec 1 Demo LICENSED BY PKWARE Inc 11 14 2002 with expire Date 12 14 2002 Rec 2 55 YIRS9UQ5 202020202 My Demo Customer Name Rec 3 99 EARZ5URF 20021214 0107X8WTP05 Compression Evaluation set to expire in 30 days on 20021214 Decompression Evaluation set to expire in 30 days on 20021214 Database File Handlers Evaluation set to expire in 30 days on 20021214 IFS File Handlers Evaluation set to expire in 30 days on 20
54. s used with DELETE ignored Explanation This message should never occur Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0027 30 Archive file is empty cannot make it as old as latest entry Explanation PKZIP run with archive file in the IFS file type Cannot set date and time of Archive to latest time of files because Archive file is empty Chapter 12 Messages 71 AQZ0028 30 Archive file has only directories cannot make it as old as latest entry Explanation PKZIP run with archive file in the IFS file type Cannot set date and time of Archive to latest time of files The archive file is OK AQZ0029 40 Name Not match 6 amp 1 Explanation A file in the FILES selection keyword could not be found or matched with a pattern PKZIP will not process AQZ0030 00 Scanning files for match Explanation Information only The Search has started for file selections AQZ0031 00 Found amp 1 matching files Explanation Information only The number of selection files that was found is considered for processing AQZ0032 00 Copying temp amp 1 to amp 2 Explanation Copies a temporary Archive file to the requested Archive name AQZ0034 00 Searching Archive amp 1 for files to extract Explanation Informational only PKUNZIP has started searching the archive for files that meet the selection and excluding parameters AQZ0035 00 Extracting file amp 1 Ex
55. send message commands and also to stdout and stderr PASSWORD PASSWORD Archive Password Chapter 9 PKZIP Commands 45 Specifies a password for files being added to an archive This password may be up to 64 characters in length and is case sensitive All files selected for archiving will be encrypted using the specified password Note There is no way to extract the password used from the archive data If the password is forgotten the file will become inaccessible If files in an archive need to have different passwords PKZIP must be run for each password required Since the password is entered in EBCDIC the translation table referenced in the FTRAN parameter is used to translate it to ASCII Care should be take when using the FTRAN override and when using a password To use password protected files the same FTRAN override option is required SFUSER SFUSER CURRENT ALL User Name List Specifies the user names that created spool files that will be selected The allowable values are CURRENT Only files created by the user running this command are selected ALL Files created by all users are selected User Name Specify up to 10 user names Only files created by those users are selected SFQUEUE SFQUEUE ALL Name Specifies the Output Queue that will be searched for spool file selections If no OUTQ Library is specified it will default to LIBL The allowable values are ALL Files on any device created or user
56. slash The starting point is frequently a user s current directory This is in contrast to an Absolute Path Name See also Path Name Remote Job Entry RJE Communications software and hardware that allow a user to submit a job from a display station on a remote system to a System 370 type host system Return Code A value generated by operating system software to a program to indicate the results of an operation by that program The value may also be generated by the program and passed back to the operator Report Program Generator RPG A programming language used on iSeries and mainframes for writing application programs for business data processing requirements RISC See Reduced Instruction Set Computer shown on page 173 RJE See Remote Job Entry shown above RPG See Report Program Generator shown above SBCS See Single Byte Character Set Service Pack The Series product has available a collection of code fixes that contain PC code These fixes are contained in a single program temporary fix PTF which makes installation easier Single Byte Character Set SBCS A coded character set in which each character is represented by a one byte code point A one byte code point allows representation of up to 256 characters Languages that are based on an alphabet such as the Latin alphabet as contrasted with languages that are based on ideographic characters are usually represented by a single byte coded character set For
57. spool file attributes If the parameter SFQUEUE is used it will override the attribute for the output queue In both cases the spooled file name is the one contained in the spooled file attributes parameter The spooled file number will be the next sequential one available for the job that the spooled file becomes a part of OS 400 Authority requirements when extracting spool files 1 Special Authority SPLCTL This authority is needed if you are creating a spooled file for an other user 2 Output Queue Authority USE 3 Output Queue Library Authority EXECUTE 4 Object QSPCRTSP API Authority USE The following are several examples of results of extracting spool files Start with archiving the following spool files that were created with job MYJOB1 and User EVWSS File File Nbr Job User Number Date Time QSYSPRT 397 MYJOB1 EVWSS 010893 12 11 02 13 35 29 QSYSPRT 398 MYJOB1 EVWSS 010893 12 11 02 13 36 09 QSYSPRT 399 MYJOB1 EVWSS 010893 12 11 02 13 36 09 Now extract with job MYJOB1 and User EVWSS but am now on a different day and job number Next extract with job MYJOB2 and User EVWSS but am now on a different day and job number File File Nbr Job User Number Date Time QSYSPRT 2 MYJOB1 EVWSS 010927 12 12 02 09 57 42 QSYSPRT 3 MYJOB1 EVWSS 010927 12 12 02 09 57 42 QSYSPRT 4 MYJOB1 EVWSS 010927 12 12 02 09 57 42 File File Nbr Job User Number Date Time QSYSPRT 2 MYJOB2 EVWSS 010928 12 12 02 09 59 06 QSY
58. storage that can be addressed directly 2 A group of 8 adjacent bits In the EBCDIC ASCII coding system 1 byte can represent a character In the double byte coding system 2 bytes represent a character 166 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 CICS See Customer Information Control System COBOL Common Business Oriented Language Code Page A specification of code points for each graphic character set or for a collection of graphic character sets Within a given code page a code point can have only one specific meaning A code page is also sometimes known as a code set Command Line The blank line on a display console where commands option numbers or selections can be entered Configuration File 1 A file that specifies the way a program functions 2 In PKZIP the file that contains the default values needed for the system to run These can usually be re specified to meet local user requirements Console 1 A display station from which an operator can control and observe the system operation For example an operator can install the operating system do an attended IPL or sign on the system after using the End System ENDSYS command The console is the first workstation that the iSeries system activates in a partition The console is always available for use 2 In COBOL a function name associated with the operator s display station 3 In a Windows operating system environment any operator interface with a s
59. system format such as QSYS is library file member and IFS is directory file and can include wildcards and Note If TYPE VIEW is being used then the format for these names is the MS DOS format The PKZIP program can also exclude file specifications by using the list file parameter EXCLFILE with a list of names to exclude Please refer to Chapter 4 File Selection and Name Processing for details of file specification formatting The valid parameter values for the FILES keyword are as follows file specificationl file specification2 file specificationn EXTRAFLD EXTRAFLD YES NO Specifies if the basic PKZIP for OS 400 extended file attributes should be stored in the archive Some basic file attributes are record size library text description File text description etc The allowable values are YES Store the basic normal Series file attributes See Chapter 8 Extended Attributes for more definitions NO Does not store any extended attributes ERROPT ERROPT END SKIP Specifies what action to take if an error occurs while processing selecting or compressing a Spool File The allowable values are END The PKZIP will end without completing the compression of the file The archive is not updated 42 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 SKIP The program will skip the file with the input error and continue to process all other files to completion Message AQZ0022 will be
60. the Data Area PKZDTAS PKZDTA5 Data Area The PKZDTAS data area is required to be in the library list in order run the programs and commands of PKZIP for OS 400 The data area is 50 bytes in length with the following layout Bytes 1 thru 10 Library name for the product required to run the product Bytes 11 thru 20 Release Levels for PKZIP for OS 400 Bytes 21 thru50 Distribution and Generation Information only An example of the DSPDTAARA PKZDTA S output might look like Display Data Area PKZDTAS PKZ550430 Offset PKZ550430 V5 5 NNOV4R3M0 The running of PKZIP for OS 400 requires the data area to determine the library name to use for running the commands help panels and message file How to Change the Standard Library Name To assist the customer in changing the environment for running the PKZIP for OS 400 product the program PKZSETLIB has been included in the distribution library PKZSETLIB will set the PKZDAT5 data area s Library name and will change the commands and help panels to recognize the library links An example of how use PKZSETLIB to change the standard library name to a user environment Library name is shown in the steps below 1 Rename the PKZIP for OS 400 standard library to the new library name gt RNMOBJ 0BJ PKZ550430 OBJTYPE LIB NEWOBJ newlib 2 Verify that newlib is in library list with ADDLIBLE or EDTLIBL 158 PKZIP OS 400 5 5 User s Guide PKOU V5R500
61. the data in the file is extracted PKZIP for OS 400 processes it again by the same algorithm to produce a second CRC value Once the file is processed the original CRC value is compared to the new CRC value to ensure that they match Note If the data is the same as its previous state the same CRC value will be produced When the two CRC values are compared and should the extracted value not match the stored initial value the integrity of the file is in question and PKZIP for OS 400 reports the results In this case it is possible the data was corrupted within the ZIP Archive Data Encryption PKZIP for OS 400 Version 5 5 encrypt data for security control and provide a password lockout for extracting data Varying security levels are available with 96 128 192 and 256 bit encryption with varying encryption algorithms As of July 1 2001 the US Government mandated through the Gramm Leach Bliley Act that customer information must be encrypted to keep it confidential See Section Advanced Encryption Standard AES for more information to help organizations meet this requirement for advanced encryption PKZIP for OS 400 Version 5 5 implements the Advanced Encryption Standard Decryption of encrypted information requires a key PKZIP OS 400 Version 5 5 uses a multi layer key generation process based on a user specified password of up to 200 characters that creates a unique internal key for each file being processed In addition
62. the file AQZ0219 00 No errors detected in compressed data of amp 1 Explanation PKUNZIP encountered errors with Archive file amp 1 during run Review job log for messages AQZ0220 00 No errors detected in amp 1 for amp 2 file s tested Explanation PKUNZIP was run with TYPE TEST No errors were found in testing the selected files in the archive file amp 2 AQZ0221 00 amp 1 file s skipped because of unsupported compression or encoding Explanation PKUNZIP encounter amp 1 files that were bypassed due to unsupported Compression methods Review job log for details AQZ0224 00 Warning 6 amp 1 is probably truncated Explanation While trying to extract file amp 1 some type of write error occurred forcing an incomplete extraction The file has probably been truncated Review Job Log for more information about why this message occurred Chapter 12 Messages 83 AQZ0225 20 amp 1 Unknown compression method Explanation Compression method number amp 2 was found in the archive for file amp 1 This compres sion is unknown and is not supported by this PKUNZIP version PKUNZIP will skip this file and then will attempt to extract the next file within the archive AQZ0226 00 amp 1 Bad CRC 82 Explanation While extracting file amp 1 the CRC calculated for the file was not the same as the CRC stored in the Archive for the file AQZ0227 00 amp 1 Compressed EA data missing amp 2 bytes
63. to other file systems that reside on remote Series systems See IBM s Integrated File System Introduction SC41 5711 for additional information QNetWare QNetWare file system This file system provides access to local or remote data and objects that are stored on a server that runs Novell NetWare 4 10 or 4 11 or to standalone PC Servers running Novell Netware 3 12 4 10 4 11 or 5 0 A user can mount NetWare file systems over existing local file systems dynamically See File Management SC41 5710 for additional information QNTC Windows NT Server file system This file system provides access to data and objects that are stored on a server running Windows NT 4 0 or higher It allows iSeries applications to use the same data as Windows NT clients This includes access to the data on a Windows NT Server that is running on an integrated PC Server See IBM s OS 400 iSeries Integration with Windows NT Server SC41 5439 for details QOpenSys Open Systems file system This file system is compatible with UNIX based open system standards such as POSIX and XPG Like the root file system this file system takes advantage of the stream file and directory support that is provided by the integrated file system In addition it supports case sensitive object names See IBM s Integrated File System Introduction SC41 5711 for additional information UDFS User Defined File System This file system resides on the Auxiliary Storage Pool ASP of the user
64. to return the name of a file on the OS 400 as library file member If this is invalid then file open errors will occur If they are valid but did not exist before PKUNZIP will create the library file and member In the supplied library there is a sample CVTNAME CLP that contains logic for the following flags e If the flag is 400 there is no conversion taking place and the input name is passed back as a new name e If the flag is O4MS the program will convert an iSeries file name library file member to a MS DOS name with such as library file member e If the flag is MSO4 the program will take a MS DOS file name dir1 dir2 dir3 name xxx and make it an iSeries name such as dir2 dir3 namexxx where dir2 will be the library dir3 will be a file name and namexxx will be up to a 10 byte character member name e If the flag is MSD the program will convert an iSeries file name library file member to a MS DOS name with suffix TXT to the file library file TXT e If the flag is MSM the program will convert an iSeries file name library file member to an MS DOS name with a suffix TXT added to the member name such as library file member TXT e If the flag is IFS the program will format a file name library file member for the iSeries QSYS LIB Integrated File System For example QSYS LIB LIBRARY LIB FILE FILE MEMBER MBR Appendix D External Name Conversion Program 147 Ch
65. you want to transfer data across platforms using any other version of PKZIP or other ZIP utility you should always run a test to verify the cross platform compatibility PKZIP for OS 400 uses the same ZIP file archive format used by other PKZIP 2 x compatible products independent of the platform on which it is running PKZIP for OS 400 archives are not platform depend ent allowing greater flexibility in file usage Data can be zipped on one platform for example UNIX and 4 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 unzipped onto another platform such as OS 400 To do this PKZIP for OS 400 converts the data structure into the PKZIP format and saves the appropriate file information in the ZIP Archival directory entries If you want to transfer data across platforms using any other Zip compatible product the user should check with the supplier first to confirm that the versions of PKZIP that are compatible For more information regarding Data Formats see Chapter 5 Text or Binary for a discussion regarding special considerations when transferring files between different platform types Release Summary New Features New parameter ADVCRYPT to specify encryption level New Parameter PASSWORDV which is required for Advanced Encryption and is used to verify with PASSWORD to assure accuracy Password now accepts up to 200 characters Spool Files can be archived or converted to a TEXT or PDF format PKUNZIP n
66. 0 gt ADDLIBE newlib 1 Execute PKZSETLIB program to change the data area and change links gt CALL PKZSETLIB newlib 2 Display the PKZDTAS5 data area and verify that the Library has been changed gt DSPDTAARA PKZDTAS Positions 1 thru 10 should contain newlib 3 Test the commands PKZIP or PKUNZIP to make sure they execute correctly At this point the newlib is the new PKZIP for OS 400 library for this environment and will need to be placed in the library list to run Alternate Install from SAVF with Non Standard Library Name After the SAVF is ready to restore the library a slight modification to the commands as shown in Chapter 3 PKZIP for OS 400 Installation will be required In the RSTLIB command you will specify newlib in the parameter RSTLIB to restore the library with the new library name For example gt RSTLIB SAVLIB PKZ550430 DEV SAVF SAVF mylib PKZ550 RSTLIB newlib To complete the installation do the following 1 Add the newlib to your library list with ADDLIBLE gt ADDLIBLE newlib 2 Execute the PKZSETLIB program to change data area and change links gt CALL PKZSETLIB newlib 3 Display the PKZDTAS5 data area and verify that the Library has been changed gt DSPDTAARA PKZDTAS Positions 1 thru 10 should contain newlib 4 Test the commands PKZIP or PKUNZIP to make sure they execute correctly At this point the newlib is the new PKZ
67. 0 127 AQZ9087 00 127 AQZ9100 40 127 AQZ9101 40 127 AQZ9102 40 128 AQZ9103 40 128 AQZ9104 40 128 Archive 166 ARCHIVE 37 54 ARCHTEXT 37 AS 400 166 AS 400 Object 166 ASCII 166 Authorized Program Analysis Report APAR 166 Bandwidth 166 BASIC 131 Batch Job 166 Binary File 166 Binary Records 15 Bit 166 Block 166 Byte 166 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Cc CAPACITY 131 Chapter 10 PKUNZIP Commands 53 Chapter 11 Processing with GZIP 64 Chapter 12 Messages 68 Chapter 3 PKZIP for OS 400 Installation 9 Chapter 4 File Selection and Name Processing 12 Chapter 5 ZIP Files 15 Chapter 6 OS 400 File Processing Support 17 Chapter 7 ZIP Archives 25 Chapter 8 Extended Attributes 27 Chapter 9 PKZIP Commands 34 CICS 166 COBOL 167 Code Page 167 Command Keyword Details 36 54 Command Line 167 Command Summary 53 Command Summary with Parameter Keyword Format 34 Commands 53 Comment Control Card 133 COMPAT 38 COMPRESS 38 61 Compressing 66 Compressing a file 67 Compressing a SAVF file 22 Compression 132 Conditional Use 138 Configuration File 167 Console 167 Contents vi Control Language CL Program 167 Conventions Used in this Manual iv Could DES Cracker like hardware break an AES key 4 CRC 167 Creating List Files 152 Creating new Translation Table Members 154 Cross Platform Compat
68. 00 Unshrinking amp 1 amp 2 Explanation PKUNZIP Informational TYPE EXTRACT is in the process of extracting file amp 1 that was compressed with the Shrink method and with either a mode of empty Binary Text Text in EBCDIC SAVF or Database File AQZ0253 00 Exploding 4 amp 1 amp 2 Explanation PKUNZIP Informational TYPE EXTRACT is in the process of extracting file amp 1 that was compressed with the Implode method with either a mode of empty Binary Text Text in EBCDIC SAVF or Database File AQZ0254 00 Inflating amp 1 amp 2 Explanation PKUNZIP Informational TYPE EXTRACT is in the process of extracting file amp 1 that was compressed with the Deflate method with either a mode of empty Binary Text Text in EBCDIC SAVF or Database File AQZ0255 10 Member lt amp 1 gt truncated to 10 characters Explanation The member name of a file being extracted exceeds the 10 character limitation for an iSeries file member name The name is truncated to 10 characters AQZ0256 10 Warning Cannot set times for amp l Explanation After extracting a file to the Integrated File System PKUNZIP failed to reset the date 86 and time from the archive file to the file extracted to IFS The file data is correct PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0257 00 When Creating an out list file TYPE must be VIEW with NORMAL view Explanation PKUNZIP has keyword CRTLIST specified and can only
69. 00 00 PKZIP for OS 400 TM Compression Utility Version amp 1 amp 2 Explanation Displays the Version amp 1 of PKUNZIP for OS 400 with version release date of amp 2 AQZ9001 00 PKZIP running under Beta release amp 1 Explanation Displays if PKZIP is running under an Alpha or a Beta Release AQZ9002 00 PKZIP is being terminated due license validation failure Explanation PKZIP could not validate the License Obtain proper Licensing keys from PKWARE Inc and run INSTPKLIC AQZ9003 00 Machine ID amp 1 Processor Group amp 2 Explanation Displays the Machine CPU Serial number and the Processor Group Information AQZ9004 00 EVALUATION Running Explanation PKZIP is running under DEMO and Evaluation mode A License Key needs to be obtained AQZ9005 00 Enterprise Registered Explanation PKZIP for OS 400 is Licensed with Enterprise Registered AQZ9006 00 Registered Explanation PKZIP for OS 400 has been registered with a valid License Key AQZ9007 00 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved Explanation PKZIP for OS 400 Banner lines Displays when PKZIP or PKUNZIP starts 120 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ9008 00 THIS LICENSE HAS EXPIRED To renew your license Explanation During PKZIP start up processing it was determined that your license has expired See Following Messages on how to update your Licenses AQZ
70. 002 07 12 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107X8WT Processor Group P10 KKEKKKKKKKKK KKK KKK KKK KKK AAA AA AAA AAA A License Report requested on 07 16 01 11 22 from CPU Serial 0107X8WT This Product is Licensed to Customer 110531837 My Company Name Dayton OH KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKkkAkk Compression Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KKEKKKKKKKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKK KKK KKK Decompression Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KOR KKK KK KK RK KK KK RK KK KKK RK KK KK KK KK KK KK KK KKK GZIP Licensed on Following processors Expiration of 00 00 0000 KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEKE KEKE IFS File Handlers Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KKEKKKKKKKK KKK KKK KKK KKK KKK AAA AAA AA Database File Handlers Licensed on Following processors Expiration of 00 00 0000 Serial 0107X8WT is Not Licensed Use Of The Product will CEASE in 7 days 7 23 2002 KOR KK KK KK KK KK KK RK KK KK KK KK KK KK KK KK KK KK KKK Conditional Use PKWARE Inc recognizes that there may be periods where the licensing environment established by the customer is no longer valid Circumstances such as disaster recovery processing or th
71. 0102 00 74 AQZ0103 00 74 AQZ0104 00 74 AQZ0105 00 74 AQZ0106 00 74 AQZ0107 40 74 AQZ0108 00 74 AQZ0109 00 74 AQZ0110 00 75 AQZ0111 00 75 AQZ0112 00 75 AQZ0113 00 75 AQZ0114 00 75 AQZ0115 00 75 AQZ0116 00 75 AQZ0117 00 75 AQZ0118 40 76 AQZ0119 40 76 AQZ0120 40 76 AQZ0121 00 76 AQZ0122 00 76 AQZ0123 00 76 AQZ0124 00 76 AQZ0125 00 77 AQZ0126 00 77 AQZ0127 00 77 AQZ0128 00 77 AQZ0129 40 77 AQZ0130 00 77 AQZ0131 00 77 AQZ0132 00 78 AQZ0133 40 78 AQZ0134 00 78 AQZ0135 10 78 AQZ0136 00 78 AQZ0137 10 78 AQZ0138 00 78 AQZ0139 00 79 AQZ0140 00 79 AQZ0141 00 79 AQZ0143 00 79 AQZ0144 40 79 AQZ0145 40 79 AQZ0146 40 79 AQZ0147 00 79 AQZ0148 40 80 Index 177 AQZ0149 10 80 AQZ0150 40 80 AQZ0151 00 80 AQZ0152 20 80 AQZ0153 00 80 AQZ0154 20 80 AQZ0155 30 81 AQZ0156 00 81 AQZ0157 40 81 AQZ0158 40 81 AQZ0165 00 81 AQZ0201 00 81 AQZ0203 10 81 AQZ0204 10 81 AQZ0205 00 82 AQZ0208 00 82 AQZ0211 00 82 AQZ0212 00 82 AQZ0213 00 82 AQZ0214 00 82 AQZ0215 00 82 AQZ0216 00 83 AQZ0217 00 83 AQZ0218 00 83 AQZ0219 00 83 AQZ0220 00 83 AQZ0221 00 83 AQZ0224 00 83 AQZ0225 20 84 AQZ0226 00 84 AQZ0227 00 84 AQZ0228 00 84 AQZ0231 00 84 AQZ0232 00 84 AQZ0234 00 84 AQZ0235 00 85 AQZ0236 00 85 AQZ0240 00 85 AQZ0241 00 85 AQZ0242 40 85 AQZ0246 00 85 AQZ0247 00 85 AQZ0250 00 86 AQZ0251 00 86 AQZ0252 00 86 AQZ0253 00 86 AQZ0254 00 86
72. 021214 GZIP Evaluation set to expire in 30 days on 20021214 Advanced Encryption Evaluation set to expire in 30 days on 20021214 Spool Files Evaluation set to expire in 30 days on 20021214 License File PKZ550430 PKZLIC PKZLIC Updated successfully Install Basic PKZIP for OS 400 TM Compression Utility Version 5 5 2002 07 12 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107X8WT Processor Group P10 Rec 1 LICENSED BY PKWARE 07 13 01 WSS Rec 2 55 B7LJJ3A0 110531837 My Company Name Dayton OH Rec 3 yyyymmdd ssssssssttt Rec 4 77 1LTJ1233 20020801 0107X8WTP10 License File PKZ550430 PKZLIC PKZLIC Updated successfully Install Enterprise PKZIP for OS 400 TM Compression Utility Version 5 5 2002 07 12 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107X8WT Processor Group P10 Rec 1 LICENSED BY PKWARE 07 13 01 WSS Rec 2 55 Q9LAY3M5 110531837 My Company Name Dayton OH Rec 3 yyyymmdd ssssssssttt Rec 4 88 DMTMQ2BX 20020801 ENTERPRISE1 License File PKZ550430 PKZLIC PKZLIC Updated successfully Install Single PKZIP for OS 400 TM Compression Utility Version 5 5 2002 07 12 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107
73. 114 Index 179 AQZ0841 00 114 AQZ0842 00 114 AQZ0843 00 114 AQZ0844 00 114 AQZ0845 00 114 AQZ0846 00 114 AQZ0847 00 115 AQZ0848 00 115 AQZ0849 00 115 AQZ0850 00 115 AQZ0851 00 115 AQZ0852 00 115 AQZ0853 00 115 AQZ0854 00 116 AQZ0855 00 116 AQZ0856 00 116 AQZ0857 00 116 AQZ0858 00 116 AQZ0859 00 116 AQZ0860 00 117 AQZ0861 00 117 AQZ0862 00 117 AQZ0863 00 117 AQZ0864 00 117 AQZ0865 00 117 AQZ0866 00 117 AQZ0867 00 118 AQZ0868 00 118 AQZ0869 00 118 AQZ0870 00 118 AQZ0871 00 118 AQZ0872 00 118 AQZ0873 00 118 AQZ0874 00 119 AQZ0875 00 119 AQZ9000 00 120 AQZ9001 00 120 AQZ9002 00 120 AQZ9003 00 120 AQZ9004 00 120 AQZ9005 00 120 AQZ9006 00 120 AQZ9007 00 120 AQZ9008 00 121 AQZ9009 00 121 AQZ9010 00 121 AQZ9011 50 121 AQZ9012 50 121 AQZ9013 50 121 AQZ9014 00 121 AQZ9015 00 122 AQZ9016 00 122 AQZ9017 00 122 AQZ9050 50 122 AQZ9051 50 122 AQZ9052 50 122 180 AQZ9054 50 123 AQZ9055 50 123 AQZ9056 00 123 AQZ9057 00 123 AQZ9058 00 123 AQZ9059 00 123 AQZ9060 50 123 AQZ9061 40 124 AQZ9062 40 124 AQZ9063 40 124 AQZ9064 40 124 AQZ9065 40 124 AQZ9066 40 124 AQZ9067 40 124 AQZ9068 40 125 AQZ9069 40 125 AQZ9070 40 125 AQZ9071 40 125 AQZ9072 40 125 AQZ9073 40 125 AQZ9074 40 125 AQZ9075 40 126 AQZ9076 40 126 AQZ9079 00 126 AQZ9080 00 126 AQZ9081 00 126 AQZ9082 00 126 AQZ9083 00 126 AQZ9084 00 127 AQZ9085 00 127 AQZ9086 0
74. 2 for prompt for the over writing of file amp 1 The response received was R to rename the file Enter in a valid name for the new file Chapter 12 Messages 87 AQZ0264 20 Warning EBCDIC Translation code x 15 must convert to x 0a in amp 1 amp 2 override Explanation Keyword TRAN Data EBCDIC Translation Mbr was selected with an override member EBCDIC code x 15 must translate to x 0A for iSeries EL End of Line character Correct and Re run AQZ0265 00 Warning The password has embedded blanks Explanation A password was entered for PKZIP keyword PASSWORD and was found to have blanks embedded Some systems do not accept embedded blanks in the password Run continues with the entered password AQZ0266 00 Tersing amp 1 in amp 2 mode Explanation PKZIP Informational File amp 1 is being compressed with the TERSE compression method with either a mode of empty Binary Text Text in EBCDIC SAVF or Database File AQZ0267 00 unTersing amp 1 amp 2 Explanation PKUNZIP Informational TYPE EXTRACT is in the process of extracting file amp 1 that was compressed by the TERSE method with either a mode of empty Binary Text Text in EBCDIC SAVF or Database File AQZ0268 10 Warning Record length mismatch Archived file record length amp 1 output file record length amp 2 Explanation PKUNZIP has detected that the output file and the file in the archive have different
75. 6 3e485445 TESTLIB1 MYSPLFTM P T4RSTLIB XY 256 Stored 256 01 16 01 15 22 29058c73 TESTLIB1 TEST1 HEX 686712 86412 6 files To extract to a new Library use the keyword EXDIR and DROPPATH PKUNZIP ARCHIVE atest qz tstchg TYPE EXTRACT EXDIR mynewlib DROPPATH LIB PKUNZIP Archive ATEST QZ TSTCHG Searching Archive ATEST QZ TSTCHG for files to extract Extracting file TESTLIB1 BEN BEESON NOTE path Library MYNEWLIB created NOTE Library created File BEN created in library MYNEWLIB Member BEESON added to file BEN in MYNEWLIB Member BEESON file BEN in MYNEWLIB changed Inflating MYNEWLIB BEN BEESON Text NOTE new path Extracting file TESTLIB1 MYSPLFTM P AQZIP123 4X File MYSPLFTMP created in library MYNEWLIB Member AQZIP1234X added to file MYSPLFTMP in MYNEWLIB Member AQZIP1234X file MYSPLFTMP in MYNEWLIB changed Inflating MYNEWLIB MYSPLFTMP AQZIP1234x Text Since the library mynewlib did not exist it was created Appendix B Examples 139 Example 2 CLP with Override for Stdout and Stderr to an OUTQ The following is an example of overriding the PKZIP and PKUNZIP program output and then redirecting the output to an OUTQ This also provides an example of using mixed file systems such as having the archive file in the IFS and selecting files from the QSYS Library file system ZIPEXPLO1 PGM PARM amp OUTQ Program ZIPEXPLO1 Example RRR KR KKK IKK IKK e he RARA RARA RARA RARA IK IARI A
76. 9009 00 Contact your dealer with the following information Explanation Informing that the next message provides information required to obtain a license update AQZ9010 00 Make sure you have run the Install License program INSTPKLIC Explanation A problem has occurred when trying to open and process the licensing This is proba bly due to not running the Install License program AQZ9011 50 Could not open License file for lt 41 gt aborting 42 Explanation PKZIP or PKUNZIP could not open the License file Job will terminate This is probably due to not running the Install Program AQZ9012 50 Could not read License file base for lt amp 1 gt Length returned amp 2 Explanation An error occurred while reading the PKZIP Licensing File Review Job Log for more details Job is being terminated AQZ9013 50 Could not read License file Feature for lt amp 1 gt Length returned amp 2 Explanation An error occurred while reading the PKZIP Licensing File Review Job Log for more details Job is being terminated AQZ9014 00 amp 1 Warning This license will expire in amp 2 days on amp 3 Explanation A warning that your license will expire soon Contact your supplier to obtain a new license Chapter 12 Messages 121 AQZ9015 00 UNREGISTERED Copy Running Explanation PKZIP for OS 400 is running without a valid license It will run temporarily for 30 days Contact your supplier to obtain a new
77. ALL If ALL is specified without at least a qualifying library name the specification is ig nored and no files will be selected The PKZIP for OS 400 QSYS file system expands a partial file specification in several ways to make file specification more convenient Each file specification may consist of a filename a library name a file name and member name a library name and file name or a library name file name and member name OS 400 SAVF may also be selected but because a SAVF file does not contain members a SAVF will not be selected if a member name was included in the file specification In the Internal File System each file specification may consist of a directory a path of directories a directory and file or a path of directories and file 12 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 The various combinations that may be used are shown below File Type File specification Expanded As Notes QSYS library library all all Finds all files in libraries beginning with library fileinlib LIBL fileinlib ALL Searches library list for all files called fileinlib f a matching file is found all of its members will be selected If a SAVF is found it will be selected fileinlib mem LIBL fileinlib mem Searches library list for all files beginning with fileinlib lfa matching file is found members beginning with mem will be selected If a SAVF is found
78. AQZ0255 10 86 AQZ0256 10 86 AQZ0257 00 87 AQZ0258 10 87 AQZ0259 00 87 AQZ0260 00 87 AQZ0261 00 87 AQZ0262 87 AQZ0262 20 87 178 AQZ0263 00 87 AQZ0264 20 88 AQZ0265 00 88 AQZ0265 40 122 128 AQZ0266 00 88 AQZ0267 00 88 AQZ0268 10 88 AQZ0270 40 88 AQZ0271 40 89 AQZ0272 40 89 AQZ0273 40 89 AQZ0274 40 89 AQZ0275 40 89 AQZ0276 40 89 AQZ0280 40 90 AQZ0281 40 90 AQZ0282 40 90 AQZ0283 40 90 AQZ0284 40 90 AQZ0285 40 90 AQZ0286 40 91 AQZ0287 40 91 AQZ0288 40 91 AQZ0289 40 91 AQZ0291 40 91 AQZ0292 40 91 AQZ0293 40 92 AQZ0294 40 92 AQZ0295 10 92 AQZ0296 10 92 AQZ0297 40 92 AQZ0298 40 92 93 AQZ0401 40 93 AQZ0402 40 93 AQZ0403 40 93 AQZ0404 40 93 AQZ0405 40 93 AQZ0406 40 93 AQZ0407 40 94 AQZ0408 40 94 AQZ0409 40 94 AQZ0410 40 94 AQZ0411 40 94 AQZ0412 00 94 AQZ0413 00 94 AQZ0414 00 95 AQZ0415 00 95 AQZ0416 00 95 AQZ0417 40 95 AQZ0418 40 95 AQZ0419 40 95 AQZ0420 40 95 AQZ0450 40 96 AQZ0451 40 96 AQZ0452 40 96 AQZ0453 40 96 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0454 40 96 AQZ0455 40 96 AQZ0456 40 96 AQZ0457 40 97 AQZ0458 40 97 AQZ0459 20 97 AQZ0460 40 97 AQZ0461 40 97 AQZ0462 40 97 AQZ0463 40 97 AQZ0464 40 98 AQZ0468 40 98 AQZ0469 40 98 AQZ0470 40 98 AQZ0471 40 98 AQZ0472 40 98 AQZ0473 00 99 AQZ0475 40 99 AQZ0476 30 99 AQZ0477 30 99 AQZ0478 30 99 AQZ0479 30 99 AQZ0480 30 100 AQZ0481 30
79. Archive Files Used By PKZIP for OS 400 The term GZIP Archive file is used to describe the file that holds data that has been compressed by one of the GZIP programs and meets the specifications of RFC 1952 At the end of the GZIP Archive is a trailer that contains the file s compressed size uncompressed size and a CRC value for the file which is used to verify that the data which is decompressed is identical to that originally compressed A GZIP Archive file can be transferred from one platform to another and can be decompressed by a GZIP compatible application which is running on that platform The internal format of a GZIP Archive is identical no matter what platform compressed the file PKZIP for OS 400 by default creates new archives as members of PF DTA files with 132 byte records The archive file is given a text field of File created by PKZIP iSeries The archive member is given a text field of Member created by PKZIP iSeries If you wish to create your own archive perhaps because a lar ger record size would be convenient then you can do so but consider the following e When creating the file do not create any members in it e After creating the file change the MAXMBRS parameter for the file from 1 to NOMAX A GZIP Archive holds files internally in either Text or Binary format both of which are compatible with other platforms supported by GZIP Because information held in a GZIP Archive is defaulted for binary 64
80. CII Translate Table Euro USASCII EBCDIC USA ASCII Translate Table USASCIIE EBCDIC USA ASCII Translate Table Euro International Code Page Support Some data interchange environments require specialized multi language character translation support PKZIP for OS 400 provides tables for character based data translation through translate tables that are also included in the PKZTABLES The tables for the following international code pages are provided in the PKZIP for OS 400 PKZTABLES as members TRTxxyy where xx from and yy to EURO e o EIA atan 20 eso ase es am ama 277 eso ess es as a IBM 850 IBM 4946 Appendix F Translation Tables 153 cono esco er REF row vo eo 278 850 858 EF 297 850 858 EM These members are provided as is It is the responsibility of the user to ensure that data translation mapping is in accordance with their business needs Norwegian mi rene Translation Table Layout There are two translation tables in PKZTABLES The first table is a translation from ASCII to EBCDIC The second is EBCDIC to ASCII In each table there are 256 entries representing hex values from x 00 thru x FF Each entry is represented as a 4 character field such as 0x00 and OxFF On each line there must be 8 entries with each entry separated by a space With 8 entries per line there must be 32 lines of table entries for
81. Checking The following brief example demonstrates using PKZIP in a CL passing the archives library file and member as variables and then monitoring for errors from the PKZIP run ZIPEXPLO3 PGM PARM amp ZIPLIB amp ZIPFILE amp ZIPMBR Program ZIPEXPLO3 Example A A 144 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Abstract This is a example CL program that has 3 paramters that specifies the archive s Library File and Member 1 Will add the PKZIP for OS 400 Library to Library List If it is already part of LIBL then note so as to not remove at the end 2 Build the archive file namefor PKZIP by concatenating the inputted library file and member names 3 Compress all files in TESTLIB with PKZIP Command 4 Monitor for error messages from PKZIP If errors send message 5 If the PKZIP Library was not present at the beginning remove it from LIBL A hkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk amp PKZIPLIB contains the current PKZIP library DCL VAR PKZIPLIB TYPE CHAR LEN 10 VALUE PKZ550430 if PKZIP library is in Libl do not remove it at the end DCL VAR amp LIBLCHG TYPE CHAR LEN 1 VALUE Y amp ZIPLIB is Library where archive will be stored DCL VAR amp ZIPLIB TYPE CHAR LEN 10 amp ZIPFILE is File for the archive DCL VAR amp ZIPFILE TYPE CHAR LEN 10 amp ZIP
82. DIR 57 EXRROPT 42 Extended Attribute 168 Extended Attributes 27 Index 181 Extended Binary Coded Decimal Interchange Code EBCDIC 169 External Name Conversion Program CVTNAME 147 Extracting 66 Extracting Records into a SAVF file 22 Extracting Spool files with PKUNZIP 162 EXTRAFLD 42 F Feature Control Card 134 FEATURES 131 File Attributes 16 File Exclusion Inputs 14 File Field Attributes 31 File Physical Attributes 28 File Processing Support 17 File Selection and Name Processing 12 File Systems in the IFS 18 File Transfer Protocol FTP 169 FILES 43 58 FILESTEXT 43 FILETYPE 43 58 FTP 169 FTRAN 44 59 G General Features of PKZIP for OS 400 7 Getting Started with PKZIP for OS 400 7 GIGA ZIP 132 Glossary 165 GMT 169 GNU zip 64 Greenwich mean time GMT 169 GZIP 44 169 GZIP Archive Files 64 GZIP Archive Files Used By PKZIP for OS 400 64 H Host 169 How to Change the Standard Library Name 158 1 O 169 IBM s Terminology Web Site 165 IFS Integrated File System 17 IFS File Handler 132 IFS Summary 21 IFSCDEPAGE 45 59 Implementation Considerations 156 161 INCLFILE 45 59 Index 176 182 PKZIP OS 400 5 5 User s Guide Input ZIP Archive files 14 Input Output I O 169 Install Basic 135 Install Demo 135 Install Enterprise 135 Install Single 135 Installation 9 Installation Procedures 10 Installa
83. E LIB amp PKZIPLIB MONMSG MSGID CPF2103 EXEC CHGVAR VAR amp LIBLCHG VALUE N Set Current Directory to MYLIB not Required for this test Just an example CHGCURLIB CURLIB amp CURLIB Set Current Directory to zip not Required for this test Just an example CD DIR zipdir Check input outq to see overides required CHKOUTO IF COND amp OUTQ EQ none OR amp OUTQ EQ NONE THEN GOTO CMDLBL NOOUTQ change Stdout and Stderr to my outq OVRPRTF FILE STDOUT TOFILE LIBL QSYSPRT OUTQ amp OUTQ OVRPRTF FILE STDERR TOFILE LIBL QSYSPRT OUTQ amp OUTQ NOOUTQ 140 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Test basic PKZIP TESTO1 PKZIP ARCHIVE ATEST PKZ2 MYSLO4 FILES TESTLIB MYSPLF ALL EXCLUDE TESTLIB MYSPLF Q Test basic PKZIP with archive in IFS and print only messages TESTO2 PKZIP ARCHIVE mydir tmpsave itest01 FILES TESTLIB TEST FILETYPE BINARY TYPARCHFL IFS MSGTYPE PRINT Test PKZIP with all files in IFS TESTO3 PKZIP ARCHIVE mydir tmpsave itest02 zip FILES mydir testl basetest TYPARCHEL IFS TYPFL2ZP IFS Test PKUNZIP view of archive from test02 TESTO4 PKUNZIP ARCHIVE mydir tmpsave itest01 TYPARCHFL IFS MSGTYPE PRINT If PKZIP Library was added to LIBL then remove it ENDPGM IF COND amp LIBLCHG EQ Y THEN RMVLIBLE LIB amp
84. EKKK End of data KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK k k KK k F3 Exit F5 Refresh F9 Retrieve F10 Cursor Fr11 Toggle F12 Cancel F16 Repeat find F24 More keys Once you have typed or copied the license information provided by PKWARE you will need to save these changes and exit the edited member Next run the install program using the following command Appendix A Licensing Requirements 129 INSTPKLIC INFILE LIBL PKZLICIN INMBR PKWARELIC or prompt F4 Type choices Type Input Control Library name Control Member Install PKZIP for OS 400 License INSTPKLIC press Enter INSTALL PKZLICIN LIBL pkwarelic INSTALL VIEW Name PKZLICIN Name LIBL Name FIRST File Bottom F3 Exit F4 Prompt F5 Refresh F12 Cancel F13 How to use this display F24 More keys By executing the INSTPKLIC command the LICENSE dataset will be updated and a report will be produced that will reflect the state of PKZIP for OS 400 at your location PKZIP for OS 400 TM Compression Utility Version 5 5 2002 11 14 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107X8WT Processor Group POS Rec 1 Demo LICENSED BY PKWARE Inc 11 14 2002 with expire Date 12 14 2002 Rec 2 55 Y1IRS9UQ5 202020202 My Demo Customer Name Rec 3 99 EARZ5URF 20021214 0107X8WTP05 Compression Evaluation set to expire in 30 days on 20021214 Decompression Evaluation set to ex
85. ERRIDE FOR STDOUT AND STDERR TO AN OUTO ooccccoccconn ooo 140 EXAMPLE 3 CREATING ARCHIVE IN PERSONAL FOLDERS QDLS eeeeeeteteeeeeeees 142 EXAMPLE 4 PROCESSING ARCHIVE ON A CD QOPT eseese 143 EXAMPLE 5 COMPRESSING FILES FROM A CD QOPT eessen 144 EXAMPLE 6 COMPRESSING CL WITH MSG CHECKING cooooccccccccccccnnnnnnnnncnnnnnnnnnnnnnnnnznnnnos 144 APPENDIX C MEMORY ERROR 00 eee i i inne 146 APPENDIX D EXTERNAL NAME CONVERSION PROGRAM CVTNAME 147 SAMPLE GY TNANIE wees cccarcte arr tere a a da 148 APPENDIX E LIST FILES AND THEIR USAGE ssssssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 152 CREATING IST PILES uno Rs Rd Nr 152 Using List Files aS INPUT 152 APPENDIX F TRANSLATION TABLES 000 cccceceeeeeeeeeeeeeeeeeneeeeeeeeeeeeeeeeeeeeeeeeeee 153 INTERNATIONAL CODE PAGE SUPPORT wicacstesscuusaessbisaesnasedossaensuspanspudespusguabnensnvascsnepeasys 153 Example of PKZTABLES USASCII Translation Table 0 0 0 0 eeeeeeeeeeeeeeeeeeeee 155 APPENDIX G IMPLEMENTATION CONSIDERATIONS eeeeeeeeeeeeeeeeees 156 Viii PKZIP OS 400 5 5 User s Guide PKOU V5R5000 KEY FEATURES 00d td dd dd id RdA 156 APPENDIX H OPERATING ENVIRONMENT 0 c0scecceceeceeceececcecceceececcecceceeceeeeeees 158 PKZDTAS5 DATA AREA sscecceccecceceeceeceeceeaeeaecuececeeaesaecueceeaesaeeaeceeseeaesnesueseeaesaeeneseeaes 158 HOW TO CHANGE THE STANDARD LIBRARY NAME
86. ETECT path filename FTRAN EINTERNAL CVTDATA External Pgm Conversion Extended Data Member Name IFSCDEPAGE NO CVTFLAG NONE Code page 400 External Pgm Conversion Flags INCLFILE NONE path filename CVTTYPE NONE DROP MSGTYPE PRINT SUFFIX SEND BOTH DFTDBRECLN 132 decimal number OVERWRITE NO YES DROPPATH NONE PROMPT ALL LIB PASSWORD Archive Password EXCLFILE NONE SFQUEUE DFT path filename Library Outq SPLUSRID EXCLUDE file_specification 1 User ID file_specification2 file_specificationn TRAN INTERNAL Member Name EXDIR CURRENT path Chapter 10 PKUNZIP Commands 53 TYPARCHFL DB BRIEF IFS COMMENT TYPFL2ZP DB VIEWSORT ASIS IFS DATE DATER TYPLISTFL DB NAME CES PERCENT PERCENTR VERBOSE NORMAL SIZE NONE SIZER ALL MAX VIEWOPT NORMAL DETAIL PKUNZIP Command Keyword Details TYPE TYPE EXTRACT NEWER TEST VIEW The TYPE keyword specifies the type of action PKUNZIP should perform on the ZIP archive The possible actions are VIEW Will output information about all files or selected files contained in an archive This option is performed using PKUNZIP The sequence see VIEWSORT and type of list VIEWOPT determines what information is displayed EXTRACT Extracts files from the
87. File Defines whether File is external file type 20 Triggers Available File had Triggers defined See Database Attributes Considerations 21 File SQL Table File is an SQL Table 22 Constraints Available File had Constraints defined See Database Attributes Considerations 23 File has Null Fields File contains fields which allows NULL contents See Database Attributes Considerations PKZIP OS 400 5 5 User s Guide PKOU V5R5000 File Field Attributes See Series e DDS Reference Publication No RBAF P000 00 for a description of the keywords Attribute Description 1 Field Name Field Name 2 Field Data Type Specifies the data type associated with the field such as A character P Packed Decimal etc 3 Field Length Specifies the field length for named field 4 Number of Decimals Specifies the decimal placement within a zoned decimal field and the data type of the field as it appears in your program 5 Field Usage Specifies that a named field is an output only or program to system field 6 Field CCSID CCSID Specifies a coded character set identifier for character fields 7 Field Text TEXT A text description or comment for the record format or field that is used for program documentation 8 Column Headings COLHDG Specifies column headings used as a label for this field by various Series file tools 9 Keyb
88. GZ01 Member GZ01 file MYARCHFIL in MYLIB1 changed PKZIP Compressed 1 files in GZIP Archive MYLIB1 MYARCHFIL GZ01 PKZIP Completed Successfully Chapter 11 Processing with GZIP 67 Chapter 12 Messages PKZIP for OS 400 messages are broken down into 3 types When using VIEW type all displays of the archive and files information use messages AQZ0800 thru AQZ0899 The Licensing Install and Lisping validation use messages that start with AQZ9nnnn All other messages start with AQZ0001 through AQZ0799 There are two messages that are issued as Escape messages and because they are issued as an Escape message they can be monitored with the MONMSG command in CL programs Escape messages indicates a condition causing PKZIP or PKUNZIP to end abnormally without completing its work By monitoring for escape messages you can take corrective actions or clean up and end your procedure or program To see the actual condition that may have caused the problem you should review all previous message from the job log If PKZIP or PKUNZIP issues one of these escape message and the messages are not being monitored then the iSeries will issue an inquiry message requiring a reply normal iSeries processing The message numbers that are issued as Escape are AQZ0022 PKZIP Completed with Errors AQZ0038 PKUNZIP Completed with Errors There are three messages that are issued as Completion message types and are also issued a
89. IK He he e IIA IIA KIA AKA J Abstract This is a example CL program has on parameter for the OUTQ for the processing of PKZIP for 0S 400 If it is none or NONE no overriding to QPRINT will take place 1 Will add the PKZIP for OS 400 Library to Library List If it is already part of LIBL then note so as to not remove at the end 2 Set the Current Library only required if parameters of PKZIP leaves out the Library and a default is needed 3 An example of setting the current directory is IFS 4 Check input OUTQ If none keep processing 5 Override the Stdout and Stderr to input outq This is where PKZIP will send messages when the MSGTYPE is PRINT or BOTH 6 Run Test01 of PKZIP 7 Run Test02 of PKZIP with archive in IFS 8 Run Test03 of PKZIP with IFS system 9 Run Test04 of PKUNZIP to view archive 10 If the PKZIP Library was not present at the beginning remove it from LIBL E A A OUTQ DCL VAR amp OUTQ TYPE CHAR LEN 10 PKZIPLIB DCL VAR amp PKZIPLIB TYPE CHAR LEN 10 VALUE PKZ55430 if PKZIP library is in Libl do not remove it at the end LIBLCHG DCL VAR amp LIBLCHG TYPE CHAR LEN 1 VALUE Y CURLIB DCL VAR amp CURLIB TYPE CHAR LEN 10 VALUE MYLIB ZIPDIR DCL VAR amp ZIPDIR TYPE CHAR LEN 10 VALUE mydir Add the PKZIP for 0S 400 library to library List ADDLIBL
90. ING WITH GZIP u cscceeceecceeceecceeceeceeeceeceeseeseeeeeeeeeneeeeeees 64 INTRODUCTION TO GZIP GNU ZIP A A TRIAS 64 Contents vii GZIP ARCHIVE FILES USED BY PKZIP FOR OS 400 coccnccncnncnconconccncnnnnnnnconcnnnnncnncncon 64 CROSS PLATFORM COMPATIBILITY ici dd lide Rid dade hd Laid Bid dada Od LE REDS 65 special Note on GZIP Passwords ut 65 PROCESSING GZIP ARCHIVES td 65 Compressing oF Sk Tek ah ha e ahh RE 66 EXUACUMG use 66 SAMPLE ZIP PROCESSING daa E cv Cceus oe AA EA 67 COMPressi Al iii AAA 67 CHAPTER 12 MESSAGES 000 A AA IA 68 ROZ0001 AQZOPIO MESSAGES riso eseeto eeaeee diablo 68 AQZ0800 AQZ0899 VIEW DISPLAYS MESSAGES ceeeeeeeeeeeeeeeeeeeeeeeeeeeeeereeeeees 109 AQZ9XXX LICENSE MESSAGES sii is casted swale AR AA AR A ARA 120 APPENDIX A LICENSING REQUIREMENTS 0 0 eset 129 TRIACPRERIOD aa Sani bara ase hand AR NARA 129 PREPOMUING e ee ee db o ol 129 LICENSED IYRES oa RO 131 PRODUCT FEATURE Sna DS 132 LICENSING ENVIRONMENT 2 cccsoctetataratsent deed cauatien LARREA ARA AAA AAA AAA 133 Current Use License Lanne nian ne A A A pean 133 Record Layouts nennen e E R AA AA A 133 PRE DOINING ke u E E E E E EEEE 135 Conditional USE coi e e E a E AA EERE 138 APPENDIX B EXAMPLES scscsecetenctscesctetecetanetecetatetacenaretacetsnetatetdnstaseechstanetdestanetananacs 139 EXAMPLE 1 PKUNZIP FILES TO A NEW OR DIFFERENT LIBRARY c00sccceesseeeeseeeeerenes 139 EXAMPLE 2 CLP WITH OV
91. IP for OS 400 the program allocates memory for sorts buffers and other storage requirements There are diagnostic checks in the system to validate memory requests If a request fails the job will terminate and send a message to the message queue indicating a memory allocation failure Some systems limit the memory allocation for certain user jobs which may cause this problem In some cases programs can have what is called memory leaks where memory is never freed Signing off or ending the job will free the allocated memory If a message indicates that a memory allocation error occurred retrieve the failed job log and contact the Product Services Division at 1 937 847 2687 for assistance 146 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Appendix D External Name Conversion Program CVTNAME PKZIP for OS 400 provides an exit that calls a compiled CLP program named CVTNAME PKZIP can change the names of Series file names to a ZIPPED file name to be used in the archive PKUNZIP can change a ZIPPED file name in an archive to an Series file name This is activated by using the parameter CVTFLAG and not being set to NONE PKZIP for OS 400 will call the first CVTNAME program found in the library list PKZIP for OS 400 will call the program and pass three fields to CVTNAME and will expect a return field The first field passed is a 256 byte field that contains the input name in PKZIP it is the Series name and in PKUNZ
92. IP it is the ZIPPED name in the archive that can be changed The second field passed is a 5 byte field that can be used to help code specific logic to control the name change process The third field is up to 256 bytes of extended data from the command to provide more flexibility in controlling the conversion of file names The program will pass back up to 256 bytes of a file name that will be used as the output name in the archive The exit can be divided into different conversion routines by assigning each routine a 5 character name which is passed in as the CVTFLAG parameter value This routine works for both the PKZIP and PKUNZIP programs but normally you will need a different conversion routine or CVTFLAG for archiving or extraction When the CVTNAME returns the returned name should either hold the new name or remain blank to indicate that the default conversion rules should be used Note The PKZIP and PKUNZIP programs perform no validity checking on the name that is passed back and assumes that the name is valid and unique If the name is not valid or unique open errors or missing files may occur For PKZIP the name exit receives the OS 400 file name and the returned name is the name that will be used for the file name in the archive Ensure that names returned are unique otherwise only the first of the duplicated files will be compressed For PKUNZIP the CVTNAME exit receives the name of the file that is in the archive and expects
93. IP because filenames have to be held in the ISO 8859 1 LATIN 1 character set e Parameter TYPE type of processing to be performed cannot be specified because DELETE UPDATE FRESHEN MOVEF or MOVEU as a GZIP Archive cannot be updated once created e Only one file is supported per GZIP Archive When creating an archive this means that only one file or member can be identified for inclusion in the archive e f PKZIP for OS 400 is used to create and encrypt a GZIP Archive using a password other platforms may not be able to decrypt the data The encryption algorithm used by PKZIP for OS 400 in a GZIP Archive is similar to that used by PKZIP but it is not supported as part of the specifications for GZIP e Once an iSeries SAVF has been zipped into a GZIP Archive the archive will extract on another platform but will not be available as a SAVF it will just be a binary file and of no use on another platform e The file name stored in an archive created by PKZIP for OS 400 will typically contain library file and member names directory components which relate to the qualifiers of the original iSeries name According to the GZIP specifications the file name stored should be the original name of the file being compressed with any directory components removed Most GZIP utilities support directory components and the default PKZIP for OS 400 processing will include library file and member names in the output file name Note
94. IP for OS 400 library for this environment and will need to be placed in the library list to run Running Without the PKZIP Library in the Library List PKZIP for OS 400 can run without the library in the library list as long as a data area as described above is in a library that is in the library list One method is qualifying the command with the library name such as gt mylibrary PKZIP ARCHIVE myarchive V5 test1 FILES testlib all The other method copies the commands to a library that exist in their Library List Appendix H Operating Environment 159 Note The running of PKZIP for OS 400 requires the data area to determine the library name to use for running the commands help panels and message files The following are 5 steps to run PKZIP for OS 400 without its distribution library in the library list Assume PKZ55x430 is the PKZIP for OS 400 library and the customers library MYlibrary is In the customer s standard library list We will now add 3 new object to the libray MYlibrary 1 Create a new data area in the chosen library MYlibrary gt CRTDTAARA DTAARA MYlibrary PKZDTA5 TYPE CHAR LEN 50 TEXT PKZIP control data area 2 Next set the data area value to the same values found in supplied data area in the PKZIP Library gt DSPDTAARA PKZ55x430 PKZDTA5 output might look like Display Data Area PKZDTAS PKZ55x430 PKZ55x430 V5 5 NNOV4R3MO 3 Now change the
95. IT parameter is invalid with GZIP YES Explanation GZIP archives do not support file comments TEXTEDIT must be NO 108 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0800 AQZ0899 VIEW Displays Messages AQZ0800 00 Filename 6 amp 1 Explanation Displays the Archive file name being viewed or processed AQZ0801 00 Archive Comment amp 1 Explanation Displays the Archive Comment if one exists when TYPE VIEW is used with parameters NORMAL DETAIL COMMENT for keyword VIEWOPT AQZ0802 00 Length Date Time Name Explanation This message will appear at the top of the file information listing when the option VIEWOPT BRIEF is used with TYPE VIEW AQZ0803 00 Explanation This message will appear after message AQZ0802 for the file information listing when the option VIEWOPT BRIEF is used with TYPE VIEW AQZ0804 00 amp 1 amp 2 amp 3 Explanation File information listing when the option VIEWOPT BRIEF is used with TYPE VIEW Length uncompressed size modifications Date and time of file and the filename AQZ0805 00 Explanation This message will appear after the brief file information listing as a separator when the option VIEWOPT BRIEF is used with TYPE VIEW AQZ0806 00 amp 1 amp 2 fileg3 Explanation This message is the totals for file information listing when the option VIEWOPT BRIEF is used with TYPE VIEW Total Uncompressed size amp 1 and Number of files in list ing
96. IZE SIZER List the files in the sequence in which they are stored in the archive such as as is List the files in ascending order of the file s date amp time as stored in the archive List the files in descending order of the file s date amp time as stored in the archive List the files in ascending order of the file name as stored in the archive List the files in descending order of the file name as stored in the archive List the files in ascending order of the compression percentage as stored in the archive List the files in descending order of the compression percentage as stored in the archive List the files in ascending order of the uncompressed file size as stored in the archive List the files in descending order of the uncompressed file size as stored in the archive Chapter 10 PKUNZIP Commands 63 Chapter 11 Processing with GZIP Introduction to GZIP GNU zip GZIP GNU zip is a compression utility designed to use a different standard for handling compressed data in an Archive lts main advantages over other compression utilities are much better compression and free dom from patented algorithms It has been adopted by the GNU project and is now relatively popular on the Internet GZIP was written by Jean Loup Gailly jloup gzip org and Mark Adler for the decompression code GZIP GNU zip utility program available on a number of platforms including MVS UNIX and PC can be used like PKZIP fo
97. Job ending with Error Code amp 1 amp 2 Explanation Information about current job could not be retrieved Job will be aborted Try re running If problem continues please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0287 40 Spool File Selection List could not generated Job ending with Error Code amp 1 amp 2 Explanation While trying to select spool files for processing the job has failed while generating a list of spool files Try re running If problem continues please contact the Product Ser vices Division at 1 937 847 2687 for assistance AQZ0288 40 Abnormal Error Occurred while processing Spool Files Explanation While processing a spool file an internal error occurred with Error Codes amp 1 amp 2 Try re running If problem continues please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0289 40 Failure occurred during creation of Spool File Explanation While trying to create a spool during extraction a failure occurred with Error Codes amp 1 amp 2 Try re running If problem continues please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0291 40 SFJOBNAM in the PKZIP command is incomplete or Invalid Explanation If the Spool File Job Name is Spool File Job User and Spool File Job number must be blank Otherwise all fields must contain valid name user and number or they must all b
98. KLIC See Message AQZ9087 for more contact information AQZ9105 40 Advance Encryption Feature is not licensed for this Serial Number Run will not be processed Explanation PKZIP could not validate the Advance Encryption License Feature Obtain proper Licensing keys from your reseller and run INSTPKLIC See Message AQZ9087 for more contact information AQZ9106 40 Spool File Feature is not licensed for this Serial Number Run will not be processed Explanation PKZIP could not validate the Spool File License Feature Obtain proper Licensing keys from your reseller and run INSTPKLIC See Message AQZ9087 for more contact in formation AQZ9108 40 Beta Release Has Expired Contact PKWARE Inc for Final Beta Release Explanation You are running a Beta Version of PKZIP for OS 400 that has expired Contact PKWARE Inc for a newer version of PKZIP for OS 400 128 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Appendix A Licensing Requirements PKZIP for OS 400 is a licensed product Without proper licensing the product can only be used to view archives Product features and license types can be licensed separately as the user s needs dictate The license key will contain all of the elements necessary to validate a customer s use of PKZIP for OS 400 The licensing process is comprised of several key elements that are described in the following sections Trial Period License generation for a trial use of f
99. KZIP These formats are described here and several commands are available for transforming files into one of these formats as they are compressed You may specify in which format a file is stored using the FILETYPE BINARY or FILETYPE TEXT command parameters OS 400 SAVF are always stored as BINARY type If you do not specify FILETYPE BINARY or TEXT then the PKZIP and PKUNZIP programs both will default to FILETYPE DETECT For more information see FILETYPE DETECT Old ZIP Archive When the PKZIP or PKUNZIP command is run the ZIP archive which is specified by use of the ARCHIVE parameter is known as the old ZIP archive except when the TYPE ADD parameter is being used to create a new ZIP archive The old ZIP archive may have been created by PKZIP for OS 400 during an earlier operation or may have been created by PKZIP on another platform and transferred from there When a ZIP archive is being updated or when PKUNZIP is extracting files from a ZIP archive the necessary details are taken from the old ZIP archive It should be noted that when PKZIP for OS 400 is updating a ZIP ar chive it takes the necessary data from the old ZIP archive merges it with any new data and transfers it to a new ZIP archive in a temporary member in the same OS 400 file as the old archive When all updating is completed PKZIP for OS 400 deletes the old ZIP archive and then renames the new ZIP archive to the same name as the old ZIP arch
100. LETYPE TEXT BINARY EBCDIC DETECT Specifies whether the files selected are treated as text or binary data For text files added to an archive trailing spaces in each line are removed the text is converted to ASCII based on the translation tables by default and a carriage return and line feed CR LF are added to each line before the data is compressed into the archive Binary files are not converted at all There are attributes which indicate how a file was compressed TEXT BINARY or a SAVF in the Archive headers The default setting and recommended is DETECT which analyzes the header to determine the file type To view the attribute settings of a file use the VIEWOPT DETECT 58 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 If the file is a SAVF then it will be processed as BINARY regardless of any option that you select DETECT Uses the attribute setting that is stored in the archive to determine the file type TEXT Specifies that the files selected are text files and translation will be performed using the translate tables specified in the TRAN option BINARY Specifies that the files selected are binary files and no translation should be performed EBCDIC Specifies that the files selected are text files and leaves it in EBCDIC without performing any translation This is good only if the files are to be used on an Ser ies or IBM type mainframe If they are unzipped to a PC file then a translation from EBCDIC to
101. Length Specifies the record length to use when creating an archive file in the QSYS Library system If the TYPARCHFL parameter is DB and the archive file does not exist the archive file will be created with the record length specified in this parameter Note A large record length will leave a high residual number if only one byte is use in the last record The allowable values are 132 Default is record length of 132 to match previous versions 40 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Record Length A decimal number from 50 to 32000 DELIM DELIM CRLF CR LF LFCR When compressing a text file not binary the DELIM parameter specifies what characters are to be appended at the end of records to serve as delimiters The delimiter is removed from the record when it is decompressed The allowable values are CRLF This is the default selection Specifies for PKZIP for OS 400 to use the default delimiter CR LF x 0DOA at the end of each text record CR Appends an ASCII Carriage Return hex OD LF Appends an ASCII Line Feed character hex 0A LFCR Appends an ASCII Line Feed character hex OAOD Note that transfers of MS DOS records uses a CRLF for a delimiter while UNIX records use a LF DIRNAMES DIRNAMES YES NO Specifies to store directories as an entry This is valid only for files in IFS YES Store the directories as entries in the archive NO Do not store directories as an
102. MBR is Member of the archive file DCL VAR amp ZIPMBR TYPE CHAR LEN 10 Archive file for PKZIP built with concatenation DCL VAR amp ZARCHF TYPE CHAR LEN 36 Add the PKZIP for OS 400 library to library List ADDLIBLE LIB amp PKZIPLIB MONMSG MSGID CPF2103 EXEC CHGVAR VAR amp LIBLCHG VALUE N Concatenate the libraries files and members for PKZIP of the archive CHGVAR VAR amp ZARCHF VALUE amp ZIPLIB TCAT TCAT amp ZIPFILE TCAT TCAT amp ZIPMBR Compress all files in the library TESTLIB and store them in the archive specified in the calling of the CLP program If messages AQZ0022 PKZIP Completed with Errors or AQZ0012 PKZIP ending with Nothing to do are returned from PKZIP send message indicating an error Occured PKZIP ARCHIVE amp ZARCHF FILES TESTLIB all all COMPRESS NORMAL ARCHTEXT This the text of the archive for example 3 MONMSG MSGID AQZ0022 EXEC SNDPGMMSG MSG PKZIP Ended with MONMSG for AQZ0022 MONMSG MSGID AQZ0012 EXEC SNDPGMMSG MSG PKZIP Ended with MONMSG for AQZ0012 If PKZIP Library was added to LIBL then remove it ENDPGM IF COND amp LIBLCHG EQ Y THEN RMVLIBLE LIB amp PKZIPLIB EOJ ENDPGM Appendix B Examples 145 Appendix C Memory Errors In some rare cases PKZIP for OS 400 may experience a memory error condition While running PKZ
103. NORMAL are used with the VIEWOPT option Total Uncompressed size amp 1 Total Compressed size amp 2 for amp 3 number files in listing AQZ0813 00 Archive amp 1 amp 2 bytes amp 3 file amp 4 Explanation Archive statistics for Archive File amp 1 is amp 2 bytes is length with amp 3 files archived Information with TYPE VIEW and VIEWOPT DETAIL 110 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0814 00 Created by amp 1 amp 2 Explanation Displays the PKZIP operating system and the PKZIP algorithm version which the file was added to the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0816 00 Minimum file system compatibility required 6 amp 1 amp 2 Explanation Information with TYPE VIEW and VIEWOPT DETAIL and only with debug option on Shows detail Operating System 8 1 with version 8 2 AQZ0817 00 Minimum to Extract 6 amp 1 amp 2 Explanation Displays the minimum version of the PKZIP algorithm required to extract the file from the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0818 00 Compression method 6 amp 1 42 Explanation Displays the Compression Method used to compress the file Information with TYPE VIEW and VIEWOPT DETAIL AQZ0821 00 Extended local header 6 amp 1 Explanation Shows the setting of the general purpose bit to indicate an Extended local header ex ists Information with TYPE VIEW and VIEWOPT DETAIL AQZ0822 00 Date
104. OxEl Ox8F 0x46 0x75 OxFD OxEB OxEE OxED f0 f 7 8 f 0x90 OxEF 0xB3 OxFB 0xB9 OxEA OxBD OxFF f8 ff SD kD Se ee x x x Mm XM ans WU NOW OM P P WAN PKZIP 400 Translate Table EBCDIC to USASCII 00 07 0x00 0x01 0x02 0x03 OxEC 0x09 OxCA Ox7F 00 07 08 0 OxE2 0xD2 0xD3 0x0B 0x0C 0x0D Ox0E OxA9 08 0 10 17 0x10 0x11 0x12 0x13 OxEF 0xC5 0x08 OxCB 10 17 18 1 0x18 0x19 OxDC 0xD8 0x1C 0x1D 0x1E 0x1F 18 1 20 27 OxB7 0xB8 0xB9 OxBB 0xC4 0x0A 0x17 0x1B 20 27 28 2 OxCC OxCD OxCF OxDO OxD1 0x05 0x06 0x07 28 2 30 37 OxD9 OxDA 0x16 OxDD OxDE OxDF OxEO 0x04 30 37 38 3 0xE3 OxE5 OxE9 OxEB 0xB0 0xB1 0x9E Ox1lA 38 3f 40 47 0x20 0xC9 0x83 0x84 0x85 OxAO OxF2 0x86 40 47 48 4f 0x87 OxA4 0x9B 0x2E 0x3C 0x28 0x2B 0xB3 48 4f 50 57 0x26 0x82 0x88 0x89 0x8A OxAl 0x8C 0x8B 50 57 58 5 Ox8D OxE1 0x21 0x24 0x2A 0x29 0x3B OxAA 58 5f 60 67 0x2D 0x2F 0xB2 0x8E 0xB4 0xB5 OxB6 Ox8F 60 67 68 6 0x80 OxA5 0x7C 0x2C 0x25 Ox5F 0x3E 0x3F 68 6f 70 77 OxBA 0x90 OxBC OxBD OxBE 0xF3 0xC0 0xC1 70 77 78 7 0xC2 0x60 0x3A 0x23 0x40 0x27 0x3D 0x22 78 7 80 87 OxC3 0x61 0x62 0x63 0x64 0x65 0x66 0x67 80 87 88 8 0x68 0x69 OxAE OxAF 0xC6 0xC7 0xC8 0OxF1 88 8 90 97 OxF8 Ox6A 0x6B 0x6C 0x6D Ox6E Ox6F 0x70 90 97 98 9 0x71 0x72 OxA6 OxA7 0x91 OxCE 0x92 0x0F 98 9f a0 a7
105. P command this error should never occur Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0456 40 amp 1 bad filename length in amp 2 directory Explanation File amp 1 was found to have a bad file name length in the archive amp 2 directory Processing will continue at the next entry Try running PKUNZIP with detail view to gather more information The archive may be corrupted 96 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0457 40 amp 1 Bad Extra data length in amp 2 directory Explanation File amp 1 was found to have a bad Extra data length in the archive amp 2 directory Processing will continue at the next entry Try running PKUNZIP with a detail view to gather more information The archive may be corrupted AQZ0458 40 File amp 1 Bad Archive File offset amp 2 6 amp 3 Explanation PKUNZIP was trying to extract or test files in the Archive File number 1 in archive contained a bad offset length 82 AQZ0459 20 Length warning amp 1 bytes amp 2 Explanation Length Warning Based on the Local directory the bytes required are less than the actual bytes used Review the extracted file and ensure it is extracted correctly Run PKUNZIP with View detail to check files sizes The file is extracted and the process continues AQZ0460 40 Length Error amp 1 bytes amp 2 Explanation Length Failure Based on the Local directory the bytes required
106. PLF Attributes When a spool is selected and the parameter EXTRAFL is coded YES the default then extended attributes listed below are stored in archive and can be viewed with PKUNZIP TYPE VIEW VIEWOPT ALL Also when the spool files are stored in the archive the date and time for the file is the spool files creation date and time and can be viewed with PKUNZIP Extended Attributes 1 Description The spool file description is built as follows Job Name User Name Job Number Spool File Name Fspool File Number Suffix For Example MYJOB BILLS 152681 INVOICE F0021 SPLF 2 Spool File Type SCS SNA Character Stream IPDS An intelligent printer data stream AFPDS Advanced Function Print Data Stream USERASCII An ASCII data stream user defined LINE Line data that is very printer specific and AFPDSLINE Mixed data line data and AFPDS data 3 Target File created Describes the target type file created during compression SPLF Spool Files TXT ASCII Text Conversion and PDF Portable Document Format 4 Number of Pages contained in the spool file An example of the attributes view seen with VIEWOPT ALL for a spool file converted to a PDF for the might look like Filename CRTCM60 PDF Detected File type Binary Created by PKZIP for OS 400 5 5 PKZIP 2 x compatible Minimum to Extract PKZIP 2 0 Or Greater Compression method Deflated Fast Date and Time 20U2 DEE LF O72 22500 Compressed size 2316 bytes U
107. RESHEN Compression Level SUPERFAST NO FAST NORMAL MAX File Types z s s 00 DETECT DETECT TEXT BINARY Zip Spool Files a gt e s a a SPL SPL Archive Password After defining what spool files are to be selected for compression you need to define the file format the spool file will be stored in the archive At this time there 3 formats of SPLF Spool File native mode TEXT ASCII text document with 3 variation of how a new page is handled and PDF Adobe Portable Document Format Chapter 6 OS 400 File Processing Support 23 For use with TEXT and PDF there are 3 variation of storing the file name in the archive with the parameter SFTGFILE SFTGFILE GEN1 will generate a very specific name using most of the Spool File name attributes to form the file name so that it will not be a duplicated The name will be built as follows Job Name User Name Job Number Spool File Name Fspool File Number Suffix For example MYJOB BILLS 152681 INVOICE F0021 SPLF The suffix is dependent on the SFTARGET setting SPLF can only be stored as SFTGFILE GEN1 SFTGFILE GEN2 uses the spool file name and appends the spool file number followed by the suffix that is depended on the SFTARGET setting Caution should be taken in that a duplicate file name in the archive could be created An example of GEN2 is a spool file INVOICE with Spool File number of 21 that will be converted to a text file will generat
108. S and EXCLUDE parameters This parameter only works with the TYPE set to VIEW See parameter TYPLISTEL for file system type information NONE No list file will be created path filename Enter the file path and name of the file to create The layout depends on which file system you want to create the file in Library File System The format is Library File Mbr Integrated File System IFS The format is path1 path2 pathn filename CVTDATA CVTDATA External Pgm Conversion Extended Data Specifies the extended data that is passed to the external program CVTNAME When CVTFLAG is not NONE the contents of the parameter is passed to provide extended flexibility in controlling how the iSeries names are stored in the archive See Appendix D External Name Conversion Program for more details on the external program External Pgm Conversion Extended Data Specify up to 255 bytes of unedited data which is passed to the exit program CVTNAME to assist in controlling the program logic CVTFLAG CVTFLAG NONE 400 Conversion Flags Specifies the flags passed to the external program CVTNAME These are used to control how the Series names are stored in the archive See Appendix D External Name Conversion Program CVTNAME for more details on the external program The allowable values are NONE Conversion exit is not active 400 Use the included sample CVTNAME program section that does not change the names Conversion Flags S
109. SPLF TEXT The spool file will be saved in the archived as an ASCII Text document The suffix for this selection is TXT Each New page will have a Form Feed control character TEXT1 The spool file will be saved in the archived as an ASCII Text document The suffix for this selection is TXT Each New page will have a Carriage Control and Line Feed control characters TEXT2 The spool file will be saved in the archived as an ASCII Text document The suffix for this selection is TXT Each page will have a Carriage Control and Line Feed control characters for blanks lines to fill out a page with the number lines required by the spool file attribute PDF The spool file will be saved in the archived as a PDF Text document The suffix for this selection is PDF The size will be adjusted based upon the width and length of the Spool File SFTGFILE SFTGFILE GEN1 GEN2 GEN1P File Name Specifies the how the file name will be stored in the archive The allowable values are GEN1 GEN1 is the default selection This generate a very specific name using most of the Spool File name attributes to form the file name so that it will not be duplicated The name will be built as follows Job Name User Name Job Number Spool File Name Fspool File Number Suffix MYJOB BILLS 152681 INVOICE F0021 SPLF The suffix is dependent on the SFTARGET setting GEN1P GEN1P generates the same file name as GEN1 except instead of a separat
110. SPRT 3 MYJOB2 EVWSS 010928 12 12 02 09 59 06 QSYSPRT 4 MYJOB2 EVWSS 010928 12 12 02 09 59 06 Next using the User override with the SPLUSRID WSS and submit MYJOB1 with User EVWSS File File Nbr Job User Number Date Time QSYSPRT 26 QPRTJOB WSS 010118 12 12 02 10 02 50 QSYSPRT 27 QPRTJOB WSS 010118 12 12 02 10 02 50 QSYSPRT 28 QPRTJOB WSS 010118 12 12 02 10 02 50 Notice that the JOB was changed to QPRTJOB since the user being extracted was different than the user running the Job Appendix I SPOOL Files Considerations 163 Next being signed on as user WSS submit a job MYJOB11 with the job parameter USER profile specified for user EVWSS gt SBMJOB CMD PKUNZIP ARCHIVE atest splftst tst02 TYPE EXTRACT JOB MYJOB11 USER EVWSS File File Nbr Job User Number Date Time QSYSPRT 2 MYJOB11 EVWSS 010936 12 12 02 10 25 25 QSYSPRT 3 MYJOB11 EVWSS 010936 12 12 02 10 25 25 OSYSPRT 4 MYJOB11 EVWSS 010936 12 12 02 10 25 25 164 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Glossary This glossary provides definitions for items that may have been referenced in the PKZIP documentation It is not meant to be exhaustive There are excellent source of documentation for computing terms on the Internet three of which are shown below IBM s Terminology http www networking ibm com nsq nsqmain htm Web Site Absolute Path Name A string of characters that is used to refer to an object starting at the
111. Text Desc 4 amp 1 Explanation Displays the text associated with a library that contains the file that has been stored within the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0845 00 File Text Desc 4 amp 1 Explanation Displays the text associated with a file that has been stored within the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0846 00 Mbr Text Desc 6 amp 1 Explanation Displays the text associated with the member of the file that has been stored in the 114 archive Information with TYPE VIEW and VIEWOPT DETAIL PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0847 00 Record Length 6 amp 1 Explanation Displays the record length of the file in the Archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0848 00 Source or Data 4 amp 1 Explanation Displays whether the file stored in the archive is a PF DTA file or is a PF SRC file type Information with TYPE VIEW and VIEWOPT DETAIL AQZ0849 00 Source Type 6 amp 1 Explanation Displays the source type for example CLP RPG CMD etc for a PF SRC member Displays Information with TYPE VIEW and VIEWOPT DETAIL AQZ0850 00 Unknown Database type 6 amp 1 Explanation The Extended Data field specifying the file is a database or is not invalid Database options ignored Information with TYPE VIEW and VIEWOPT DETAIL AQZ0851 00 Database File Attributes Explanation This indicates that a file
112. The license dataset must be defined and customized prior to use of the product Extended attributes are stored within the archive directory Note These attributes are not published as part of a program control interface and may change between releases Using the parameter TYPE VIEW with VIEWOPT ALL will report extended file information in the same report format order regardless of the order that extended attributes are stored in the archive PKZIP for OS 400 library can be renamed from the standard distribution name of PKZ550430 to fit the operational environment PKZIP and PKUNZIP commands can be executed without the products library being part of the library list Appendix G Implementation Considerations 157 Appendix H Operating Environment PKZIP for OS 400 is distributed in a standard library such as PKZ550430 where the 500 is the version release of PKZIP for OS 400 and 430 is the minimum OS 400 operation system release that it supports such as VAR3MO The PKZIP for OS 400 Library contains Programs Commands Help Panels Mes sage File License Files Translation Source File Command Source File CL Source File CVTNAME CL program and examples and the PKZIP for OS 400 Control Data Area necessary to run the product As released the distributed library PKZ550430 must be in the library list and the library name must be the same as distributed The Library name used by PKZIP for OS 400 is determined by
113. View to indicate Advanced Encryption AES protection is used for a file ARCHIVE ARCHIVE Archive Zip File name with path Specifies the path file name or the library file name of the PKZIP for OS 400 archive to be processed If the file exists PKZIP will overwrite the file otherwise PKZIP will create the file for you Depending on which file system you choose the Path or Library must exist This is a required parameter The format depends on whether you will be using the Archive file in the Library File System or the IFS Integrated File System See parameter TYPARCHEL for file system type information Library File System Format is Library File Member If Member is omitted it will be created with the file name If the file is not found it will be created with a default length specified in parameter DFTARCHREC which has a default of 132 If you would create a file manually to use a larger record length create it with no members and with parameter MAXMBRS with NOMAX or with a high excepted limit If the Library is not specified the file name will be searched using LIBL If the file name is not found the file will be created in the users CURLIB If a Library is specified and does not exist PKZIP will create the Library Integrated File System IFS Open system path followed by the archive file name Chapter 9 PKZIP Commands 37 ARCHTEXT ARCHTEXT NONE Archive File Text description Specifies text that w
114. WORD 45 52 60 Path and Path names 18 Path Name 172 PDF Creation Attributes 162 PF 172 PFK 172 Physical Disk I O 172 Physical File 172 Physical File Member 172 Physical Files both Source and Data 27 PKUNZIP Command Keyword Details 54 PKUNZIP Command Summary 53 PKUNZIP Commands 53 PKZDTA5 Data Area 158 PKZIP Command Keyword Details 36 PKZIP Commands 34 PKZIP for OS 400 Differences with other Platforms 8 PKZIP for OS 400 Restrictions 6 PKZTABLES 154 155 PL I 172 POWER 173 Preface iii Primary File Selection Inputs 12 Processing GZIP Archives 65 Processing with GZIP 64 Product Features 132 Production Library 173 Program Temporary Fix PTF 173 Programmed Function Key PF or PFK 173 Programming Language l PL I 173 PTF 173 Q QDLS 19 20 QFileSvr 400 19 QNetWare 19 QNetWare file system 19 QNTC 19 QOpenSys 19 QOPT 19 20 QSYS 173 QSYS Library File System 17 QSYS Summary 17 QSYS LIB 19 Qualified Name 173 Record 173 Record Layouts 133 Reduced Instruction Set Computer RISC 173 Reentrant 173 Related IBM Publications v Related Publications iv relative path name 18 Relative Path Name 173 Release Summary 5 Remote Job Entry RJE 173 Report Program Generator RPG 174 Reporting 129 135 Return Code 174 RISC 174 RJE 174 root 19 RPG 174 Running Without the Library in the Library List 159 S Sam
115. X8WT Processor Group P10 Rec LICENSED BY PKWARE 07 13 01 WSS Rec 5 X1LT83K1 110531837 My Company Name Dayton OH Rec yyyymmdd ssssssttttii Rec Ssssssssttt Rec B7233 20020801 0107X8WTP Rec TH823F 20020801 0107X8WTP Rec B723U 20020801 0107X8WTP Rec TH823B 20020801 0107X8WTP Rec B723P 20020801 0107X8WTP License File PKZ550430 PKZLIC PKZLIC Updated successfully 00 3000 NRA Reporting To report on the status of a license at your location you can run the license program with the following command INSTPKLIC TYPE VIEW EXAMPLES from above Appendix A Licensing Requirements 135 View Demo PKZIP for 0S 400 TM Compression Utility Version 528 0 20 20027 La Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107X8WT Processor Group P05 KKEKKKKKKKK KKK KKK KKK KK KKK KKK KKKKKKKKKK KKK KK KKK A License Report requested on 11 14 02 14 19 from CPU Serial 0107X8WT This Product is Licensed to Customer 202020202 My Demo Customer Name KKEKKKKKKK KKK KKK KKK KKK KKK KK KKKKKKKKKKK KK KKK KKK Compression Licensed as a DEMO with 30 Days remaining 12 14 2002 Contact PKWARE Inc for Licensing KKEKKKKKK KKK KKK KKK KKK KKK KKK KKKKKKKKKKKKK KKK KKK Decompression Licensed as a DEMO with 30 Days remaining 12 14 2002 Contact PKWARE Inc for Licensing KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKkKkk kk EMO with 30 Days remaini
116. YES is specified for the PKZIP command and if the file being compressed is a Physical File PF DTA or PF_SRC then the basic extended attributes are created followed by the de tailed Database attributes With the detailed Database attributes PKUNZIP can build and compile the DDS source file to recreate the database file see DATABASE Attributes The database file will be compressed in the Binary mode Standard QSYS Library File System Attributes When the files being compressed are from the QSYS Library File System the standard attributes created are described in the following tables For additional information see the DSPFD command in the IBM manuals Physical Files both Source and Data Attribute Description 1 Maximum Record Length Specifies the length in bytes of the records stored in the physical file 2 Library Text The text description of the library that the file does exist 3 File Text The text description of the File 4 Member Text The text description of the member 5 File Type Specifies whether each member of the physical file being created contains data records or contains source records statements PF_SRC or PF_DTA 6 Source Type Code Specifies the source type of the member such as CLP PF LF RPGLE etc Chapter 8 Extended Attributes 27 SAVF Attribute Description 1 Library Text The text description of the library that the SAVF e
117. Z550vrm library contains PKZIP for OS 400 Version 5 5 patch level 0 with the OS 400 version specified as vrm OS 400 version Target Release and Modification for the product build for example 330for V4R3MO To unload the required library for PKZIP for OS 400 load the CD ROM and issue the following command RSTLIB SAVLIB PKZ550vrm DEV optnn OPTFILE pkzip Where vrm is the version release and modification level and optnn is the correct optical device name to use Using FTP to iSeries 1 After downloading the program locate a SAVF on your hard drive The SAVF is named PKZ550430 SAV Remember the path to this file because it will be required in your FTP session 2 Start an iSeries workstation type session and then sign on with sufficient authority to perform the commands used below 3 Create a SAVF on the iSeries CRTSAVF YourLIB PKZIP550 The TCP IP network server must be running or start the TCP IP network server with STRTCP 4 Start a PC based FTP session with your normal FTP procedures and send the PC file to the iSeries SAVF you created in Binary mode or run the following e FTP Open the Series IP Address and sign on BIN this will transfer the file as a Binary object PUT Local file PKZ550430 sav Remote file YourLIB PKZIP550 5 Restore the PKZIP for OS 400 product from the SAVF RSTLIB SAVLIB PKZ550430 DEV SAVF SAVF YourLIB PKZIP550 RSTLIB PKZ550430 6 Delete the SAVF DLTF
118. Z9067 40 An error has occurred in validating the License Contact Your Dealer Explanation The validation of the license was found to be Invalid Contact your Dealer for correct codes The License File will not be updated 124 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ9068 40 An error has occurred in validating the License Contact Your Dealer Explanation The validation of the license was found to be Invalid Contact your Dealer for correct codes The License File will not be updated AQZ9069 40 Customer name cannot be blank for Control 55 Explanation In the Customer Control record starts with 55 the Customer Name should contain the Customers Name in Positions 23 thru 72 and must not be blank AQZ9070 40 Duplicate hardware lt s gt found for Feature 2 Explanation Only one unique hardware Serial Number and Processor Group is allowed per Fea ture Code The License File will not be updated AQZ9071 40 Embedded blanks in hardware lt amp 1 gt for feature amp 2 Explanation The Hardware codes Serial Number and Processor Group must all be non blank characters The License File will not be updated AQZ9072 40 Max hardware exceeded amp 2 for Feature amp 2 Explanation All Hardware available entries are in use There is no room to add another hardware entry for the product Contact your Dealer AQZ9073 40 amp 1 Request to setup DEMO rejected DEMO is already running Expla
119. ZIP 162 When extracting a spool file with PKUNZIP the new spooled file will be created with attributes based on values taken from the spooled file attributes when PKZIP archived the spool file The spool file s File Number Job Job User Job Number date and time are controlled by IBM OS 400 operating system during the creation of a spool file The new spool file that is created by the PKUNZIP is spooled under one of two jobs and is dictated by IBM s create spool file API The job is determined by the user name field from the attributes If the user name is the current user it is a part of the user s job and is owned by the user profile that the job was started with First the user profile for the user name must already exist When using the user id override parameter SPLUSRID the spool file will be now belong to the override user If the ownership of the new spooled file is assigned to a different user by a different user profile name in the user name field from the attributes then the current user must have SPLCTL authority to assign the spooled file to another user When this is done the new spooled file is by the user PKZIP OS 400 5 5 User s Guide PKOU V5R5000 specified in the user name field or override parameter The new spooled file is then part of a spe cial system job QPRTJOB that is created for each user The new spooled file is placed on the output queue specified in the output queue name field from the original
120. ZIP Completed Successfully Press ENTER to end terminal session To see the file in the folders run WRKLNK QDLS MYFOLDER Work with Object Links Directory QDLS MYFOLDER Type options press Enter 3 Copy 4 Remove 5 Next level 7 Rename 8 Display attributes 11 Change current directory Opt Object link Type Attribute Text ri FLR pa FLR MYARCH1 ZIP DOC 142 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Next to view the contents run PKUNZIP ARCHIVE QDLS MYFOLDER MYARCH1 ZIP TYPARCHFL IFS PKZIP for 0S 400 TM Compression Utility Version 5 5 2002 08 21 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP is a registered trademark of PKWARE Inc Archive QDLS MYFOLDER MYARCH1 ZIP 551 bytes 1 file Length Method Size Ratio Date Time CRC 32 Name 259 Defl F 177 32 11 27 00 15 32 b5dbf80c TESTLIB BEN BEESON 259 177 32 1 file PKUNZIP extracted 0 files PKUNZIP Completed Successfully Press ENTER to end terminal session Example 4 Processing Archive on a CD QOPT The following is an example of processing an archive that exists on a CD and using PKUNZIP to view or extract Because the archive file is on a CD and the file system QOPT controls the CD this archive basically exists in the IFS First check and ensure the archive is on the CD by doing a WRKLNK you can use WRKOPTDIR but using WRKLNK will show the actual paths required Remember the volume of the CD is also a
121. ach component can be up to 10 characters long and the object type can be up to 6 characters long 5 The directory hierarchy within QSYS LIB can either be two or three levels deep two or three components in the path name depending on the type of object being accessed If the object is a database file the hierarchy can contain three levels library file or member otherwise there can be only two levels library or object The combined length of each component name plus the num ber of directory levels determine the maximum length of the path name If and QSYS LIB are in cluded as the first two levels the directory hierarchy for QSYS LIB can be up to five levels deep 6 The characters in names are converted to code when the names are stored Quoted names however are stored using the code page of the job For information about code pages see the publication National Language Support IFS Summary Only directories and Stream Files are supported by PKZIP for OS 400 If the archive file is to be in IFS set parameter TYPARCHFL IFS If the file being compressed or extracted is in IFS set parameter TYPFL2ZP IFS Chapter 6 OS 400 File Processing Support 21 If the list files are to be in IFS see Appendix E List Files and their Usage set parameter TYPLISTFL IFS Format Summary Directory Directory 1 directory2 will be current directory Stream File filename or directory filename will be cur
122. al table for translation Using this is initially faster be cause PKZIP does not have to parse the override table Member Name Specifies the member name in the file PKZTABLES that will be parsed and used to translate data files to the archive character set The member should have the exact format of member UKASCII in file PKZTABLES see Appendix F Translation Tables for defining translation tables TYPARCHFL TYPARCHFL DB IFS Specifies the type of file system in which the archive file will exist see parameters ARCHIVE and TMPPATH for additional information DB Archive files are to be in the QSYS Library file system IFS Archive files are to be in the Integrated Files System IFS TYPFL2ZP TYPFL2ZP DB IFS Specifies the type of file system that contains files to be zipped Reflected for files in parameters FILES and EXCLUDE DB Files to be zipped are in the QSYS Library file system IFS Files to be zipped are in the IFS Integrated Files System DBA Files to be compressed are database files in the QSYS Library file system with Database Mode DBSERVICE YES and the records are to processed in arrival sequence This is only pertinent for Database files containing keys and when it is important to retain the arrival sequence of the data SPL Files to be zipped are Spool Files TYPLISTFL TYPLISTFL DB 1FS 50 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Specifies the type of files system tha
123. amp 1 Explanation Informational How many include items found in EXCLUDE and EXCLFILE AQZ0116 00 Zip diagnostic amp lcluding lt amp 2 gt Explanation Informational PKZIP Display of file being included or excluded AQZ0117 00 File matches archive file skipping Explanation PKZIP running with a file selected which is the current file requested as the archive This file is skipped from the selection process Chapter 12 Messages 75 AQZ0118 40 Replace cannot open amp 1 Explanation PKZIP is trying to copy the temporary archive file to the archive file The archive file cannot be opened Check the job log for messages as to why the open failed If specifying parameter TMPPATH in the Library File system verify that both Library and File name is specified for example MPPATH MYLIB TEMPARCH AQZ0119 40 Fcopy Write error Explanation PKZIP is trying to copy the temporary archive e file to the archive file The archive encountered an error while writing the new archive file Check the job log for messages to determine why the write failed AQZ0120 40 Fatal Incorrect compressed size amp 1 Explanation A failure occurred while compressing The size reported by the compression engine is different from the offset determined in the archive file This should never happen Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0121 00 Stats amp 1 amp 2 Explanati
124. and Media Services an external identifier for media A label includes information about volume serial identifier creation date expiration date location and container identifier LAC See License Authorization Code shown below Lempel Ziv LZ A technique for compressing data This technique replaces some character strings which occur repeatedly within the data with codes The encoded character strings are then kept in a common dictionary which is created as the data is being sent Library List A list that indicates which libraries are to be searched and the order in which they are to be searched The system recognized identifier is LIBL License Authorization Code LAC The inserted code that is needed to unlock an iSeries licensed program Linkage Editor A system related program that resolves cross references between separately compiled object modules and then assigns final storage addresses to create a single load module Logical Partition A subset of a single iSeries system that contains resources such as processors memory and input output devices A logical partition operates as an independent system If hardware requirements are sufficient multiple logical partitions can exist within a system LZ See Lempel Ziv LZ shown above Magnetic Tape Unit See Tape Drive MQSeries A series of IBM products that enables programs to communicate across a network of disparate components Multithreading A programming tec
125. and Time amp 1 Explanation Displays the modification Date mm dd yyyy and Time hh mm of files attributes Information with TYPE VIEW and VIEWOPT DETAIL AQZ0823 00 32 bit CRC value hex 6 amp 1 Explanation Displays the value of the Cyclical Redundancy Check of a file in the archive Informa tion with TYPE VIEW and VIEWOPT DETAIL Chapter 12 Messages 111 AQZ0824 00 Compressed size amp 1 bytes Explanation Displays the compressed size of a file in the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0825 00 Uncompressed size 6 amp 1 bytes Explanation Displays the Uncompressed size of a file in the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0826 00 Length of filename 6 amp 1 bytes Explanation Displays the length of the file name of a file in the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0827 00 Length of extra field 6 amp 1 bytes Explanation Displays the length of the Extended Data field in the Archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0828 00 Length of file comment 6 amp 1 characters Explanation Displays the Length of a file comment if it exists in the archive Information with TYPE VIEW and VIEWOPT DETAIL AQZ0829 00 Size of sliding dictionary implosion amp 1K Explanation Displays the size of the sliding dictionary that was used to compress a file in the archive with the Implosio
126. anges can be made to CVTNAME to fit the customer s site requirements The use of and changes to the CVTNAME program is the customer s responsibility The following is an example of the CVTNAME CLP source code included in the PKZIP for OS 400 library Sample CVTNAME Program CVTNAME Sample A BRK KK RR RR RR RR RR RR RR RR RR RR RR RR RRA RARA KK RRA Abstract This is a sample CL program that can be used by E PKZIP for OS 400 product as an exit program to change the names from 0S 400 to an archive name and visa versus There are 4 parameters s 1 The input name that is supplied by PKZIP or PKUNZIP E to this program to analyze up 255 bytes 2 The Name that this program can change and passes back to the calling programs to use up to 255 bytes f this is passed back with the lst position blank PKZIP PKUNZIP will revert back to settings of the CVTTYPE parameter DES 3 A 5 byte field that represents a control field or v JE or flags that controls how CVTNAME should process the i name 4 A 255 byte field that is user defined in the command to provide more information to assist controlling the F logic in processing the name For Example it may E time stamp prefix of the file names This sample CVTNAME CLP has three flags accepted 1 If the flag is 400 there are no conversion taking place and the input name is passed back as new name 2 If the
127. archive amp 1 and that the archive is identified as a GZIP archive GZIP Archive files cannot be updated AQZ0601 40 Option GZIP cannot zip to an existing archive Explanation PKZIP GZIP YES parameter has been specified and the archive indicated on the PKZIP command already exists A GZIP Archive cannot be updated you can only compress in GZIP format to a new archive Specify an archive name that is not in use AQZ0602 40 Option GZIP only allows 1 file per archive Explanation GZIP processing has identified more than one file to include in the archive but only one file is allowed per GZIP archive Specify a file name or wildcard combination that identifies only one file or be more specific and specify the library the file and the member names 106 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0603 40 Invalid TYPE used with GZIP TYPE ADD MOVEA VIEW is only valid option for GZIP Explanation A PKZIP TYPE other than ADD MOVEA or VIEW was specified with option GZIP YES This is an invalid combination Job terminated AQZ0604 00 PKZIP Compressed amp 1 files in GZIP Archive amp 2 Explanation amp 1 is the number of files that were compressed in this run of PKZIP storing them in the GZIP Archive File amp 2 AQZ0605 40 GZIP cannot allocate memory for GZIP extraction Explanation PKUNZIP was trying to extract the file from an archive identified as a GZIP archive but could not allocat
128. archive please refer to the DROPPATH CVTTYPE TO and EXDIR parameters for controlling the conversion of file names extracted from the archive NEWER Extracts files in the archive that have a more recent date and time than the corresponding file on disk If the files do not exist on disk they will be extracted as newer All other files will be skipped TEST Tests the integrity of files in the archive by extracting files without writing the data As each file is extracted a CRC is calculated At the end of the file the calculated CRC is compared against the stored CRC in the archive file header to confirm that the data has not been corrupted ARCHIVE ARCHIVE Archive Zip File name with path Specifies the path file name or the library file name of the PKUNZIP archive to be processed This is a required parameter The format depends on whether you will be using the Archive file in the Library File System or the IFS Integrated File System See parameter TYPARCHEL for file system type information 54 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Library File System Format is Library File Member If Member is omitted it will use the file name for the member Integrated File System IFS Open system path followed by the archive file name CRTLIST CRTLIST NONE path filename Specifies that PKUNZIP will create an output file with a list of entries that will be compressed based upon the selection criteria in the FILE
129. archive entry DIRRECRS DIRRECRS NONE FULL NAMEONLY IFS only Specifies whether to search recursively through directories for file selection or only search the current specified directory The allowable values are NONE Search only the current specified directory FULL Search through all directories by starting with the current specified directory for selected files If FULL is used and is for file selections all files found in all directories below the current directory will be selected NAMEONLY To be considered a hit the full path and file name must match the selection statements exactly EXCLFILE EXCLFILE NONE path filename Chapter 9 PKZIP Commands 41 This parameter specifies the file containing the list of files to be excluded This can be used with or without the EXCLUDE parameter See parameter TYPLISTFL for file system type information NONE No list file will be processed path filename Enter the file path and name of the file to process The layout depends on which file system you want the file created Library File System The format is Library File Mbr Integrated File System IFS The format is path1 path2 pathn filename EXCLUDE EXCLUDEffile_specification1 file_specification2 file_specificationn Specifies the files and file specification patterns that will be excluded from the PKZIP run One or more names can be specified Each name should be in the OS 400 file
130. are more than the actual bytes used Review the extracted file and ensure it is extracted correctly Run PKUNZIP with View detail to check files sizes The file is extracted and the process continues AQZ0461 40 Error Not enough memory to Unshrink amp 1 Explanation While trying to allocate memory to Un shrink file amp 1 an error occurred All processing is terminated Check other messages in Job Log for possible causes and refer to Appendix C about memory errors If this continues please contact the Product Ser vices Division at 1 937 847 2687 for assistance AQZ0462 40 File amp 1 Bad local header Explanation File in the archive with sequence number amp 1 has an invalid Local Directory Header File cannot be extract or tested The Archive may be corrupted AQZ0463 40 Attempting to re compensate Explanation An error occurred previously in the archive see Message Log An attempt will be made to compensate for the error Chapter 12 Messages 97 AQZ0464 40 Skipping amp 1 2 volume label Explanation An archive created under another system has Volume label appearing in the archive iSeries cannot process this request and will skip file amp 1 AQZ0468 40 Invalid compressed data to amp 1 amp 2 Explanation While attempting to uncompress file amp 2 using method amp 1 it was determined that the compressed data was invalid or corrupt Review the log for other messages to help diagnose the
131. ation PKUNZIP could not find the specified file name in the FILES and or INCLFILE parameters File is not extracted AQZ0204 10 Caution Excluded file name not matched 6 amp 1 Explanation Based upon entered EXCLUDE and EXCLFILE parameters PKUNZIP did not find any names to exclude This is informational only Chapter 12 Messages 81 AQZ0205 00 Please check that you have transferred or created the Archive File in the appropriate BINARY mode Explanation PKUNZIP displays this message as a reminder of a common cause of an invalid archive file This message appears with invalid archive messages AQZ0208 00 Skipping 6 amp 1 unsupported compression method amp 2 Explanation PKUNZIP while trying to extract file amp 1 found an unsupported compression method The file is unable to be extracted Run PKUNZIP with TYPE VIEW and VIEWOPT Detail for more information about the file and its compression method This file is skipped in this extraction run AQZ0211 00 amp 1 appears to use backslashes as path separators Explanation The selection file amp 1 appears to have double in the name for path separators Will continue processing with normal separators Review results to verify AQZ0212 00 Error Invalid response amp 1 Explanation An Invalid response was received for a reply message Review the reply message request for a valid response and once located enter a valid response AQZ0213 00
132. ations Data Integrity 1 The condition that exists as long as accidental or intentional destruction alteration or loss of data does not occur 2 Within the scope of a unit of work either all changes to the database management systems are completed or none of them are The set of change operations are considered an integral set DBCS See Double byte Character Set Device 1 A piece of equipment that is used with the computer A device does not generally interact directly with the system but is controlled by a controller Each device has a device description associated with it and often also has a job associated with it Devices can be workstations printers diskette units tape units or remote systems 2 In Backup Recovery and Media Services an IBM tape reel or cartridge unit or any other unit containing removable media which is available to the iSeries system for use in Backup Recovery and Media Services processing Direct Access A file access method allowing reading and writing of records in an arbitrary order Contrast with keyed access and sequential access Double byte Character Set DBCS A set of characters in which each character is represented by 2 bytes Languages such as Japanese Chinese and Korean which contain more symbols than can be represented by 256 code points require double byte character sets Because each character requires 2 bytes the typing displaying and print ing of DBCS characters req
133. ave the option ALWNULL warning message AQZ0521 will be issued 2 If the file contains Triggers warning message AQZ0518 will be issued Any information about the triggers and associated programs are not stored in the archive If a file has File Constraints warning message AQZ0519 will be issued If an authorization list was specified for the file then the AUT parameter is set to CHANGED The authorization list is not stored in the archive It is up to the user to set the authorization list when extracted 5 Ifa file has an Alternate Collating Sequence warning message AQZ0520 will be issued The information about the alternate collating sequence is not stored the archive Ifthe database s Triggers File Constraints Alternate Collating Sequence and Logical files are to be preserved then save the database file trigger programs if they exist and logical files to a SAVF Then compress the SAVF Note Using DBSERVICE YES can increase the size of the archive because some databases may have hundreds of fields and attributes If this archive will be used on a platform other than Series with PKZIP for 0S 400 1 these attributes are ignored and therefore should not be used Source File Considerations When compressing source files the use of the archive file should be considered By using the DBSERVICE NO only the data is extracted in text mode such as the sequences numbers and change dates are not included This would be
134. be in the QSYS file system set parameter TYPLISTFL DB Format Summary PF DTA LIBRARY FILE MEMBER PF SRC LIBRARY FILE MEMBER SAVF LIBRARY FILE IFS Integrated File System The Integrated File System is a part of OS 400 which supports stream input output and storage manage ment similar to personal computer and UNIX operating systems while providing an integrating structure over all information stored in the iSeries The key features of the integrated file system are e Support for storing information in stream files that can contain long continuous strings of data These strings of data might be for example the text of a document or the picture elements in a picture The stream file support is designed for efficient use in client server applications e A hierarchical directory structure that allows objects to be organized by specifying the path through the directories to an object for access to an object Chapter 6 OS 400 File Processing Support 17 e A common view of stream files that are stored locally on iSeries Integrated Netfinity Server for iSeries or a remote Windows NT server Stream files can also be stored remotely on a Local Area Network LAN server Directories and Current Directory A directory is a special object that is used to locate objects by names specified by users Each directory contains a list of objects that are attached to it and that list may include other directories A current direct
135. be used 3 A file stored on a computer network which can be retrieved by a file transfer program FTP or other means 4 The PKZIP file that holds the compressed zipped data file ASCII See American Standard Code for Information Interchange iSeries See Application System 400 shown above iSeries Object An object that exists in a library on the iSeries system and is represented by an object on the PC For example a user profile is an iSeries object represented on the PC by the user profile object Authorized Program Analysis Report APAR A request for correction of a defect in a current release of an IBM supplied program Bandwidth The capacity of a communications line normally expressed in bits per second bps A lack of band width is one of the prime motivations for compression software Batch Job A predefined group of processing actions submitted to the system to be performed with little or no interaction between the user and the system This is in contrast to an Interactive Job Binary File A file that contains codes that are not part of the ASCII character set Binary files can utilize all 256 possible values for each byte in the file Bit A contraction of binary digit Either of the binary digits O or 1 Compare with byte Block 1 A group of records that are recorded or processed as a unit 2 A set of adjacent records stored as a unit on a disk diskette or magnetic tape Byte 1 The smallest unit of
136. be used with TYPE VIEW and VIEWOPT NORMAL Correct and RE RUN AQZ0258 10 Overriding Library lt amp 1 gt is invalid Explanation Parameter EXDIR was specified in PKUNZIP with TYPE EXTRACT and TYPFL2ZP DB The first path in EXDIR contains an invalid Library due to the name exceeding 10 characters Run is aborted Correct command and re run AQZ0259 00 Target file exists Skipping amp 1 Explanation Warning PKUNZIP was extracting file amp 1 but the file already exists Parameter OVERWRITE was either set to NO or it was set to PROMPT and the response on the prompt was N AQZ0260 00 Target file newer Skipping amp 1 Explanation Warning PKUNZIP was extracting file amp 1 with TYPE NEWER The current file is newer than the file in the Archive and will be skipped AQZ0261 00 File 6 amp 1 tested OK Explanation Informational PKUNZIP with TYPE TEST tested file amp 1 and found NO problems AQZ0262 20 Warning 6 amp 1 already exists Reply Y N A R y n or fr Explanation Y Overwrite this file with the file extracted from the archive N The file will not be extracted from the archive A All files in the archive will be extracted and will over write any existing files of the same name R you will be prompted for a new file name The default is N If you wish to change this default then use the CHGMSGD command AQZ0263 00 Enter in the new File Name for 6 amp 1 Explanation PKUNZIP issued message AQZ026
137. caecuececaeeaececeeseeaesaecueseeaeeaeeaeeneaees V CONTENTS E aa i a Vi CHAPTER 1 AN INTRODUCTION TO PKZIP OS 400 ooo ccececceccecceceeceececeeceeceeeeeees 1 DATA GOMPRESSION ses ceecre eerste a e tare 1 ZIPSARGHIVES ce a ee hl ah re ant a oe e a oe de ane adam ny TNT 1 CYCLIC REDUNDANCY CHECK 2 0ccecceccececeeceececeeceecuecueaeeaecuecueaeeaeeueceeaesaecaecuesesauenecueeeeaes 2 DATA ENCRYPTION di A EEE 2 RES RE Yy SIZ CS seen aah nd Daath as ed ia ia ade 4 Could DES Cracker like hardware break an AES key ccnn 4 Monitoring Algorithm Security scccscces cose ewcececceden eter esceeserevereseresetceerexeteseresetcdenedeccdeteneet 4 What is the Life Expectancy of AES cccccccceeesseeeeeeeeeeeeeeeesseeeeeeeeeeeaeeessseeeeeeess 4 CROSS PLATFORM COMPATIBILITY cc cscecceccecceceeceececceececaecuecueaueaecuecueeeeaecaecueceeaesaecueeneaes 4 RELEASE SUMMARY cccecceceeceececceececeecuecueceeaecaecuecueseeuecuecueseeaeeaecueceeseeaesecueseeaeeeseeeneaees 5 New Features E E E tothe tec et dota ti 5 PKZIP FOR OS 400 RESTRICTIONS cccccceeceececcecceceeceeceeceeaeeaecueceeceeaecueceeseeaeseeeeeneaees 6 CHAPTER 2 GETTING STARTED WITH PKZIP FOR OS 400 Quo ce ceceecceceeceeceeeeeees 7 GENERAL FEATURES OF PKZIP FOR OS 400 ooo ioc eccecceececcecaeceececceseeeaeceeeeeceeaeeneeneeeeas 7 INVOKING PKZIP FOR OS 400 SERVICES cccccceccecceceeceececceeaecueceeceeaeeaeceeeeeseeaesaeeneeees 7 PKZIP FOR
138. cally to the new Archive after updating and the old Archive is deleted A new ZIP archive is created when an old ZIP archive is updated or when a TYPE ADD parameter see Chapter 9 PKZIP Commands is used with PKZIP for OS 400 where there is no old ZIP archive 26 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Chapter 8 Extended Attributes This chapter reviews the extended attributes that PKZIP for OS 400 builds when using the parameters EXTRAFLD YES or DBSERVICE YES These extended attributes can be viewed for a file by using PKUNZIP with parameters TYPE VIEW and VIEWOPT DETAIL for the archive Within the ZIP Archive are two directories that provide information about the files that are held within it A Local Directory included at the beginning of each file contains information such as the file size and the date the file was zipped The Central Directory located at the end of the ZIP Archive lists the complete contents of the ZIP Archive and is the primary source of information for UNZIP processing In each directory there can exist extended data or attributes for the compressed files When EXTRAFLD YES is specified a set of basic attributes are created for each file in the archive The type of attribute created depends on the type of file system QSYS Library File System or IFS in which the file being compressed exists The standard attributes for both systems are described below If the parameter DBSERVICE
139. cial Database functionality such as Triggers File Constraints Alternate Collating Sequence and Logical files are not stored in an archive To maintain this functionality use the SAVF method see Use of SAVF Method 6 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Chapter 2 Getting Started with PKZIP for OS 400 PKZIP for OS 400 is a broad flexible product on the iSeries and AS 400 platforms allowing for compression and decompression of files It is fully compliant with other PKZIP9 4 x compatible compres sion products running on other operating systems Because the PKZIP standard for text data storage is ASCII PKZIP for OS 400 facilitates conversion between the ASCII and EBCDIC character sets Therefore compressed text files can be transferred between IBM mainframe environments and systems using the ASCII character sets including UNIX DOS PKZIP for OS 400 PKZIP for MVS and PKZIP for VSE In addition to PKZIP format archive support PKZIP for OS 400 can also produce and manipulate GNU GZIP format archives Additional information on this subject can be found in Chapter 11 Processing with GZIP General Features of PKZIP for OS 400 PKZIP for OS 400 is generally compatible with PKZIP 2 x and as such has the following features e Compliance with compression programs on other platforms including Windows LINUX UNIX DOS PKZIP for OS 400 PKZIP for MVS and PKZIP for VSE e
140. contents of key fields in records For example a bank name and address file might be in order and keyed by the account number Keyword 1 A mnemonic abbreviation that identifies a parameter in a command 2 A user defined word used as one of the search values to identify a document during a search operation 3 In COBOL a reserved word that is required by the syntax of a COBOL statement or entry 4 In DDS a name that identifies a function 5 In REXX a symbol reserved for use by the language processor in a certain context Keywords include the names of the instructions and ELSE END OTHERWISE THEN and WHEN 6 In query management one of the predefined words associated with a query command 7 A name that identifies a parameter used in an SQL statement See also parameter Label lt 1 The name of a file on a diskette or tape 2 An identifier within a command or program statement generally used for branching 3 In Interactive Source Debugger a place in a source program that the user can choose to display again 4 In REXX a clause that consists of a single symbol followed by a colon 5 In RPG a symbolic name that represents a specific location in a program A label can serve as the destination point for one or more branching operations 6 In DB2 UDB for iSeries SQL a way of attaching text to columns tables and packages 170 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 7 In Backup Recovery
141. cters in the ASCII character set are standard on all systems Others may be different for a given language set It may be necessary to create a different translation tables see Translation Table to create standard translation between ASCII and other character sets American National Standards Institute ANSI An organization sponsored by the Computer and Business Equipment Manufacturers Association for establishing voluntary industry standards ANSI See American National Standards Institute APAR See Authorized Program Analysis Report below API See Application Programming Interface shown on page 166 Glossary 165 Application Programming Interface An interface between the operating system or systems related program that allows an application program written in a high level language to use specific data or services of the operating system or the program The API also allows the user to develop an application program written in a high level language to access PKZIP data and or functions of the PKZIP system Application System 400 iSeries One of a family of general purpose systems with a single operating system Operating System 400 that provides application portability across all models Archive 1 The act of transferring files from the computer into a long term storage medium Archived files are often compressed to save space 2 An individual file or group of files which must be extracted and decompressed in order to
142. d from host computers FTP requires a user ID and possibly a password to allow access to files on a remote host system FTP assumes that the Transmission Control Protocol is the underlying protocol FTP See File Transfer Protocol shown above GMT See Greenwich mean time shown below or Universal Time Coordinated UTC Greenwich mean time GMT A synonym for Universal Time Coordinated UTC which is the mean solar time of the meridian of Greenwich England and is the prime basis of standard time throughout the world GZIP GZIP also known as GNU zip is a compression utility designed to utilize a different standard for handling compressed file data in an Archive Its main advantages over other compression utilities are much better compression and freedom from patented algorithms It has been adopted by the GNU project and is now relatively popular on the Internet Additional information can be found at http www qzip org Host The controlling or highest level system in a data communications configuration for example an iSeries system is the host system for the work stations connected to it 1 0 See Input Output shown below Input Output 1 0 Data provided to the computer or data resulting from computer processing Installation Verification Procedure IVP A sample application script or jobstream provided to verify successful installation of a product may be either software or hardware Integrated File System A functio
143. data area gt CHGDTAARA DTAARA MYlibrary PKZDTA5 VALUE PKZ55x430 V5 5xxxV4R3M0 Next we need to copy the two commands to the MYlibrary Library 4 gt CRTDUPOBJ OBJ PKZIP FROMLIB PKZ55x430 OBJTYPE CMD TOLIB MYlibrary 5 gt CRTDUPOBJ OBJ PKUNZIP FROMLIB PKZ55x430 OBJTYPE CMD TOLIB MYlibrary At this point PKZIP will work for all users that have the library MYlibrary in their library list Note When installing another PKZIP for OS 400 Version the same process should be run to pick up the latest settings of the data area and commands Next ensure the PKZIP for OS 400 library is NOT in your library list and run a few sample test for PKZIP and PKUNZIP to make sure the product works 160 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Appendix SPOOL Files Considerations This appendix contains information on how PKZIP for OS 400 handles spool files in different scenarios that might be helpful consideration in planning of compressing spool files Spool File Selections Care should be taken when selecting spool files to not set all of the spool file selection parameters to ALL as this will select all spool files on your iSeries This is why the default for the user id is SFUSER CURRENT to at least limit it to the current user in case a selection is not filled in correctly If a spool file is deleted after the selection but before the actual compression takes place the PKZIP job will fail S
144. default setting ALL indicates that spool file number is not important LAST The spooled file with the highest number is used Spool File Number A number 1 9999 to specify the number of the spooled file whose data records are to be selected STOREPATH STOREPATH NO YES Specifies whether to store the full path and file name in the archive or to just save the file name If the file is an IFS file type the path is all directories from the current directory to the directory of the file In the Library System the path is the Library and the File name The Member name is considered to be the archive name The allowable values are YES Store all paths and the filename in the PKZIP archive NO Store only the filename in the PKZIP archive TMPPATH TMPPATH CURRENT pathname Specifies a directory or Library File in which to build the temporary archive file While PKZIP is compressing data into an archive a temporary archive file name is used The temporary file name is a 10 character name with a prefix of PZ followed by a time stamp PZtttttttt If this option is CURRENT the temporary file is built in the same directory for Library file systems it is same Library File with temp member in which the new archive will be stored and is then renamed at the end of the run to the archive name If an override path is specified the temporary archive file is built into that specified path and the file is then copied to its fina
145. demark of PKWARE R Inc Archive QOPT MYTESTLABEL PKZ55 1 ZIP 1373026 bytes 1 file Length Method Size Ratio Date Time CRC 32 Name 6044544 Defl N 1372902 77 08 16 01 21 17 d73f09cf PKZ55430 sav 6044544 1372902 77 1 file PKUNZIP extracted 0 files PKUNZIP Completed Successfully Example 5 Compressing files from a CD QOPT Using the document DOC files on the CD shown in Example 4 we can compress the files and store them in the archive in my archive library ATEST under the file V509 archives with an archive file member named CDTEST01 PKZIP ARCHIVE atest v509 cdtest01 FILES QOPT MYTESTLABEL OS_400 3 DOC QOPT MYTESTLABEL PKZCVT 2 DOC TYPFL2ZP IFS PKZIP for OS 400 TM Compression Utility Version 5 5 2002 08 22 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Scanning files for match Found 2 matching files Compressing QOPT MYTESTLABEL OS 400 3 DOC in BINARY mode Add QOPT MYTESTLABEL OS 400 3 DOC Deflating 77 Compressing QOPT MYTESTLABEL PKZCVT 2 DOC in BINARY mode Add QOPT MYTESTLABEL PKZCVT 2 DOC Deflating 795 PKZIP Compressed 2 files in Archive ATEST V509 CDTESTO1 PKZIP Completed Successfully Because you would not be able to extract them to the CD you may want to use the parameter STOREPATH NO so that only file names OS_400 3 DOC and PKZCVT 2 DOC are stored in the archive Example 6 Compressing CL with MSG
146. directory is being removed from the archive file AQZ0134 00 Zip Info amp 1 amp 2 Explanation Informational PKZIP about archive files when processing with enhanced debug turned on AQZ0135 10 Zero length name for entry amp 1 Explanation An error occurred reading the archive file for entry 81 The name of the file has a zero length If processing continues unpredictable results may occur The source of the archive file and its history of reaching it current state should be reviewed Other files in the archive should be valid AQZ0136 00 Bad extended local header for Explanation An archive file indicated it contained an extended local header The header is cor rupted Processing will be terminated Run PKUNZIP with TYPE View and VIEWOPT Detail to see if more information is available AQZ0137 10 Extended local header not found for amp 1 Explanation An archive indicated it contained an extended local header for file amp 1 The extended header could not be found nor processed Run PKUNZIP with TYPE View and VIEWOPT Detail to see if more information is available AQZ0138 00 Missing end signature probably not a archive file did you remember to use binary mode when you transferred it Explanation 78 The archive file did not have an end signature which usually indicates it is not an archive file or it is an incomplete archive file PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0139 00
147. e the directory and sub directory names and the file name For example QOPT VOLUMENAME DIRECTORYNAME SUBDIRECTORYNAME FILENAME The file system name QOPT is required The volume name is required and can be up to 32 characters long You can include one or more directories or sub directories in the path name but QOPT requires none The total number of characters in all directory names and sub directory names including the leading slash cannot exceed 256 characters Directory and file names allow any character except X 00 through X 3F X FF lowercase alphabetic characters and the following characters Asterisk Hyphen Question mark Quotation mark 20 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 e Greater than gt e Less than lt 6 The file name is the last element in the path name The file name length is limited by the directory name length in the path The directory names and file name combined cannot exceed 256 characters including the leading slash For more details on path name rules in the QOPT file system see the Path Name Rules discussion in the publication Optical Support Using QSYS LIB Through the Integrated File System Interface Even though PKZIP for OS 400 accesses the QSYS Library file system directly there is an ability to access the QSYS LIB file system through the integrated file system interface In using the integrated file system interface you should be aware of
148. e Job log to see if any messages pertain to the file The file being used may cause this The job will be terminated and the archive will be corrupted AQZ0516 40 Could not allocate Memory for Terse extraction PKUNZIP is ending immediately Explanation PKZIP was compressing the file with compression type TERSE but could not allocate memory for the TERSE buffers Check other messages in Job Log for possible causes and refer to Appendix C about memory errors If this continues please contact the Product Services Division at 1 937 847 2687 for assistance 104 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0517 40 Terse Extraction Failure Work buffers are too small Explanation PKUNZIP could not complete an extraction of a file compressed in TERSE mode because the buffers were two small This should not occur for an archive created with this release Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0518 00 Explanation Warning File amp 1 has associated triggers PKZIP has detected that the database file being zipped has trigger programs associ ated with it PKZIP does not store trigger program information in the archive See Chapter 8 Storing Database File Extended Attributes for more information This message only appears when compressing database files If you want to preserve the trigger information first save the file and trigger programs to a SAVF and then add the
149. e Memory The attributes will be ignored AQZ0491 40 Error More than amp 1 simultaneous threads Some threads are probably not calling DESTROYTHREAD Explanation Internal Error This should not occur Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0492 40 Error Could not find global pointer in table Maybe somebody accidentally called DESTROYTHREAD twice Explanation Internal Error This should not occur Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0493 40 Error Global pointer in table does not match pointer passed as parameter Explanation Internal Error This should not occur Please contact the Product Services Division at 1 937 847 2687 for assistance Chapter 12 Messages 101 AQZ0494 00 Warning Cannot set UID amp 1 and or GID d for amp 2 Explanation After extracting a file successfully PKUNZIP could change the UID attributes for a file in the Integrated File System to UID in the archive settings See Job Log for more Information AQZ0495 00 Warning Cannot set modification access times for amp 1 Explanation After extracting a file successfully PKUNZIP could change the modification time and the access time for a file in the Integrated File System to the time that is stored within the archives Times are left as the time extracted See Job Log for more Information AQZ0496 00 Warning Cannot set permiss
150. e a file name of INVOICE21 TXT In cases where a very specific name is desired for the file in archive name SFTGFILE can be code with the name This is designed for selecting only one file at a time otherwise file names will be duplicated When Extracting a spool file with PKUNZIP the attributes from the when it was compressed will be preserved except for new spool file numbers will be generated There is anew parameter SPLUSRID for the user ID on the new extracted spool file If it is DFT the original user ID will stay with the new spool file Note on extracting Spool Files To create or extract spool file with PKUNZIP the user must have USE authority to the AP QSPCRTSP The normal setting for the API QSPCRTSP is Authority PUBLIC EXCLUDE The API authority is set this way so that system administrators can control the use of this API This API has security implications because you can create spooled file from the data of another spooled file To allow user to extract spool files change the API authority on a need basis 24 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Chapter 7 ZIP Archives A ZIP Archive is the storage facility for files that are compressed or simply stored using the PKZIP product It can hold up to 65 535 files which may have been compressed by up to 99 of their original size Data integrity is validated by a Cyclic Redundancy Check CRC to maintain integrity of the data from compression through th
151. e blank Correct and re run AQZ0292 40 Error Occurred while transforming the spool file Job is aborted Explanation A major error has occurred while transforming a spool file to an ASCII file Job is being aborted with exception code amp 1 amp 2 Try re running the job If this failure continues please contact the Product Services Division at 1 937 847 2687 for assistance Chapter 12 Messages 91 AQZ0293 40 Parameter SFTARGET SPLF requires SFTGFILE GEN1 Correct and re run Explanation SFTGFILE must be coded as GEN1 when requesting a target type of Spool File SFTARGET SPLF Correct and re run AQZ0294 40 Spoof File amp 1 is amp 2 type print file and Convert Format is TEXT File bypassed Explanation Only Spool File Types SCS IPDS and AFP are valid for Text conversion amp 2 type cannot convert to TEXT format AQZ0295 10 Spool File amp 1 is being skipped due to being in OPEN Status Explanation Spool Files that are in an Open Status are not eligible for selection File will be skipped AQZ0296 10 Spool File amp 1 Exceeds Maximum allowed size Explanation The Spool File amp 1 Exceeded the maximum allowed of amp 2 File will be either skipped or job will end based on ERROPT settings AQZ0297 40 The Output Queue for Spool Files selection cannot be found Explanation The output queue specified in parameter SFQUEUE is invalid or cannot be found in the libraries specified
152. e extraction process In addition to the data file attributes are retained allowing extraction of the same file characteristics without the need of control card specifications An Archive can exist in three possible states during processing described as Old Archive Temporary Dataset and New Archive An explanation of the functions of each of these is described in the sections below A ZIP Archive is transferable between platforms such as files that are compressed by PKZIP9 in one platform may be extracted by PKZIP on a different platform maintaining identical data This chapter describes the types of files used by PKZIP for OS 400 and provides a description of the way in which they are accessed by PKZIP for OS 400 ZIP archives PKZIP for OS 400 by default creates new archives as members of PF DTA files with 132 byte records The archive file is given a text field of File created by PKZIP for OS 400 The archive member is given a text field of Member created by PKZIP for OS 400 If you wish to create your own archive perhaps to have a larger record size for performance then you can do so but try to adhere to the following e When you create the file do not create any members in it e After having created the file change the MAXMBRS parameter for the file from 1 to NOMAX A ZIP archive holds files internally in one of several formats which are compatible with other platforms supported by P
153. e in the archive displays non MSDOS external file attributes Information with TYPE VIEW and VIEWOPT DETAIL AQZ0871 00 MS DOS file attributes amp 1 hex 4 amp 2 Explanation If present for a file in the archive displays MS DOS file attributes Information with TYPE VIEW and VIEWOPT DETAIL AQZ0872 00 Advanced Encryption amp 1 amp 2 Explanation Displays the Advanced Encryption method the file was archived Information with TYPE VIEW and VIEWOPT DETAIL AQZ0873 00 Algorithm Key amp 1 Security type amp 2 Explanation Displays the Advanced Encryption algorithm key text description and the Security type 118 Password Certificate Signature or Combination Password with Signature that was used to encrypt the file Information with TYPE VIEW and VIEWOPT DETAIL PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0874 00 Spool File Type 6 amp 1 Target File amp 2 CdPg amp 3 Nbr Of pages amp 4 Explanation Displays the Spool File type the Target Format File Type and the number of pages in the Spool File If the target is Text or PDF then CdPg amp 3 will be displayed to show the code page that was used to translate the EBCDIC to ASCII AQZ0875 00 SPLF Desc l Explanation Displays the spool file name attributes with separation with format Job Name User Name Job Number Spool File Name F spool File Number Suffix Chapter 12 Messages 119 AQZ9xxx LICENSE Messages AQZ90
154. e installation or upgrade of new processors will affect the environment To accommodate the customer PKZIP for OS 400 has a process that will allow a customer to continue using the product for a period of 5 days Dur ing this time error messages will be displayed on the console as well as the printout for each execution of PKZIP for OS 400 At the end of the grace period if the license keys are not updated the product will no longer function in any environment other than to VIEW an archive This 5 day grace period is designed in such a way that it will not cease to function on a weekend or the Monday following the 5 day grace period During this process you must contact PKWARE Inc at 1 937 847 2687 to obtain licensing to allow use beyond the conditional period 138 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Appendix B Examples Example 1 PKUNZIP Files to a New or Different Library To extract the files in the archive to new library An example of the files in the archives are PKUNZIP ARCHIVE atest qz tstchg Archive ATEST QZ TSTCHG 88572 bytes 6 files Length Method Size Ratio Date Time CRC 32 Name 259 Defl F 178 01 16 01 08 24 b5dbf80c TESTLIB1 BEN BEESON 449664 Defl F 48720 01 16 01 14 46 94c7506c TESTLIB1 MYSPLFTM P AQZ1P123 4X 205693 Defl F 29687 01 16 01 14 46 e2473ea4 TESTLIB1 MYSPLFTM P LISTDBOB X 27488 Defl F 6771 01 16 01 14 46 c264817a TESTLIB1 MYSPLFTM P QPRINT1X 3352 Defl F 800 01 16 01 14 4
155. e memory Job is terminated Check other messages in Job Log for possible causes and refer to Appendix C about memory errors If this continues please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0606 40 GZIP Archive File amp 1 probably corrupt Explanation PKUNZIP was trying to extract from archive file amp 1 and it was identified as a GZIP archive ltwas determined that it could be corrupt based on the setting in the header or trailer AQZ0607 40 Cannot Use compress STORE or TERSE with GZIP Explanation GZIP parameter YES cannot be used when COMPRESS parameter is set to STORE or TERSE AQZ0608 40 GZIP YES cannot be used with FTRAN table Explanation FTRAN table override cannot be used with option GZIP YES due to compliant issues AQZ0609 00 Warning GZIP Archive has non compliant Flag settings Explanation The archive being processed has reserve bits in the Flag byte set This may indicate the presence of new fields or options in the archive that prevent the file being extracted from being extracted correctly Chapter 12 Messages 107 AQZ0610 40 GZIP Archive amp 1 contains no filename and Default Path was not specified Explanation The GZIP Archive that is being extracted does not contain a file name To get a file name use EXDIR keyword and enter a path and filename If IFS use path filename For Library file system use library filename AQZ0611 40 TEXTED
156. e number members e Expanded the field sizes of the ARCHIVE and FILES parameters to 140 characters in PKZIP and PKUNZIP commands to allow more folders in the path of IFS files Added keyword MBR to parameter EXDIR in command PKUNZIP If EXDIR is coded with keyword MBR and the file system is the QSYS Library system PKUNZIP will use the member name for the file name For example e EXDIR newlib MBR and DROPPATH ALL parameters are coded and the file name in archive is mylib myfile mymbr the file will be extract to the file newlib mymbr mymbr This only valid for TYPFL2ZP DB files e Support Of Spool Files along with text document conversion e New parameter DELIM was added to PKZIP to provide the ability to define the end of record characters at the end of a Text record such as CRLF etc e New Install process from CD using LODRUN command PKZIP for OS 400 Restrictions Due to various iSeries processing characteristics the following restrictions should be carefully reviewed to determine the best way to proceed when using PKZIP for OS 400 e PKZIP for OS 400 in the QSYS file system will only work with objects that have an object type of FILE and an attribute of PF DTA PF SRC and SAVF To process other objects such as PGM CMD etc use the SAVF method see Use of SAVF Method e PKZIP for OS 400 in the Integrated File System IFS will only work with stream files STRM and directories DIR e Spe
157. e parameter options or modifiers Related Publications The PKZIP family of products includes the following manuals e PKZIP for MVS User s Guide iv PKZIP OS 400 5 5 User s Guide PKOU V5R5000 e PKZIP for MVS 8 PKZIP VSE Messages and Codes e PKZIP for VSE User s Guide e PKZIP for Command Line UNIX User s Guide e PKZIP for Command Line Windows User s Guide Related IBM Publications IBM Manuals relating to the PKZIP for OS 400 product include e System Messages This manual documents messages issued by the OS 400 operating system The descriptions explain why the component issued the message provide the actions of the operating system and suggest responses by the applications programmer system programmer and or operator e 0S 400 CL Programming SC41 5721 This manual provides a wide range discussion of iSeries e Advanced Series programming topics including Control language programming Series e Advanced Series programming concepts Objects and libraries and Message handling e OS 400 CL Reference SC41 5722 thru SC41 5726 This manual may be used in the iSeries Information Center to find information on the following CL Reference topics OS 400 commands OS 400 objects Command description format Command parts Command syntax About syntax diagrams CL character sets and values Object naming rules Expressions in CL commands and Command definition statements e Integrated File System I
158. each table set representing the 256 translation values The tables have imbedded comments to help in their documentation In the table example below to translate an ASCII character A hexadecimal x 41 or decimal value of 65 go to entry 65 in the table Line 8 entry 2 and find a hexadecimal x C1 which is the EBCDIC A See the Example of PKZTABLES USASCIlI Translation Table Note Do not alter any other members found in the PKZTABLES file or PKZIP for OS 400 may not func tion correctly Creating new Translation Table Members The following steps should be taken if you wish to define your own translation table 1 Copy one of the distributed members in PKZTABLES to a member name of your choice 2 Edit the new table using the OS 400 Source Entry Utility SEU 3 Change the values with respect to the layout describe above making sure not to alter the overall table layout If the overall layout is altered PKZIP for OS 400 may not work correctly 4 Save the member and test your changes 154 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Example of PKZTABLES USASCII Translation Table PKZIP 400 Translate Table USASCII to EBCDIC 00 07 0x00 0x01 0x02 0x03 0x37 0x2D 0x2E 0x2F 00 07 08 0 0x16 0x05 0x25 Ox0B 0x0C D Ox0E 0x9F 08 0 10 17 0x10 0x11 0x12 0x13 0xB6 0x32 0x26 10 17 18 1f 0x18 0x19 0x3F 0x27 0x1C 0x1E 0x1F 18 1f 20 27 0x40 0x5A 0x7F 0x7B 0x5B 0x50 0
159. eady exist in an archive file If the date time of the file is newer than the date time of the file in the archive the file will be compressed and replace the one in the archive VIEW The VIEW option provides information about all files or selected files contained in an archive This option is performed using PKUNZIP The sequence see VIEWSORT and type of list VIEWOPT determines what information is displayed MOVEA The MOVEA Move and Add option option performs the ADD option and upon completion of a successful PKZIP command the actual file will be deleted MOVEF The MOVEF Move and Freshen option option performs the FRESHEN option and upon completion of a successful PKZIP command the actual file will be deleted MOVEU The MOVEU Move and Update option option performs the UPDATE option and upon completion of a successful PKZIP command the actual file will be deleted DELETE The DELETE option removes entries from the archive file based upon the selection of FILES and EXCLUDE parameters The format of the FILES and EXCLUDE parameters should be in the format of the files as seen in the archive ADVCRYPT ADVCRYPT ZIPSTD ASE128 AES192 AES256 When a ZIP action is requested to save a file in an Archive and a password is provided PKZIP for 0S400 will use an encryption method to protect the data This command value specifies which algorithm to be employed 36 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 P
160. elds Information with TYPE VIEW VIEWOPT AQZ0856 00 Explanation Displays heading separator for the Field Description details Information with TYPE VIEW and VIEWOPT DETAIL AQZ0857 00 amp 1 amp 2 amp 3 amp 4 amp 5 amp 6 amp 7 amp 8 amp 9 amp 10 Explanation This field has the following attributes Num Field Number amp 1 Name Internal Field name amp 2 Width Field width amp 3 General amp 4 U Usage 85 D Field Data type 8 amp 6 N Null capable 87 V Variable length field 88 K _ Key Field 89 CCSID CCSID of field 810 Information with TYPE VIEW and VIEWOPT DETAIL AQZ0858 00 Text 6 amp 1 Explanation Displays the Fields text description for this field is amp 1 Information with TYPE VIEW and VIEWOPT DETAIL AQZ0859 00 Alias l Explanation Displays the alternative field name alias for this field amp 1 Information with 116 TYPE VIEW and VIEWOPT DETAIL PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0860 00 Default l Explanation Displays the default value for the field is amp 1 Information with TYPE VIEW and VIEWOPT DETAIL AQZ0861 00 Col Heading 1 4 amp 1 Explanation Displays the First column heading for the field is amp 1 Information with TYPE VIEW and VIEWOPT DETAIL AQZ0862 00 Col Heading 2 4 amp 1 Explanation Displays the Second column heading for the field is amp 1 Information with TYPE VIEW
161. em The QSYS file system supports the Series library structure This file system provides access to database files and all other iSeries object types that library manages On the IBM iSeries system each QSYS type file also called a file object has a description that details the file characteristics and how the data associ ated with the file is organized into records and in many cases the fields associated for each record Whenever a file is processed the OS 400 uses this description Of the objects in the library system PKZIP for OS 400 will only process physical files that have an attrib ute type of PF DTA physical data files PF SRC physical source file or SAVF save files QSYS files always exist in a library and the PF DTA and PF SRC files if data exist will always have one to many members in the file Therefore PF DTA and PF SRC files have a name format of library file member A SAVF a special type of iSeries file for saving and restoring iSeries objects does not have any members giving a file format of library file Because SAVF types are handled in a special way they are given additional consideration see SAVF and Use of SAVF Method QSYS Summary If the archive file is to be in the QSYS file system set parameter TYPARCHFL DB If the file being compressed or extracted is in the QSYS file system set parameter TYPFL2ZP DB If the list files see Appendix E List Files and their Usage are to
162. ently AES has three key sizes They are 128 192 and 256 bits Key sizes are depicted in the following decimal terms e 3 4 x 10 possible 128 bit keys e 6 2 x107 possible 192 bit keys and e 1 1 x 10 possible 256 bit keys In comparison DES keys are only 56 bits which means there are approximately 7 2 x 10 possible DES keys Therefore there they are on the order of 10 times more AES 128 bit keys than DES 56 bit keys Could DES Cracker like hardware break an AES key Specialized DES Cracker machines were built in the late 1990 s that could recover a DES key after only a few hours By trying possible key values the hardware could determine which key was used to encrypt a message To illustrate the higher level of security that AES provides versus DES if a machine that could recover a DES key in a second such as try 2 keys per second then it would take that machine approximately 149 thousand billion 149 trillion years to crack a 128 bit AES key A further perspective is that the universe is believed to be less than 20 billion years old thus making the case that cracking a 128 bit AES key is nearly impossible with today s technology Monitoring Algorithm Security The National Institute of Standards and Technology NIST continues to follow developments in the cryptanalysis of Rijndael The AES is formally reevaluated every five years Plans for maintenance activities for the standard will be developed in the
163. er case the central directory and archive file comment will be found on the last disk s of this archive AQZ0484 00 Caution Archive file amp 1 comment will be truncated Explanation While displaying the Archive file comment it was truncated due to excess length This affects only the displayed information not the data itself AQZ0485 30 Error Cannot delete old amp 1 Explanation Cannot Delete File amp 1 on IFS system file type See Job Message Log for more information AQZ0486 30 Error PKZIP cannot open Archive File amp 1 Explanation Archive File amp 1 cannot be opened for reading in PKZIP See Job Message log for more information 100 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0487 30 Error Cannot create 6 amp 1 Explanation PKUNZIP was trying to create file 81 for extraction but the create process failed The file was not extracted See Message Log for create failure AQZ0488 40 Error Archive file amp 1 read error Explanation PKUNZIP received a file error while reading Archive file amp 1 Job is terminated See Message log for Error Reason AQZ0489 10 Warning Filename too long truncating Explanation The file name length including path found in the archive exceeds the length of 255 bytes allowed in PKUNZIP File name is truncated AQZ0490 10 Warning Extra field too long amp 1 Ignoring Explanation The extended attribute is too long for PKUNZIP to allocat
164. erminated AQZ0147 00 will just copy entry over amp 1 Explanation PKZIP will copy the archive over the current archive file amp 1 Chapter 12 Messages 79 AQZ0148 40 Archive file empty Explanation PKZIP process ended with no files in the archive file Review selection process and preceding messages The Archive is not valid and cannot be used to extract files AQZ0149 10 File is being skipped due to previous error Explanation An error occurred processing file amp 1 and the parameter ERROPT was set to SKIP the file AQZ0150 40 Archive File lt amp 1 gt is not found or empty without ADD TYPE Explanation PKZIP process is running without TYPE ADD cannot find the specified archive file or the Archive file is empty For Actions other than ADD a valid existing archive must exist AQZ0151 00 lt amp 1 gt include pattern or file could not find a match in search path Explanation The Include pattern in the FILES or INCLFILE could not find a match during the PKZIP run Review selection parameters the library list or the current directory AQZ0152 20 Cannot have duplicate names in Zip Include Explanation PKZIP found entries in the FILES or INCLFILE that results in duplicate entries Correct and rerun AQZ0153 00 Duplicates l1st lt 41 gt 2nd lt 42 gt Explanation Part 2 of message AQZ0152 showing the duplicate files AQZ0154 20 Cannot read Archive file lt amp 1 gt f
165. erver Control Language CL Program A program that is created from source statements consisting entirely of control language commands CRC See Cyclic Redundancy Check Cryptography 1 A method of protecting data Cryptographic services include data encryption and message authentication 2 In cryptographic software the transformation of data to conceal its meaning secret code 3 The transformation of data to conceal its information content to prevent its undetected modification or to prevent its unauthorized use Current Library The library that is specified to be the first user library searched for objects requested by a user The name for the current library can be specified on the Sign On display or in a user profile When you specify an object name such as the name of a file or program on a command but do not specify a library name the system searches the libraries in the system part of the library list then searches the current library before searching the user part of the library list The current library is also the library that the system uses when you create a new object if you do not specify a library name Customer Information Control System CICS An IBM licensed program that enables transactions entered at remote workstations to be processed concurrently by user written application programs The licensed program includes functions for building using and maintaining databases and for communicating with CICS p
166. eter Program Variables ae Input Name that is used examine for change INNAME DCL VAR amp INNAME TYPE CHAR LEN 256 Changed name that is passed back to PKZIP for OS 400 OUTNAME DCL VAR amp OUTNAME TYPE CHAR LEN 256 Flags from PKZIP for OS 400 for controlling logic flow CVTFLAGS DCL VAR amp CVTFLAGS TYPE CHAR LEN 5 JE data from PKZIP command for controlling logic flow CVTDATA DCL VAR amp CVTDATA TYPE CHAR LEN 256 148 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 E Y RES i i i i TE RO RE RAR RR RRE RRA RRE RARO RAR ROA i RAR RR Program Variables ES OS 400 QSYS file name represented like libnm filenm mbrnm LIBNM DCL VAR LIBNM TYPE CHAR LEN 10 Library Name FILENM DC VAR 8FILENM 1 HAR EN 10 File name MBRNM DC VAR amp MBRNI 10 Member name DC VAR 8 IDX DC VAR amp IDXPRV DC VAR amp LEN DCL VAR amp MSGVAR 7 DCL VAR amp MUVAR pl blank out name uncase no hit CHGVAR VAR amp OUTNAME VA Zz VA Nh AAA Zz R R R R kK kK kkk K K K K K K K K K K K K K K K K K K K K K K K K KK Flag set to 400 IF COND amp CVTFLAGS EQ 400 THEN DO CHGVAR VAR amp OUTNAME VALUE amp INNAME GOTO CMDLBL ENDCHG ENDDO RTRTR NR SRA RR RRA RS RARO RA E E RRE i IRTE RO i RT RT RR Flag set to O4MS Change iSeries
167. etermined that the path of file to extract exceeded 255 bytes File will use default path Chapter 12 Messages 103 AQZ0511 40 Failure to create file lt 41 gt in Library lt amp 2 gt Explanation PKUNZIP was issuing a CRTPF command for a file that was using default settings before extracting and an error occur in the CRTPF command See Job Log for more information about failure Files are not extracted AQZ0512 40 Failure to create SAVF lt 41 gt in Library lt amp 2 gt Explanation PKUNZIP was issuing a CRTSAVF command to create file amp 1 for extracting and the create process failed See Job Log for more information about failure Files are not extracted AQZ0513 10 Warning Line amp 1 has been truncated Explanation When writing a text file the length of the line exceeded the record length of the output file and the line was truncated Use an output file with the correct record length AQZ0514 30 Failure in creating Library amp 1 for Archive Explanation PKUNZIP was trying to extract a file to library 81 and the library did not exist and PKUNZIP failed when trying to create the Library For more information see Job Log This may be a security issue File is not extracted AQZ0515 40 PKZIP Failure in file read request Request bytes amp 1 Explanation While trying to read a selected file for compression PKZIP experienced an error where the size of the data read failed the request View th
168. eview message amp 1 for more information AQZ0415 00 API error amp 1 Change Object descriptions lt amp 2 gt Explanation While issuing a change to the object amp 2 error amp 1 occurred Review message 81 for more information AQZ0416 00 API error amp 1 Process Command lt amp 2 gt Explanation While trying to process command amp 2 error amp 1 occurred Review message amp 1 for more information This may occur if the user does not have the proper authority for the command AQZ0417 40 Error writing List file al Explanation Keyword CRTLIST was specified and an error occurred while writing to file amp 1 Review all job log messages for more details Job will be terminated AQZ0418 40 Error opening or closing list file amp 1 Explanation Keyword CRTLIST was specified and an error occurred while 82 was opening or closing file 81 Review all job log messages for more details Job will be terminated AQZ0419 40 Cannot open file lt amp 1 gt for Include selection Explanation File 81 specified in keyword INCLFILE cannot be opened See job log messages for more information Verify that file amp 1 is a valid file for input to include selection Job is terminated AQZ0420 40 Cannot open file lt amp 1 gt for Exclude filtering Explanation File amp 1 specified in keyword EXCLFILE cannot be opened See job log messages for more information Verify that file amp 1 is a valid file for input
169. example the Spanish language can be represented by a single byte coded character set See also the Double Byte Character Set DBCS Source File A file of programming code that has not yet been compiled into machine language A source file can be created by the specification of FILETYPE SRC on the Create command A source file can contain source statements for such items as high level language programs and data description specifications Source files maintained on a PC typically use a TXT as the extension On a mainframe source files are typically found in a partitioned data set or are maintained within a library management tool Spanned Record A logical record that stored across more than one block This is commonly used to get around a system limitation that a block cannot be larger than 32 760 bytes With spanned records one record spans two or more blocks Spool File Files that exist in an Output Queue which contain reports to printed on the AS 400 system Theses files along with attributes can then be directed and transformed to a printer attached to your system 174 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Stream File A data file that contains continuous streams of bits such as PC files documents and other data stored in Series folders Stream files are well suited for storing strings of data such as the text of a document images audio and video The content and format of stream files are managed by the applica
170. file according to the FILETYPE used PKZIP for OS 400 iSeries uses translation tables that should be suitable for most customers but some users may wish to alter the tables The procedure for changing the translation tables is discussed If text files are only used on iSeries then the FILETYPE EBCDIC may be used This uses iSeries files as is for the file which are faster for text files but does not translate the data to ASCII This will provide a small improvement in performance Additionally PKZIP for OS 400 will translate each character in a text file from EBCDIC character format to ASCII character format by default This is done using one of the two internal translation tables which are named UKASCII and USASCII It is recognized that these translation tables may not suffice for all countries or all situations especially on those sites where text files are received from several different countries for Chapter 5 Zip Files 15 processing into a single format The source of the translation tables used by the PKZIP and PKUNZIP programs has been supplied together with instructions for modifying the tables to create additional files see the Translation Tables section of this chapter for more details This enables sites to modify the translation table as required In a case where FILETYPE is neither TEXT nor BINARY DETECT is the default mode PKZIP for OS 400 will read up to 64K of data from the input file and scan it f
171. file comments stored on a separate line after its details VIEWSORT VIEWSORT ASIS DATE DATER NAME NAMER PERCENT PERCENTR SIZE SIZER Specifies the sequence of the viewing display The allowable values are ASIS Lists files in a sequence in which they are stored in the archive such as as is DATE Lists files in an ascending order of the file s date amp time as stored in the archive Chapter 9 PKZIP Commands 51 DATER Lists files in a descending order of the file s date amp time as stored in the archive NAME Lists files in an ascending order of the file name as stored in the archive NAMER Lists files in a descending order of the file name as stored in the archive PERCENT Lists files in an ascending order of the compression percentage as stored in the archive PERCENTR Lists files in a descending order of the compression percentage as stored in the archive SIZE Lists files in an ascending order of the uncompressed file size as stored in the archive SIZER Lists files in a descending order of the uncompressed file size as stored in the archive VPASSWORD VPASSWORD Archive Verify Password Specifies a verification password against the entered password since the PASSWORD is not visible This parameter is required for all encryption methods except ZIPSTD VPASSWORD follows all the rules of PASSWORD and must match exactly to the archive password entered in PASSWORD parameter or the run wil
172. files containing the file testit the relative path name to the file is Myfiles testit Notice that the path name does not include the name of the current directory The first item in the name is the directory or object at the next level below the current directory Stream Files A stream file is a randomly accessible sequence of bytes with no further structure imposed by the system The integrated file system provides support for storing and operating on information in the form of stream files Documents that are stored in iSeries folders are stream files Other examples of stream files are PC files and the files in UNIX systems An integrated file system stream file is a system object that has an ob ject type of STMF Other IFS Objects There are other object types such as link objects etc in IFS which at this time are not supported by PKZIP for OS 400 File Systems in the IFS There are currently ten 10 file systems that are part of the Integrated Files system Each file system is a major sub tree in the IFS directory structure A file system provides the support to access specific segments of storage that are organized as logical units These logical units on the iSeries are files directories libraries and objects 18 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Each of these file systems has a set of logical structures and rules for interacting with information in storage These structures and rules may be and
173. future with full consideration of all circumstances When an issue arises that requires immediate attention NIST will act expeditiously and consider all available alternatives What is the Life Expectancy of AES No one can be certain of how long the AES will remain secure However NIST s DES was the U S Government standard for almost twenty years before it was cracked by a massive parallel network computer attacks and special purpose DES cracking hardware The AES supports significantly larger key sizes than that of DES Barring any attacks against AES that are faster than key exhaustion and the advent of future advances in technology AES could remain secure well beyond twenty years Cross Platform Compatibility Cross platform compatibility provides PKZIP for OS 400 its ability to allow data to move between different computer operating environments PKZIP was intentionally designed for cross platform use Regardless of platform PKZIP for OS 400 archives are 100 cross platform compatible with all other ZIP utilities like PKZIP for MVS PKZIP for VSE PKZIP for UNIX PKZIP for LINUX PKZIP for DOS and PKZIP for Windows to name a few Because PKZIP for OS 400 automatically converts the data between EBCDIC and ASCII files prepared on the host are perfectly readable on any PC or UNIX system The internal format of a ZIP archive is identical no matter which platform compressed the files that the archive contains If
174. g to process anyway Explanation While extracting files from Archive file 81 with PKUNZIP it was found to have amp 2 bytes missing according to the directories PKUNZIP will continue attempting to extract the files and will complete the process AQZ0479 30 Error amp 1 NULL central directory offset attempting to process anyway Explanation While extracting from archive file 8 1 an error was found in the Central Directory offset PKUNZIP will try to compensate and continue the process Chapter 12 Messages 99 AQZ0480 30 Warning amp 1 Archive File is empty Explanation PKUNZIP found that archive file amp 1 is empty and that there is nothing to process AQZ0481 30 Error amp 1 Start of central directory not found Archive file is corrupt Explanation PKUNZIP could not find the start of the central directory in Archive file amp 1 Archive file is corrupt and the job will be terminated AQZ0482 30 Warning amp 1 Reported length of central directory IS amp 2 bytes too long Compensating Explanation PKUNZIP found that the length of the central directory of the archive is too long by amp 2 bytes PKUNZIP will try to compensate and continue AQZ0483 40 End of central directory signature not found in archive 6 amp 1 Explanation An End of central directory signature not found Either this file amp 1 is not an archive file or it constitutes one disk of a multi part archive In the lat
175. g1 gt cannot be open for input Explanation The PKZIP License Install program could not open the Library File member 81 input file that contains the licensing update keys Job is terminated See Job Log for more Details AQZ9055 50 Error Reading Input Control file lt l gt Explanation The PKZIP License Install program could not read the Library File member amp 1 input file that contains the licensing update keys Job is terminated See Job Log for more Details AQZ9056 00 amp 1 Evaluation set to expire in amp 2 days on amp 3 Explanation Feature Code amp 1 has been set for Evaluation and will expire in amp 2 Days on the date of 83 AQZ9057 00 Nbr of Feature Control Records Type amp 1 was amp 2 Explanation The total of Inputted Feature control records with type amp 1 was processed This is only with debug turned on AQZ9058 00 Rec amp 1 amp 2 Explanation Displays Detail input control records being processed by INSTPKLIC includes comments AQZ9059 00 License File amp 1 Updated successfully Explanation The PKZIP License File amp 1 was updated successfully with supplied control records AQZ9060 50 License file NOT Updated Explanation Due to errors wile running the License Install program the License file was not updated Review Job Log for previous message which indicates why the file was not updated Chapter 12 Messages 123 AQZ9061 40 Error found in processing input pa
176. gging software or operations This contrasts with a Production Library Time Sharing Option Interactive processing software used on the System 370 operating system for remote terminals Time Stamp A software mechanism for recording the current date and or current time of day Translation Table Translation tables are used by the PKZIP and PKUNZIP programs for translating characters in compressed text files between the ASCII character sets used within a ZIP archive and the EBCDIC character set used on IBM based systems These tables may be created and modified by the user as documented in the User s Guide Trigger A set of predefined actions that run automatically whenever a specified action or change occurs for example a change to a specified table or file Triggers are often used to automate environments such as running a backup when a certain number of transactions are processed Glossary 175 Truncate To cut off or delete the data that will not fit within a specified line width or display This may also be attributed to data that does not fit within the specified length of a field definition Unit The defined space within designated disk units that is addressed by the operating system Universal Time Coordinated UTC A synonym for Greenwich Mean Time GMT which is the mean solar time of the meridian of Greenwich England and is the prime basis of standard time throughout the world User Interface The actions or items that
177. h TYPE VIEW AQZ9082 00 amp 1 Licensed as a DEMO with amp 2 Days remaining amp 3 Explanation Displays the hardware amp 1 is running as a demo and has amp 2 days remaining Informa tion of INSTPKLIC with TYPE VIEW AQZ9083 00 Enterprise Licensed All Products Features are available on all CPUs Expiration Date is amp 1 Explanation Display that all CPUs are being run with the Enterprise license also displays the expiration date Information of INSTPKLIC with TYPE VIEW 126 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ9084 00 amp 1 Licensed on Following processors Expiration of amp 2 Explanation Displays the Feature Codes and their expiration date that is on current License File Information of INSTPKLIC with TYPE VIEW AQZ9085 00 Serial amp 1 Processor Type amp 2 Explanation Displays the list of hardware that is active under the Feature Code AQZ90084 Information of INSTPKLIC with TYPE VIEW AQZ9086 00 Serial amp 1 is Not Licensed Use Of The Product will CEASE in amp 2 days amp 3 Explanation Displays the hardware that is not currently licensed for the above Feature Code AQZ9084 and display when it will expire Information of INSTPKLIC with TYPE VIEW AQZ9087 00 Contact PKWARE of Ohio Inc for Licensing Explanation Informational message to contact your support for Licensing Update Please contact the Product Services Division at 1 937 847 2687 for a
178. haracters over 10 DFTDBRECLN DFTDBRECLN 132 Record Length Specifies the record length to use when creating a file in the QSYS Library system If TYPFL2ZP parameter is DB and the file being extracted does not exist nor does extended attribute for the record length exist the file will be created with the record length specified in this parameter The allowable values are 132 Default is record length of 132 to match previous versions Record Length A decimal number from 50 to 32000 DROPPATH DROPPATH NONE ALL LIB Used to drop the path s or libraries of files that are stored in the archives therefore only using the file names in the archive This is used along with the keyword EXDIR where the default paths are defined when dropping the paths on files in the archive For example if the file in the archive is path1 path2 filename IFS or Library File member QSYS and if DROPPATH is ALL the file being extracted would be filename or member If LIB was used the file being extracted would be path1 filename or File member See Example 1 PKUNZIP Files to a New or Different Library in Appendix B Examples for an example of using EXDIR and DROPPATH together 56 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 The allowable values are NONE Do not remove paths and or libraries in the archive ALL Remove all paths that are stored in the archive leaving only an IFS file name or
179. he files in the list file should be in the format of the archive See the parameters FILES and EXCLUDE for specifications 152 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Appendix F Translation Tables Text files such as program source code are usually held within an archive using the ASCII character set for compatibility with other versions of PKZ P For these to be usable on OS 400 they must be converted to the IBM EBCDIC character set PKZIP for OS 400 uses one of two possible internal translation tables which should be suitable for most customers These translation table members are used by parameters FTRAN and TRAN in both the PKZIP and PKUNZIP programs Included as part of the distribution are a series of override translation tables Some users may wish to define their own table The override Translation Tables included are stored as source members in file PKZTABLES PKZIP for OS 400 Resources Tables By referencing the members in parameters TRAN and FTRAN PKZIP for OS 400 will access the selected member in the PKZTABLES file and parse them to an internal hexadecimal table for use in translation The following translation tables are included Table Translation Translation Explanation Name from to ASCIIISO EBCDIC ASCII iso Translate Table default LATIN1 EBCDIC ASCII Latin Translate Table NOOP NO OP Translation Table Straight UKASCII EBCDIC UK FeCl Translate Table UKASCIIE EBCDIC UK AS
180. hened in the archive Only file comments of files that are affected by a change are eligible for editing FILETYPE FILETYPE BINARY DETECT EBCDIC FIXTEXT TEXT Specifies whether the files selected are treated as text or binary data For text files added to an archive trailing spaces in each line are removed the text is converted to ASCII based on the translation tables by default and a carriage return and line feed CR LF are added to each line before the data is compressed into the archive Binary files are not converted Chapter 9 PKZIP Commands 43 The default is DETECT where PKZIP attempts to make a determination based on the existing data type The program will read in a portion of the data evaluate it and determine the appropriate process Note This will lower performance time A message will display the type used when compressing Use of text file options is usually faster because PKZIP has to process less data than with BINARY but more processing may also take place to perform the translation If the file is a SAVF or a Database File with DBSERVICE YES then the file will be processed as BINARY no matter what option is specified BINARY Specifies that the files selected are binary files and no translation should be performed DETECT The PKZIP program will try to determine the data type of Text or Binary EBCDIC Specifies that the files selected are text files and leaves it in EBCDIC without perfor
181. hnique that reduces the complexity and overhead of concurrent programming New ZIP Archive A New ZIP archive is the archive created by a compression program when either an old ZIP archive is updated or when files are compressed and no ZIP archive currently exists It may be thought of as the receiving archive Also see Old ZIP Archive Null Value A parameter position within a record for which no value is specified n way Processor Architecture A processor architecture that provides expandability for future system growth by allowing for additional processors To the user the additional processors are transparent because they separately manage the work load by sharing the work evenly among the n way processors Glossary 171 Old ZIP Archive An Old ZIP archive is an existing archive which is opened by a compression program to be updated or for its contents to be extracted It may be thought of as the sending archive Also see New ZIP Archive Operating System 400 OS 400 An IBM licensed program that is as the primary operating system for an Series system OS 400 See Operating System 400 shown above Output Information or data received from a computer that is shown on a display printed on the printer communicated or stored on disk diskette or tape Output Queue An AS 400 object that contains entries for spooled output files to be written to an output device Packed Decimal Format A decimal value in which each b
182. iSeries that occurred in run AQZ0019 00 PKZIP Compressed amp 1 files in Archive amp 2 Explanation amp 1 is the number of files that were compressed in this run of PKZIP storing them in the Archive file amp 2 70 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0020 00 PKZIP Completed Successfully Explanation PKZIP Completed Successfully This message can be monitored using MONMSG AQZ0021 10 There are no files to select from Zip ending Explanation Either no files were selected with Files parameters for all actions or no files qualified for selection with FRESHEN or UPDATE TYPE Review archive and selection parameters AQZ0022 40 PKZIP Completed with Errors Explanation See job log for previous errors messages An error occurred that caused PKZIP to complete unsuccessfully AQZ0022 message will be issued as an Escape message type Escape messages indicate a condition causing PKZIP to end abnormally without completing its work This message can be monitored using MONMSG AQZ0023 10 Invalid date amp 1 for date select option amp 2 Explanation DATETYPE with BEFORE or AFTER was selected in PKZIP but has an invalid date in DATEAB Format must be mmddyyyy or yyyymmdd The mm must be 1 thru 12 The dd must be 1 thru 31 AQZ0025 40 File name lt amp 1 gt contains special characters Explanation The file contains characters not valid for a file name AQZ0026 30 Invalid option
183. ibility 4 65 CRTLIST 38 55 Cryptography 167 Current Library 167 Current Use License 133 Customer Control Card 134 Customer Information Control System CICS 167 CVTDATA 39 55 CVTFLAG 39 55 CVTNAME 147 CVTTYPE 39 56 Cyclic Redundancy Check 2 Cyclic Redundancy Check CRC 167 Cylinder 168 D Data Compression 1 168 Data Encryption 2 Data Format Text Records vs Binary Records 15 Data Integrity 168 Database Attribute Considerations 32 DATABASE Attributes 28 Database File Handler 132 DATEAB 40 DATETYPE 40 DBCS 168 DBSERVICE 40 Decompression 132 DELIM 41 DEMO 131 Device 168 DFTARCHREC 40 DFTDBRECLN 56 Direct Access 168 Directories and Current Directory 18 DIRNAMES 41 DIRRECRS 41 DISASTER RECOVERY 131 Document Library Services file system 19 Document Library Services File System QDLS 20 Double byte Character Set DBCS 168 DROPPATH 56 EBCDIC 168 Encryption 168 ENTERPRISE 131 Example 1 PKUNZIP Files to a New or Different Library 139 Example 2 CLP with Override for Stdout and Stderr to an OUTQ 140 Example 3 Creating Archive in Personal Folders QDLS 142 Example 4 Processing Archive on a CD QOPT 143 Example 5 Compressing files from a CD QOPT 144 Example 6 Compressing CL with MSG Checking 144 Example of PKZTABLES USASCII Translation Table 155 Examples 139 EXCLFILE 41 57 EXCLUDE 42 57 EX
184. ify the information An attribute is stored in the archive header that identifies if the file is a SAVF The PKUNZIP program will also retain the original attribute from the extended attributes such as SAVF Description and Library Description A common problem in some Series environments is that some users may not have the authority to the SAVF commands which can result in failures To overwrite a current SAVF file When extracting a compressed file it may be desirable to overwrite the existing file By using the OVERWRITE YES parameter PKUNZIP will first issue a CLRSAVF command to clear the save This demonstrates why care should be taken when extracting a SAVF 22 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 SPOOL Files PKZIP for OS 400 has the ability to select compress and extract spool files Not only can a spool file be compressed they can be converted to other document formats that will allow the document file to be distributed and read by other media and software All spool files are eligible for compression but only Spool File Types SCS IPDS AFPDS are supported for Text Document conversion By using the PKZIP command and setting parameter TYPFL2ZP SPL other parameters will be shown to help select the spool files To assist a new command PKZSPOOL is provided to sequenced the selections and eliminate parameters that are not valid for selection of spool files Spool File parameters specifies the group of sp
185. ile can be put in either the QSYS file system or IFS TYPLISTFL DB When the file system is QSYS the output file will create a physical file PF DTA with a record length of 132 For the file format in CRTLIST you can use any of the following formats library file library file mbr file or file mbr When a member is not entered the member name will be the same as the file name You should use the utility that your organization uses to edit data files TYPLISTFL IFS When using the IFS the output file will create a stream file STMF object type Most organization uses EDTF For the file format in CRTLIST you can use any of the following formats file file suffix dir1 file dir1 dir2 dirn file or dir1 etc When the path does not start with then the path starts in your current directory When creating a file manually follow the creation attributes described above Using List Files as Input Both PKZIP and PKUNZIP programs can use list file parameters for both selections of files INCLFILE file name and or the excluding of file EXCLFILE file name The file name of parameters depends on the setting of TYPLISTFL DB or IFS and should follow the guidelines in Creating List Files above When using PKZIP the format of files in the list file should be in the format of the iSeries files that will be processed See the parameters FILES and EXCLUDE for specifications When using PKUNZIP the format of t
186. iled Explanation PKUNZIP failed while converting mapping the internal file amp 1 name to an iSeries external file name Check Log to see if file was extracted successfully AQZ0504 20 Checkdir Cannot create extraction directory amp 1 Explanation PKUNZIP failed while trying to create directory amp 1 in the Integrated File System re quired extracting file AQZ0505 10 Warning Cannot set UID amp 1 for amp 2 Explanation After extracting a file successfully PKUNZIP could change the UID attributes for a file in Integrated File System to UID in the archive settings See Job Log for more Informa tion AQZ0506 10 Checkdir warning Path too long truncating amp 1 Explanation The path name in the archive file is longer than 255 bytes for an Integrated File System Path will truncate for file extraction AQZ0508 10 Checkdir error amp 1 exists but is not directory unable to process Explanation PKUNZIP was extracting a file to the Integrated File System where the Archive file name indicated it is a directory but it already exists and it is not a directory A default path will be used AQZ0509 10 Checkdir error Cannot create amp 1 unable to process amp 2 Explanation PKUNZIP could not create directory amp 1 in the Integrated Files System A default directory is used See Job Log for information for the failure AQZ0510 10 Checkdir error Path too long 6 amp 1 Explanation PKUNZIP d
187. ility in controlling how the iSeries names are stored in the archive See Appendix D External Name Conversion Program for more details on the external program External Pgm Conversion Extended Data Specify up to 255 bytes of unedited data which is passed to the exit program CVTNAME to assist in controlling the program logic CVTFLAG CVTFLAG NONE 400 Conversion Flags Specifies the flags passed to the external program CVTNAME These are used to control how the iSeries names are stored in the archive See Appendix D External Name Conversion Program for more details on the external program NONE Conversion exit is not active 400 Use the included sample CVTNAME program section that does not change the names Conversion Flags Specify a 5 byte flag that is passed to the exit program CVTNAME to control the program logic If the name passed back is blank then conversion is referred back to the setting of the CVTTYPE parameter CVTTYPE CVTTYPE NONE DROP SUFFIX Specifies how the iSeries Library and File names are stored in the archive Since the length of the Library name File name and member name can each be up to 10 characters and MS DOS format requires a maximum of 8 characters with an optional extension this option allows name compatibility The allowable values are Chapter 9 PKZIP Commands 39 SUFFIX This forces any Series name with more than 8 characters to create a name of 8 characters and a period f
188. ill be stored in the archive as the archive s file comment NONE No archive comment will be stored Archive File Text description Up to 255 characters that are stored as the archive s file comments COMPAT COMPAT NONE PK400 Specifies that PKZIP will create and store extended data field information in another supported format or previous version At this time only PKZIP Version 4 0 for OS 400 is supported The allowable values are NONE The Extended Data fields will be in PKZIP for OS 400 Version 5 0 formats PK400 The Extended Data fields will output to the archive in the format used by PKZIP Version 4 0 for OS 400 product This option should be used if the archive file will be extracted by PKZIP Version 4 0 for OS 400 and the attributes are required to create the files The files can be extracted without this option but the files may have to be manually created in order to have the proper attributes such as record length and text descriptions COMPRESS COMPRESS FAST SUPERFAST MAX STORE TERSE Specifies the compression method or level to be used during a run of PKZIP This is used to specify the amount and speed of compression that is required for any updated files The allowable values are FAST This selection provides ample compression at a fast rate SUPERFAST This is the default selection This will compress in the fastest time but will compress the files by the least amount MAX This
189. in a SAVF and then perform SAVF to the archive Chapter 12 Messages 105 AQZ0522 00 Database process selected but missing DB extended data record File amp 1 Explanation An extended data file indicates that Database attributes are present in order to create a DB that is not currently present but the attributes could not be found The archive may be corrupt Will try with default settings AQZ0523 00 Failure building DDS source to gen database File amp 1 Explanation While building the DDS source for creating file amp 1 an error occurred in routine build_ddssrc with number amp 2 See job log for other messages Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0525 00 Warning File amp 1 has Public Authorization List Explanation PKZIP has detected that the database file being zipped has a Public Authorization List associated with it PKZIP does not store Public Authorization List information in the archive See Chapter 8 Storing Database File Extended Attributes for more information This message only appears when compressing database files When extracting the file it is up to the user to provide Public Authorization List information If you wish to preserve Public Authorization List information first save the file to a SAVF and then add the file to the archive AQZ0600 00 Archive amp 1 Identified as a GZIP archive Explanation PKZIP was run specifying existing
190. ions for amp 1 Explanation After extracting a file successfully PKUNZIP could not set the authority permissions for the file in the Integrated File System File has job user as owner See Job Log for more information AQZ0498 40 amp 1 Write error was encountered while extracting Explanation While extracting and writing file amp 1 an error occurred It could be the allowable disk allocation for a user a job or a file See Job Log for more information Current extracted file is incomplete AQZ0499 50 Archive file probably corrupt amp 1 Explanation A Handler signal occurred in PKUNZIP which indicates an internal error occurred or the archive file is corrupt Please contact the Product Services Division at 1 937 847 2687 for assistance with the archive file and Job LOG MAJOR Error AQZ0501 20 Warning Cannot allocate wildcard buffers Explanation PKUNZIP could not allocate Memory resources in do_wild for the Integrated File Sys tem wildcard buffers Cannot select files Check other messages in Job Log for possi ble causes and refer to Appendix C about memory errors If this continues please con tact the Product Services Division at 1 937 847 2687 for assistance AQZ0502 00 Creating directory l Explanation Information only PKUNZIP created directory amp 1 in the Integrated File System 102 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0503 30 Mapname Conversion of amp 1 fa
191. iration of 12 31 2002 Serial 0107X8WT Processor Type P10 KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK Decompression Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK GZIP Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KKAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKkKkkXk IFS File Handlers Licensed on Following processors Expiration of 12 31 2002 Serial 0107X8WT Processor Type P10 KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK Database File Handlers Licensed on Following processors Expiration of 12 31 2 001 Serial 0107X8WT Processor Type P10 KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKkKkkXk 136 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 View Enterprise PKZIP for 0S 400 TM Compression Utility Version 5 5 2002 07 12 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107X8WT Processor Group P10 KKEKKKKKKKK KKK KKK KKK KKK KKK KKKKKKKKKKKKKKKKKKKK A License Report requested on 07 16 01 08 59 from CPU Serial 0107X8WT This Product is Licensed to Customer 110531837 My Company Name Dayton OH KREKEKKKKKK KEK KK KKK KK KKKKKKKKKKKKKKKKKKKKKKKKKKK Enterprise Licensed All Products Features are available on all CPUs Expiration Date is 12 31 2002 KKEKKKKKKK KKK KKK KKK KKK KKK KKK
192. is capable of storing compressed data into ZIP archives There is no limit to the number of archives you may create ZIP archive capability e ZIP archive refers to any valid ZIP format file created by a PKZIP 4 x compatible product e Each archive can store up to 65 535 files e Files that were up to 4 gigabytes before zipping can be archived to archive larger files see Chapter 11 Processing with GZIP e Each archive may contain up to 4 gigabytes of data For each file in the archive the following information is stored with the compressed data Chapter 1 Introduction to PKZIP OS 400 1 e Filename e File directory date and time e File s initial CRC value see Cyclic Redundancy Check e Method of compression used e PKZIP for OS 400 version required for file extraction e File size uncompressed e File size compressed Some files may contain the following additional information e The version of PKZIP for OS 400 that created the file e File attributes e Any comment about the file e Any comment about the archive e Platform specific attributes see Cross Platform Compatibility Cyclic Redundancy Check Cyclic Redundancy Check CRC is a method used to verify the integrity of a data file after it is restored from a ZIP archive Before a file is compressed a PKZIP for OS 400 algorithm computes a 32 bit hexadecimal value for its data The CRC value is stored in a file that is within the ZIP archive When
193. istered file system All remaining elements must be the name of a directory except the last element which can be the name of a directory or file See also Absolute Path Name and Relative Path Name 4 The name of an object in the integrated file system Protected objects have one or more path names PF or PFK lt See Program Function Key shown on page 173 Physical Disk I O A disk hardware operation for reading or writing data 172 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Physical File Describes how data is to be presented to or received from a program and how data is stored in the database A physical file contains a single record format and at least one member Physical File Member A named subset of the data records in a physical file See also member PL I See Programming Language l shown below POWER See Job Entry Subsystem Production Library A library which contains objects needed for normal processing This contrasts with a Test Library Programmed Function Key PF or PFK On a workstation a specified series of keys that can perform various functions selected by the user or determined by an application program Programming Language PL I A programming language designed for use in a wide range of commercial and scientific computer applications Program Temporary Fix PTF A temporary solution to or a bypass of a problem that is necessary to provide a complete solution to correct a defect in a
194. it will NOT be selected because the file specification includes a member name library file library file ALL Searches libraries that begin with library prefix and for files that begin with file prefix If a matching file is found all of its members will be selected If a SAVF is found it will be selected library file memo library file mem Searches libraries that begin with ibrary prefix and files that begin with file prefix If a matching file is found members beginning with mem prefix will be se lected Ifa SAVF is found it will not be selected because the file specification in cludes a member name IFS Dir Dir all Searches all files in path DIR Chapter 4 File Selection and Name Processing 13 Note If parameters TYPE VIEW or TYPE DELETE are used then the file name format for these names should be in MS DOS format that is if CVTFLAG has not been used See the FILES keyword Files may also be excluded See the EXCLUDE keyword The valid parameter values for the FILES keyword are as follows file specification 1 file specification 2 file_specification nn This is the list of one or more file specifications separated by spaces For example mylib myfile prf mylib all all By default PKZIP for OS 400 does a match not case sensitive on the filenames from the system Some IFS file systems contain case sensitive file names
195. ive For this reason a file containing a ZIP archive should allow for at least one temporary member to be allocated When PKZIP for OS 400 creates an archive file it uses MAXMBRS NOMAX Temporary Archive File A temporary archive file refers to an archive work in progress PKZIP for OS 400 will always use a temporary archive file and its definition depends on the file system If the file system type is IFS then the temporary archive file will be in the same directory of the specified new archive If the file system type is Chapter 7 Zip Archives 25 QSYS the temporary archive file will become a member of the specified archive file The temporary file or member will have a unique name PKnnnnnnnn where nn represents an internal time When the file has been completed successfully the temporary name will be renamed to the specified name in the ARCHIVE parameter If this is a process in which an old archive is being updated then if successful the old archive will be deleted before the rename If a problem occurs the temporary archive may stay with the temporary name View the job log if this happens to determine the status of the archive New ZIP Archive When the processing of the temporary dataset is finalized PKZIP for OS 400 creates a new ZIPPED Archive that is the modified after version of the old Archive The modified name of the old Archive and specified allocation information is transferred automati
196. l archive path at the end of the run The temporary file name and path type will be the same as specified for ARCHIVE See parameter TYPARCHEL for file system type information Special libraries such as QTEMP are used frequently CURRENT Specifies that the current archive path will be used see ARCHIVE to build the temporary archive file PZxxxxxxxx pathname Specifies a path name if using IFS such as PKZIP tempdir or a Library File if using the Library System NOTE 1 When using the QSYS library file system and specifying qtemp as the TMPPATH a dynamic file name and member name is created in the library qtemp At the end of the run the file and member are removed Chapter 9 PKZIP Commands 49 If any other combination of names is used then a dynamic member name is created and only the member is removed NOTE 2 When using the QSYS library file system and specifying a TMPPATH there may be a slight performance degradation because the archive file will have to be copied from one library file to another library file Otherwise if CURRENT is used the file member name will only be renamed TRAN TRAN INTERNAL Member Name Specifies the translation table for use with translating data from the Series EBCDIC character set to the character set used in the archive file normally the ASCII character set A default internal table is prede fined see Appendix F Translation Tables INTERNAL Use the predefined intern
197. l be terminated 52 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Chapter 10 PKUNZIP Commands PKUNZIP Command Summary with Parameter Keyword Format If the OS 400 command prompt screen is to be used the command format is simply PKUNZIP The command prompt screen is displayed when ENTER or PF4 is pressed The parameter keywords are displayed on this screen together with the available keyword options The required options can be selected before PF4 is pressed to accept the selections If the command and parameter keywords are entered together on the command line the required format is PKUNZIP keyword1 option keyword2 option keywordn option Keywords are marked by spaces The keyword ARCHIVE is the only positional keyword where the keyword is not required Whenever the word path is used its meaning depends on the file system that is being used If IFS is used path refers to the openness true path type If the Library systems or DB is used path means Library file and then the file name refers to the member name Refer to the individual parameter descriptions within this section for details The page number where complete command details can be found is at the right of the command TYPE VIEW FILES file_specificationl EXTRACT file_specification2 NEWER file_specificationn TEST FILETYPE TEXT ARCHIVE Archive Zip File name with path BINARY EBCDIC CRTLIST NONE D
198. lected SFJOBNAM SFJOBNAM Blank Spool File Jobname User Job Number Specifies the job name user name and job number that will be used to select spool files If anything other than blanks are in SFJOBNAM parameter it will be used as the primary selection criteria If any of the three fields Job Name User Name and Job Number are specified then all three fields must be entered and be valid The allowable values are Blank This is the default selection This will cause all other selection criteria to be used for spool files E The will cause the current Job name User Name Job Number to be used to select spool files Job name Specify the name of the job to be selected If no job qualifier is given all of the jobs currently in the system are searched for the simple job name User Name Specify the name that identifies the user profile under which the job is run Job Number Specify the job number assigned by the system SFTARGET SFTARGET SPLF TEXT PDF TEXT1 TEXT2 Specifies the format of the file that will be stored in the archive The allowable values are SPLF This is the default selection This will compress the spool file in a spool file format with all of the spool file attributes This format is only valid on an AS 400 If is Chapter 9 PKZIP Commands 47 extracted it will take on the latest spool file settings such as Job Name User Job Number Spool File number etc The suffix for this selection is
199. mat of member UKASCII in file PKZTABLES See Appendix F Translation Tables for defining translation tables GZIP GZIP YES NO If this option is set to YES PKZIP will create a compressed archive in the GZIP format The GZIP format only allows for one file or member per archive and all text data is stored in ISO 8859 1 LATIN 1 character set The GZIP format is very different from the PKZIP for OS 400 archive format a program that can process PKZIP archives will not necessarily process a GZIP Archive correctly The GZIP Archive created conforms to the GZIP specifications RFC1951 and RFC1952 Do not use this option if the archive is to be unzipped on another platform where GZIP compatibility is not confirmed The allowable values are 44 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 YES The PKZIP program will create a compressed archive in the GZIP format NO The PKZIP program will create an archive in the PKZIP format This is the default IFSCDEPAGE IFSCDEPAGE NO Code Page If this option is set to NO PKZIP will read IFS files using the code page that is registered for the file Otherwise PKZIP will read IFS files with the specified code page This parameter also controls the Spool File ASCII conversion for TEST and PDF documents When NO is specified for Spool Files the conversion will use code page 819 The allowable values are NO The PKZIP program will read IFS files with the code page regis
200. me of the last update to the file e A flag to indicate optional Extended Data Exist these fields are usually operating system dependant and may be ignored if identification code is unrecognized e The name of the file that was compressed e An archive text comment e Compressed data followed by the GZIP Trailer at the end of the archive The trailer includes a CRC value and the original size of the uncompressed file Cross Platform Compatibility Since GZIP Archive files adhere to RFC 1952 the files are compatible across all GZIP supported platforms If executable files and other platform dependent objects are compressed on one platform and then decompressed on another it is unlikely that they will work on the new platform The same can be said about EBCDIC vs ASCII Because the extra information is platform dependent most likely it will be ignored by another platform Special Note on GZIP Passwords GZIP standard processing RFC 1952 does not normally allow a password to be placed on a GZIP Archive PKZIP for OS 400 does allow this feature but its use may cause compatibility issues with other platforms PKZIP for MVS does use the same password standard so GZIP Archives with passwords can be exchanged between PKZIP for OS 400 PKZIP for VSE and PKZIP for MVS Because GZIP Archives that are created with a password with PKZIP for OS 400 or PKZIP for MVS are not part of the GZIP standards these files will probabl
201. ming any translation This is good only if the files are to be used on an Ser ies or IBM type mainframe If they are unzipped to a PC file then a translation from EBCDIC to ASCII would be required FIXTEXT Specifies that the files selected are text files with a fixed record length based on the iSeries file s record length and translation will be performed using the translate tables specified in the TRAN option This means the compressed file will contain records with trailing spaces followed by a CR and LF This is only valid for ASYS Library file types as files in the IFS do not contain a record length TEXT Specifies that the files selected are text files and translation will be performed using the translate tables specified in the TRAN option FTRAN FTRAN INTERNAL Member Name Specifies the translation table for use in translating File names comments and password from the Series EBCDIC character set to the character set used in the archive file normally ASCII character set A default internal table is predefined See Appendix F Translation Tables for additional information INTERNAL Use the predefined internal table for translation Using this is initially faster be cause PKZIP does not have to parse the override table membername Specify the member name in the file PKZTABLES that will be parsed and used to translate File names and comments files to the archive character set The member should have the exact for
202. n compression method Information with TYPE VIEW and VIEWOPT DETAIL AQZ0830 00 Number of Shannon Fano trees implosion 4 amp 1 Explanation Displays the number of Shannon Fano trees that were used to compress a file in the archive with an Implosion compression method Information with TYPE VIEW and VIEWOPT DETAIL 112 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0831 00 Detected File type 6 amp 1 amp 2 Explanation Based on internal Attributes displays the file type that was detected for a file in the Archive The Types are Binary Text Text in EBCDIC SAVF UNKNOWN Information with TYPE VIEW and VIEWOPT DETAIL AQZ0834 10 Caution Archive File comment truncated Explanation The Archive file comment exceeded the buffer size and will be truncated This is only a warning that affects the display of the comment Information with TYPE VIEW and VIEWOPT DETAIL AQZ0835 00 Unknown Extended Attribute TAG amp 1 with length of amp 2 Explanation An Unknown Extended Attribute Key was found PKUNZIP does not handle this and will be bypassed Information with TYPE VIEW and VIEWOPT DETAIL AQZ0836 00 Extended attributes 6 amp 1 Length amp 2 Explanation If extended attributes are stored in the archive for this file then Yes is displayed otherwise No is displayed The size of these extended attributes are amp 2 bytes Information with TYPE VIEW and VIEWOPT DETAIL
203. n of the operating system that provides storage support similar to personal computer operating systems such as DOS and OS 2 and UNIX systems Glossary 169 Interactive Job A job started for a person who signs on to a work station and communicates or converses with another computing entity such as a mainframe or iSeries system This is in contrast to a Batch Job Internet Protocol IP A protocol that routes data through a network or interconnected networks IP acts as an intermediary between the higher protocol layers and the physical network However this protocol does not provide error recovery and flow control and does not guarantee the reliability of the physical network Internet Protocol IP Address The unique 32 bit address that specifies the location of each device or workstation in the Internet For example 009 067 097 103 is an IP address and is commonly written as 9 67 97 103 10 See Input Output See Internet Protocol shown above IVP See Installation Verification Procedure Julian Date A date format that contains the year in positions 1 and 2 and the day in positions 3 through 5 The day is represented as 1 through 366 right adjusted with zeros in the unused high order positions For example the Julian date for April 6 1987 is 87096 Kanji Characters originating from the Chinese characters used in the Japanese written language Keyed Sequence An order in which records are retrieved based on the
204. nation A request in the License Install Program to setup a Demo license was issued but a DEMO is currently active A DEMO request cannot be run until current DEMO expires The License File is not updated AQZ9074 40 Cannot do VIEW option until file has been Installed Explanation A request in the License Install program to view the current license setting was issued but the VIEW option cannot be used until one valid install is processed Chapter 12 Messages 125 AQZ9075 40 Invalid or Missing Member Name Explanation Special characters or a blank member name was submitted in the command INSTPKLIC for parameter INMBR AQZ9076 40 Feature Code amp 1 is invalid for Customer Number amp 2 Explanation The Customer Number amp 2 on the input control record is invalid for the specified Feature Code amp 1 Contact your Dealer for correct codes The License File will not be updated AQZ9079 00 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkkxk Explanation Displays a Print Separator for INSTPKLIC viewing AQZ9080 00 A License Report requested on amp 1 from CPU Serial 2 Explanation The Licensing Install program was run with TYPE VIEW and the report of the current status of the License will be following for this CPU AQZ9081 00 This Product is Licensed to Customer amp 1 amp 2 Explanation Displays the Customer Number and Customer Name currently on license file Information of INSTPKLIC wit
205. ncompressed size 8146 bytes 32 bit CRC value hex 40950039 Extended attributes yes Length 112 Spool File Type SCS Target File PDF Nbr Of pages 3 SPLF Desc EVWSS EVWSS Ht007892 CRTCM F0060 PDF File Comment none The above view comes from the below spool file Appendix I SPOOL Files Considerations 161 5722581 V5R1MO Work With Output Queue QPRINT2 in QGPL 11 19 02 14 08 53 Page 1 File User User Data Status Pages Cpy Form Tp Pty File Number Job Number Date Time CRTCM EVWSS RDY 3 1 STD 5 60 EVWSS 007892 10 17 02 07 22 00 PDF Creation Attributes When creating a PDF the attributes are also stored in the PDF document to help trace back what spool file that it originated from 1 The date and time of the spool file creation will be the PDF date and time of creation 2 The Author will be the USER ID that created the Spool File 3 The subject will be made up of the Spool File Name Number and the JOB Number User ID Job Name An example of a PDF summary is Document Summary x File J Bills CRTCM60 PDF Title Subject Author Keywords Binding Creator 05400 Producer PKZIP_OS400 TM 5 0 98 10 17 2002 Created 10 17 02 7 22 00 AM Modified Not Available File Size 8 0 KB 8 146 Bytes Security None PDF Version 1 4 Acrobat 5 x Fast Web View No Page Size 12 4 in x 10 28 in Tagged PDF No Number of Pages 3 Cancel Extracting Spool files with PKUN
206. ndependent format which is not OS 400 compatible Note Directory entries within a ZIP archive are actually in a format compatible with UNIX systems and have been translated into the ASCII character set In addition the dataset level separators are typically set as the forward slash not the period as in OS 400 although this can be controlled through com mand actions in PKZIP for OS 400 See Chapter 6 OS 400 File Processing Support for further information on how PKZIP for OS 400 handles file name interchanges between OS 400 and common ZIP format Primary File Selection Inputs PKZIP for OS 400 can only read 1 0S 400 objects of type FILE only with attributes PF SRC PF DTA and SAVF 2 IFS Stream files STMR and IFS Directories DIR Other objects must first be unloaded into an OS 400 save file SAVF before they can be processed by PKZIP for OS 400 see Use of SAVF Method The FILES parameter in both PKZIP and PKUNZIP specifies which files are to be processed One or more names can be specified and each name is in either OS 400 QSYS format or IFS format depending on F2ZTYPE settings An asterisk may be used at the end of the library name file name or member name to select names beginning with the prefix used To select all members of a file ALL may be used To select all files in a library ALL may be used as long as it is qualified by at least a library name for example FILES mylib
207. ng 12 14 2002 Contact PKWARE Inc for Licensing KKKKKKKKKKKKKKKKKKKKKK KK KK KK KK KK KKKKKKKKKkk kk IFS File Handlers Licensed as a DEMO with 30 Days remaining 12 14 2002 Contact PKWARE Inc for Licensing kkkkxkxkxkxkxkxkxkxkxkxkxkxkxkxkxkxkxkxkxkkxkxkkxkxkxkxkxkxkxkxkkxkxkkkxkkxkxkxx k Database File Handlers Licensed as a DEMO with 30 Days remaining 12 14 2002 Contact PKWARE Inc for Licensing kkkkxkxkxkxkxkxkxkxkxkxkxkxkxkxkxkkkxkxkkxkxkkxkxkkxkxkkxkxkkkxkkkxkkkxkx k Advanced Encryption Licensed as a DEMO with 30 Days remaining 12 14 2002 Contact PKWARE Inc for Licensing kkkkxkxkxkxkxkxkxkxkxkxkxkxkxkkxkxkxkxkxkkxkxkkxkxkkxkxkkxkkkxkxkkkxkkkxkx k Spool Files Licensed as a DEMO with 30 Days remaining 12 14 2002 Contact PKWARE Inc for Licensing kkkkxkxkxkxkxkxkxkxkxkxkxkxkxkkxkxkkxkxkkxkxkkxkxkkxkxkkkxkkxkxkkkxkkkxkx k Press ENTER to end terminal session GZIP Licensed as a D View Basic PKZIP for OS 400 TM Compression Utility Version 5 5 2002 07 12 Copyright 2003 PKWARE of Ohio Inc All Rights Reserved PKZIP R is a registered trademark of PKWARE R Inc Machine ID 0107X8WT Processor Group P10 KKEKKKKK KKK KKK KKK KKK KKK KK KKK KKKKKEKKKKKKKKK KK kk A License Report requested on 07 16 01 08 57 from CPU Serial 0107X8WT This Product is Licensed to Customer 110531837 My Company Name Dayton OH KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKkk kk Compression Licensed on Following processors Exp
208. nized or is Invalid File will be skipped 98 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0473 00 Error Cannot allocate unzip buffers Explanation While starting to extract the file PKUNZIP could not allocate enough memory for IO buffers within the file Job will be terminated Check other messages in the Job Log for possible causes and refer to Appendix C about memory errors If this continues please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0475 40 Warning amp 1 Archive File is disk u of a multi disk archive and this is not the disk on which the central Archive File directory begins Explanation The Archive indicates that the archive part of a multi disk archive is invalid for PKUNZIP Review the source of the archive and ensure the archive is made up of one file AQZ0476 30 Warning amp 1 End of central directory record claims this is disk amp 2 attempting to process anyway Explanation The Central Directory has a setting that indicates this is a multi archive disk file It will attempt to process file amp 1 Expect errors and warnings true multi part support does not exist AQZ0477 30 Warning amp 1 Archive File claims to be last disk of a multi part archive attempting to process anyway Explanation Expect errors and warnings true multi part support does not exist AQZ0478 30 Error amp 1 Missing amp 2 bytes in Archive file attemptin
209. nslation Using this is initially faster be cause PKUNZIP does not have to parse the override table Member Name Specifies the member name in the file PKZTABLES that will be parsed and used to translate data files to the archive character set The member should have the exact format of member UKASCII in file PKZTABLES see Appendix F Translation Tables for defining translation tables Chapter 10 PKLUNZIP Commands 61 TYPARCHFL TYPARCHFL DB IFS Specifies the type of file system in which the archive file will exist see parameters ARCHIVE and TMPPATH for additional information DB Archive files are to be in the QSYS Library file system IFS Archive files are to be in the Integrated Files System IFS TYPFL2ZP TYPFL2ZP DB IFS Specifies the type of file system that contains the files to be unzipped Reflected for files in parameters FILES and EXCLUDE DB Files to be unzipped are in the QSYS Library file system IFS Files to be unzipped are in the IFS Integrated Files System TYPLISTFL TYPLISTFL DB IFS Specifies the type of files system that will be used for the input list file and or the output list file of selected items To use input list files see parameters INCLFILE file section list or EXCLFILE file exclude list To create an output list file of the selected files items see parameter CRTLIST DB Files are in the QSYS Library file system IFS Files are in the IFS Integrated File
210. ntroduction SC41 5711 This book provides an overview of the integrated file system which includes What is the integrated file system Why you might want to use it Integrated file system concepts and terminology The interfaces you can use to interact with the integrated file system The APIs and techniques you can use to create programs that interact with the integrated file system and Characteristics of individual file systems e File Management SC41 5710 This manual describes the data management portion of the Operating System 400 licensed program Data management provides applications with access to input and output file data that is external to the application There are several types of these input and output files and each file type has its own characteristics In addition all of the file types share a common set of characteristics e DDS Reference RBAF P000 00 This manual contains detailed instructions for coding the data description specifications DDS for files that can be described externally These files are the physical logical display printer and intersystem communications functions hereafter referred to as ICF files Preface V Contents PREFACE gt a into oa ainia dev ic III ABOUT THIS MANUAE a ae do III CONVENTIONS USED IN THIS MANUAL 22 0ccecceceeceececceececeecueceeaecaececucaeeaececuecesaeeaeeneeneas IV RELATED PUBLICATIONS IV RELATED IBM PUBLICATIONS cccccceceeceececceeaeceecueceeceeae
211. o all features of PKZIP for OS 400 on all systems See product options below TIME DELIMITED Each license type is modifiable by time Each license will have a finite time period Appendix A Licensing Requirements 131 Product Features The license key will be comprised of codes to reflect the product features selected by the customer The following list contains the product features available Compression This licensable module allows for the compression of data into a ZIP file This license is required to read the input data and write out the archive or ZIP file Decompression This licensable module allows for the decompression of data from a ZIP file or an archive This license is required to read the ZIP archive and to write the OS 400 datasets during the extraction routine Database File Handler This licensable module allows for PKZIP to read and write Physical Data Files Physical Source Files and SAVF in the QSYS Library Files system When licensed with Compression and Decompression it allows theses files and members to be compressed and decompressed It also allows ZIP archives and List Files to be stored and processed in a Physical Data Files format in the QSYS Library Files system IFS File Handler This licensable module allows PKZIP to read and write files to Stream Files in the Integrated File System IFS When licensed with Compression and Decompression it allows Stream Files to be compressed and decom
212. o the original processing start time AQZ0108 00 Excluding lt amp 1 gt Explanation In run PKZIP a file found in the selection process was excluded due to a match excluding file parameter AQZ0109 00 Compressing amp 1 in amp 2 mode Explanation Informational Compressing has started for the file with a specified mode The modes are 1 SAVF 2 DATABASE 3 BINARY 4 TEXT and 5 Text in EBCDIC 74 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0110 00 The Output List file lt amp 1 gt is being created Explanation Informational to indicate that file amp 1 is being created and will also be used to add list records selected in the run See Keyword CRTLIST for more details AQZ0111 00 amp 1 Records written to the Output List file amp 2 Explanation Informational indicates that amp 1 records were outputted to the list file amp 2 See keyword CRTLIST for more details AQZ0112 00 amp 1 records read from Include File amp 2 Explanation INCLFILE parameter was optioned in PKZIP or PKUNZIP This message displays how many records were in the file AQZ0113 00 Include parameters supplied amp 1 Explanation Informational How many include items found in FILES and INCLFILE AQZ0114 00 amp 1 records read from Exclude File amp 2 Explanation EXCLFILE parameter was optioned in PKZIP or PKUNZIP This message displays how many records were in the file AQZ0115 00 Exclude parameters supplied
213. oard Shift Character REFSHIFT Specifies a keyboard shift for a field when the field is referred to in a display file or DFU operation 10 Allow NULLS ALWNULL To define this field to allow the null value 11 Variable Length VARLEN To define this field as a variable length field 12 Alias ALIAS Specifies an alternative name for the field 13 Default Values DFT Specifies a default value for a field 14 Edit Formatting values EDTCDE EDTWRD DATFMT DATSEP TIMFMT TIMSEP Specifies editing for the field you are defining when the field is referenced later during display or printer file creation 15 Validity Checking CHECK COMP RANGE etc Specifies validity checking in display files 16 Indicator for Double Precision An indicator for float type fields specifying single or double precision 17 Allocated Length The allocated length in bytes for data types that use variable lengths Chapter 8 Extended Attributes 31 Key Field Attributes See the IBM Manual for the DDS description of keywords for KEYS Attribute Description 1 Key Field Name The field name of the key Type of Sequence Defines the type of key and the sequence of the key Database Attribute Considerations Special Database functionality and information such as Triggers File Constraints Authorization Lists and Alternate Collating Sequences are not stored in an archive 1 Ifa file has fields that h
214. often are different from one file system to another The IFS treats the library support and folders support as separate file systems The ten file systems are 1 10 root file system This file system takes full advantage of stream file support and hierarchical directory structure of the integrated file system The root file system has the characteristics of the Disk Operating System DOS and OS 2 file systems Most of references throughout this guide re fer to the root system QDLS Document Library Services file system This file system provides access to documents and folders See IBM s Office Services Concepts and Programmer s Guide SH21 0703 for addi tional information QOPT Optical file system This file system provides access to stream data that is stored on opti cal media such as CDs See IBM s Optical Support SC41 5310 for additional information QSYS LIB Library file system This file system supports the Series library structure and provides access to database files and all of the other Series object types that the library support manages NFS Network File System This file system provides the user with access to data and objects that are stored on a remote NFS server An NFS server can export a network file system that NFS clients will then mount dynamically See IBM s OS 400 Network File System Support SC41 5714 for additional information QFileSvr 400 This file system provides access
215. ogram will write the IFS files with the specified code page value INCLFILE INCLFILE NONE path filename This parameter specifies the file containing the list of files to be selected for including This can be used with or without the FILES parameter See parameter TYPLISTFL for file system type information NONE No Include list file will be processed This is the default Chapter 10 PKUNZIP Commands 59 path filename Enter the file path and name of the file to process The layout depends on which file system you want the file created Library File System The format is Library File Mbr Integrated File System IFS The format is path1 path2 pathn filename MSGTYPE MSGTYPE PRINT SEND BOTH Specifies where the display of messages and information should be shown The PKUNZIP program can send messages which appear on the log and also may print to stdout and stderr If working interactively stdout and stderr will display upon the dynamic screen If submitted via batch you can override them to print in an OUTQ or you can build a CL and save them to an outfile SEND Send the information to the log with send message commands PRINT Send the information to stdout and stderr BOTH Send the information to the log with send message commands and also to stdout and stderr OVERWRITE OVERWRITE NO YES PROMPT Controls how PKUNZIP reacts to files that are being extracted and the file already exists To help pre
216. ollowed by characters 9 and 10 to be considered an extension to suffix NONE This leaves the Series name as the archive name DROP This forces any Series name with more than 8 characters to drop characters 9 thru 19 DATEAB DATEAB mmddyyyy Used with DATETYPE parameter DATEAB specifies the date to be used to compare with the files latest modification date for file selection The format is mmddyyyy where mm is a valid month 01 12 dd is valid day of the month and yyyy is the four digits of the year 2001 DATETYPE DATETYPE NO BEFORE AFTER Specifies if PKZIP should select files based upon a file modification date The allowable values are NO No date selection will take place BEFORE Files with a modification date before the date in DATETYPE will be selected AFTER Files with a modification date on or after the date in DATETYPE will be selected DBSERVICE DBSERVICE NO YES Specifies if the iSeries special Database extended file attributes describing the database file fields and keys are to be store in the archives This will force the option EXTRAFLD YES The database will also be stored in Binary mode This mode can produce larger archive files The allowable values are NO Does not store Database extended services attributes YES Stores the Database extended service attributes in the archive file and treat non SAVF as a database DFTARCHREC DFTARCHREC 132 Record
217. ompressed size amp 1 by amp 2 bytes Contact the Product Services Division at 1 937 847 2687 for assistance AQZ0274 40 Encryption Method is not Supported Explanation PKUNZIP cannot extract file due to the encryption method indicated on the archive Perform PKZIP TYPE VIEW VIEWOPT ALL to check Encryption Method on message AQZ0872 Only valid encryption methods supported are Zip Standard AES 128 AES 192 and AES 256 AQZ0275 40 A File in the Archive coded for Adavnced Encryption was found to be Invalid Explanation PKUNZIP was extracting a file coded as being archived with advanced encryption The file is invalid due to invalid encryption data Perform PKZIP TYPE VIEW VIEWOPT ALL and check other messages in Job Log for possible causes If this continues please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0276 40 Security Types Not Supported for file Archive Explanation PKUNZIP could not extract file Archive indicates that it contains Security Types of Certificate Signature or Combination Password and Signature PKUNZIP only supports password only Do a PKUNZIP TYPE VIEW VIEWOPT DETAIL to see security type Chapter 12 Messages 89 AQZ0280 40 Only TYPE ADD or TYPE MOVE are valid with Spool Files selection Explanation When parameter TYPFL2ZP SPL is used for Spool File selection only ADD and MOVE are valid settings for the TYPE parameter Correct and re r
218. ompressing a file The following example shows how to compress a file into a GZIP Archive The PKZIP command is used to compress data into an archive To select the GZIP format for the resulting archive you must use the GZIP YES option with the PKZIP command PKZIP ARCHIVE MYLIB1 MYARCHFIL GZ01 FILES TESTLIB1 FILE1TXT TYPE ADD GZIP YES The command above will compress the text file TESTLIB1 FILE1TXT into the archive MYLIB1 MYARCHFIL GZ01 in GZIP format The archive must not already exist or an error message will be generated and the operation will fail The output from the above command should look like the following File MYARCHFIL created in library MYLIB1 PKZIP TM for OS 400 Data Compression Version 5 5 2002 05 01 Copyright 2003 PKWARE of Ohio Inc All rights reserved PKZIP R is a registered trademark of PKWARE R Inc EVALUATION Running EVALUATION Warning This license will expire in 29 days on 2002 06 02 Contact your dealer with the following information Machine ID 0107X8WT Processor Group P10 Scanning files for match as File MYARCHFIL in library MYLIB1 with member GZ01 not found Found 1 matching files Member GZ01 added to file MYARCHFIL in MYLIB1 Member GZ01 removed from file MYARCHFIL in MYLIBl Member PZ3AF2447F added to file MYARCHFIL in MYLIBl Compressing TESTLIB1 FILE1TXT FILE1TXT in TEXT mode Add TESTLIB1 FILE1TXT FILE1TXT Deflating 31 Member PZ3AF2447F renamed to member
219. on Information in PKZIP with verbose on Shows the size of the file being compressed and the size of the compressed file AQZ0122 00 Enter new Zip file Comment for file 6 amp 1 Explanation FILESTEXT was set to edit a new comment for files being added to the archive Enter the file s comment and press the Enter key AQZ0123 00 Enter Zip file Comment for file amp 1 Explanation An unexpected error was encountered while writing the Archive file PKZIP is terminated and the FILESTEXT was set to edit Comments for files being added or updated to the archive Enter the file s comment and press the Enter key AQZ0124 00 Zip Info amp 1 amp 2 Explanation Informational PKZIP files when processing with enhanced DEBUG options 76 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0125 00 Zip reading amp 1 Explanation Informational PKZIP reading the file amp in the current archive Only is displayed with Verbose MAX during fix option This option is not available at this time AQZ0126 00 Zip Info amp 1 for amp 2 Explanation Informational PKZIP Compression statistic of file amp 2 Only Displays with Verbose MAX during fix option This option is not available at this time AQZ0127 00 Zip warning 6 amp 1 amp 2 truncated Explanation Informational PKZIP Archive file has been truncated Only Displays with Verbose MAX during fix option This option is not available at this time AQZ0128
220. on While opening file 81 an open error occurred Review FTRAN and TRAN keyword entries and messages in the job log to determine the cause of problem Current run is terminated AQZ0404 40 Read Error while reading Translate table lt amp l1 gt Explanation While reading file amp 1 an error occurred Review FTRAN and TRAN keyword entries and messages in the job log to determine the cause of the problem Browse file amp 1 and review the data to ensure it follows the requirements of a Translate Table Current run is terminated AQZ0405 40 Translate Table must have 256 entries File lt amp 1 gt found amp 2 entries Explanation A Translation Table is required to have 256 entries Browse file amp 1 and review the data to ensure it follows the requirements of a Translate Table Current run is terminated AQZ0406 40 Internal Error Should not occur amp 1 Explanation If this error occurs review to ensure you have a valid archive Please contact the Product Services Division at 1 937 847 2687 for assistance Current run is terminated Chapter 12 Messages 93 AQZ0407 40 amp 1 file size changed while zipping Explanation PKZIP has determined that the size of file amp 1 has changed while compressing Size Information amp 2 File should be compressed again AQZ0408 40 Compression of input file amp 1 failed Could not read input file Explanation A read error occurred while trying to compress in
221. only valid for TYPFL2ZP DB files EXDIR is also used when the archive file is a GZIP Archive and there is no file name stored in the archive In this case EXDIR becomes a required field CURRENT Current directory for IFS or CURLIB UNZIPPED for the QSYS Library file system path Enter the path or path path in which to extract The layout depends on the file system in which the file is to be created Library File System The format is Library File Integrated File System IFS The format is path1 path2 pathn FILES FILES file_specification1 file_specification2 file_specificationn Specifies the files and file specification patterns that will be selected in the PKUNZIP process One or more names can be specified Each name should be in the OS 400 file system format such as QSYS is library file member and IFS is directory file and can include wildcard and Note If TYPE VIEW is being used then the format for these names is the MS DOS format The PKUNZIP program can also have file specification selections to include by using the list file parameter INCLFILE with a list of names to select Files may also be excluded See EXCLUDE parameter Please refer to Chapter 4 File Selection and Name Processing for details of file specification formatting The valid parameter values for the FILES keyword are as follows file specificationl file specification2 file _specificationn FILETYPE FI
222. onooonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnns 27 AVE pea crac ace A NN 28 STANDARD IFS ATTRIBUTES 0 cccceceeceececcecceceeceecueceeaecuecueceeaeeaecueceeaeeaecuecueaeeaeeneeneaees 28 ADVANCED ENCRYPTION ATTRIBUTES 2 cccceceeceececcecceceecueceeceeaecueceeceeaeeaececuesesaeeneeneeeeas 28 DATABASE ATTRIBUTES 0 0ccecceceeceececceceeceecuecueceeaecaecuecueseeaecaecueceeaesaecnecueseeaesaeeneeeeas 28 File Physical AUnDUtes sita ii A tate au tabe ie tate ae tabe ae tate at tat ae 28 File Field Attributes crann a ana A 31 Key Field AtinbUles 2 da 32 Database Attribute Considerations 20 00 0200 ccc ccceccaeceececceececeeceeceeceececaecueeueseeaeenseneeeees 32 Source File Considerations cccccccecceceececcecceceeceeceeceeaecuecuececaecaecueceesesaeeneeneaees 32 SPOOL FILEATIRIBUVES odiado a ae E E td ir ada adas 33 CHAPTER 9 PKZIP COMMANDS ooocoocconcconnonconnnnnnononnnnnrn cnn ron nan ronr narrar ener 34 PKZIP COMMAND SUMMARY WITH PARAMETER KEYWORD FORMAT 2 cecceceeeececceeececeess 34 PKZIP COMMAND KEYWORD DETAILS 2 ceceeceeceeceececeeceeceececaecuecueceeaecnecuecueseeaeeneseeeneas 36 CHAPTER 10 PKUNZIP COMMANDS 2 0eceecceeceecceeccecceeceeceeeceeceeceeseeeceeeeeneaeesers 53 PKUNZIP COMMAND SUMMARY WITH PARAMETER KEYWORD FORMAT 2 cecceceeceececeeees 53 PKUNZIP COMMAND KEYWORD DETAILS oocoococcnccnconconcnccnconconcnnnnnonconconnnnnnncnconinnnnnnncinss 54 CHAPTER 11 PROCESS
223. ool files that are to be selected Eight positional values can be specified to select the spool files the Spool File Name SPLFILE the Spool File Number SPLNBR the user that created the files SFUSER the OUTQ that the file is residing SFQUEUE the form type specified SFFORM the user data tag associated with the spool file SFUSRDTA the status of the Spool File SFSTATUS or the specific Job Name User Name Job Number SFJOBNAM Only files that meet all of the selection values will be selected A sample of the default selection parameters is shown in the window below Selection Sample using PKZSPOOL Command SPLF File Compression 5 5 PKZSPOOL Type choices press Enter Archive Zip File name gt myar Spool Fil 4 a s s w aoe 4 Eai ALL Spool File Name All Spool File User CURRENT User ID CURRENT ALL for more values Output Queue Name ALL OutQ name ALL Library E 8 a pl a es Library LIBL CURLIB Print Form Type i ALL Form Type STD ALL Print File User p tina Data ALL User Data all Spool Files Status ALL ALL READY HELD for more as Spool File Job Name Job name for all User bW E E HS User Id Job Runner De A oe Job Number Spooled file bee tem fs ates ALL 1 9999 ALL LAST Target File Format SPLF SPLF TEXT PDF TEXT1 Target File Name GEN1 Type of processing ADD ADD UPDATE F
224. or GEN1P will use a as name separator GEN2 GEN2 uses the spool file name and appends the spool file number followed by the suffix that is depended on the SFTARGET setting Caution should be taken in that a duplicate file name in the archive could be created An example of GEN2 is a spool file INVOICE with Spool File number of 21 that will be converted to a text file will generate a file name of INVOICE21 TXT File Name This parameter should only be used when selecting one specific spool file where you want a specific file name SPLFILE SPLFILE ALL Spool File Name Specifies the Spool File Name that will be selected This parameter is used along with all the other Spool File selection parameters to determine the spool files to select The allowable values are ALL This is the default setting ALL indicates that spool file name is not important Spool File Name A very specific Spool File Name that will be searched for and selected 48 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 SPLNBR SPLFILE ALL LAST Spool File Number Specifies the number of the spooled file from the job whose data records are to be selected If ALL is coded then all file numbers are considered This parameter is only valid when the SFJOBNAM parameter or SPLFILE are used This parameter is used along with all the other Spool File selection parameters to determine the spool files to select The allowable values are ALL This is the
225. or FRESHEN or UPDATE Explanation PKZIP is running with TYPE FRESHEN or UPDATE and could not read the archive file Review Job Log for other messages to determine cause 80 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0155 30 No files found for lt amp 1l gt in archive file for DELETE TYPE Explanation The file pattern specified for a PKZIP run with DELETE found no files that matched in the archive AQZ0156 00 Searching for files to include Explanation PKZIP searching for files that match entered file specifications AQZ0157 40 Library lt amp 1 gt cannot not be found Explanation PKZIP in an attempt to find file selections could not find a specified Library Review selection criteria in FILES and INCLFILE Run is terminated AQZ0158 40 File not found in Library amp 1 Explanation PKZIP in an attempt to find file selections could not find a specified file in a specific Library Review selection criteria in FILES and INCLFILE Run is terminated AQZ0165 00 File amp 1 exceeds 4 Gig and PKZIP is not running with GZIP YES File bypassed Explanation PKZIP is trying to compress file amp 1 in a standard archive parameter GZIP is NO and the sizes exceed 4 Gigabytes Use GZIP YES to compress AQZ0201 00 PKUNZIP Archive 6 amp 1 Explanation PKUNZIP Informational Currently processing Archive file amp 1 AQZ0203 10 Caution File name not matched 4 amp 1 Explan
226. or exact cause This indicates a major archive failure for PKZIP to process Review all messages and run PKUNZIP with TYPE TEST to see if there are more details This may indicate that current archive is incomplete or corrupted AQZ0004 40 Out Of Memory 4 amp 1 amp 2 Explanation While trying to allocate memory in PKZIP or PKUNZIP a failure occurred and no memory was granted Check other messages in Job Log possible causes and refer to Appendix C about memory errors If this continues please contact the Product Ser vices Division at 1 937 847 2687 for assistance AQZ0005 40 Logic Error amp 1 42 Explanation This message should never occur If it does it may be due to a corrupted Archive file Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0006 40 Error opening temp archive file lt amp l gt Explanation While trying to process PKZIP a failure occurred opening the temporary Archive file lt amp 1 gt Review other messages with PKZIP and the iSeries for more details of why the failure occurred Attributes used were amp 2 AQZ0009 40 User interrupt or termination amp 1 amp 2 Explanation PKZIP encountered a request to terminate If it continues to be unknown please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0010 40 Error using temp file 4 amp 1 amp 2 Explanation While trying to process PKZIP a failure occurred with the temporary Archive file
227. or non translatable text characters using the active text translation table If any characters will not translate successfully using this method the entire file will be treated as if BINARY has been used Note One exception to this is X 00 or the NULL terminator character which is commonly used in C language The NULL character will be allowed within the files If it is unknown if the file in the ZIP Archive is text or binary the user may use the TYPE VIEW and VIEWOPT DETAIL parameters to examine the file attributes File Attributes Within each ZIP Archive there are two different directories providing information about the files held in that archive A Local Directory is included at the front of each file with information pertaining to it for example file size and date ZIPPED and a Central Directory is located at the end of the ZIP Archive The Central directory lists the complete contents of the ZIP Archive and is the primary source of information for UNZIP processing PKZIP for OS 400 will store extended attributes about the file that can be useful in recreating the file during UNZIP processing See Chapter 8 Extended Attributes for more details 16 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Chapter 6 OS 400 File Processing Support PKZIP for OS 400 can support files maintained in both the traditional QSYS Library file system and in IFS Integrated File System and Spool files QSYS Library File Syst
228. or the purpose only for which it is supplied It must not be reproduced in whole or in part or used for tendering purposes except under an agreement or with the consent in writing of PKWARE of Ohio Inc and then only on condition that this notice is included in any such reproduction No information as to the contents or subject matter of this document or any part thereof either directly or indirectly arising there from shall be given or communicated in any manner whatsoever to a third party being an individual firm or company or any employee thereof without the prior consent in writing of PKWARE of Ohio Inc Copyright 2003 PKWARE of Ohio Inc All rights reserved ii PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Preface The PKZIP family of products consists of high performance data compression software The archives resulting from compression by PKZIP for OS 400 can be transported or transmitted to other operating system platforms where they will undergo decompression by PKUNZIP or an acceptable substitute About this Manual This manual provides the information needed to utilize PKZIP for OS 400 in an operational environment It is assumed that people using this manual have a good understanding of Control Language CL and dataset processing Note that the contents of this manual applies to the following operating systems e 0S 400 e iSeries e Chapter 1 An Introduction to PKZIP for OS 400 provides a general description of the
229. ormat If the OS 400 command prompt screen is to be used the command format is simply PKZIP There also a command PKZSPOOL which is the same command as PKZIP but has the parameter TYPFL2ZP set to SPL for spool files The parameters are also re sequenced for importance of Spool Files The command prompt screen is displayed when ENTER or PF4 is pressed The parameter keywords are displayed on this screen together with the available keyword options The required options can be selected before PF4 is pressed to accept the selections If the command and parameter keywords are entered together on the command line the required format is PKZIP keyword1 option keyword2 option keywordn option Keywords are demarcated by spaces The keyword ARCHIVE is the only positional keyword where the keyword is not required Whenever the word path is used its meaning depends on the file system that is being used If IFS is used path refers to the openness true path type If the Library systems or DB is used path means Library file and then the file name refers to the member name Refer to the individual parameter descriptions within this section for details The page number where com plete command details can be found is at the right of the command TYPE ADD CVTFLAG NONE UPDATE 400 FRESHEN External Pgm Conversion Flags MOVEA MOVEF CVTTYPE NONE MOVEU DROP DELETE SUFFIX VIEW
230. ory is the first directory in which the operating system locates files and it also stores temporary files and output files When you request an operation for an object such as a file the system searches for the object in the current directory unless a different directory path is specified The current directory is similar in nature to the current library If the file selection does not start with Root Directory the files should be in the path of the current directory Path and Path names A path name also called a pathname on some systems informs the system how to locate an object The path name is expressed as a sequence of directory names followed by the name of the object Individual directories and the object name are separated by a slash character An example might be directory 1 directory2 file For convenience the back slash 1 can be used instead of the slash in integrated file system commands There are two ways of indicating a path name e An absolute path name begins at the highest level or root directory which is identified by the character For example consider the following path from the directory to the file named Testit mydept myfiles testit e If the path name does not begin with the character the system assumes that the path begins at your current directory This type of path name is called a relative path name For example if your current directory is mydept and it has a sub directory named my
231. ossible Encryptions are ZIPSTD AES128 AES192 AES256 Usage Notes This algorithm is the original algorithm used in PKZIP 2 x products and is compati ble with other PKZIP 2 04g products that support standard encryption Unless the installation defaults module has been tailored differently this is the default value for the product if you choose to encrypt a file A PKZIP exclusive implementation of the AES 128 bit key algorithm AES stands for Advanced Encryption Standard also known as Rijndael will be used A PKZIP exclusive implementation of the AES 192 bit key algorithm AES stands for Advanced Encryption Standard also known as Rijndael will be used A PKZIP exclusive implementation of the AES 256 bit key algorithm AES stands for Advanced Encryption Standard also known as Rijndael will be used e PKUNZIP will detect automatically which encryption method was specified during the ZIP process and operate accordingly e During a PKZIP ZIP run only 1 encryption method may be specified and that method will be used for each file that is operated e By executing PKZIP at different times various files within the Archive may be saved with differing levels and types of protection That is some files may not be protected at all while others may have different methods and or passwords e A character is shown in a View to indicate Standard Encryption protection is used for a file e A character is shown in a
232. ow supports using a member FIRST or LAST for a member when using the QSYS file system PKZIP now recognizes the older physical files with attributes of PF38 System 38 physical files Parameter CVTDATA is added to PKZIP and PKUNZIP commands and CVTNAME program changed to accept 4 variables Old File Name New File name CVTFLAG and CVTDATA PKZIP and PKUNZIP will issues STATUS message for completion messages so they can be moni tored The following message can now be monitored AQZ0012 PKZIP ending with Nothing to do for lt amp 1 gt AQZ0020 PKZIP Completed Successfully AQZ0022 PKZIP Completed with Errors AQZ0037 PKUNZIP Completed Successfully AQZ0038 PKUNZIP Completed with Errors Fix security authorization when creating a new directory or folder in the IFS so that authority is inherited from directory above When only the file name is used in FILES parameter for selection PKZIP was defaulting to CURLIB This has been revised per documentation to use LIBL as the default When creating a file in the Integrated File System the file will be created with attributes of directory that is created in plus owner of the PKUNZIP run PKZIP revised to include files with attribute DDMF and file type DDM while searching for files in the selection parameters Added translation code tables 850 ASCII and 037 EBCDIC to PKZIPTABLES file PKZ850037 PKZCHGOWN CLP program source is provided in the source file QCLSRC file to
233. pecify a 5 byte flag that is passed to the exit program CVTNAME to control the program logic If the name passed back is blank then conversion is referred back to the setting of the CVTTYPE parameter Chapter 10 PKUNZIP Commands 55 CVTTYPE CVTTYPE NONE DROP SUFFIX Specifies how the files names in the archive will be converted to a file name in the iSeries Library File and Member format In the iSeries QSYS Library system the length of each name in the QSYS format can only be up to 10 characters In other platforms the file name formats including MS DOS may have an extension with a period separator which is not valid in the iSeries DB Name The file names in some cases may even exceed the 10 character limit This parameter gives control over the file name conversion process Note The conversion of file names may result in duplicate file names on the iSeries system In this case the rules for overwriting the files are in effect for duplicates see the OVERWRITE option If this is the case using specific file inclusion and exclusion with multiple runs may be required to extract all of the files The allowable values are SUFFIX This forces the removal of the period extension and stores name truncating characters over 10 characters NAMEFILE _ The extensions are considered to be file names or treated as a slash DROP Drops all characters after the period extension separator and stores the name truncating c
234. pire in 30 days on 20021214 Database File Handlers Evaluation set to expire in 30 days on 20021214 IFS File Handlers Evaluation set to expire in 30 days on 20021214 GZIP Evaluation set to expire in 30 days on 20021214 Advanced Encryption Evaluation set to expire in 30 days on 20021214 Spool Files Evaluation set to expire in 30 days on 20021214 License File PKZ550430 PKZLIC PKZLIC Updated successfully Press ENTER to end terminal session PKOU V5R5000 130 PKZIP OS 400 5 5 User s Guide Licensed Types The license key will be comprised of codes to reflect the license types selected by the customer The following list contains the types of licensing available Type Description Use BASIC CAPACITY DISASTER RECOVERY ENTERPRISE FEATURES The BASIC license type is the base line It represents a license for which there are no restrictions other than time In contrast all other license types define restrictions within which the application is licensed and the customer is to abide The CAPACITY license type compares the capacity of the operating environment as defined by the machine serial number along with a predefined table For instance to ensure the application is running on a machine whose computing capacity is not larger than for what the product is licensed for A DEMO license is typically restricted to a certain time period number of executions or limited set of function
235. planation Informational only PKUNZIP is in the process of extracting file amp 1 AQZ0036 00 PKUNZIP extracted amp 1 files Explanation Informational only PKUNZIP reports the number of files that were extracted in this run 72 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0037 00 PKUNZIP Completed Successfully Explanation Informational Only PKUNZIP completed with no errors This message can be monitored using MONMSG AQZ0038 40 PKUNZIP Completed with Errors Explanation During a run of PKUNZIP errors were encountered Some processing may or may not have completed Review the preceding messages for further details AQZ0038 message will be issued as an Escape message type Escape messages indicates a condition causing PKUNZIP to end abnormally without completing its work This message can be monitored using MONMSG AQZ0039 00 PKUNZIP found amp 1 file s in Error Explanation The run of PKUNZIP found amp 1 files with some type of error resulting in these files not being processed Consult the job log to discover why these files were in error AQZ0040 10 PKUNZIP skipped amp 1 file s Explanation PKUNZIP skipped the files due to target files already existing on the system and the parameter to OVERWRITE was set to NO which informs the system not to overwrite any file that already exists AQZ0041 00 Searching GZIP Archive amp 1 for files to extract Explanation Informational only PKZIP
236. ple CVTNAME 148 Sample GZIP Processing 67 SAVF 22 28 SBCS 174 Service Pack 174 SFFORM 46 SFJOBNAM 47 SFQUEUE 46 SFSTATUS 47 Index 183 SFTARGET 47 SFTGFILE 48 SFUSER 46 SFUSRDTA 46 Source File 174 Source File Considerations 32 Spanned Record 174 Special Note on GZIP Passwords 65 SPLF Attributes 161 SPLFILE 48 SPLNBR 49 SPLUSRID 61 Spool File 174 Spool File Selections 161 SPOOL Files 23 Standard IFS Attributes 28 33 Standard Library Name 158 Standard QSYS Library File System Attributes 27 STOREPATH 49 Stream File 174 Stream Files 18 System Library 175 System Processor 175 System 36 Environment 175 System 38 Environment 175 T Tape Cartridge 175 Tape Drive 175 Tape Volume 175 Temporary Archive File 25 Test Library 175 Text Records 15 Time Stamp 175 TIME DELIMITED 131 Time Sharing Option 175 TMPPATH 49 To overwrite a current SAVF file 22 TRAN 50 61 Translation Table 175 Translation Table Layout 154 Translation Tables 153 Trial Period 129 Trigger 175 Truncate 175 TYPARCHFL 50 62 TYPE 36 54 184 PKZIP OS 400 5 5 User s Guide TYPFL2ZP 50 62 TYPLISTFL 50 62 UDFS 19 Unit 175 Universal Time Coordinated UTC 176 Unloading PKZIP for OS 400 from a CD ROM 9 Unloading PKZIP for OS 400 from Tape 9 USASCII 154 155 Use of SAVF Method 8 User Interface 176 User Defined File System 19 U
237. pool file attributes will be used when extracting files Outq The specific OUTQ that will used when the spool file is extracted It must be a valid Output Queue Qutq Library The library where the OUTQ resides SPLUSRID SPLUSRID DFT User ID The user ID to use when extracting a Spool File If DFT is used the User ID belonging to the spool file will be used when building the spool file The allowable values are DFT Use User Id associated with spool file in the archive User ID Specify a valid user ID that the new extracted spool file will belong to It must be a valid User ID on the OS 400 Note on extracting Spool Files To create or extract spool file with PKUNZIP the user must have USE authority to the API ASPCRTSP The normal setting for the API QSPCRTSP is Authority PUBLIC EXCLUDE The API authority is set this way so that system administrators can control the use of this API This API has se curity implications because you can create a spooled file from the data of another spooled file To allow user to extract spool files change the API authority on a need basis TRAN TRAN INTERNAL Member Name Specifies the translation table for use with translating data from the Series EBCDIC character set to the character set used in the archive file normally the ASCII character set A default internal table is prede fined see Appendix F Translation Tables INTERNAL Use the predefined internal table for tra
238. pressed lt also allows ZIP archives and List Files to be stored and processed in a stream file format in the IFS This licensable module allows a user to read and write GZIP compatible files GZIP files created using PKZIP for OS 400 can be extracted with any compatible GZIP utility on any other platform Advanced Encryption This licensable module allows a user to compress and extract files with Advanced Encryption Advance Encryption Standard Spool File Handler This licensable module allows a user to compress and extract Spool files The module also allows the Spool File to converted another format 132 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Licensing Environment PKZIP for OS 400 contains a series of processes that will update the current user license allow reporting of license information allow conditional use during a disaster recovery and allow conditional use during a modification of the customer s physical environment Current Use License To allow processing of files and archives the license key must be made available to PKZIP for OS 400 The license file is updated by INSTPKLIC to reflect the license types and product codes that have been selected by the customer This is accomplished by contacting your dealer and obtaining the valid license records After receiving the licensing information from your dealer you must update them in the license input file PKZLICIN for member PKWARELIC This can be done
239. problem Do a PKUNZIP with VIEWOPT DETAIL Verify the source of the archive that is being processed to verify if it was created using a compression product from PKWARE Inc Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0469 40 Error Not enough memory to amp 1 amp 2 Explanation While attempting to uncompress file amp 2 using method amp 1 PKUNZIP could not allocate enough memory to extract file Check other messages in Job Log for possible causes and refer to Appendix C about memory errors If this continues please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0470 40 amp 1 Out of memory while inflating EAs Explanation While extracting file amp 1 an allocation of memory failure occurred while trying to extract and file with EAs attributes This archive was created by another system type Check other messages in the Job Log for possible causes and refer to Appendix C about memory errors If this continues please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0471 40 amp 1 Unknown error on extended attributes Explanation While extracting file amp 1 an unknown error occurred while trying to process the Ex tended attributes data This archive was created by another system type AQZ0472 40 Unsupported extra field compression type amp 1 skipping Explanation The Extended data fields for file amp 1 was found but is not recog
240. put file amp 1 Review all job log messages to determine cause of read error Job is terminated AQZ0409 40 Failure during user space creation amp 1l Explanation A failure occurred while using an API which required a user space that failed See message amp 2 in job log for which API and why the failure occurred Job is terminated AQZ0410 40 API list command failure due error amp 1 amp 2 Explanation Review error message amp 1 for more information why API list command amp 2 failed Job is terminated AQZ0411 40 File amp 1 is not a database Explanation A List Member API was issued for file amp 1 A return message CPF3C23 indicates this file is not a database file which is allowed to have members Review file amp 1 to ensure it is a valid file to compress Job is terminated AQZ0412 00 API error amp 1 Get Member descriptions lt amp 2 gt Explanation While issuing a Get Member descriptions for file amp 2 error amp 1 occurred Review message amp 1 for more information AQZ0413 00 API error amp 1 Database File descriptions lt amp 2 gt Explanation While retrieving the file descriptions for file amp 2 error amp 1 occurred Review message amp 1 for more information 94 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0414 00 API error amp 1 Get Object descriptions lt amp 2 gt Explanation While retrieving object descriptions for file amp 2 error amp 1 occurred R
241. r OS 400 to compress and extract data PKZIP for OS 400 in producing GZIP Archives implements two GZIP standard specifications e RFC 1952 GZIP file format specification Version 4 3 which documents the GZIP specifications and the format of a GZIP Archive file e RFC 1951 DEFLATE Compressed Data Format Specification Version 1 3 which documents the compression algorithm used by GZIP processing The RFC is a process to promote specifications and standards throughout the Internet community and can be found at www fags org rics Both RFC 1952 and RFC 1951 specifications are platform independent therefore data that was compressed on one platform for example UNIX may be decompressed on an other platform for example iSeries or MVS The one significant advantage of GZIP Archive files over ZIP archive files is the ability to handle larger greater than 4 Gb file sizes The standard ZIP archive format restricts processing to uncompressed files that are less than 4 Gb and cannot create an archive containing multiple files that would meet or exceed the 4 Gb limit These restrictions are due to the size of the specified fields 4 byte fields that contain the file size information within the archive The GZIP Archive format see RFC 1952 can process files of any size This format does not maintain a directory of information for individual files and allows sizes to wrap at 4 Gb therefore it does not suffer from size restriction GZIP
242. rameters Explanation Errors were found while processing the input control records in the License Install program License file was not updated Review Job Log for previous message which indicates why the file was not updated AQZ9062 40 More than 1 control code 55 record Run terminated Explanation Only one Customer Control Record beginning with 55 is allowed in the License Control Program Job will be terminated Review Input Control file for control records AQZ9063 40 Control Record 55 must be 1st non comment record Explanation The first control record non comment in the License Control input file must the Customer Control Record beginning with 55 Job will be terminated AQZ9064 40 Invalid Feature Code lt amp 1l gt in Position 1 amp 2 Explanation In positions 1 and 2 of the License control record is the Feature Code The License Install Program found the invalid Feature code of amp 1 The License File will not be updated AQZ9065 40 Invalid Date lt amp 1 gt on record amp 2 Explanation An Invalid Feature Date on control record number amp 2 was found Date must be YYYYMMDD format with valid month and day The License File will not be updated AQZ9066 40 An error has occurred in validating the Customer Number amp 1 Contact your Dealer Explanation The Customer Number amp 1 was found to be Invalid Contact your dealer for correct codes The License File will not be updated AQ
243. rchive comment will be displayed but ANSI control codes in this comment will not be masked out This could cause attribute changes on the iSeries display Archive file date con DOS options control whether the ZIP file date is updated or retained when al trols PKZIP tering the archive Because the last used date on OS 400 is not under pro gram control or alterable by a command these options are not supported Archive Comments DOS options allow editing of comments for individual files in an archive This PKZIPO version supports editing of a file s text description but is not recommended for batch running or for a large number of files due to the interactive message responses required File naming differences The files used in the QSYS library file system have their own naming style Each file associated with a library file and members would be depicted as library file member Usually all file names are stored as open system file names with directories ending with a file name For a detailed description and techniques see Chapter 6 OS 400 File Processing HELP PKZIP for DOS has options to display a list of commands Because PKZIP for OS 400 uses OS 400 commands the help system is built for each command and is activated by PF1 on each parameter Mixed Case Filenames When using the IFS Integrated File System the file names are case sensitive and act like other file systems UNIX DOS Windows etc When using the QSYS Libra
244. rent directory Full Path Directory1 Directory2 filenam e For more information see reference IBM publication Integrated File System Introduction SC41 5711 or visit the IBM web site SAVF SAVF denoted by the OS 400 system TYPE FILE and ATTR SAVF are a special form of file designed specifically to handle save restore data in the iSeries system Some SAVF special characteristics are e The SAVF is always processed as binary with all records being 528 characters in length e The only way to create a SAVF is to use the CRTSAVF command e The only way to overwrite a SAVF is to first use the CLRSAVF command e Only asave and restore iSeries function can update or change data e A SAVF will not be selected if a member name is included in the file specification SAVF are a means to compress other Series object types programs modules commanas logical files triggers etc that are in the iSeries system by first doing a SAVLIB or SAVOBJ for those objects to a SAVF Then you can compress and extract the SAVF Compressing a SAVF file The only difference when compressing a SAVF is not to specify a member only library file If a member is specified then no SAVF types will be compressed Extracting Records into a SAVF file It is helpful before extracting records from a ZIP Archive to be aware of what file names and file attributes are being stored for the compressed file VIEWOPT DETAIL may be used on the Archive to ver
245. rograms on other operating systems Glossary 167 Cyclic Redundancy Check CRC A Cyclic Redundancy Check is a number derived from a block of data and stored or transmitted with the data in order to detect any errors in transmission This can also be used to check the contents of a ZIP archive It s similar in nature to a checksum A CRC may be calculated by adding words or bytes of the data Once the data arrives at the receiving computer a calculation and comparison is made to the value originally transmitted If the calculated values are different a transmission error is indicated The CRC information is called redundant because it adds no significant information to the transmission or archive itself It s only used to check that the contents of a ZIP archive are correct When a file is compressed the CRC is calculated and a value is calculated based upon the contents and using a standard algorithm The resulting value 32 bits in length is the CRC that is stored with that com pressed file When the file is decompressed the CRC is recalculated again based upon the extracted contents and compared to the original CRC Error results will be generated showing any file corruption that may have occurred Cylinder The tracks on a disk or diskette that can be accessed without movement of the read write arm and head Data Compression The reduction in size or space taken of data volume on the media when performing a save or store oper
246. ry file system the file names are always in UPPER CASE Occasionally when trying to update and archive or select from an archive you may encounter a case sensitive search Use PKUNZIP view to get the exact name stored This would be appropriate when doing a PKZIP TYPE DELETE where the selection file would need to match Use of SAVF Method At this time only physical files with attributes of PF DTA PF SRC and SAVF in the QSYS file system Stream files in the IFS and Spool Files can be processed by PKZIP for OS 400 Also some special Database functionality such as Triggers File Constraints Alternate Collating Sequence and such are not stored in the Archives To overcome some of the restrictions listed above PKZIP for OS 400 can compress and decompress SAVF The objects to be compressed are saved to a SAVF using SAVOBJ or SAVLIB The SAVF is then compressed to an archive using PKZIP To restore the data first use PKUNZIP to re create the SAVF then use RSTOBJ or RSTLIB to restore objects from within the decompressed SAVF SAVF are binary and only pertain to OS 400 8 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Chapter 3 PKZIP for OS 400 Installation This chapter describes the process of receiving PKZIP for OS 400 either by tape CD ROM or by FTP The process consists of building the PKZIP for OS 400 version library adding the library to your library list and running the Install License command with an A
247. ryption Note 1 PKZIP for MVS Version 5 5 supports the following operating sys tems MVS ESA 4 2 and above OS 390 and z OS Note 2 PKZIP supports advanced password encryption for the following types of UNIX Sun Solaris 2 6 and above HP UX 10 20 and above IBM AIX 4 3 and above Intel Linux based on 2 4 kernel PKZIP for OS 400 uses AES which is the official US Government standard for encryption The AES algorithm was approved as the Federal Information Processing Standard by the Commerce Department on May 26 2002 The Rijndael the name combination of the two researchers who developed Rijndael Dr Joan Daeman and Dr Vincent Rijmen algorithm uses a combination of advanced security performance efficiency ease of implementation and flexibility to make it an appropriate standard of advanced encryption for the AES Rijndael performs consistently in both hardware and software and in cross platform environments regardless of its use in feedback or non feedback modes Rijndael s key setup time is very good and its key agility is excellent Memory requirements are very low making it the first choice for restricted space environments in which it also demonstrates high performance Power and timing attacks are easily defended against due to Rijndael s operations Note that the AES was intentionally developed to replace DES Chapter 1 Introduction to PKZIP OS 400 3 AES Key Sizes Curr
248. s These licenses may allow other types of use This license is also known as Try and Buy or Supply before Buy Terms and conditions can be an added restriction to any of the license types A DISASTER RECOVERY license is granted by the vendor to allow a specified product to execute under conditions defined as disaster recovery for a specified period of time or for a specified number of occurrences These terms and conditions can be an added restriction to any of the license types An ENTERPRISE license assigned to an enterprise which may be comprised of multi ple sites complexes nodes and or serial numbers It is an all encompassing license to a single entity These terms and conditions are derived from any of the license types A packaging and enablement option An optional feature of a product can be packaged licensed and enabled at the discretion of the software publisher Features can be licensed in the same manner as software products and can be of any license type The customer will receive a predetermined set of product features The customer will designate the serial number of the processor s To run PKZIP for a DEMO or trial period a license file must be established by contacting PKWARE Sales at 1 937 847 2374 Implemented with a 5 day grace period to allow the customer to contact PKWARE Inc to update the license The grace period will never expire on a weekend Allows a customer full access t
249. s System VERBOSE VERBOSE NORMAL NONE ALL MAX Specifies how the detail will be displayed during a PKUNZIP run The allowable values are NORMAL Displays most informative message to show PKUNZIP is processing NONE Displays only major exception information ALL Displays all messages MAX Used only for debugging purposes 62 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 VIEWOPT VIEWOPT NORMAL DETAIL BRIEF COMMENT Specifies the level of information produced when viewing the archive The allowable values are NORMAL Shows the Original File Length Compression Method Compressed Size Compression Ratio File Date and Time 32 bit CRC value and File Name for each file in the archive DETAIL Shows very detailed technical information about each file in the archive It will also show all extended attribute extra data fields information that was stored in the archive produced by PKZIP only if the PKZIP keywords EXTRAFLD YES or DBSERVICE YES were specified BRIEF Shows the Original File Length File Date and Time and File Name for each file in the archive COMMENT Same as the NORMAL option but also shows any file comments stored on a separate line after its details VIEWSORT VIEWSORT ASIS DATE DATER NAME NAMER PERCENT PERCENTR SIZE SIZER Specifies the sequence of the viewing display The allowable values are ASIS DATE DATER NAME NAMER PERCENT PERCENTR S
250. s a Status message type Because the messages are issued as a Status type they can be monitored with the MONMSG command in CL programs The message numbers that are issued as Status message types are AQZ0012 PKZIP ending with Nothing to do for lt amp 1 gt AQZ0020 PKZIP Completed Successfully AQ20037 PKUNZIP Completed Successfully EXAMPLE Msg ID Severity Code Message Text AQZ0109 00 Compressing amp 1 in 2 mode Explanation Informational Compressing has started for the file with a specified mode The modes are 1 SAVF 2 DATABASE 3 BINARY 4 TEXT and 5 Text in EBCDIC The Message text 81 will be the file name and amp 2 will be the mode such as Compressing TESTLIB TESTFILE TESTFILE in TEXT mode AQZ0001 AQZ0799 Messages AQZ0001 00 PKZIP 6 amp 1 82 Explanation This message is used in conjunction with other messages to provide extended information See Messages preceding 68 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0002 40 Unexpected End of File 4 amp 1 amp 2 Explanation While reading an Archive file in PKZIP an unexpected End of File was encountered The file may not have been created properly or copied to completion Try running the TYPE TEST to see it can identify more information and review all other messages AQZ0003 40 Archive file Structure Error l amp 2 Explanation This message is associated with the previous message f
251. s choice The user creates and manages this file system See IBM s Integrated File System Introduction SC41 5711 for additional information PKZIP for OS 400 works with all file systems but the rules of each file system must be adhered to or a File I O error will most likely occur In most cases the files can be compressed and extracted in one run when all the file names and paths meet the file system s rules When creating an archive file in one file sys tem one restriction is that when using the TMPPATH option the temp path must also be in the same file system as the archive files On the following pages are rules for some of the most used file systems Chapter 6 OS 400 File Processing Support 19 Document Library Services File System QDLS The QDLS file system supports the folders structure It provides access to documents and folders Additionally it supports iSeries folders and document library objects DLOs and supports data stored in stream files Considerations and Limitations 1 You must be enrolled in the system distribution directory when working with objects in QDLS 2 QDLS converts the lowercase English alphabetic characters a through z to uppercase when used in object names Therefore a search for object names using only those characters is not case sensitive All other characters are case sensitive in QDLS 3 Each component of the path name can consist of just a name such as QDLS MYFLR1 MYDOC1 or
252. sers may select any available translation table by using TRAN and FTRAN parameters PKZIP for OS 400 extracts text records stored in the ZIP Archive by examining data for record delimiter and file terminator indicators Using these indicators PKZIP for OS 400 aligns records in accordance with target file attributes Text files such as program source code are held within an archive using the ASCII character set for compatibility with other versions of PKZIP For these to be usable on OS 400 they must be converted to the IBM EBCDIC character set Additionally the carriage return and line feed characters must be removed before writing lines to a file because OS 400 files are record based and do not use control characters to separate records or lines Text files usually have spaces at the end of a line When using the text file handlers PKZIP for OS 400 has less data to read because the input output routines remove trailing spaces and replace them with a new line character This improves PKZIP for OS 400 performance When extracting files from an archive PKZIP for OS 400 must know whether to perform text conversions PKZIP for OS 400 stores an indicator in the archive file s local header defining if a file is binary or text based Because this indicator may be wrong in some circumstances use the FILETYPE keyword to specify whether text conversions are required When adding files to an archive PKZIP for OS 400 will flag the
253. sical Attributes For more information see the CRTPF and CHGPF commands or IBM Publications Attribute Description 1 File Record Format The name of the file s Record Format 28 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Attribute Description File Record Text The Text description for the File s Format Maximum Number of Mem bers Specifies the maximum number of members that the physical file being created can have at any time Number Fields The number of fields in the database Number of keys The number of key fields in the database SIZE nbr Records SIZE parameter option The number of records that can be inserted before an automatic extension occurs SIZE increment value SIZE parameter option Value for the number of additional records SIZE number of increments SIZE parameter option Maximum number of parts to be added automatically to the member Public Authority AUT Specifies the authority given to users who do not have specific authority to the physical file Note If an authorization list was specified for the file then AUT is set to CHANGED vSee Database Attributes Considerations 10 Record Description CCSID The Coded character set identifier for the Record description 11 Delete Percent DLTPCT Specifies the percentage of deleted records a file can contain before you want the s
254. sing FTP to AS 400 10 Using List Files as Input 152 Using ASYS LIB Through the Integrated File System Interface 21 UTC 176 Variable Length 176 VERBOSE 51 62 View Basic 136 View Demo 136 View Enterprise 137 View Single 137 View Single with Exception 138 VIEWOPT 51 63 VIEWSORT 51 63 Volume 176 Volume Label 176 Volume Table of Contents VTOC 176 VTOC 176 Ww What is the Life Expectancy of AES 4 Windows NT Server file system 19 Z ZIP Archive 176 ZIP Archives 1 25 ZIP Files 15 ZIP Processing File Selection 12 PKOU V5R5000
255. ssistance AQZ9100 40 Compression Feature is not licensed for this Serial Number Run will not be processed Explanation PKZIP could not validate the Compression License Feature Obtain proper Licensing keys from your reseller and run INSTPKLIC See Message AQZ9087 for more contact information AQZ9101 40 Decompression Feature is not licensed for this Serial Number Run will not be processed Explanation PKZIP could not validate the Decompression License Feature Obtain proper Licensing keys from your reseller and run INSTPKLIC See Message AQZ9087 for contact information Chapter 12 Messages 127 AQZ9102 40 GZIP Feature is not licensed for this Serial Number Run will not be processed Explanation PKZIP could not validate the GZIP License Feature Obtain proper Licensing keys from your reseller and run INSTPKLIC See Message AQZ9087 for more contact information AQZ9103 40 IFS File Handlers Feature is not licensed for this Serial Number Run will not be processed Explanation PKZIP could not validate the IFS File Handlers License Feature Obtain proper Licensing keys from your reseller and run INSTPKLIC See Message AQZ9087 for more contact information AQZ9104 40 Database File Handlers Feature is not licensed for this Serial Number Run will not be processed Explanation PKZIP could not validate the Database File Handlers License Feature Obtain proper Licensing keys from your reseller and run INSTP
256. such as EBCDIC will stay EBCDIC The length of binary records in UNZIP processing is determined by the archive s fixed length records PKZIP for OS 400 will fill the available block automatically according to allocation specifications In the context of ZIPPED Archives a text file is one that is stored in the ASCII format A text file contains records of data each separated by a delimiter to signify the end of the record Note An EBCDIC file containing text information such as source code can be stored in its original format by using BINARY but it is not considered to be a text file within the ZIP architecture PKZIP for OS 400 uses the default line delimiter CR LF x 0D0A at the end of each text record Text File members in the QSYS Library file system use new line characters NL X 15 internally PKZIP for OS 400 will handle the CR LF and NL in both extraction and compressions automatically At the time of PKUNZIP file extraction PKZIP for OS 400 will convert text data from ASCII to EBCDIC by using a translation table During installation several translation tables are available and the customization process will select one of the translation tables as a default Additional translation tables may be created through the customizing procedure Situations may arise in unique platform interchanges or when working with text files from other countries where the default text translation table is not adequate U
257. t will be used for the input list file and or the output list file of selected items To use input list files see parameters INCLFILE file section list or EXCLFILE file exclude list To create an output list file of the selected file items see parameter CRTLIST DB Files are in the QSYS Library file system IFS Files are in the IFS Integrated Files System VERBOSE VERBOSE NORMAL NONE ALL MAX Specifies how the detail will be displayed during a PKZIP run The allowable values are NORMAL Displays most informative message to show PKZIP is processing NONE Displays only major exception information ALL Displays all messages MAX Used only for debugging purposes VIEWOPT VIEWOPT NORMAL DETAIL BRIEF COMMENT Specifies the level of information produced when viewing the archive The allowable values are NORMAL Shows the Original File Length Compression Method Compressed Size Compression Ratio File Date and Time 32 bit CRC value and File Name for each file in the archive DETAIL Shows detailed technical information about each file in the archive It also shows all extended attribute extra data fields information that was stored in the archive produced by PKZIP only if the PKZIP keywords EXTRAFLD YES or DBSERVICE YES were specified BRIEF Shows the Original File Length File Date and Time and File Name for each file in the archive COMMENT Same as the NORMAL option but also shows any
258. tered for the file If the file is a Spool Files the code page 819 will be used This is the default Code Page The PKZIP program will read IFS files with the specified code page value If the file is a spool file it is the code page that a spool file will use for ASCII translation INCLFILE INCLFILE NONE path filename This parameter specifies the file containing the list of files to be selected for inclusion This can be used with or without the FILES parameter See parameter TYPLISTFL for file system type information NONE No Include list file will be processed This is the default path filename Enter the file path and name of the file to process The layout depends on which file system you want to create the file in Library File System The format is Library File Mbr Integrated File System IFS The format is path1 path2 pathn filename MSGTYPE MSGTYPE PRINT SEND BOTH Specifies where the display of messages and information should be shown The PKZIP program has the ability to send messages that appear on the log and or the ability to print to stdout and stderr If working interactively stdout and stderr will show upon the dynamic screen If submitted via batch you can override them to print in an OUTQ or build a CL and save them to an outfile SEND Send the information to the log with send message commands PRINT Send the information to stdout and stderr BOTH Send the information to the log with
259. th keyword formats and details e Chapter 10 Provides a summary of all of the PKUNZIP commands that provides parameters with keyword formats and details e Chapter 11 Provides a description of the GZIP format archive and the GZIP processing supported by PKZIP for OS 400 e Chapter 12 Provides a description and a summary of all of all of the system generated messages e Glossary Contains a glossary of OS 400 specific terms e Index Contains a detailed list of terms and their locations within this document This manual is intended for persons responsible for implementing and using PKZIP Version 5 5 for OS 400 The manual assumes that the reader has a good understanding of CL and dataset processing Conventions Used in this Manual Throughout this manual the following conventions are used The use of the Courier font indicates text that may be found in control language CL parameter controls or printed output The use of italics indicates a value that must be substituted by the user for example a dataset name It may also be used to indicate the title of an associated manual or the title of a chapter within this manual Bullets indicate items or instructions in a list The use of lt angle brackets gt in a command definition indicates a mandatory parameter The use of square brackets in a command definition indicates an optional parameter A vertical bar in a command definition is used to separate mutually exclusiv
260. the desired method if the source members are being transferred to another platform or if the sequence number and changes dates are not important This method would also give the best results for the total size of the archive If the sequence numbers and change dates are to be preserved then you would use DBSERVICE YES to store this source file as a database file This would not work very well on non EBCDIC platforms because the data is stored in binary mode with no EBCDIC to ASCII translation The problem is that each member will have all available database attributes This is still minimal because there are only three fields for a source database 32 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Spool File Attributes When the files being compressed are from a spool file the standard attributes are Attribute Description 1 Spool File Type Device Type SCS AFP etc 2 Target Output Type The type of file that was archived or converted Spool File Text or PDF 3 Internal Job and spool ID Internal Job and Spool codes controlling the spool file 4 Spool File description The description of the file using the file name file number job user and job number 5 Pages Number of pages in the spool file 6 Code Page The cod page the was used to convert the spool file to TEXT or PDF Chapter 8 Extended Attributes 33 Chapter 9 PKZIP Commands PKZIP Command Summary with Parameter Keyword F
261. the following considerations and limitations 1 File handling restrictions in the QSYS LIB file system are e Logical files are not supported e Physical files supported for text mode access are program described physical files containing a single field and source physical files containing a single text field Physical files supported for binary mode access include externally described physical files in addition to files supported for text mode access e fany job has a database file member open only one job is given write access to that file member at any given time Other requests are allowed read only access 2 In general the QSYS LIB file system does not distinguish between uppercase and lowercase in the names of objects A search for object names achieves the same result regardless of whether characters in the names are uppercase or lowercase If a name is enclosed in quotation marks the case of each character in the name is preserved A search involving quoted names therefore is sensitive to the case of the characters in the quoted name 3 Each component of the path name must contain the object name followed by the object type of the object For example QSYS LIB TESTLIB LIB MYFILE FILE MYFILE MBR The object name and object type are separated by a period Objects in a library can have the same name if they are different object types so the object type must be specified uniquely to identify the object 4 The object name in e
262. tion Verification Procedure IVP 169 Integrated File System 169 Interactive Job 169 International Code Page Support 153 Internet Protocol IP 170 Internet Protocol IP Address 170 Introduction to GZIP 64 Introduction to PKZIP OS 400 1 Invoking PKZIP for OS 400 Services 7 IO 170 IP 170 IVP 170 J Julian Date 170 K Kanji 170 Key Features 156 161 162 Key Field Attributes 32 Keyed Sequence 170 Keyword 170 Keyword Details 36 54 Label 170 LAC 170 Library file system 19 Library List 171 License Authorization Code LAC 171 Licensed Types 131 Licensing Environment 133 Licensing Requirements 129 Linkage Editor 171 List Files and their Usage 152 Logical Partition 171 LZ 171 Magnetic Tape Unit 171 Memory Errors 146 Messages 68 Monitoring Algorithm Security 4 MQSeries 171 MSGTYPE 45 60 PKOU V5R5000 Multithreading 171 N Name Processing 12 Network File System 19 New Features 5 New ZIP Archive 26 171 NFS 19 Non Standard Library Name 159 Null Value 171 n way Processor Architecture 171 O Old ZIP Archive 25 171 Open Systems file system 19 Operating Environment 158 Optical file system 19 Optical File System QOPT 20 OS 400 172 OS 400 File Processing Support 17 Other IFS Objects 18 Output 172 Output Queue 172 OVERWRITE 60 P Packed Decimal Format 172 Parameter 172 Parameter List 172 Partition 172 PASS
263. tion rather than by the system System Library The library shipped with the operating system that contains objects such as authorization lists and device descriptions created by a user Also included are system commands and other system objects required to run the system The system identifier is QSYS System Processor The operating system logic that contains the processor function to translate and process OS 400 control language commands and programming language statements System 36 Environment A function of the OS 400 operating system that processes most of the System 36 operator control language OCL statements programs and procedure statements to run System 36 application programs and allows the user to process the control language CL commands System 38 Environment A function of the OS 400 operating system that processes most of the System 38 operator control language OCL statements programs and procedure statements to run System 38 application programs and allows the user to process the control language CL commands Tape Cartridge A formed case containing a small reel of magnetic tape that can be put into a tape drive without stringing the tape between reels Tape Drive A hardware device that is used to read and write information on magnetic tapes or cartridges Tape Volume A single reel of magnetic tape May also be used to describe a single tape cartridge Test Library A user defined library used for debu
264. tion2 file specificationn EXDIR EXDIR CURRENT path If there are no paths stored in the archive file name EXDIR specifies the default path to store the files being extracted The path definition depends on the file system type in parameter TYPFL2ZP This will happen when the files come from a PC or if the files were compressed with PKZIP for OS 400 using the STOREPATH NO parameter If the file system type is IFS EXDIR will be the paths defined for your iSeries open systems and the default path will be the current directory settings issue the command DSPCURDIR to see the current directory settings Chapter 10 PKUNZIP Commands 57 If the file system type is the Library File System the path will be either a Library or a Library Filename The default is CURLIB UNZIPPED and if the file UNZIPPED does not exist then it is created with a record length of 132 It is best to create a default file with the record length of your choice because if a text file is extracted with a record length greater than the file s record length the record will be truncated to fit the record length If EXDIR is coded with keyword MBR and the file system is the QSYS Library system PKUNZIP will use the member name for the file name For example EXDIR newlib MBR and DROPPATH ALL parame ters are coded and the file name in archive is mylib myfile mymbr the file will be extract to the file newlib mymbr mymbr This is
265. to exclude selection Job is terminated Chapter 12 Messages 95 AQZ0450 40 Did not find end of central dir signature at end of central dir Explanation While scanning an archive for proper archive signatures the end of central dir signature could not be found Ensure it is a valid archive or if the archive was sent via FTP ensure Binary was used AQZ0451 40 Expected central file header signature not found file amp 1 Explanation While scanning an archive for proper archive signatures the expected central file header signature could not be found The archive may be corrupted or it was transferred from another source incorrectly AQZ0452 40 Attempt to seek before beginning of Archive file amp 1 Explanation While scanning the archive for valid information an offset caused PKZIP to attempt seeking functions prior to the beginning of the archive The archive may be corrupted AQZ0453 40 amp 1 Bad file comment length Explanation The archive indicated that a comment existed for file amp 1 The length was zero or the comment length was wrong Run PKUNZIP with Detail View for more information AQZ0454 40 Invalid option mixture should never occur by using PKUNZIP Command Explanation Please contact the Product Services Division at 1 937 847 2687 for assistance AQZ0455 40 Both Overwrite NONE and ALL specified ignoring ALL This should never Occur Explanation By using the PKUNZI
266. to restore the library manually First load the PKZIP for OS 400 CD into the optical unit and note the device name It is usually OPTO1 METHOD A LODRUN command At a command line type SLODRUN DEV OPT or gt LODRUN DEV optical device LODRUN will first display the following screen showing the default library with the version of PKZIP for OS 400 that will be installed from the CD The display will wait for a valid Library and the pressing of the Enter Key to install PKZIP for OS 400 If the F3 or F12 key is pressed the install will end without installing the product PKZIP for OS 400 TM Version V5 5 0 Install PKZIP for OS 400 TM to Library PKZ550430 Note Library Must Not Exist Press Enter to Continue F3 Exit F12 Cancel Eror Message AreCaAS Sas US OS A OS SA Chapter 3 PKZIP OS 400 Installation 9 Next the install process will restore the PKZIP for OS 400 product to the library requested and add the new library to the library list Then using the program PKZIP program PKZSETLIB all settings for com mands Data Area and Help files will be resolved to the new library At this point PKZIP for OS 400 is in your library list is ready to run the loading the of the keys DEMO or registered using INSTPKLIC command See Appendix A for Licensing Requirements METHOD B RSTLIB command The PKZIP for OS 400 installation CD ROM contains a SAVF file with the product library for the OS 400 The PK
267. uires hardware and programs that support DBCS Four double byte charac ter sets are supported by the system Japanese Korean Simplified Chinese and Traditional Chinese See also the Single Byte Character Set SBCS EBCDIC See the Extended Binary Coded Decimal Interchange Code shown on page 169 168 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 Encryption The transformation of data into an unintelligible form so that the original data either cannot be obtained or can be obtained only by decryption Extended Attribute Information attached to an object that provides a detailed description about the object to an application system or user Extended Binary Coded Decimal Interchange Code EBCDIC The Extended Binary Coded Decimal Interchange Code is an 8 bit binary code for larger IBM mainframes in which each byte represents one alphanumeric character or two decimal digits The single byte structure has a range of X 00 to X FF Control commands are subset with a range of X 00 to X 3F while graphic characters have a range from X 41 to X FE The space character is represented by a X 40 EBCDIC is similar in nature to ASCII code which is used on many other computers When ZIP programs compress a text file they translate data from EBCDIC to ASCII characters within a ZIP archive using a translation table File Transfer Protocol FTP In TCP IP an application protocol used for transferring files to an
268. ull functionality is a an easy process of generating a license report and calling your reseller or PKWARE Sales at 937 847 2374 Once on the phone with your reseller or PKWARE representative you will provide them information off this license report at which point they will generate a DEMO code and send it to you via email Reporting To report on the status of a license at your location you can run the license program with the following command INSTPKLIC TYPE VIEW The output of this report is what you will need to send to your reseller or PKWARE Sales Representative to obtain a DEMO code Note The PKZIP Library must be added to the library list prior to running this command Trial activation is accomplished by first editing the member PKWARELIC and adding the Company Customer record and keys supplied by PKWARE Inc One way of editing the member would to use the following command with the correct library EDTF FILE PKZ550430 PKZLICIN MBR PKWARELIC or STRSEU SRCFILE PKZ550430 PKZLICIN SRCMBR PKWARELIC Example of PKWARELIC input file member with Demo License data supplied by PKWARE Inc Columns Browse PKZ55430 PKZLICIN SEU gt PKWARELIC FMT AS E KKKKKKKKKKKKKKK Beginning of data KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 0001 Demo LICENSED BY PKWARE Inc 11 14 2002 with expire Date 12 14 2002 0004 55 Y1LRS9UQ05 202020202 My Demo Customer Name 0009 99 EARZ5URF 20021214 0107X8WTPO5 KKKKKKKKKKKEKKKK
269. un AQZ0281 40 File Inlcudes and Excludes are invalid for Spool File selection Explanation When parameter TYPFL2ZP SPL is used for Spool File selection the INCLUDE and EXCLUDE parameters are not allowed Correct and re run AQZ0282 40 Input list file for file includes and excludes are invalid with Spool File Selection Explanation When parameter TYPFL2ZP SPL is used for Spool File selection the INCLFILE and EXCLFILE parameters for list input file includes and excludes are not allowed Correct and re run AQZ0283 40 Date selection DATETYPE with Before or After is Invalid with Spool File Selection Explanation When parameter TYPFL2ZP SPL is used for Spool File selection the DATETYPE must be NONE Correct and re run AQZ0284 40 STOREPATH NO is invalid with Spool Selection Explanation When parameter TYPFL2ZP SPL is used for Spool File selection the STOREPATH must be YES Correct and re run AQZ0285 40 The Spooled File and or Attributes cannot be retrieved Error Code amp 1 with 42 Explanation While trying to retrieve a Spool File or the Spool File attributes an error code amp 1 with 82 occurred Job will be aborted It may be that the spool file was being modified Try re running If problem continues please contact the Product Services Division at 1 937 847 2687 for assistance 90 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 AQZ0286 40 Job information cannot be retrieved
270. uthorized License Even though the default library for PKZIP for OS 400 Version 5 5 patch level 0 is PKZ550430 and is referenced in this manual the library name for the product can be named otherwise to suit your environmental needs It is recommend that you use a generic name for the library that will be used for production such as PKZIP or PKZIPPROD This will allow news version to be implemented without changing a lot of CL programs or processes To use another library name review the procedures in Appendix H Operating Environment on how to use the CALL PKZSETLIB program to change the standard library name Unloading PKZIP for OS 400 from Tape The PKZIP for OS 400 installation tape contains a SAVF file with the product library for the OS 400 The file PKZ550vrm library contains PKZIP for OS 400 Version 5 5 patch level 0 with the OS 400 version specified as vrm OS 400 version Target Release and Modification for the product build for example 430 for V4R3MO To unload the required library for PKZIP for OS 400 load the tape and issue the following command RSTLIB SAVLIB PKZ550vrm DEV tapnn Where vrm is the version release and modification level and tapnn is the appropriate tape device name Unloading PKZIP for OS 400 from a CD ROM The PKZIP for OS 400 installation from a CD ROM can be performed using either of the following two methods One method is to use the LODRUN command and the second method would be
271. vent accidental overwriting of files the default is NO The allowable values are YES Always overwrite files If the file exist the file will be overwritten with no message or prompting NO Never overwrite files If the file already exists then the archive file will be skipped and not extracted This is the default PROMPT When a file being extracted already exists PKUNZIP will issue the warning message AQZ0262 and prompt the user for the required action PASSWORD PASSWORD Archive Password Specifies a password to be used for files that were added to the archive with a password This password may be up to 64 characters in length and is case sensitive All files selected for archiving will be checked for encryption using the specified password Files in the archive may have different passwords If so PKUNZIP must be run once for each password Since the password in entered in EBCDIC the translation table referenced in the FTRAN parameter is used to translate it to ASCII Care should be take when using the FTRAN override and when using a password To use password protected files the same FTRAN override option is required 60 PKZIP OS 400 5 5 User s Guide PKOU V5R5000 SFQUEUE SFQUEUE DFT Name Specifies the Output Queue that will be used as an override when extracting spool files If no OUTQ Library is specified it will default to LIBL The allowable values are DFT The Output Queue that are in the s
272. with the commands EDTF FILE PKZ550430 PKZLICIN MBR PKWARELIC or STRSEU SRCFILE PKZ550430 PKZLICIN SRCMBR PKWARELIC After updating the control records the license file must be updated by use of the following command INSTPKLIC INFILE LIBL PKZLICIN INMBR PKWARELIC or prompt F4 Install PKZIP for OS 400 License INSTPKLIC Type choices press Enter INSTALL INSTALL VIEW Input Control File PKZLICIN Name PKZLICIN Library name LIBL Name LIBL Control Member PKWARELIC Name FIRST Bottom F3 Exit F4 Prompt F5 Refresh F12 Cancel F13 How to use this display F24 More keys Enter the key codes received from PKWARE Inc Note The license data can be kept in any source file other than the file PKZLICIN file In fact it would be wise to save the License input file for ease of future releases in another library Record Layouts The record layouts for Control file records portions of which PKWARE Inc will provide are as follows Comment Control Card Comment cards are free format and begin with an in column 1 Appendix A Licensing Requirements 133 Customer Control Card Customer records always begins with a 55 Control Check Customer Customer Code Characters Number Name Format 55 CCCCCCCC nannnnnnnn XXX XXX Columns 1 2 4 11 13 21 23 72 Length 2 8 9 50 55 Feature Control Code always a 55 cccccccc Check Character supplied by PKWARE Inc
273. x7D 20 27 28 2f 0x4D 0x5D 0x5C 0x4E 0x6B 0x4B 0x61 28 2f 30 37 OxFO 0xF1 0xF2 0xF3 0xF4 F5 OxF6 0xF7 30 37 38 3 OxF8 OxF9 Ox7A Ox5E 0x4C E OxGE 0x6F 38 3f 40 47 Ox7C 0xC1 0xC2 0xC3 0xC4 OxC6 OxC7 40 47 48 4 0xC8 0xC9 OxD1 0xD2 0xD3 OxD5 0xD6 48 4f 50 57 OxD7 0xD8 0xD9 OxE2 0xE3 E4 OxE5 0xE6 50 57 58 5 OxE7 0xE8 OxE9 OxBA OxE0 OxBO 0x6D 58 5 60 67 0x79 0x81 0x82 0x83 0x84 0x86 0x87 60 67 68 6 0x88 0x89 0x91 0x92 0x93 0x95 0x96 68 6f 70 77 0x97 0x98 0x99 OxA2 0xA3 0xA4 0xA5 0xA6 70 77 78 7 OxA7 OxA8 OxA9 0xC0 Ox6A OxDO OxAl 0x07 78 7f 80 87 0x68 OxDC 0x51 0x42 0x43 0x44 0x47 0x48 80 87 88 8 0x52 0x53 0x54 0x57 0x56 0x58 0x63 0x67 88 8f 90 97 0x71 0x9C Ox9E OxCB 0xCC OxCD OxDB OxDD 90 97 98 9 OxDF OxEC OxFC 0x4A 0xB1 0xB2 0x3E 0xB4 98 9f a0 a7 0x45 0x55 OxCE 0x49 0x69 0x9A 0x9B a0 a7 a8 af OxAB 0x0F Ox5F OxB7 OxAA 0x8A 0x8B a8 af b0 b7 0x3C 0x3D 0x62 0x64 0x65 0x66 0x20 b0 b7 b8 bf 0x21 0x22 0x70 0x72 0x73 0x74 OxBE b8 bf c0 c7 0x76 0x77 0x78 0x24 0x15 0x8C 0x8D c0 ce7 7 c8 cf 0x8E 0x41 0x06 0x 0x28 0x29 0x9D 0x2A c8 cf d0 d7 0x2B 0x2C 0x09 Ox0A OxAC OxAD OxAE OxAF d0 d7 d8 df 0x1B 0x30 0x31 OxFA 0x1A 0x33 0x34 0x35 d8 df e0 e7 0x36 0x59 0x08 0x38 OxBC 0x39 OxAO OxBF e0 e7 e8 ef OxCA 0x3A OxFE 0x3B 0x04 OxCF OxDA 0x14 e8 ef f0 7
274. xists 2 File Text The text description of the SAVF Standard IFS Attributes When the files being compressed are from the Integrated File System the standard attributes for stream files are as described in the following table Attribute Description 1 Code Page File creations date time The date and time when the file was created 3 File last access date time The date and time when the file was last accessed 4 File last modification date time The data and time when the file was last modified Advanced Encryption Attributes When the files being compressed with Advanced Encryption encryption attributes are added to the archive Attribute Description 1 Encryption Method Algorithm Indicates the Encryption Method Encryption Key Type The key type used with the encryption algorithm 3 Security Method Indicates whether a password certificate or both password and certificate are in use DATABASE Attributes With the parameter DBSERVICE YES in PKZIP a special set of attributes are created for files that are Physical Files both Source and Data types in the QSYS Library File System These attributes can be used by PKUNZIP to create a database by building the DDS source and issuing the CRTPF command for the source These Database attributes are described in the following tables File Phy
275. y appear to be corrupt on other platforms Processing GZIP Archives PKZIP for OS 400 can create and extract information from GZIP format archives similar to how it can be used to create and extract information from a ZIP archive The creation of a GZIP Archive and other parameters is exactly like all other processes in PKZIP for OS 400 including use of extended attributes To create a GZIP Archive file code the parameter GZIP YES The difference is that the archive can only have one 1 file and the archive cannot be updated The PKUNZIP program will identify the GZIP Archive and process it accordingly Chapter 11 Processing with GZIP 65 The following are the specific GZIP Restrictions that pertain to the PKZIP and PKUNZIP programs Compressing e The code used by PKZIP for OS 400 follows the standards specified in the two applicable RFC s Specifically these are RFC 1952 GZIP file format specification Version 4 3 and RFC 1951 DEFLATE Compressed Data Format Specification Version 1 3 PKZIP for OS 400 should always be able to create a GZIP compatible compressed file and extract data from a GZIP compressed file where the GZIP utility matches these two specifications e Parameter COMPRESS NO cannot be used because all GZIP Archives must contain compressed data e Parameter COMPRESS TERSE cannot be used because terse compression is a non standard compression method for GZIP e Parameter FTRAN is not valid for GZ
276. ystem to send a message to the system history log 12 Reuse deleted records REUSEDLT Specifies whether deleted record space should be reused on subse quent write operations 13 Access path size ACCPTHSIZ Specifies the maximum size of auxiliary storage that can be occupied by access paths that are associated with keyed source physical files 14 Access path maintenance MAINT Specifies the type of access path maintenance used for all members of the physical file 15 Access path recovery RECOVER For files having immediate or delayed maintenance on their access paths specifies when recovery processing of the file is done if a system failure occurs while the access path is being changed 16 Allocate storage ALLOCATE Specifies storage space is allocated for the initial number of records SIZE parameter for each physical file member when it is added 17 Force keyed access path FRCACCPTH For files with keyed access paths only specifies access path changes are forced to auxiliary storage along with the associated records in the file whenever the access path is changed 18 Record format level check LVLCHK Specifies the record format level identifiers in the program are checked against those in the logical file when the file is Chapter 8 Extended Attributes 29 30 Attribute Description opened 19 Program describe
277. yte within a field represents two numeric digits except the far right byte which contains one digit in bits 0 through 3 and the sign in bits 4 through 7 For all other bytes bits 0 through 3 represent one digit bits 4 through 7 represent one digit For example the decimal value 123 is represented as 0001 0010 0011 1111 or 123F in hexadecimal Parameter 1 In DB2 UDB for iSeries SQL the keywords and values that further define SQL pre compiler commands and SQL statements See also keyword Parameter List A list of values in a calling program that corresponds exactly to a list in a called program for the pur poses of providing address ability and data exchange It contains parameter names and the order in which they are to be associated in the calling and called program Partition A fixed size portion of the available storage Path Name 1 A string of characters used to refer to an object The string can consist of one or more elements each separated by a slash and may begin with a slash Each element is typically a directory or equivalent except for the last element which can be a directory or another object such as a file 2 A sequence of directory names followed by a file name each separated by a slash 3 In a hierarchical file system HFS the name used to refer to a file or directory The path name must start with a slash and consist of elements separated by a slash The first element must be the name of a reg

Download Pdf Manuals

Related Search

Related Contents

MPI  Siemens Welding System SINVERT 350 User's Manual  Medifridge Instructions Français  ES 05 - produktinfo.conrad.com  Airis LW277 Manual - Recambios, accesorios y repuestos  Tiptel 1020  

Copyright © All rights reserved. Failed to retrieve file