home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / unzip531.zip / cmsmvs / README.CMS < prev    next >
Text File  |  1997-03-09  |  5KB  |  141 lines
  1. [Notes accompanying first beta of VM/CMS port; still mostly applicable
  2.  to the UnZip 5.2 release.  Somebody with a VM/CMS 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. -----------------------------------------------------------------------
  10. Additional notes from Greg Hartwig (7/96):
  11.  
  12. The UNZIP MODULE has been packed to preserve CMS line ends
  13. and is shipped as UNZIP.MOD.
  14. To restore it to an executable module on CMS, do the following:
  15. 1. Upload it to CMS as a Fixed file with LRECL 1024.
  16.    Example, from a DOS or OS/2 window, type this:
  17.       SEND unzip.mod A:unzip module a (RECFM F LRECL 1024
  18.  
  19. 2. Use COPYFILE to unpack the file.
  20.    Example, in CMS type this:
  21.       COPYFILE UNZIP MODULE A (UNPACK REPLACE OLDDATE
  22.  
  23. '+' and '-' are valid characters in CMS file names, so the code
  24. to remove them for CMS is only done for MVS now.
  25.  
  26. I don't have access to an MVS system, so my changes to the
  27. code have only been tested on CMS.  C/370 version 2.2 was used
  28. to compile the code.
  29.  
  30. Greg Hartwig
  31. e-mail: ghartwig@ix.netcom.com
  32.         ghartwig@vnet.ibm.com
  33. -----------------------------------------------------------------------
  34.  
  35.  
  36.                         Using under VM/CMS:
  37.                     ---------------------------
  38.  
  39. 1. To use the Info-ZIP's UNZIP under VM/CMS you need:
  40.  
  41.    - C/370 ver 2.1 compiler or another compatible compiler supporting
  42.      long names for function/variable names.
  43.  
  44.    - that the disk where the compiler is on is accessed
  45.  
  46.    - at least the following nucleus extensions (display of NUCXMAP):
  47.  
  48.      NAME      ENTRY    USERWORD ORIGIN   BYTES   AMODE (Attributes)
  49.      EDCX24    0038B000 00000000 0038B000 00002FD8  ANY  SYSTEM
  50.      EDCXV     001D1000 00000000 001D1000 000824C8   31  SYSTEM
  51.  
  52. 2. To compile the program under VM/CMS do :
  53.  
  54.    - unzip all the files from unz512vm.zip file. They are stored as
  55.      ASCII format so you have to unzip them first on PC or other
  56.      system that already have UNZIP, and then upload them to the
  57.      mainframe with ASCII to EBCDIC conversion.
  58.  
  59.    - execute UNZVMC to compile and link all the sources.
  60.  
  61.    - if everything is ok you will get an UNZIP MODULE
  62.  
  63. 3. Using UNZIP
  64.  
  65.    - Just read the UNZIP.DOC
  66.  
  67.    - A few exceptions concerning VM/CMS
  68.  
  69.      3.1. use always filename.filetype.mdisk format to specify
  70.           vm/cms files
  71.  
  72.      3.2. If the ZIP file has been zipped on an ASCII based system
  73.           it will be automatically translated to EBCDIC
  74.           ( I hope I got all those translation tables OK :-)
  75.  
  76.      3.3. The date and the time of the output files is set to the
  77.           current system date/time - not according the date/time in
  78.           the zip file.
  79.  
  80.      3.4. You can even unzip using VM/CMS PIPELINES
  81.           so unzip can be used as pipeline filter:
  82.  
  83.           'pipe cms unzip -p test.zip george.test | count lines | cons'
  84.           ( we do also a lot of pipethinking here ;-)
  85.  
  86.      3.5. If you got also the ZIP program (see ZIP201VM.ZIP) you can
  87.           do zipping and unzipping without translating to ASCII
  88.           the ZIP also preserves the file information (LRECL,BLKSIZE..)
  89.           So when you UNZIP a file zipped with ZIP under VM/MVS it
  90.           restores the file info.
  91.  
  92.           There currently some problems with file with RECFM=V*
  93.           I don't save the length of each record yet :-)
  94.  
  95.      3.6. No wildcards are supported in the input zip name you have
  96.           to give the real name (.zip is not necessary)
  97.  
  98.           So you CAN'T use things like: unzip -t *.zip
  99.  
  100.      3.7. But you CAN use wildcards as filename selection like:
  101.           unzip -t myzip *.c  - OK or even
  102.           unzip -t myzip *.c -x z*.c  - to exclude all files matching
  103.                                         z*.c
  104.  
  105.      3.8. A filename translations is being done in some cases:
  106.          - when there is no filetype (extension) the name becomes
  107.            firstname.NONAME
  108.  
  109.      3.9. When you unzip a file all of your currently accessed disks
  110.           are checked for the existence of this file if it exist
  111.           somewhere you get a reply if you want to overwright it ot no
  112.  
  113.      3.10. If you have CMS PIPELINES installed you can use the MC EXEC
  114.            as a MAKE utility to conditional compile all the sources
  115.            using as input UNZIP MAKEFILE.
  116.  
  117.      3.11. NO SFS is supported if you are using VM/ESA - everything is
  118.            extracted to the current directory.
  119.  
  120.      3.12. You can specify destination minidisk for unzip using the -d
  121.            option. Example : UNZIP myzip *.c -d b
  122.            This will unzip all .c files on your B disk.
  123.  
  124.       3.9. All '+' or '-' signs are skipped from the filenames
  125.  
  126. Please report all bugs and problems to :
  127.      Zip-Bugs@lists.wku.edu
  128.  
  129. That's all for now.
  130.  
  131. Have fun!
  132.  
  133.  
  134. George Petrov
  135. e-mail: c888090@nlevdpsb.snads.philips.nl
  136. tel: +31-40-781155
  137.  
  138. Philips C&P
  139. Eindhoven
  140. The Netherlands
  141.