Installation Guide

How to install Ruby for VMS.

Preparation to install

Check operating system version. Ruby for VMS has been tested on OpenVMS Alpha V7.3-1 and V7.3-2. OpenVMS/Japanese is not mandatory. You can check the version number with following procedure.

$ SHOW SYSTEM/NOPROCESS
OpenVMS V7.3-1  on node HATENA   6-AUG-2004 15:23:46.58  Uptime  21 21:54:13

Download and unzip the software kit (ruby-vms-x181x014.zip). PCSI kit 'DLS-AXPVMS-RUBY-X0108-1X014-1.PCSI' will be extracted.

You can get unzip for VMS from OpenVMS Freeware page or OpenVMS Freeware CD.

$ UNZIP :== $dev:[dir]UNZIP.EXE"

$ UNZIP "-V" rubyvms_x181x014.zip
Archive:  dev:[dir]RUBYVMS_X181X014.ZIP;1
  inflating: DLS-AXPVMS-RUBY-X0108-1X014-1.PCSI

$ DIRECTORY/SIZE/DATE *.PCSI

Directory dev:[dir]

DLS-AXPVMS-RUBY-X0108-1X014-1.PCSI;1
                        8240   9-AUG-2004 19:08:11.57

Total of 1 file, 8240 blocks.

Install

It is easy to install with PRODUCT INSTALL command.

$ PRODUCT INSTALL */SOURCE=dev:[dir]

The following product has been selected:
    DLS AXPVMS RUBY X1.8-1X014              Layered Product

Do you want to continue? [YES] YES

Configuration phase starting ...

You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.

DLS AXPVMS RUBY X1.8-1X014

* This product does not have any configuration options.

Execution phase starting ...

The following product will be installed to destination:
    DLS AXPVMS RUBY X1.8-1X014              DISK$SYSTEM:[VMS$COMMON.]

Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%

The following product has been installed:
    DLS AXPVMS RUBY X1.8-1X014              Layered Product

After installation

Execute SYS$STARTUP:RUBY_STARTUP.COM to define logical names. (In current release, this procedure is not executed automatically.)

Then the RUBY command will be registerd to the command table (DCLTABLES.EXE). You may reread the command table with SET COMMAND command.

$ @SYS$STARTUP:RUBY_STARTUP.COM

$ SET COMMAND/TABLE=SYS$SHARE:DCLTABLES.EXE

Add a line to execute this command procedure into SYS$STARTUP:STARTUP_VMS.COM with text editor.

A Little Verification

You can verify that Ruby for VMS has been installed successfully with following commands.

$ ruby -v
ruby 1.8.1 (2003-12-25) [alpha-vms]

$ ruby -e "puts 'hello, world.'"
hello, world.

$