Category : Communication (modem) tools and utilities
Archive   : VTRANS.ZIP
Filename : VTRANS.DOC

 
Output of file : VTRANS.DOC contained in archive : VTRANS.ZIP
CHAPTER 19 VTRANS7 AND VTRANS8 PROTOCOLS

VTRANS7 and VTRANS8 are Coefficient's own error-correcting file
transfer protocols. They can be used to transfer any kind of
file.

Because VTRANS7 converts the data into a printable ASCII
representation before it is transferred (and then converts it
back at the other end), and since it appends end-of-line
characters to each block, VTRANS7 can be used on host computers
which don't (or don't easily) support a transparent 8-bit data
path or "delimiterless" reads.

VTRANS transfers can be directed entirely under host computer
control. The PC filename, the operational parameters, and the
start command can all be given by escape sequences. Unattended
single and multiple file transfers can thus be performed using
VTRANS7 and VTRANS8.

On the negative side, the VTRANS protocols require software on
both sides of the transfer. Coefficient has supplied you with
eight host-side source code modules on diskette.


HOW TO INSTALL THE VTRANS HOST SOFTWARE

VTERM/220 comes with the following host programs in source code:

B8VMS.BAS
F8VMS.FOR (and its companion F8VMS.DEC)
F7VMS.FOR (and its companion F7VMS.DEC)
B8RSTS.BAS
B7RSTS.BAS
F7RSX.FTN (and its companion F7RSX.DEC)
C8UNIX.C (and its companions C8UNIX.H and C8MAKE.FIL)
C7UNIX.C (and its companions C7UNIX.H and C7MAKE.FIL)

The programs with VMS in their names are for use on DEC VAX
computers running under the VMS operating system. The VAX soft-
ware requires that the host computer have either a BASIC or a
FORTRAN-77 compiler.

Those whose names contain the letters RSTS are for use on DEC
PDP-11s running under RSTS/E. RSTS/E systems all come equipped
with the appropriate BASIC + compiler for the RSTS programs.
The program with RSX in its name is for use on DEC PDP-11s
running either RSX-11M or M+. The RSX program requires a
FORTRAN-77 compiler.

The programs with UNIX in their names are for use on a great
variety of UNIX and XENIX systems. UNIX systems come equipped
with the appropriate C compiler needed by the UNIX host software
programs.

For easy recognition, the first letter of each programs name
indicates whether it is written in a form of BASIC, in FORTRAN,
or in C. In addition, the digit in second position indicates
which of the VTRANS protocols it supports, 7-bit or 8-bit.

All the programs are extensively commented and include users'
notes and other valuable information.

The first step is to choose which of the supplied programs you
can and want to use. Then simply transfer the file with that
source code from the PC diskette to your host computer using
ASCII Text Protocol. (For instructions, see the ASCII.XFR file.)

Make sure you transfer any companion files indicated in the file
table above together to the same account and directory. All the
files should end up having the same name as on the distribution
diskette, with the exception of C8MAKE.FIL and C7MAKE.FIL.
Whichever of these two files you need for your UNIX system should
be uploaded to your host and named "makefile".

For example, if you're going to use F8VMS.FOR, the FORTRAN
program for the VAX computer, be sure to also transfer the file
named F8VMS.DEC and make certain that it is named F8VMS.DEC on
the host and that it resides in the same directory as its
companion.

After the program you've chosen is compiled on the host computer,
you will be ready to use the VTRANS protocol it supports. These
are the commands to be typed in to the host to compile each
program:

To Compile B8VMS.BAS:
BAS B8VMS
LINK B8VMS
REN B8VMS.EXE VTRANS.EXE

To Compile F8VMS.FOR:
FOR F8VMS
LINK F8VMS
REN F8VMS.EXE VTRANS.EXE

For F7VMS.FOR:
FOR F7VMS
LINK F7VMS
REN F7VMS.EXE VTRANS.EXE

To Compile B8RSTS.BAS
SW BASIC
EXTEND
OLD B8RSTS
COMPILE
PIP VTRANS.* = B8RSTS.BAC/RE

To Compile B7RSTS.BAS
SW BASIC
EXTEND
OLD B7RSTS
COMPILE
PIP VTRANS.* = B7RSTS.BAC/RE

To Compile F7RSX.FTN
F77 F7RSX=F7RSX
TKB
/
VTRANS/FP=F7RSX,[1,1]F4POTS/LB,RMSLIB/LB
MAXBUF=512
//

Note: On some RSX systems [1,1]F4POTS/LB will be known by
another name. Consult your system manager if there is a problem
compiling with the above sequence of commands.

To Compile C8UNIX.C and C7UNIX.C
make

Note: There are two major "flavors" of terminal drivers for UNIX
systems. If the program fails to link, edit the makefile to
c hange TYPE2 to TYPE1 or vice-versa.

If you have a problem compiling the program, consult the intro-
ductory comments at the beginning of the source code file. These
discuss some of the possible reasons why your system will not
compile the program and what remedies you can take.

If none of the described situations applies in your case, the
most likely problem is a transmission line error in transferring
the program file to the host. Try it again.

Once you have successfully executed the commands in the small
table above, you are ready to use VTRANS to exchange files with
your host computer. The procedure is described in the next
section.


HOW TO USE VTRANS WITH A HOST COMPUTER

This section explains how to use VTRANS with a host computer.
For information on using VTRANS to transfer files from one PC to
another PC, see "PC to PC File Transfers" later in this file.

Before you can use VTRANS7 or VTRANS8 to exchange files with a
host, you must upload a VTRANS program to the host and compile it
as described in the previous section.

After the host VTRANS program has been properly installed, you
can use it with VTERM to transfer files to or from your PC.

Below are the commands you use to start VTRANS file transfer.

_________________________________
OPERATING COMMAND TO
SYSTEM START VTRANS
_________________________________
RSX
VMSRUN VTRANS
RSTS

UNIX VTRANS
_________________________________

In response to the command to start VTRANS, the host program asks
you questions and then prompts you to begin a VTRANS transfer by
pressing the Enter key.

To give the default answer to a particular question in the VTRANS
dialog, just press the Enter key.

If you end the answer to a question with a semicolon (;) default
answers are assumed for all remaining questions in the dialog and
transfer begins immediately.

To automate VTRANS, you can make text files with answers to the
VTRANS dialog questions. This is explained in the next section.


UNATTENDED AND MULTIPLE VTRANS TRANSFERS

VTRANS with VAX VMS: If your host computer is a VAX, both VMS
programs supplied with VTERM fully support the operating system
facilities for redirecting command input and program message
output.

In addition, answering the first dialog question (Which direction
is transfer?) with @ makes the host program take
answers to the dialog from the indicated file. At the end of the
file, input will revert to interactive.

Note: The VTRANS dialog for VTERM/220 is the same as for
VTERM III. If you have been using only VTERM II, you can
use old VTRANS command files, but you must indicate them with
~ rather than @ .

After each successful (or unsuccessful) transfer, the programs
return to the beginning of the dialog. Whether the host program
is being directed from the keyboard or from a command file,
choosing option four on the menu terminates the process.

VTRANS with RSTS/E: On RSTS/E systems, the above process is
emulated by the program asking for the name of a command file, if
any, and taking the responses for the dialog from the file
entered in response to the question. A log file is generated
(VTRANS.LOG) which can later be consulted to follow the results
of the multiple transfer.

VTRANS with RSX: Answering the first dialog question (Which
direction is transfer?) with @ makes the host program
take answers to the dialog from the indicated file. At the end
of the file, input will revert to interactive.

Note: The VTRANS dialog for VTERM/220 is the same as for
VTERM III. If you have been using only VTERM II, you can
use old VTRANS command files, but you must indicate them with
~ rather than @ .

VTRANS with UNIX: On UNIX systems unattended and multiple file
transfers are accomplished by invoking a command file with the
syntax vtrans . For example, if the command file is
named cmds, to invoke it you enter vtrans cmds.

For technical reasons, UNIX standard input/output redirection is
not supported. Under some versions of UNIX, all responses in a
UNIX command file must be explicit; blank lines in a file will
not be interpreted as default responses as they would be if the
responses were entered from the keyboard. It is sufficient,
however, to have a blank line in a command file to respond to the
final PRESS TO BEGIN TRANSFER question in the VTRANS
dialog.


PC-TO-PC FILE TRANSFERS

When transferring to or from another PC:

þ Be sure that Local echo is set ON on Setup Screen One so
you can see any messages that you type to the other computer
before and after file transfer.

þ Set New line mode ON if someone is attending the other PC.
During the file transfer, the PCs will not be able to
communicate via the keyboards.

You can use any of the file transfer protocols for exchanging
files with another microcomputer so long as the other
microcomputer is running software which supports the chosen
protocol.

If the other micro is a PC running VTERM, then the best protocol
to use is VTRANS8.

When you run VTRANS8 or VTRANS7 protocol between two PCs, one PC
functions as the active PC, and the other as the passive PC. The
active PC may be either the sender or receiver. The active PC
automatically sets Protocol, Block Size, Direction, and End-of-
Block (if VTRANS7) on the passive PC by the active PC.

Before using VTRANS to transfer files between PCs, you should
read "How to Transfer Files" in the INTRO.XFR file.

The steps for completing PC-to-PC transfer are outlined below.
All these instructions apply if you are the operator of the
active PC.

1. Press Alt-T (for transmit) or Alt-R (for receive).

2. Complete the fields in the File Transfer Window by toggling
with the Plus (+) key or by typing as appropriate.

3. Press Alt-T or Alt-R again to start the transfer.

To cancel the transfer, press Esc before pressing Alt-T or Alt-R
the second time

You can terminate the transfer at any time from either the active
or passive PC by pressing Alt-A (for abort), Alt-S (for setup),
or the hot key (to exit temporarily to DOS).

_______________________________________________________
| |
| Filename: \REP\BARB.DAT |
| Protocol: VTRANS (8-BIT) |
| Remote Filename: BARB.BAK |
| If File Exists: PROMPT |
| Ctrl-Z Marks End: NO |
| Translate: OFF |
| Remove Characters: |
|_______________________________________________________|
Arrow keys select, + changes. Alt-T=Transmit,Esc=Cancel

Figure 19-1. File Transfer Window for VTRANS, PC-to-PC
Transfer. The VTRANS8 window for transmitting
a file is shown. The VTRANS8 receive and VTRANS7
receive and transmit windows have the same fields.


File Transfer Window Fields
for PC-to-PC Transfer using VTRANS Protocol

When you press Alt-T or Alt-R the first time, a File Transfer
Window, like the one illustrated in Figure 19-1, appears.

Complete the fields in the window by toggling with the numeric
keypad Plus (+) key or by typing. The fields are described
below.

Filename: Type the name of the file on the local PC.

Protocol: Toggle this field until VTRANS7 or VTRANS8 appears.

Remote Filename: Type in the name of the file on the remote PC.

If File Exists: This field determines what VTERM does if a file
already exists on the receiving PC with the same
name as the received file. You choose one of the
following:

þ OVERWRITE, VTERM erases the old file while
writing the new one to disk.

þ RENAME, the new file is renamed to avoid
overwriting the old file. (VTERM renames the
file by replacing the last character of the file
extension with a zero. If such a filename
already exists, VTERM uses a 1, then a 2, etc.,
up to 999.)

þ PROMPT, VTERM prompts you when the new file is
received and gives you the option of aborting,
overwriting, or renaming.

Ctrl-Z Marks End: When you are sending a file and select YES for
this setting, VTERM sends a Ctrl-Z if it encounters
one in the file and then stops sending. If the file
does not contain a Ctrl-Z, VTERM sends one after sending
the entire file.

When you are sending a file and select NO, VTERM
sends the file exactly as it it is, including any
Ctrl-Zs if any.

When you are receiving a file and select YES for
this option, VTERM appends a Ctrl-Z at the end of
the file if one is not already there. Otherwise, VTERM
receives the file exactly as it is sent.

When you are receiving a file and select NO, VTERM
receives the file exactly as it is without changes.

If you wish to remove a terminating Ctrl-Z from a
file that already has one (or may have one), enter
<26> in the Remove Characters field (see below).

If you are transferring a file that contains binary
data -- an .EXE or .COM file, for instance -- select
NO for this setting. If you are transferring a text file,
you should usually select YES.

Figure 19-2 summarizes the effects of choosing YES
or NO for this option.

__________________________________________________________
If Ctrl-Z Marks End field is . . .
YES NO
__________________________________________________________
When Stop at first Ctrl-Z Send file exactly
Sending don't send it or as it is.
File following characters.

When Append Ctrl-Z at end Receive file
Receiving of file if it lacks one; exactly as it is.
File otherwise receive file
exactly as it is.
___________________________________________________________
Figure 19-2. Effect of Ctrl-Z Marks End of File

Translate: This field determines whether VTERM translates
certain foreign language characters during file
transfer. Select OFF if you do not want translation.
Select ON if you do. For ASCII file transfer, you
probably want this option ON.

Remove Characters: Use this field to specify characters that you
want VTERM to remove from the file before
writing it on disk. You can enter control
characters in this field between angle brackets
either as decimal values (for example, <13>) or
as mnemonics (for example, ).

CAUTION: VTERM removes spaces from your file
if you accidentally leave a space character in
this field. If there is data in this field,
the small triangular character appears at the
end of the data just as in the filename field.


  3 Responses to “Category : Communication (modem) tools and utilities
Archive   : VTRANS.ZIP
Filename : VTRANS.DOC

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: http://www.os2museum.com/wp/mtswslnk/