Getting started with Caché 4.0 for Alpha VMS

Overview:
The installation procedure for Caché 4.0 on Alpha VMS is different than previous versions of Caché. The files needed are in a multi-level directory tree, which cannot be simply copied from the CD into the cachesys directory due to issues with the VMS copy utility. Installation requires restoring the saveset to a "kit" directory on the target system and running cinstall.com from that location.

Once the Installation has been completed, users will have to familiarize themselves with new commands to access and work with Caché.
For example, csession configuration_name will give you access to the Caché environment, and ccontrol help will give an overview of the other related commands. See more details below.

Installation Procedure:
Note: It is recommended that you have your license key ready to enter it when prompted during the install, see item 6 below

1. Create a kit directory eg: disk:[kit]
$ create/dir disk:[kit]

2. mount the cdrom and navigate to the saveset file:
$ mount dka400: isc
%MOUNT-I-WRITELOCK, volume is write locked
%MOUNT-I-MOUNTED, ISC mounted on _RICKTS$DKA400:
$ set def dka400:[rel.alphavms.dist.V4-0-BUILD135-2]
$ dir

Directory DKA400:[REL.ALPHAVMS.DIST.V4-0-BUILD135-2]

C40B135-2.BCK;1 C40B135-2.BCKFDL;1

Total of 2 files.

3. restore the saveset, C40B135-2.BCK;1 to the directory established in step 1. Above:
$ backup C40B135-2.BCK /sav disk:[kit...]
NOTE:make sure to include the 3 periods at the end of the directory specification so that VMS will create the necessary multilevel file structure.

4. navigate to the [.REL.ALPHAVMS.DIST.Q4-0-BUILD135-2] sub directory of your [kit] directory and issue a dir command:

$ set def DKA200:[KIT.REL.ALPHAVMS.DIST.Q4-0-BUILD135-2]
$ dir

Directory DKA200:[KIT.REL.ALPHAVMS.DIST.Q4-0-BUILD135-2]

CINSTALL.COM;1 DIST.DIR;1

Total of 2 files.

5. execute cinstall.com from here and you should see the following screen output:
$ @cinstall

Currently defined Caché configurations:

Enter configuration name: Cache
Do you want to create configuration Cache<No>? yes
Enter installation directory location:
dka200:[40build135-2]

Disk blocks required = 211251
Disk blocks available = 2023308

Note that the installation script asks for a configuration name. If you had already installed Caché 4.0, it would have displayed existing configurations, and if you specified a configuration name from the list displayed, this installation would upgrade that Caché instance. If you specify a new configuration name it treats it as a fresh install and asks for an installation directory. In this case we are making a fresh install and giving it the configuration name "Cache". The installation proceeds to calculate if there is enough space to continue.

The install script proceeds by asking questions involving the optional components, this is similar to previous versions.

6. It will ask you if you want to install a license at this time. If you say no, the installation will continue to completion. In previous versions, you would still be able to open a single terminal session even if you had not entered the license yet. In this version, you will not be able to, so it is a good idea to have your license key ready and enter it at this point.

7. The installation will complete and state that users can log in. Note that the command Caché will not work from the DCL command line as it did in the past. Use csession configuration_name (csession may be abbreviated by "cs") to enter Caché.

Bringing up Caché...
Once this completes, users may access Caché
This copy of Caché has been licensed for use exclusively by:
Your License Owner
Copyright (c) 2000 by InterSystems Corporation
Any other use is a violation of your license agreement

Setting to InterSystems defaults ... done.

Exiting Caché installation procedure
$ Cs Cache

USER>

New Commands to Access and Work with Caché:
In order to support multiple instances of Caché, a new Caché Registry database has been implemented. This Caché Registry database is located in SYS$LIBRARY in a file called Caché.reg. In order to manage the database and the multiple instances of Caché, a group of new commands have been implemented for the 4.0 version of Caché. For example, since you may have several instances of Caché running in this version, simply typing "Cache" on the command line would not tell the system which Caché instance to enter. The new command is csession configuration_name which may be abbreviated as Cs configuration_name. There are also several commands which start with the command "ccontrol" which may be abbreviated "cc". You can get a helpful printout of these by typing cc help at the DCL prompt:

$ cc help
ccontrol start <configuration> [parameters]
Run the configuration's CSTART procedure to bring Caché up.
For help about parameters: ccontrol start <configuration> help

ccontrol stop <configuration> [parameters]
Run the configuration's CSTOP procedure to shut Caché down.
For help about parameters: ccontrol stop <configuration> help

ccontrol force <configuration> [parameters]
Run the configuration's CFORCE procedure to force Caché down.
For help about parameters: ccontrol force <configuration> help

ccontrol backup <configuration> [parameters]
Run the configuration's CBACKUP procedure for database backup.
For help about parameters: ccontrol backup <configuration> help

ccontrol create <configuration> [parameters]
Create a configuration's entry in the Caché registry.

ccontrol update <configuration> [parameters]
Update a configuration's entry in the Caché registry.

ccontrol delete <configuration>
Delete a configuration's entry from the Caché registry.
Note that this is **not** an UNINSTALL procedure.
The configuration's files are not removed.

ccontrol rename <configuration> <new-name>
Change a configuration's name.

ccontrol default
Display the name of the default Caché configuration,
if one has been designated.

ccontrol default <configuration>
Designate the default Caché configuration.

ccontrol default ""
A default configuration is not assigned.

ccontrol list
List Caché registry information for all configurations.

ccontrol list <configuration>
List the configuration's Caché registry information.

ccontrol session <configuration> [parameters]
Start a terminal session for the configuration.
For a description of parameters: ccontrol session

ccontrol version
Display the ccontrol program version number.

ccontrol help
Display help for all ccontrol functions.

ccontrol help [function]...
Display help for specific ccontrol functions.