\documentstyle[a4,12pt]{article}
\begin{document}
\author{10/87}
\title{APM 1.10 2}
\maketitle
\parskip .1 in
\setcounter{secnumdepth}{10}
\parindent 0in

\section{Preamble}
A Brief Introduction to the APM system

\section{Introduction}
The Department has an ethernet-like local area network with
about 60 Advanced Personal Machines (APM's) and a number of file-servers
attached. There are three principal public file servers, referred to as
ALPHA, BRAVO and CHARLIE ,and special ones DEMO and MET. Users are normally
accredited to only one of these,
and any of the workstations can be used with any of them.

ALPHA: \hspace{ 0.3 in} This is still under development.
BRAVO: \hspace{ 0.3 in} This is normally used by the staff and postgraduate students
CHARLIE: \hspace{ 0.2 in} This is normally used by undergraduates and MSc students
DEMO: \hspace{ 0.4 in} This is a demonstration and project machine
MET: \hspace{ 0.5 in} This belongs to the Department of Meteorology.

The workstations are modular computer systems based at present on the
Motorola 68000. There are many different hardware configurations
possible, and some of these are described below. Most software will run
on any of the systems unless it has any specific hardware requirements
(eg. Graphics).

Basic system: \hspace{ 0.5 in} Motorola 68000 or 68010, 2Mb of memory, Ethernet interface,
\\ \hspace*{ 1.4 in} Wyse 75 or (occasionally) Visual 200 VDU.
Level 1.5 graphics: Basic system, 8 plane framestore, mouse interface,
\\ \hspace*{ 1.4 in} Colour monitor.
Big system: \hspace{ 0.7 in} Basic system but up to 6 Mb of main memory. There are
\\ \hspace*{ 1.4 in} a couple of these in the public area.

If users require other configurations they should ask the technical staff for
assistance. All of the public workstations are currently situated in the
machine halls bar one which is in the "Charles" room. Six APMs are on the
Gandalf PACX and are accessible from any Gandalf terminal (and indeed from
anywhere else via the network).

\section{Powering on}

If switched off:

Switch on the VDU (switch on the right hand side or front), and
colour monitor (switch below the screen at the front) if one is present.
Turn the key switch on the front right of the APM cabinet.

The machine will now boot from the default filestore.
(BRAVO for machines in offices and CHARLIE for most public machines)
As the machine boots various messages giving the versions of the system
components and files being loaded are printed on the console.

The machines should be left switched on during the day.

\section{Reinitialising a stuck system:}

If you wish to re-boot the system while it is running, you can press Ctrl+T,
followed by 'R' for Re-boot. If the terminal does not respond, the machine
can be re-booted by pressing the reset switch on the processor board (the
one with two lights and a ribbon cable) which is inside the cabinet.

\section{Logging on}

When the machine finishes booting the cursor should be positioned to the
right of a curly bracket, which is the command prompt ('\}'). The form of the
login command is

\hspace*{ 0.5 in} L Username \hspace{ 0.8 in} or \hspace{ 0.5 in} L Filestore::Username
\\ \hspace*{ 0.5 in} password \hspace{ 1.5 in} password

If the form on the left is used, the system will attempt to log you onto
the same filestore as was used by the previous person (or the one it booted
from if it has just been booted). If the message 'No Authority' appears you
have mis-typed the username or password. If the message 'Owner XXX: not found'
occurs then you may be trying to use the wrong filestore, and the form on the
right should be used.

Once you have logged on successfully, any system alert messages are printed,
and your file LOGIN.COM, if you have one, will be obeyed.

\section{On your first log on}
Users are normally accredited with a null password. If the user FG has just
been accredited to filestore 'C', the following is a typical dialogue required
to 'personalise' their number.

\hspace*{ 0.5 in} \} L c::fg
\\ \hspace*{ 0.5 in} Pass: \hspace{ 1.7 in} \{ Press \hspace{ 0.3 in} $<$return$>$
\\ \hspace*{ 0.5 in} You are using Filestore C (1B) \{ Welcome message and alert info.
\\ \hspace*{ 0.5 in} \} PASS \hspace{ 1.7 in} \{ Call password-setting utility
\\ \hspace*{ 0.5 in} Current password: \hspace{ 0.9 in} \{ Press $<$return$>$
\\ \hspace*{ 0.5 in} New password: DALE \hspace{ 0.9 in} \{ Note password "DALE" is not echoed
\\ \hspace*{ 0.5 in} Confirm: DALE \hspace{ 1.2 in} \{ You must type it correctly again or
\\ \hspace*{ 2.5 in} \{ it will not be changed.
\\ \hspace*{ 0.5 in} \} v login.com \hspace{ 1.2 in} \{ create a login.com file using ECCE editor
\\ \hspace*{ 0.5 in} $>$$>$ g0 \hspace{ 1.7 in} \{ Lines typed in now go into the file.
\\ \hspace*{ 2.5 in} \{ SETUP EDWIN if using graphics
\\ \hspace*{ 2.5 in} \{ SETUP VLSI if using VLSI software
\\ \hspace*{ 0.5 in} $>$$>$ : \hspace{ 1.8 in} \{ to finish entering text
\\ \hspace*{ 0.5 in} $>$$>$ \%c \hspace{ 1.7 in} \{ to close edit

$<$See caveats re more than one SETUP in a .COM file - HELP SETUP$>$

\section{Logging off}

The L command always logs you off before logging you on. If you just want
to log off, the L command without a username parameter should be used.
This command will cause a Gandalf APM to reboot unless a username is supplied.

\section{Contacts}

If a query cannot be solved by using the information provided by the
command HELP or if you have queries relating to filestore administration
(new accounts, quotas, forgotten passwords etc) then users should contact
the departmental advisory service (if this is in operation) or
Linda Wilkie (LINDA on ECSVAX). She has an office in the South machine hall.

If the query is non-urgent then users are asked to use the VAX/VMS mail system.

\section{Commands}

The general form of a command is VERB inputs / outputs -qualifier1 -q2 -q3

The general form of a file name is \hspace{ 0.2 in} FILESTORE::USER:FILENAME
however you can only access files on the particular filestore
you logged on to and the filestore field of the name must be omitted.
An exception to this is the EFTP program which can be used to transfer files
between filestores, HELP EFTP gives further details.

Filenames consist of 12 characters in the range 'a' to 'z', '0' to '9', '.',
'\$', '\_' in any order. Upper and lower case letters are treated as
equivalent. If the filename starts with a dollar, the file is assumed to
be a temporary file, and is deleted when the user logs off. Although the
filestore has no concept of file extensions, the system uses the convention
that files ending in .COM are command files, and files ending in .MOB
are Motorola Object files, and files ending
in .LIS are listing files. Users often find it convenient to treat the last
4 characters of the name as an extension, which allows programs to run on both
the VMS and APM systems with no changes.
There are two special characters "!" and "?" which may appear on the end of a
filename. These indicate temporary and corrupt files respectively. Corrupt
files indicate a filestore inconsistency and should be reported.

Most commands will prompt for their parameters if these are omitted, and will
give the user further options if the command line ends with a question mark.

This is a very brief summary of some of the standard commands. Further
information on these (and other) commands can be found by giving the
command HELP, which allows the user to explore a tree-structured database
of help information. Users are recommended to start with HELP APM and
HELP UTILITIES. If you are moving files around or are printing to remote
printers then you should look at HELP FILETRANSFER as well. If you are
considering a hardware project, HELP HARDWARE contains most of what you require.
John Butler has the "definitive" document set in hard copy.
\subsection{PAGE}
ANALYSE \hspace{ 0.2 in} file \hspace{ 1.2 in} : Analyse the file specified
ASS \hspace{ 0.5 in} file \hspace{ 1.2 in} : Assemble a 68000 program
BUG \hspace{ 1.9 in} : Report bugs in the system
CC \hspace{ 2.0 in} : HELP C for details of C compiler
COMPARE \hspace{ 0.2 in} file1, file2 / output : Compare text files
COPY \hspace{ 0.4 in} input / output \hspace{ 0.5 in} : Copy input to output
DELETE \hspace{ 0.3 in} filelist \hspace{ 0.9 in} : Delete files specifed
DUMP \hspace{ 0.4 in} file \hspace{ 1.2 in} : Dump the contents of the file (hex)
EFTP \hspace{ 1.9 in} : Move files between filestores
F or FILES user \hspace{ 1.1 in} : List the files owned by user
HELP \hspace{ 0.4 in} topic \hspace{ 1.1 in} : Help about commands, packages etc.
IE \hspace{ 0.5 in} file / file \hspace{ 0.7 in} : Use the IE screen editor
IMP \hspace{ 0.5 in} file \hspace{ 1.2 in} : Compile an IMP program
INSTALL \hspace{ 0.2 in} objectfilelist \hspace{ 0.5 in} : Make externals available for linking
P \hspace{ 0.6 in} file \hspace{ 1.2 in} : Print a file or files
PASS \hspace{ 1.9 in} : Set users password
PASCAL \hspace{ 0.3 in} file \hspace{ 1.2 in} : Compile a Pascal program
PERMIT \hspace{ 0.3 in} file / permission \hspace{ 0.3 in} : Set permission on files
RENAME \hspace{ 0.3 in} old / new \hspace{ 0.9 in} : Rename a file
SET \hspace{ 0.5 in} owner \hspace{ 1.1 in} : Set to owner directory (cf. BECOME)
SHOWSYM \hspace{ 0.2 in} symbol \hspace{ 1.1 in} : See if the symbol is defined
SUGGEST \hspace{ 1.7 in} : Submit a suggestion about the system
T \hspace{ 0.6 in} input / output \hspace{ 0.5 in} : Create, Copy, Type files
TO \hspace{ 0.5 in} file \hspace{ 1.2 in} : Redirect output to file
USERS \hspace{ 1.8 in} : List the users logged onto filestore
UTILITIES \hspace{ 1.5 in} : HELP UTILITIES for more commands
V \hspace{ 0.6 in} file / file \hspace{ 0.7 in} : Use the Visual ECCE editor
VAX \hspace{ 1.9 in} : Log onto the VAX (if essential!)

\subsection{Systems}

The current APM operating system is a single process system which was designed
in the early days of the APM to get the machines working and though adequate
for most uses is not intended to be the final operating system for these
machines.
The MUSS operating system is running on one machine and the multiprocess
MOUSE operating system should become available during the session.
All information here refers to the old system.

This document is accessible as HELP INTRO on the APMs
J. Butler
\vspace{.75in} view:Intro printed on 09/02/89 at 17.15

\newpage
\tableofcontents
\end{document}
