Installation if the CERN RPC tools under VMS

# Installation of the RPC tools under VMS

This is a list with which the user need not generally concern himself. It details the files which must be available on the machine in order to compile and link distributed programs. See also: Installation on other systems , Making sharable libraries.

A single command (@DISK$D1:[RPC]SETUP on VXCERN) sets up all the other commands and logical names required, and may be put in your login file.

The RPC files are distributed in a VMS saveset

    	VXCERN::DISK$D1:[RPC.DISTRIBUTION_KIT]RPC_VMSVVV.BCK.

Where VVV is the version number in the form, for example, 031 for version 3.1. make a suitable directory for the RPC files. The files should be unwrapped with the command

     BACKUP VXCERN::DISK$D1:[RPC.DISTRIBUTION_KIT]RPC_VMSVVV.BCK/SAV []

The files forming part of the release on VAXVMS are as follows:-

include.com
  The include preprocessor command file.
include.exe
  The include preprocessor, used by the RPC.COM command file for stubs in Pascal.
lnkdef.com
  A command file used by setup.com for defining the
rpc.com
  The command file used by the RPC command.
rpc.hlb
  A VAX/VMS help library
rpc.hlp
  The RPC help library. If your want the .HLP file, extract it from this with LIB/HELP/EXTRACT.
rpcc.exe
  The rpc compiler
rpcc.obj
  The rpc compiler in object form, so that you can link it to run on an old version of VMS if necessary. The command is LINK/NOTRACEBACK RPCC
rpcconst.h
  A pascal include file. Contains some basic definitions of constants.
rpcheader.h
  An include file in C language. Contains all constants, types, and (un)marshaling procedures.
rpclarge.olb
  The run&hyphen.time library, version for DECNET, ethernet, V24, ISO TP4, X24 8k byte buffers. Logical name is rpc_large
rpclib.olb
  The run&hyphen.time library, version for DECNET, ethernet, V24, ISO TP4, X24 etc. Logical name is rpc_lib
rpclibc.olb
  The run&hyphen.time library, version for TCP/IP working. Logical name is rpc_libc
rpclibc8k.olb
  The run&hyphen.time library, version for TCP/IP working. 8kB buffer version. Logical name is rpc_libc
rpclarge.opt
  Link options file, version for DECNET, ethernet, V24, ISO TP4, X24 8k byte buffers. Logical name is rpc_large
rpclib.opt
  Link options file, version for DECNET, ethernet, V24, ISO TP4, X24 etc. Logical name is rpc_lib
rpclibc.opt
  Link options file, version for TCP/IP working. Logical name is rpc_libc
rpclibc8k.opt
  Link options file, version for TCP/IP working. 8kB buffer version. Logical name is rpc_libc
rpcmsg.exe
  An error file. $SET ERROR RPCMSG will allow VMS to translate RPC error numbers into text strings. Any program linked with RPC can do this anyway, as the same information is in a module RPC_ERRS in the library.
rpcproc.h
  A pascal include file. Contains external declaration of routines used to transport messages to the counterpart side.
rpcstub.h
  A pascal include file. Contains system dependent library routines to marshal and unmarshal parameters.
rpctypes.h
  A pascal include file. contains system dependent type definitions.
rpc_vmsVVV.release_notes
  A set of notes describing differences between this and previous releases, and how to install the product. (VVV is the version number for example 031 for version 3.1).
setup.com
  Login command file to set up logical names and symbols. Put a call to this into the login.com for each user wishing to develop programs using RPC. (No changes are required for those users using programs built with RPC.)