\documentstyle[11pt]{article}
\pagestyle{plain}
\title{Installation of Programs \\
TCOPY and SUBTCOPY}
\author{R.~Venhola}
\maketitle
\begin{document}

\section{Program Description}
Program TCOPY copies from tape to tape.  Program SUBTCOPY creates and
submits batch job to run TCOPY.   SUBTCOPY requires one DCL command
line to execute.

\section{Files Required}
All of the files required for programs TCOPY and SUBTCOPY are located
in the CMS library~:
\begin{verbatim}

 DISK$POLARIS:[VENHOLA.DEVELOPMENT.TCOPY.CMS]

\end{verbatim}

There are a total of 12 text files that comprimise the TCOPY system~:
\begin{enumerate}
\item {\tt TCOPY\_DECUSVERSION.MAR} is the original version of TCOPY as read
from the DECUS tapes.   
\item {\tt TCOPY\_DECUSVERSION.DOC} is the original version 
documentation.
\item {\tt TCOPY.MAR} is the CCRS modified version of TCOPY.
\item {\tt SUBTCOPY.FOR} is a program to write a batch job that runs
TCOPY.
\item {\tt SUBTCOPY.CLD} is the DCL command definition of SUBTCOPY.    
\item {\tt SUBTCOPY.TEX} is the \LaTeX\ operator guide to using the
two programs.
\item {\tt INSTALLTCOPY.TEX} is the \LaTeX\ source of the current
document.
\item {\tt TCOPY.RNH} is the RUNOFF source for the TCOPY and SUBTCOPY
help file.
\pagebreak
\item {\tt TCOPY\_BUILDPROGRAMS.COM} is a command procedure to generate
the executable versions of TCOPY and SUBTCOPY.
\item {\tt TCOPY\_BUILDDOCUMENTATION.COM} is a command procedure to 
generate and print the TCOPY documentation.                        
\item {\tt TCOPY\_BUILDHELP.COM} is a command procedure to generate
the TCOPY help file.    
\item {\tt TCOPY\_SETUP.COM} is a command procedure to setup the TCOPY system.
Any user who executes this command procedure will be able to use
programs TCOPY and SUBTCOPY.
\end{enumerate}

It is recommended that copies of these files be stored in a CMS library in the 
DECUS account.  The next section is a guide to the installation
of TCOPY and SUBTCOPY as relevent to the CCRS account.  To install
in a different account, substitute the directory creation DCL commands
with the appropriate strings.

The file {\tt TCOPY\_CREATECMS.COM} will create the CMS elements,
groups and classes for programs TCOPY and SUBTCOPY.  It assumes that 
the CMS library for the programs has been created and is the current
default CMS library and that all of the required text files exist
in the current directory.  The file is in the same account as the source
code.  

\section{Installation Procedure}
\begin{enumerate}

\item Login to the DECUS account and create the directories for the 
programs.  
\begin{verbatim}
                     
 $ CREATE/DIRECTORY [.TCOPY]
 $ CREATE/DIRECTORY [.TCOPY.CMS]
 $ SET DEFAULT [.TCOPY]

\end{verbatim}                            

\item Fetch the TCOPY source code from the programmer/proletariat
account, as well as the command procedure to create the CMS elements
for the new CMS library.
\begin{verbatim}

  $ CMS
  CMS>SET LIBRARY DISK$POLARIS:[VENHOLA.DEVELOPMENT.TCOPY]
  CMS>FETCH *.* "Installing in DECUS account"
  CMS>EXIT
  $ COPY 
  From : DISK$POLARIS:[VENHOLA.DEVELOPMENT.TCOPY]TCOPY_CREATECMS.COM
  To : *

\end{verbatim}                    

\item Create the elements, groups and classes in the new CMS
library.  The command procedure is required only once and so it is
recommended that it be deleted after execution.
\begin{verbatim}                
                                                         
 $ CMS CREATE LIBRARY [.CMS] "Tape to Tape Copy Program"
 $ @TCOPY_CREATECMS
 $ DELETE TCOPY_CREATECMS.COM;

\end{verbatim}

\item The executable versions of the programs should exist in the 
current directory and well as the VMS library format help file,
the {\tt TCOPY\_SETUP.COM} command procedure and the {\tt SUBTCOPY.CLD}
file.  Check for their existance to verify that the program
was installed correctly.

\end{enumerate}

\section{Allowing a User Access to TCOPY}
To allow a user access to the TCOPY system, put the command~:
\begin{verbatim}

 @DECUS:[TCOPY]TCOPY_SETUP

\end{verbatim}

in their login command procedure.

\end{document}
       
