                          \VMS\READFRA.TXT
                             Version 1.7

The files in this Reflection X \VMS subdirectory are for use with Digital
VAX/VMS or OpenVMS/AXP hosts.  Once installed, they allow users without
SYSNAM privileges to start the DECwindows Session Manager from a terminal
session (the Method in the RX Client Startup dialog box should be set to 
telnet).  

If you are using DECnet, we recommend that you first try to use the 
pcx$server as your Method in the RX Client Startup dialog box.  Using the 
pcx$server Method to start the DECwindows Session Manager is described in 
the Reflection X User Guide and System Administrator Guide, as is information
about renaming the files listed below.  There is also a sample client startup
file (SM_PCX.RXC) in the \VMS subdirectory.

If you are using TCP/IP and if the VMS users have SYSNAM privileges, or if 
they will be running individual DECwindows applications without the Session 
Manager, then just STARTAPP.COM (in the Reflection X installation directory) 
can be used instead; the other files in this directory and the installation 
steps described below are then not necessary.  See the comments in the .COM 
files for more information.

The installation steps below should be performed by the VMS system manager,
or by a user with privileges sufficient for installing images on VMS.

File name:      Description:

READFRA.TXT     This file.
SM_DNET.RXC*    A sample client starter file for a VMS connection over DECnet.
SM_TCP.RXC*     A sample client starter file for a VMS connection over TCP/IP.
INSTALSM.COM    A DCL script that installs the files on your VMS host
                after they have been transferred.
ALPHA_SM.EXE    Binary executable file for an OpenVMS/AXP host.
VAX_SM.EXE      Binary executable file for an VAX/VMS host.
STARTLOG.COM    A DCL script that starts the DECwindows Session
                Manager.  The file is copied and renamed to a system-wide 
                RXSTARTSM.COM during the installation (INSTALSM.COM).
* Located in the \Application Data\Reflection\X\<lang>\VMS directory

The following files are also in the \VMS subdirectory, but do not transfer
them unless WRQ's technical support advises you to do so.  ALPHA_SM.EXE and
VAX_SM.EXE are already compiled for your system and	you do not need to upload
the .C or .OBJ files--if you do, INSTALSM.COM will try to recompile and/or
link a new executable.

ALPHA_SM.OBJ    Binary object file for an OpenVMS/AXP host.
VAX_SM.OBJ      Binary object file for an VAX/VMS host.
STARTSM.C       C source code for "start Session Manager."

Follow these steps:

1. Transfer only the appropriate (OpenVMS/AXP or VAX/VMS) executable file
   (ALPHA_SM.EXE or VAX_SM.EXE) to your host. There are a few ways to do this,
   depending on what products you have:
   - If you have a full PATHWORKS installation, you probably have a network
     drive that is mapped to your VMS host. If this is the case,
     just copy the files to your VMS host.
   - Use Reflection for UNIX and OpenVMS to transfer the files; use binary
     as your transfer method.
   - If you have TCP/IP and FTP on your VMS host, you can use Reflection FTP
     to transfer the files; use binary as your transfer method.

2. Transfer both ASCII files to your host (STARTLOG.COM and INSTALSM.COM).

3. At the host prompt, run the following DCL command:

    @instalsm

   This copies the files to their appropriate locations on the host and sets
   their protections.  It will also do a DCL INSTALL of the executable.

4. After the installation is complete, edit SYS$MANAGER:SYLOGIN.COM.  Add the
   following line so that all users will have the symbol for startsm:

    $ startsm:==$ startsm

5. The final step ensures that SYS$SYSTEM:STARTSM.EXE is "installed" whenever 
   VMS is booted.  Add the following line to either SYS$MANAGER:SYSTARTUP_V5.COM 
   (the name of the file on an OpenVMS/AXP host is SYSTARTUP_VMS.COM), or
   SYS$SYSTEM:STARTUP.COM:

    $ INSTALL ADD /PRIV=SYSNAM STARTSM

After these steps, the following command will make the DECwindows Session
Manager connect to the X server (Reflection X) at the specified IP address
(Reflection X automatically substitutes the IP address and display number 
of your PC for "%IP#%"):

    startsm %IP#%

This command will do the same at the specified DECnet node ID (Reflection X 
substitutes the node ID and dislay number of your PC for "%DN#%"):

    startsm %DN#%

There are two Reflection X Client files (SM_DNET.RXC and SM_TCP.RXC) that will
help the end user start the Session Manager via TCP/IP or DECnet.  These files
can be copied to the PC's Reflection X installation directory.  
