which included commits to RCS files with non-trunk default branches. git-svn-id: svn://10.65.10.50/trunk@5403 c028cbd2-c16b-5b4b-a496-9718f37d4682
		
			
				
	
	
		
			141 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
		
			Executable File
		
	
	
	
	
			
		
		
	
	
			141 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
		
			Executable File
		
	
	
	
	
| [Notes accompanying first beta of VM/CMS port; still mostly applicable
 | |
|  to the UnZip 5.2 release.  Somebody with a VM/CMS system will have to
 | |
|  update this file.]
 | |
| 
 | |
| Thank you for trying this first port of UNZIP for VM/CMS and MVS!
 | |
| 
 | |
| This is the first beta so there might be some bugs in it.
 | |
| 
 | |
| -----------------------------------------------------------------------
 | |
| Additional notes from Greg Hartwig (7/96):
 | |
| 
 | |
| The UNZIP MODULE has been packed to preserve CMS line ends
 | |
| and is shipped as UNZIP.MOD.
 | |
| To restore it to an executable module on CMS, do the following:
 | |
| 1. Upload it to CMS as a Fixed file with LRECL 1024.
 | |
|    Example, from a DOS or OS/2 window, type this:
 | |
|       SEND unzip.mod A:unzip module a (RECFM F LRECL 1024
 | |
| 
 | |
| 2. Use COPYFILE to unpack the file.
 | |
|    Example, in CMS type this:
 | |
|       COPYFILE UNZIP MODULE A (UNPACK REPLACE OLDDATE
 | |
| 
 | |
| '+' and '-' are valid characters in CMS file names, so the code
 | |
| to remove them for CMS is only done for MVS now.
 | |
| 
 | |
| I don't have access to an MVS system, so my changes to the
 | |
| code have only been tested on CMS.  C/370 version 2.2 was used
 | |
| to compile the code.
 | |
| 
 | |
| Greg Hartwig
 | |
| e-mail: ghartwig@ix.netcom.com
 | |
|         ghartwig@vnet.ibm.com
 | |
| -----------------------------------------------------------------------
 | |
| 
 | |
| 
 | |
|                         Using under VM/CMS:
 | |
|                     ---------------------------
 | |
| 
 | |
| 1. To use the Info-ZIP's UNZIP under VM/CMS you need:
 | |
| 
 | |
|    - C/370 ver 2.1 compiler or another compatible compiler supporting
 | |
|      long names for function/variable names.
 | |
| 
 | |
|    - that the disk where the compiler is on is accessed
 | |
| 
 | |
|    - at least the following nucleus extensions (display of NUCXMAP):
 | |
| 
 | |
|      NAME      ENTRY    USERWORD ORIGIN   BYTES   AMODE (Attributes)
 | |
|      EDCX24    0038B000 00000000 0038B000 00002FD8  ANY  SYSTEM
 | |
|      EDCXV     001D1000 00000000 001D1000 000824C8   31  SYSTEM
 | |
| 
 | |
| 2. To compile the program under VM/CMS do :
 | |
| 
 | |
|    - unzip all the files from unz512vm.zip file. They are stored as
 | |
|      ASCII format so you have to unzip them first on PC or other
 | |
|      system that already have UNZIP, and then upload them to the
 | |
|      mainframe with ASCII to EBCDIC conversion.
 | |
| 
 | |
|    - execute UNZVMC to compile and link all the sources.
 | |
| 
 | |
|    - if everything is ok you will get an UNZIP MODULE
 | |
| 
 | |
| 3. Using UNZIP
 | |
| 
 | |
|    - Just read the UNZIP.DOC
 | |
| 
 | |
|    - A few exceptions concerning VM/CMS
 | |
| 
 | |
|      3.1. use always filename.filetype.mdisk format to specify
 | |
|           vm/cms files
 | |
| 
 | |
|      3.2. If the ZIP file has been zipped on an ASCII based system
 | |
|           it will be automatically translated to EBCDIC
 | |
|           ( I hope I got all those translation tables OK :-)
 | |
| 
 | |
|      3.3. The date and the time of the output files is set to the
 | |
|           current system date/time - not according the date/time in
 | |
|           the zip file.
 | |
| 
 | |
|      3.4. You can even unzip using VM/CMS PIPELINES
 | |
|           so unzip can be used as pipeline filter:
 | |
| 
 | |
|           'pipe cms unzip -p test.zip george.test | count lines | cons'
 | |
|           ( we do also a lot of pipethinking here ;-)
 | |
| 
 | |
|      3.5. If you got also the ZIP program (see ZIP201VM.ZIP) you can
 | |
|           do zipping and unzipping without translating to ASCII
 | |
|           the ZIP also preserves the file information (LRECL,BLKSIZE..)
 | |
|           So when you UNZIP a file zipped with ZIP under VM/MVS it
 | |
|           restores the file info.
 | |
| 
 | |
|           There currently some problems with file with RECFM=V*
 | |
|           I don't save the length of each record yet :-)
 | |
| 
 | |
|      3.6. No wildcards are supported in the input zip name you have
 | |
|           to give the real name (.zip is not necessary)
 | |
| 
 | |
|           So you CAN'T use things like: unzip -t *.zip
 | |
| 
 | |
|      3.7. But you CAN use wildcards as filename selection like:
 | |
|           unzip -t myzip *.c  - OK or even
 | |
|           unzip -t myzip *.c -x z*.c  - to exclude all files matching
 | |
|                                         z*.c
 | |
| 
 | |
|      3.8. A filename translations is being done in some cases:
 | |
|          - when there is no filetype (extension) the name becomes
 | |
|            firstname.NONAME
 | |
| 
 | |
|      3.9. When you unzip a file all of your currently accessed disks
 | |
|           are checked for the existence of this file if it exist
 | |
|           somewhere you get a reply if you want to overwright it ot no
 | |
| 
 | |
|      3.10. If you have CMS PIPELINES installed you can use the MC EXEC
 | |
|            as a MAKE utility to conditional compile all the sources
 | |
|            using as input UNZIP MAKEFILE.
 | |
| 
 | |
|      3.11. NO SFS is supported if you are using VM/ESA - everything is
 | |
|            extracted to the current directory.
 | |
| 
 | |
|      3.12. You can specify destination minidisk for unzip using the -d
 | |
|            option. Example : UNZIP myzip *.c -d b
 | |
|            This will unzip all .c files on your B disk.
 | |
| 
 | |
|       3.9. All '+' or '-' signs are skipped from the filenames
 | |
| 
 | |
| Please report all bugs and problems to :
 | |
|      Zip-Bugs@lists.wku.edu
 | |
| 
 | |
| That's all for now.
 | |
| 
 | |
| Have fun!
 | |
| 
 | |
| 
 | |
| George Petrov
 | |
| e-mail: c888090@nlevdpsb.snads.philips.nl
 | |
| tel: +31-40-781155
 | |
| 
 | |
| Philips C&P
 | |
| Eindhoven
 | |
| The Netherlands
 |