Installing Program Files
Note: The VC/m software kit needs to be installed on the same machine as the Caché or M repository server and the web server. This means that if your system is configured to have the repository server and the web server on different machines, a complete set of VC/m files needs to be installed on both machines.
The software is normally supplied in a zip file. To install it, copy the zip file onto the target server, unzip it there into a temporary directory, then move the unzipped file tree to your chosen installation directory. When transferring the zip file between computers make sure it is handled as a binary file (e.g. if using FTP ensure bin mode is used rather than ascii mode).
Windows
Recommended Installation Directory
We recommend the following directories for your VC/m installation:
| Version | Directory |
|---|---|
| 32-bit Windows | C:\Program Files\George James Software\VCm |
| 64-bit Windows | C:\Program Files\George James Software (x86)\VCm |
UNIX/Linux
As detailed above, it is preferable to transfer the zip file to the target server before unzipping it in situ in a temporary directory, e.g.
$ unzip -a vcm.zip
Provided your unzip utility is competent this procedure ensures that text files distributed in the zip with Windows style line endings are converted to have UNIX/Linux style ones.
If this is not possible, and the zip is instead unpacked on Windows, make sure that the subsequent transfer of files to the UNIX/Linux environment does the correct thing with text files (e.g. .css, .js, .htm), converting their linebreaks from Windows-style to UNIX/Linux-style.
Suggested Installation Directory
We suggest the following directories for your VC/m installation:
| /usr/vcm |
OpenVMS
As detailed above, it is preferable to transfer the zip file to the target server before unzipping it in situ in a temporary directory, e.g.
$ UNZIP VCM.ZIP /BINARY=AUTO /TEXT=AUTO
The Info-Zip version of UNZIP.EXE is available from http://www.info-zip.org/UnZip.html
If this is not possible, and the zip is instead unpacked on Windows, make sure that the subsequent transfer of files to the OpenVMS environment does the correct thing with text files (e.g. .css, .js, .htm).
Unzipping the kit on OpenVMS typically creates the text files with Variable record format. On Caché it is necessary for these to be converted to Stream format. To achieve this VC/m includes a file called VAR_TO_STREAM.COM which is a DCL procedure that scans a directory and its subdirectories, converting files having Variable record format. The conversion uses the FDL specification in VCM_STREAM.FDL. To invoke it, switch to the directory containing these two files, and then invoke the procedure as shown below. For example, if the COM and FDL files unzipped to DISK$MAIN301:[VCM] the commands are:
$ SET DEF DISK$MAIN301:[VCM]$ @VAR_TO_STREAM DISK$MAIN301:[VCM...]*.*Each converted file will be reported. The unconverted files will remain with predecessor version numbers.
Suggested Installation Directory
We suggest the following directories for your VC/m installation:
| disk:[VCM] |
Next Step
Next, install VC/m routines.