home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / unzip532.zip / cmsmvs / README.MVS < prev    next >
Text File  |  1997-03-09  |  4KB  |  130 lines

  1. [Notes accompanying first beta of the MVS port; still mostly applicable
  2.  to the UnZip 5.2 release.  Somebody with an MVS system will have to
  3.  update this file.]
  4.  
  5. Thank you for trying this first port of UNZIP for VM/CMS and MVS!
  6.  
  7. This is the first beta so there might be some bugs in it.
  8.  
  9.                         Using under MVS:
  10.                     -------------------------
  11.  
  12. 1. To use the Info-ZIP's UNZIP under MVS you need:
  13.  
  14.    - C/370 ver 2.1 compiler or another compatible compiler supporting
  15.      long names for function/variable names.
  16.  
  17. 2. To compile the program under MVS do :
  18.  
  19.    - unzip all the files from unz52vm.zip file. They are stored as
  20.      ASCII format so you have to unzip them first on PC or other
  21.      system that already have UNZIP, and then upload them to the
  22.      mainframe with ASCII to EBCDIC conversion.
  23.  
  24.    - Copy all the .C files in the PDS called youruserid.UNZIP.C
  25.  
  26.    - Copy all the .H files in the PDS called youruserid.UNZIP.H
  27.  
  28.    - adjust the job UNZMVSC.JOB to work on your size. Change my
  29.      userid - C888090 to yours
  30.  
  31.    - execute the job UNZMVSC to compile and link all the sources.
  32.  
  33.    - maybe you have to preallocate PDS datasets named:
  34.      youruserid.UNZIP.OBJ and youruserid.UNZIP.LOAD
  35.  
  36.    - if everything is ok you will get an UNZIP MODULE
  37.  
  38. 3. Using UNZIP
  39.  
  40.    - Just read the UNZIP.DOC
  41.  
  42.    - A few exceptions concerning MVS
  43.  
  44.      3.0. There are different ways to invoke UNZIP.
  45.  
  46.         - allocating UNZIP.LOAD dataset to your ISPLLIB if you
  47.           want to invoke UNZIP under ISPF.
  48.           Then just type UNZIP ...parms... to get it work
  49.  
  50.         - You can also call it directly with :
  51.              TSO CALL 'userid.UNZIP.LOAD(UNZIP)' '...parms...'
  52.              (notice to quotes!)
  53.  
  54.         - You can even call it from a batch job like:
  55.  
  56.           //MYZIP    JOB  (account)
  57.           //STEP1    EXEC PGM=UNZIP,PARM='-l mytestz.zip *.c'
  58.           //STEPLIB  DD DSN=userid.UNZIP.LOAD,DISP=SHR
  59.           //SYSPRINT DD SYSOUT=*
  60.  
  61.           This will list all the .c files from the zip file mytestz.zip
  62.  
  63.      3.1. If the ZIP file has been zipped on an ASCII based system
  64.           it will be automatically translated to EBCDIC
  65.           ( I hope I got all those translation tables OK :-)
  66.  
  67.      3.2. The date/time of the output files is set to the
  68.           current system date/time - not according the date/time in
  69.           the zip file.
  70.  
  71.      3.3. You can even unzip using TSO/E PIPELINES
  72.           so unzip can be used as pipeline filter:
  73.  
  74.           'pipe cms unzip -p test.zip george.test | count lines | cons'
  75.           ( we do also a lot of pipethinking here ;-)
  76.  
  77.      3.4. If you got also the ZIP program (see ZIP21VM.ZIP) you can
  78.           do zipping and unzipping without translating to ASCII
  79.           the ZIP also preserves the file informations (LRECL,BLKSIZE..)
  80.           So when you UNZIP a file zipped with ZIP under MVS it
  81.           restores the file info.
  82.  
  83.           There currently some problems with file with RECFM=V*
  84.           I don't save the length of each record yet :-)
  85.  
  86.      3.5. No wildcards are supported in the input zip name you have
  87.           to give the real name (.zip is not necessary)
  88.  
  89.           So you CAN'T use things like: unzip -t *.zip
  90.  
  91.      3.6. But you CAN use wildcards as filename selection like:
  92.           unzip -t myzip *.c  - OK or even
  93.           unzip -t myzip *.c -x z*.c  - to exclude all files matching
  94.                                         z*.c
  95.  
  96.      3.7. You can unzip to a PDS using the -d parameter after the zip name
  97.           for example:
  98.  
  99.            UNZIP myzip *.c -dmyzip
  100.  
  101.           This will unzip all .c files that are in the zip file in a
  102.           PDS directory called MYZIP.C
  103.  
  104.           BE AWARE that the extension of every files is being placed as
  105.           last identifier on the PDS name, so if you have a file
  106.           in the zipfile called 'testp.doc' and you use '-d mypds'
  107.           the PDS name will become 'mypds.doc(testp)'
  108.  
  109.       3.8. All text files under MVS are created with record length 133.
  110.           This is due to a bug in the fopen that makes it always 1028
  111.  
  112.       3.9. All '+','_' or '-' signs are skipped from the filenames
  113.  
  114.  
  115. Please repport all bugs and problems to :
  116.      Zip-Bugs@lists.wku.edu
  117.  
  118. That's all for now.
  119.  
  120. Have fun!
  121.  
  122.  
  123. George Petrov
  124. e-mail: c888090@nlevdpsb.snads.philips.nl
  125. tel: +31-40-781155
  126.  
  127. Philips C&P
  128. Eindhoven
  129. The Netherlands
  130.