summaryrefslogtreecommitdiffstats
path: root/release_docs/INSTALL_VMS.txt
blob: bd9d4bced9be21beb38e09b6bbd927fedd1c6da0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
		Building and installation instructions for Alpha Open VMS
			This file is under construction
			VMS port is not finished yet.
				EIP May 5, 2006

   


		CONTENTS
		--------

		1. Obtaining HDF5
		2. Building C, Fortran and C++ libraries
		3. Testing HDF5 libraries and tools
		4. Installing HDF5 libraries
		5. Known problems


	1.Obtaining HDF5
	  Please see INSTALL file in this directory for downloading instructions.

	2. Building C, Fortran and C++ libraries
	   Use tar command to untar HDF5 source ball

		tar -xvf hdf5-1.8.0-<pre>.tar
	   Change default directory to [.hdf5-1.8.0-<pre>.vms]
           and run 
		@make
           command. This command file will build 
			C library, tests, and utilities	
			Fortran library and tests
			C++ library and tests
			C, Fortran and C++ examples

	   IMPORTANT: Compilations flags are defined in the [.vms]make.com file of the
	   source tree. It is set up to use /float=float_ieee qualifier for C, Fortran 
	   and C++ compilersi, and debug mode. If desired, those flags can be removed.
	   Do NOT REMOVE /define=H5_VMS and /standard=strict_ansi qualifiers.
	   If you have to use make.com file in a particular directory, make sure that
	   you modify the compilation flags in this file appropriately.

	   If  make.com succeeds, the following libraries and utilties will be built:

	   [.src]hdf5.olb
	   [.fortran.src]hdf5_fortran.olb
	   [.c__.src]hdf5_cplus.olb
	   [.tools.h5diff]h5diff.exe
	   [.tools.h5dump]h5dump.exe
	   [.tools.h5import]h5import.exe
	   [.tools.h5jam]h5jam.exe
	   [.tools.h5jam]h5unjam.exe
	   [.tools.h5ls]h5ls.exe
	   [.tools.h5repack]h5repack.exe

	3. Testing HDF5 libraries and tools
	   You may try to run check.com files in the following directories

	   [.test]
	   [.fortran.test]
	   [.c__.test]
	   [.examples]
	   [.fortran.examples]
	   [.c__.examples]

	4. Installing HDF5 libraries
	   Currently one has to manually copy *.olb, public *.h (all header
           files that do not have "private" in file name) iheader files and 
           Fortran modules files from 
           [.src], [.fortran.src] and [.c__.src] directories

	5. Known problems

	   - There is no support for files bigger than 2GB
           - There is no support for filters including deflated compression filter and
	      szip compression filters.
	   - There are few C and Fortran tests that fail (C mtime,  Fortran file_close and
              multifile driver tests, probably more; all major tests succeed).
	   - Mulitifile driver has not been tested yet.
	   - Test scripts for some tools are missing; existing tools test scripts
	      do not compare output with the expected output.
           - Probably more :-)


	For help contact hdfhelp@hdf.ncsa.uiuc.edu or help@hdfgroup.org