!START-OF-VAXNET.HLP
!
!	VAXNET  -  VAX Hosted Virtual Terminal Handler and File Transfer
!		   Program for Communication with Remote VAX/VMS,
!		   PDP10/DECsystem-10, or PDP11xx/(RSX11M/V3.1 with FORTRAN
!		   IV Plus)
!
!Authors:  Roger Lipsett, John Thompson  Intermetrics
!
!Date:	   22 May 1979
!
!Modules:
!
!VAX HOST: VAXNET.FOR, GETSEND.FOR, SETPRN.MAR
!
!REMOTE CPUS
!
!VAX:	   SNDRCVVAX.FOR
!
!PDP10:	   SNDRCV.F10, SPLUTL.MAC
!
!PDP10 at Carnegie Mellon University:    SNDRCVCMU.FOR,SPLUTL.MAC
!
!PDP11:	   SNDRCV11M.FTN,TECIN.FTN
!
!Program Generation:
!
!BOOTSTRAP:  It is possible to downline load any or all of VAXNET sources
!	   using TECO on a remote VAX or PDP10 and the TECOINPUT command
!	   on the host VAX.  On a PDP11 one must first type in a short
!	   program, TECIN.FTN, F4P and TKB it, RUN it and use the TECO
!	   INPUT command as on the -10 or VAX.  See the TECOINPUT command
!	   for further information.
!
!VAXNET	   LOGIN UNDER SYSTEM MANAGER'S ACCOUNT
!  ON	   FOR VAXNET
! HOST	   FOR GETSEND
! VAX:	   MAC SETPRN
!	   LINK VAXNET,GETSEND,SETPRN
!	   COPY VAXNET.EXE [SYSEXE]*
!	   SET DEF [SYSEXE]
!	   SET PROT=(SY:RWE,OW:RWE,GR:RE,WO:RE) VAXNET.EXE
!	   RUN INSTALL
!	   VAXNET /PRIV=(PHY_IO,ALTPRI,PSWAPM)
!	   Or, for later updates, VAXNET/REPLACE.
!	   (CTRL Z)
!	   SET TERM TTnn: /PASS/NOECHO/TAB/REM/NOBR/PERM/SPEED=300 or 1200
!
!	   DZ11 port TTnn should be dedicated to the modem which is used for
!	   dialing up to the remote cpu.
!
!REMOTE CPUS:
!
!PDP10:	   COMPIL SNDRCV.FOR	! Unnecessary, as the LOAD will compile it.
!	   COMPIL SPLUTL.MAC	! Unnecessary, as the LOAD will compile it.
!	   LOAD SNDRCV,SPLUTL
!	   SAVE SNDRCV
!
!VAX:	   FOR SNDRCVVAX
!	   LINK SNDRCVVAX
!
!PDP11:	   F4P SNDRCV11M=SNDRCV11M
!	   TKB SNDRCV11M/-CP=SNDRCV11M
!	   F4P TECIN=TECIN
!	   TKB TECIN/-CP=TECIN
!
!	   When you RUN SNDRCV11M, it must have its PRIORITY set high enough
!	   to insure that the WTQIO will always get all the characters that
!	   come into the PDP11 terminal port.  A priority of /PRI=51 will
!	   usually work.  Thus,   RUN SNDRCV11M /PRI=51
!	   The TECIN program also requires adequate priority.
!	   N.B.  You must be privileged to run tasks in this way.
!
VAXNET is a virtual terminal handler hosted on the VAX that contains
protocol and procedures for transferring ASCII files to or from remote
cpus from or to the VAX via an asynchronous modem connection.

A procedure for transmitting binary files in which the data is in industry
compatible mode on the -10 has also been invented, and an implementation of
-10 to VAX transfer of AN/UYK-20 SYSGEN files can be used as a template for
development of procedures for transferring other types of binary files
between other systems.

Print the [SYSHLP]VAXNET.HLP file for installation procedures.

For more information see the topics below.

*GENERAL

There are several things to remember about the virtual terminal part
of VAXNET.  One is that all prompts from remote cpus are lost except in
very curious situations of rapidly typing carriage return.  Thus when
you expect a prompt for PPN # or PASSWORD during LOGIN, you won't get
anything except perhaps a carriage return line feed (CRLF).  In general,
the VAX terminal handler reads only input lines from remote cpus which are
CR terminated.  Also, the VAX terminal handler is used to echo your typed
input.  So when you type a LOGIN 123,456 command, a -10 will also echo it.
There are other peculiarities about default terminal characteristics
that you will want to change once you get logged in to the remote cpu.
These settings are given below following the general discussion.  Another
restriction is that only carriage return and escape can be sent by
typing them directly.  (N.B. The VAX will echo the escape as $.)

*CONTROL_CHARACTERS

To send control characters CTRL C is first typed followed on the next
line by the upper or lower case alpha(s) that you wish to send.  Sending
two CNTRL C's to a -10 or VAX would be done as follows:

^C
CC

Unfortunately, one cannot use this mechanism to send CTRL C's to RSX11M
to get back to MCR level.  Thus there is no easy way to abort typeout
from say a PIP TI:=FILENAME.FOR command.  To abort the SNDRCV11M
program, one does type CNTRL C, and then after the abort message
types C.  The sequence would look like

^C
 MESSAGE ABOUT ABORTING
C

Whenever one uses the ^C method that does not interrupt SNDRCV,
any sequence of characters longer than 2 is expected to be a command.
A CTRL C followed by another CTRL C will trap back to the VAX command
interpreter. (This is not the proper way to terminate VAXNET.
Instead, use the STOP command.)

*COMMANDS

The commands to VAXNET are:

	GETA or GETA[SCII] - get an ASCII text file from the -10
	GETL or GETL[ISTING] - get a FORTRAN carriage control
			       formatted ASCII listing file from -10
	GETS or GETS[YSGEN] - get a ANS/UYK-20 SYSGEN file from -10

	SENDA or SENDA[SCII] - send an ASCII text file to the -10

	STOP - stop the VAXNET program and close down properly

	TECO or TECO[INPUT] - use TECO on -10 or VAX to downline
			      load source text for SNDRCV, etc
			      without using protocol.  On the PDP11,
			      since RSX11M does not allow disabling
			      echo, one must use a short 19 line
			      program called TECIN to write the
			      input from the TECO command into a
			      prenamed file SR.FTN.

Commands can be abbreviated or written out or partly written out.

The TECOINPUT command requires some more explanation.  First start TECO.
On a -10 the command MAKE FILE.F10 will get you into TECO and create
the file FILE.F10.  On a VAX the command should be

	MCR TEC
	EWFILE.FOR$$

On RSX11M use RUN TECIN.
At this point the VAXNET command TECO should be given.

	^C
	TECO
	NAME OF THE VAX FILE? you usually type SNDRCVxxx.yyy

The TECO procedure will format and send the VAX file to the file open
on the remote cpu.  There will be no checksumming.  When the file ends
on the VAX, the remote file is closed and the remote program (TECO or
TECIN) stops.  VAXNET is now in virtual terminal mode again.
Remember, the TECIN program will have named the file SR.FTN and you
will probably want to rename it.

*EXAMPLE

A sample terminal session with VAXNET is included here with comments:

$SHO TERM TTnn:  !Check if anyone is using the port to the remote cpu
		 !If OWNER=SELF, you can use it
$MC VAXNET	 !This will run the installed VAXNET program
 INTERMETRICS VAX VIRTUAL TERMINAL HANDLER - VAXNET - (REV 1.3)
NAME OF VAXNET DZ11 OUTPUT PORT (e.g. _TTB7:)?  you type say TTB7
TTB7 RCHANIN NOT ASSIGNED  !This means either someone else has the
			   !modem or the modem should be turned off
			   !then on a few times to clear TTB7.
$MC VAXNET	 !Try again
 INTERMETRICS VAX VIRTUAL TERMINAL HANDLER - VAXNET - (REV 1.3)
NAME OF VAXNET DZ11 OUTPUT PORT (e.g. _TTB7:)?  you type TTB7
	!Now dial up a -10 from the modem connected to TTB7
	!Wait about 15 seconds after seeing carrier go on in the modem
	!and get the -10's attention by sending a CTRL C.
^C
C

NRL-603-12 hh:mm:ss TTYnn system xx	!-10 sends these
Please LOGIN or ATTACH			!messages

LOGIN 123,456		!You type this
LOGIN 123,456		!-10 echoes this


ABCDEFG			!You type password, VAX echoes, -10 doesn't

nnnn   dd-mmm-yy   day	!-10 sends some date info
No mail			!and may or may not send some mail

TT NO ECHO	!You type
TT NO ECHO	!-10 echoes

TT NO BLANKS	!You type

TT NO FILL	!You type
TT NO CRLF	!You type
TT TABS		!You type - This finishes changing TTY characteristics
		!on the -10
RUN DSKD:SNDRCV[132,1617] !Start up the -10 program that communicates
			  !with the VAX
^C		!Now give the appropriate VAXNET command
GETS		!We want a SYSGEN file here
WHAT IS THE NAME OF THE -10 FILE? SOFTIM.ABS  !We answer with file name
NAME OF THE VAX FILE? SOFTIM.ABS	      !Again answer file name
					      !Either the -10 or the VAX
					      !filespec, or both, may be
					      !fully qualified.
RECORDS    1 THROUGH   10 SUCCESSFULLY TRANSFERRED. !Progress report
RECORDS   11 THROUGH   20 SUCCESSFULLY TRANSFERRED. !More progress
...
...
RECORDS  221 THROUGH  227 SUCCESSFULLY TRANSFERRED. !Last part
FILE TRANSMISSION COMPLETE,        28976 BYTES TRANSFERRED.

STOP	!FORTRAN STOP message from -10

END OF EXECUTION   !Message from -10

K/F	!LOGOUT from -10
^C
STOP	!Want to shut down VAXNET
$LO	!LOGOUT from VAX

*CANCEL_FILE

VAX or -10
----------

Should it be desired to cancel the file transmission process, this is
accomplished by doing a CTRL C operation to get out of transmission
mode.  Then you will be in virtual terminal handler mode and can send
two CTRL C's to abort the SNDRCV process on the remote cpu.  You can now
restart the transmission process or do whatever else is appropriate.

PDP11 RSX11M
------------

Type CTRL C, and then after the abort message, type C.

*SPECIAL_CHARACTERS

ARPANET PROBLEMS
----------------

Using the SENDA command from VAXNET via an intermediary TIP will give
difficulty with text containing @ symbols.  The simple solution is
to change all @ symbols to some other little used character like the
back slash symbol \.  Do this prior to running VAXNET using TECO.
Once transmitted, the files with \ can be changed back to @ on the remote
cpu using TECO and the command <FS\$@@$;$>.  
An alternative procedure is to change the TIP command symbol using
the TIP command
	@I octal #
   e.g. @I 134  makes \ the new TIP command symbol

PDP11 RSX11M/V3.1 TABS
----------------------

Tabs get sent to RSX11M/V3.1 without difficulty.  However, there is no
way to get the terminal driver to send tabs to the outside world.  The
SNDRCV11M.FTN program therefore converts all tabs to back slash before
sending them out.  At the VAX host use TECO on any received files to
change the \'s to tab.  e.g. <FS\$	$;$>.

*WARNING

During SEND or GET commands transmission errors may occur.  Should
this occur during "handshaking", VAXNET will drop back to virtual
terminal level and give a message.  If the errors occur during
file transmission, the resulting error recovery may or may not go
into a loop.  Looping will be obvious with many "...RETRYING"
messages.  When this happens, CTRL C and stop SNDRCV as described
above.  If normal transmission resumes, the destination file may be
corrupted in certain circumstances.  We hope to fix this problem soon.
Meanwhile, conservative practice is to discard a file which had such
transmission problems and to retransmit the file to its destination.

One final word of warning - since the virtual terminal handler does not
give prompts, it is recommended that VAXNET be used mainly for file
transmission.  The vagaries of the various remote operating systems
do not lend themselves to easy solution of the general virtual terminal
handler problem and their solution is beyond the intent of the VAXNET
program.

*SUMMARY

To Start VAXNET on VAX    $MC VAXNET

Remember Usually No Prompts from remote cpus

To Send Control Characters		To Send Commands

^C					^C
Character				Command Name

			Minimum
Command			Abbreviation

GETASCII  		GETA
GETLISTING		GETL
GETSYSGEN 		GETS
SENDASCII 		SENDA
STOP			STOP
TECOINPUT		TECO


PDP10 SUMMARY
-------------

To Start Complementary PDP10 Program   RUN DSKD:SNDRCV[132,1617]

PDP10 TTY Settings

TT NO ECHO
TT NO BLANKS
TT NO CRLF
TT NO FILL
TT TABS


VAX SUMMARY
------------

Before dialing up get the SYSTEM MANAGER at the remote VAX to set the
dial up port to NOECHO.  e.g. SET TERM TTxx /NOECHO/PERM

Remember no prompts or remote echoing will occur.

To Start Complementary Remote VAX Program   RUN SNDRCVVAX

Once logged on do the following TT settings

VAX TT Settings

SET TERM TT /NOWRAP/WIDTH=132/TAB/NOBROADCAST


PDP11 RSX11M/V3.1 SUMMARY
_________________________

After logging on to the PDP11 get the SYSTEM MANAGER to alter the basic
priority of your task to guarantee adequate QIO response.

e.g. ALT TT7 /PRI=51. should do

Alternatively get the SYSTEM MANAGER to install SNDRCV with adequate
priority.

e.g. INS SNDRCV /PRI=51.

Then you can RUN SNDRCV without losing input characters.

PDP11 RSX11M/V3.1 Terminal Settings

SET /CRT=TI:
SET /BUF=TI:200.
SET /LOWER=TI:

!
!END OF VAXNET.HLP

