\documentstyle[a4,12pt]{article}
\begin{document}
\author{APM Manual pages}
\title{SERVER Utilities}
\maketitle
\parskip .1 in
\setcounter{secnumdepth}{10}
\parindent 0in

\section{Preamble}
There are currently 3 remote services that are supported by the VAX.

\small\tt \begin{verbatim}     -  SCRIBE    Runs the SCRIBE processor. 
     -  SPICE     Runs the SPICE circuit-emulator
     -  SIMULA    Runs the first pass of the SIMULA Compiler
\end{verbatim}\rm  \normalsize 
All of these depend on the SERVER manager running on VAX. If this is not
running then the message 'Facility Unavailable' will be returned by VAX
when any of the above requests are made.

At the moment only a 'batch-like' system is in operation. The APM user
requests a service on a file, the request is queued on VAX and sometime
in the future the request will be satisfied. Meanwhile the APM user can
be doing other things. Completion is indicated by the generation of a logfile
which contains the progress output generated by the requested service.

\section{SCRIBE}

Format:

\hspace*{ 0.9 in} \} SERVER:SCRIBE \hspace{ 0.3 in} filename
\\ \hspace*{ 0.9 in} Password: $<$user's pass$>$

This is used to formulate a request for the SCRIBE service. The SCRIBE
presented is currently very limited. No file references at all are
permitted (eg @INCLUDE files) and the only device supported is the
laserprinter.

A default extension of .MSS is used and the output file generated by SCRIBE
has extension .SAN . The log file generated is SCRIBE.LOG, and contains all
output generated normally by SCRIBE for the terminal output.

The currently logged on user's password is requested for accreditation.
The request identifier is returned if the request is valid.

\section{SIMULA}

Format:

\hspace*{ 0.9 in} \} SERVER:SIMULA \hspace{ 0.3 in} filename
\\ \hspace*{ 0.9 in} Password: $<$user's pass$>$

This is used to formulate a request for the SIMULA service. Only the
front end of the SIMULA compiler is run, producing S-CODE. This is probably
only of use to MDP, who is writing the APM SIMULA compiler.

A default extension of .SIM is used and the output file generated has
extension .SCB . The log file is SIMULA.LOG and contains all the output
generated normally by SIMULA for the terminal output.

The currently logged on user's password is requested for accreditation.
The request identifier is returned if the request is valid.

\section{SPICE}

Format:

\hspace*{ 0.9 in} \} SERVER:SPICE \hspace{ 0.2 in} filename
\\ \hspace*{ 0.9 in} Password: $<$user's pass$>$

This is used to formulate a request for the SPICE service.
A default extension .SPC is used for the source file and the output file
has extension .OUT . The log file is SPICE.LOG. The currently logged on
user's password is requested for accredidation.
The request identifier is returned if the request is valid.

\section{QUEUE Manipulation}

Manipulation of queues is often necessary.

Two APM utilities are available to manipulate the SERVER queue.

\subsection{DELREQ}

Format: \hspace{ 0.3 in} \} SERVER:DELREQ \hspace{ 0.3 in} reqid

This is used to delete a request. REQID is the identifier of the request,
which is returned when the request is made. It is not possible to delete
other people's requests, nor it is possible to delete requests which
are currently being serviced.

If the user has forgotten the request identifier, he must log onto VAX
and run DRA1:[AJS.SERVER]QUEUE which will give a complete list of
entries in the queue. The VAX user can then delete his APM requests
by running DRA1:[AJS.SERVER]DELREQ or by logging back onto the APM and
using this command.

\subsection{QUEUE}

Format: \hspace{ 0.3 in} \} QUEUE

This simply returns the number of entries in the queue.

\vspace{.75in} view:server printed on 16/02/89 at 16.21

\newpage
\tableofcontents
\end{document}
