PCjs Machines

Home of the original IBM PC emulator for browsers.

Logo

PC-SIG Diskette Library (Disk #188)

[PCjs Machine "ibm5160"]

Waiting for machine "ibm5160" to load....

Information about “MINITEL”

MINITEL is an asynchronous communications program for any MSDOS or PCDOS
machine.  The program's author calls it a "stripped version of TELINK."
MINITEL can receive or transmit files in XMODEM, MODEM7 (batch) or
TELINK modes.  It is menu-driven, with all commands accessible by two
keystrokes.  Error handling is simple and straightforward.
Documentation is provided on the disk.

Features:

~ MINITEL  can receive or transmit files in XMODEM,
MODEM7(batch) or TELINK modes
~ MINITEL is menu driven, with all commands accessible by two
keystrokes
~ Most command keys are mnemonic
~ Error handling is simple and straightforward
~ Error recovery usually consists of some default action
~ Illegal baud rate selections result in no change
~ All error messages are in plain English, so you don't have
to memorize secret codes

System Requirements: Serial port, and a modem.

How to Start:  From DOS, enter TYPE MINITEL.DOC for documentation.  To
run MINITEL, at the system prompt enter MINITEL <ENTER>.

File Descriptions:

IBMMINI  EXE  IBM PC version of MINITEL MINITEL  ABS  Abstract
MINITEL  DOC  Documentation
MINITEL  LBR  File transfer program
MINITEL  DQC  Compressed documentation

CRC.TXT

PC-SIG Disk No. #188, version v1

The following is a list of the file checksums which should be produced by
the CRCK4 program on disk #9 (and others).  If the CRC numbers do not match
you may have a bad file.  To use type:  CRCK4 <filespec>

CRCK4 output for this disk:


CRCK ver 4.2B (MS DOS VERSION )
CTL-S pauses, CTL-C aborts

--> FILE:  IBMMINI .EXE         CRC = CF 1F

--> FILE:  MINITEL .ABS         CRC = 11 BB

--> FILE:  MINITEL .DOC         CRC = 2A 6B

--> FILE:  MINITEL .DQC         CRC = 6C DA

--> FILE:  MINITEL .LBR         CRC = 69 FA

--> FILE:  XXX     .            CRC = 18 2D

 ---------------------> SUM OF CRCS = FA 46

DONE

These and other Public Domain and user-supported programs from:

PC Software Interest Group
1125 Stewart Ct  Suite G
Sunnyvale, CA 94086
(408) 730-9291

MINITEL.DOC

	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 1






        -----------------------------------------------------------------
             This  program  is made available free of cost  to  all  non-
        commercial users. It is not to be sold or traded in any form.


             Please  leave any questions,  suggestions and problems at my
        BBS:
                  Fido (415)-864-1418

             MINITEL  is  a  stripped version of  TELINK.  The  following
        functions  have  been  removed:   text  download,   auto-dialing,
        telephone  directory  support,  SmartModem  modes  and  controls,
        console  control character  processing,  configureable  keyboard,
        file transmission/reception statistics.
        -----------------------------------------------------------------

        	MINITEL is an asynchronous communications program for any
        MSDOS  or  PCDOS machine.  (A version must be  configured  for  a
        particular machine.)

        	MINITEL  can receive or transmit files in XMODEM,  MODEM7
        (batch)  or  TELINK modes.  TELINK mode is  described  in  detail
        later,  but  basically  it is a MODEM7 compatible  protocol  that
        supports DOS exact file sizes and dates.

        	This manual is divided into a number of sections:

        	Section 1	Operating TELINK
        	Section 2	Quick Command Summary
        	Section 3	Command Descriptions
        	Appendix A 	File Transmission Format
        	Appendix B 	File and Path names
        	Appendix C	Command prompt Line Editing
        	Appendix D	TELINK console details
        	Index

        	The  first  section walks you through operating  MINITEL,
        and gives you a feel of how it works.   Section 2 is a  one  page
        list  of MINITEL's  commands,    followed  in section  3  with  a
        complete descrip tion of each.  You will find all commands in the
        index. You do not need to read any appendixes to operate MINITEL;
        they  are provided  for more detailed  operating  and   technical
        information.

        	To   run  MINITEL,   you need (besides the computer)  64K
        of memory,   a  disk of some sort,  a serial port,  and a  modem.
        You  will  have  to refer to your modem  manual  for  details  on
        dialing and making connections.











	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 2






        1.00            O P E R A T I N G   M I N I T E L

        	MINITEL  is menu driven,   with all  commands  accessible
        with  two   keystrokes.   You   do  not need to  enter  and  exit
        "modes"  or levels to get where you want.  Most command keys  are
        mnemonic.

        	Error  handling  is  simple,    straightforward  and  non
        dangerous,   especially in entering keyboard commands.  (Like all
        programs,    you  can  bash  diskfiles if you try hard   enough.)
        Error recovery usually consists of some default action;  entering
        a non-existent command results in a list of available   commands;
        ente ring  a blank line at a prompt quits that command;   illegal
        baud rate  selections  result in  no  change,    etc.  All  error
        messages are  in plain English,   so you don't have  to  memorize
        secret codes.

        	Running MINITEL is easy: at the system prompt, type:

        	A: MINITEL <cr>

        	MINITEL  clears the screen,  displays it's signon on  the
        top two lines,  and waits for commands.  At this point,  anything
        you type goes directly to your modem;  for a SmartModem,  you can
        dial and make your connection.


































	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 3






        Entering Commands:

        	MINITEL   provides  fancy line editing whenever you  need
        to enter filenames or whatever; see Appendix C for details.

        	MINITEL  is always in communication mode;  if  the  modem
        were  to receive data,  it would be displayed on the screen  now,
        and you could type directly back to it.

        	With  the  cursor still in the lower  left  corner,  type
        ESCape. The cursor now moves to the upper left corner, and types:

        		Command: _

        	If you wait a second or so, the menu is displayed.

        	Entering  one  of the command letters from the  menu  now
        executes  that  command.  (How to send an  ESCape?  Type  another
        ESCape.)  If  you type a key that's not a command,  MINITEL  will
        type  the menu again (if it's not already there),   display  your
        screen,  and return the cursor to where it came from. You can get
        the menu  at  any time by typing the ESCape key,    and   waiting
        about one  second.

        	If  you type the ESCape key,  followed by a  command  key
        within  one  second,  the  command will be  executed  immediately
        without  displaying the menu.  This provides an expert mode  once
        you remember the command keys.































	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 4






        2.00              C O M M A N D   S U M M A R Y

        Here is a quick list of command available in MINITEL.

        	Text and character oriented commands.

        ESC C	Save all console conversation.
        ESC S	Stops the 'C' command.
        ESC L 	Auto linefeeds on.
        ESC M 	Disable Auto line feed (default)
        ESC F 	Full duplex. (default)
        ESC H 	Half duplex.
        ESC ESC Send an ESCape.
        ESC V 	Parity selection. (none, default)

        	File oriented commands.

        ESC R 	Receive file(s) in selected mode
        ESC T 	Transmit file(s) in selected mode
        ESC N   Select a file transfer protocol

        	System and miscelaneous commands.

        ESC ?	List current MINITEL settings.
        ESC Q 	Quit. Closes any text collection file.
        ESC B	Select a baud rate for the modem. Default is 300.
        ESC Y	List disk files, sizes and transmission times.
































	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 5






                    C O M M A N D    D E S C R I P T I O N S

        	All  of  the following commands act somehow on the  disk.
        Some  create files and write on the disk;  with these you can  do
        things like delete files or change their contents,  so some  care
        is required.

        	ESC Y		List disk file information

        	The   'Y'  command is similar to a DIR command  from  the
        operating  system,   but   gives you more information.   You  are
        asked for  the name of files to look for;  entering an empty line
        is the same as *.*, like the DIR command.

        	Under  MSDOS  version 2.00,  you can  enter  a  pathname,
        specifying the directory you want to look at. If you do not, only
        files  within the current directory are listed.  Wildcards cannot
        be used in the directory portion of the path name.

        	In  addition to the file names,   MINITEL gives  you  the
        file  size,   in  bytes,   and the time it would take to send it,
        at the current baud rate.(See the 'T' and 'R' file   transmission
        commands.)

        	The transmission times are of course approximate, because
        errors sometimes occur,  requiring blocks to be resent, and other
        variables in both computers. The guesses are a little on the safe
        side for that reason.  It also takes time for the person  running
        each  each  computer to type whatever is necessary to start  file
        transmission,   and  of  course  this cannot  be  accounted  for.
        Transmission  times are most accurate when sending more than  one
        file, using the automatic batch mode.

        	After all the files are listed, the total file count, and
        the total  size and transmission times for all of the  files   is
        listed.























	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 6






        	ESC C 	Collect text

        	This  asks you for a file name,  then starts putting  all
        text  you  see  on the screen into  it.   Everything  the  remote
        computer   sends you is saved as is.   (Control-Z characters  are
        NOT  put  in the file if they appear from the modem  or  console;
        this prevents "lost" data.    Though one is put at the end of the
        file when it is closed.)

        	The  text  file  can be closed  by  the  S  command,   or
        automatically   by  the  ESC Q command.   You will get  an  error
        message  if you try an ESC C when one is already in effect.

        	Text  is  temporarily stored in memory;  every once in  a
        while it must be written out to disk to make room for more.  When
        MINITEL  is  almost out of room,  it sends  a  control-S  to  the
        remote  computer,   to tell it to pause sending data.   Up to  82
        characters after the control-S are collected,  to give the remote
        a chance to stop.  Then, the text is written out to the disk, and
        a control-Q  is sent to tell it that it may continue.    This  is
        done automatically by MINITEL.

        	Most  remote  computers will pause when  a  control-S  is
        received;   if   it  does  not,   you will probably  lose  a  few
        characters.  On systems with hard disks, you won't lose more that
        10 or so; with mini-floppies, you may lose up to 40 or so.

        	If  the  disk fills up while collecting  text,  an  error
        message  will  appear at the top of the  screen.  If  the  screen
        happens  to  scroll while you're not looking,  you won't see  the
        message. Oh well.

        	When   MINITEL is first run,   it gets as much memory  as
        it can  (up to 64K) to use as the text buffer.   You can see  the
        amount available using the ESC ? command.   The only  thing  this
        affects  is  how  often  MINITEL must write saved  text  to   the
        disk;  the  more memory, the less often it must write it out.






        	ESC S 	Stop text collection

        	Stops the collection of text.  (The 'C' command.) You get
        an error  message if you're not  collecting  text.     Appends  a
        control-Z  to  the file,   flushes it and closes the disk   file,
        where  you  can type,  print or edit it.  If you forget  to  stop
        collecting,   MINITEL  will  do  it  when you exit  via  the  'Q'
        command.








	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 7






        	ESC T 	Transmit file(s)
        	ESC R 	Receive file(s)

             The  T  (transmit)  and  R (receive) commands  are  used  to
        transfer files,  to a similar program running on another machine.
        Either   binary  or  text  files  can  be   transmitted.    Error
        detection  and recovery are done automatically.

        	There  are  a  number  of  ways in  which  files  can  be
        transferred; see ESC N for details. Selecting the right method is
        important, as transfers sometimes will not work. MINITEL tries to
        automatically  choose  the right transfer mode,  but  it  is  not
        always possible.

             Invoking  either command prompts you for files to be sent or
        received.  Except in XMODEM mode (again, see ESC N) you can enter
        any number  of  filenames,    where  each  can  contain  wildcard
        characters.  Seperate each name with spaces commas or plus signs.
        The filenames can contain drive letters,  and pathnames on  MSDOS
        v2.00.

             The  default  mode on CP/M is MODEM7,  and on MSDOS  is  the
        TELINK mode.   The TELINK mode is identical to MODEM7,  except it
        "sneaks in"  information on exact file size and creation date. If
        you  use this  mode  with  MODEM7 running on the other  computer,
        that  computer   will  get four or six errors on the  first  data
        block,   by which  time  MINITEL will figure out that it will not
        accept   the  extra   information,  and finish the  transfers  in
        MODEM7 mode.

             All  display transmission status continually on the top  two
        lines.   The   current  block  number   being   sent,   estimated
        transmission  time  left,  name,  etc is displayed.  The time  is
        constantly  recalculated,  and may be blank if:  (1) less than  1
        second,  or (2) receiving a file where the file size is  unknown.
        EXAMPLES:

             The  following  are valid filenames that can be entered  for
        transmitting files. (XMODEM can only accept a single filename.)

             FOO.COM                            send one file
             B:FOO.COM                          send one file
             FOO.*                              one or more files
             B:FOO.*,XYZ.ASM                    one or more files
             FOO.COM,\BIN\*.COM,/WORK/*.ASM     many files
             AFILE.EXE,BFILE.DOC ANOTHER.FIL    many files

             These  are  valid entries for  receiving  files.  Note  that
        filenames  themselves  are ignored,  since the actual  names  are
        received along with the files.

             B:                                 put files on drive B:







	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 8





             ?                                  files to default drive
             *                                  same as above
             \bin\                              put files in \BIN\
             foo                                in default drive
























































	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 9






             ESC N          Select file transmission mode


        	MINITEL  now  supports all popular  file  transfer  modes
        currently in use. These are:

                XMODEM		One file at a time, popular on remote systems,
        	MODEM7		Similar to XMODEM, one or more at a time,
        	TELINK		Similar to MODEM7, but sends DOS info.

        	In  addition,  transfers  can  be  done  with  the  older
        CHECKSUM  method,  or the newer,  more  reliable,  CRC  (Cyclical
        Redundancy Check). This of course makes for six different ways to
        handle files, but it's not really that bad.

        	When receiving file(s) (ESC R) you must select either CRC
        or  CHEKSUM properly.  Most systems that support CRC say so  when
        you  start the transfer.  If you get it wrong,  then you'll get a
        "timeout" or other error; change to CHECKSUM and it should work.

        	The  methods  and how to select one is  described  below;
        first, some suggestions on how to choose the right one.

        BULLETIN BOARDS AND OTHER REMOTE SYSTEMS:

        	Most of these support only XMODEM, so there is usually no
        choice!  (Fido  supports all methods.) More and more systems  are
        supporting CRC mode;  MINITEL defaults to CRC mode. Try selecting
        XMODEM and CRC; if that does not work, try XMODEM and CHECKSUM.

        TO ANOTHER COMPUTER OR SYSTEM USING MINITEL, TELINK, OR MODEM7:

        	Using  the TELINK method,  CRC vs.  CHECKSUM  is  handled
        automatically;  this  is  the  best way to  transfer  files  from
        machine  to machine.  It handles multiple files,  etc so you dont
        need to do ESC T and ESC R for each file. If both have MINITEL or
        TELINK,  then use TELINK and CRC;  if either machine has an older
        MINITEL  or TELINK that does no support CRC,  it will  switch  to
        CHECKSUM automatically.

        	If  MODEM7 is used on one or the other,  you may have  to
        select CHECKSUM.  TELINK mode will switch to MODEM7 automatically
        if necessary.

        SELECTING THE TRANSFER METHOD:

        	After  entering  ESC N,  you will see a small  menu.  You
        select a type by typing the first letter of a selection.  At  the
        left edge,  you will se the current setting;  just type the right
        letter until you see what you want,  then type [CR]. This setting
        is  also displayed by ESC ?  and also when actually  transferring
        files.







	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 10






        MODEM7:
             This is the most popular method used to transfer files,  and
        is available on almost all CP/M and MSDOS machines.   The  MODEM7
        compatible  programs  can transfer one or more files at  a  time,
        with  full  error detection and correction.  The  limitations  on
        MSDOS  are  that the original file creation time and  exact  file
        size are lost.  For text files this does not matter, but for data
        base and spreadsheet files, it can cause great problems.

        XMODEM:
             Most frequently used on bulletin boards and the like,  it is
        the original MODEM transfer protocol.   It can transfer only  one
        file  at  a  time,    and  the  user  must  enter  the   filename
        specifically.  (No  wild card characters.) It is included  mostly
        for completeness,   and should only need to be used for computers
        that do not support MODEM7 or TELINK modes.

        TELINK:
             The TELINK mode is an extention of the MODEM7 protocol,  but
        includes extra information on each file sent.  After the filename
        is sent,  the file size,  creation time and date are sent  before
        the first data block.    If MINITEL receives this block,   it  is
        used  to exactly duplicate the file on the receiving end.

             This mode is still compatible with the MODEM7 mode. However,
        MODEM7  will get four or six errors while transferring the  first
        file,   while   MINITEL  figures out that it cannot  accept  this
        data.   If  it   cannot  be accepted,   then  MINITEL  will  stop
        sending   this  info,  and will operate for the rest of the files
        in MODEM7 mode.

        CRC / CHECKSUM:

        	Entering  C  at  the prompt will toggle between  CRC  and
        CHECKSUM.   The   CRC  method  is  a  very  reliable  method   of
        transferring files; the worst error rate is 99.9969% reliability!
        CHECKSUM is probably about 95% or more accurate. Use CRC whenever
        possible,  CHECKSUM  only  if CRC isn't supported  by  the  other
        computer.




















	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 11






        	The  following commands control the way MINITEL  acts  to
        the remote computer,   and you. All of these are "not dangerous",
        i.e. you cannot wreck anything with them.

        	ESC ?		List MINITEL status

        	The  current  settings  of the commands  in  MINITEL  are
        listed  on the screen, like so:

        	<Full, half> duplex			(ESC F, H)
        	Auto linefeed <on, off>		(ESC L, M)
        	The cursor is at line 10 column 23
        Either:
        *	Collecting text in file TEXT.FIL,	(ESC C, S)
        *	 4022 saved so far, room for 18101 more
        Or:	Not collecting text
        	Currently <300, 1200, 9600> baud	(ESC B)
        	<TELINK,  MODEM7,  XMODEM> file transmission	(ESC N,J)
        	<no, odd, even> parity selected		(ESC V)

        	Most   of  these can be changed via a  MINITEL   command.
        The command  is listed to the right of each,   above.  Others are
        just internal status: they are:

        	The cursor is at line <n> column <n>

        	This  just tells you where the cursor is.  Some  bulletin
        boards  and  editors  require  you to fit  typed  lines  in  some
        arbitrary  line length;   with this you can see how close to  the
        end you are. It is updated every time you type a key.

        Either:	Collecting text in file TEXT.FIL,
        	 4022 saved so far, room for 48101 more in memory
        -or-	Not collecting text

        	If  you  have not started text collection with the ESC  C
        command,  you  will get "Not collecting text",  which means  just
        what it says.

        	If  you  are collecting text,  MINITEL will tell you  the
        name  of the file being used,  and some simple statistics on  it.
        The "...  saved so far" is the number of characters saved in  the
        disk   file.  The  "room  ..." message tells you about  how  many
        characters   will   be  saved in memory before they  need  to  be
        written   out  to  disk.   You do  not ever need to  worry  about
        the   numbers  here;   MINITEL automatically takes care of saving
        text in the disk file.  (See the ESC C command description)












	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 12






        	ESC ESCape

        	Not  really  a command,  it just sends an ESCape  to  the
        remote. The cursor will still go up to the command area, but will
        go right back down.


        	ESC F	 	Full duplex
        	ESC H	 	Half duplex

        	Changes  the  line operating mode.  The default is  Full.
        Half  duplex caused keyboard characters to be displayed  as  they
        are typed.

        	ESC L	 	Enable Auto linefeed
        	ESC M 		Disable auto linefeed

        	When enabled, causes a line feed character (control-J) to
        be typed after each carriage return typed. This is independent of
        half duplex. The linefeed is sent to the remote.


        	ESC V	 Parity selection

        	The  default  is no parity.  Parity is  generated  within
        MINITEL, and  is  either none,  even or odd.  If even or  odd  is
        selected,   the   parity  bit replaces bit 7 of  the  data  byte.
        (Obviously   only  7  bit  data can be  sent.)  Parity  will   be
        suspended when file transmission or reception is used.

        	ESC Q	Exit to DOS

        	The  'Q' command exits MINITEL,  and returns  control  to
        DOS.   If  text  collection  is on (via the 'C' command) text  is
        saved  before exiting.

        	CAUTION:
        	You must remember to disconnect from the remote computer.
        MINITEL cannot do it when you Quit.  You will still  be connected
        to the remote computer.

        	Of you do quit,  (to change diskettes,  or whatever) then
        run MINITEL again,  do not forget to set the baud rate again,  as
        MINITEL cannot remember what it was set to when you  exited,  and
        it always selects 300 baud when started.

        	ESC B		Baud rate

        	Tells you the current baud rate,  and lets you change it.
        Only 300,  1200 and 9600 are implemented.  A blank line or a  bad
        selection results in no change.  Once you type CR, it changes the
        rate, and displays the rate now in effect.







	(CRC) MINITEL Operating Manual (c) T. Jennings 1983	Page 13







             MINITEL  supports all popular file transfer  modes:  XMODEM,
        MODEM7, TELINK, in CRC or Checksum modes.

        	All  use  an identical technique to  transmit   the  data
        in   the   file;    the  difference is that   batch   mode   also
        transmits  the  file  name,   and there is a method to  tell  the
        receiver "no more files".

        	Batch mode operates in the following manner:

        	Send filename,
        	Send data,
        	Send end of file,
        	Send filename,
        	Send data,
        	Send end of file,

        	....

        	Send "no more files".

        	Single file mode is simply:

        	Send data,
        	Send end of file.


        BATCH MODE FILENAMES:

        	In  batch  mode,  the file name is sent before the  data.
        When  the  receiver is ready,  it sends a NAK  character  to  the
        transmitter,  telling it that it's ready to receive the file. The
        transmitter then sends an ACK to acknowledge that.

        	The  11 filename characters are sent one at a  time,  and
        the  receiver  acknowledges  each by sending an  ACK  after  each
        character. After the last one has been sent, the transmitter then
        sends an ___,  indicating end of name, at which time the receiver
        sends  a checksum of all the characters it's received so far.  If
        the checksum matches the transmitter's checksum,  the transmitter
        sends an ___,  indicating filename sent and received properly. If
        at any point during this something goes wrong,   the  transmitter
        sends an ___,  indicating a bad transmission,  and both computers
        abort.

        	If the first filename character is an EOT,  it  indicates
        that  there  are no more files,   i.e.  end of batch  mode.  Both
        computers are then finished with the file transmissions.










Appendix A	Block Mode File Transmission Page 14





        SINGLE FILE TRANSFER and BATCH MODE DATA TRANSFER

        	File  data  is sent 128 bytes at a time,   in a  132 byte
        block. After a block is sent to the receiver, the receiver either
        acknowledges  good or bad reception of the block.  If  good,  the
        next  block is sent,  otherwise the block is retransmitted up  to
        some predetermined number of times. Once the entire file has been
        transmitted,  an  end  of transmission character  is  sent.  This
        should be also acknowledged by the remote.

        	The   first  character  sent  by  the  file   transmitter
        determines  what  kind of block it is;  an ASCII SOH (01 hex)  or
        Start  Of Header,   indicates an upcoming block,  and an EOT  (04
        hex), or End Of Transmission, means no more blocks.

        	If  the first byte of the block is an SYN,  it  indicates
        it's a TELINK extended information block.  The 128 byte data area
        then  contains extended system information.  The first four  byte
        are  the file size,   in bytes,   and the next four bytes contain
        the  MSDOS creation date and time.   This block is only sent once
        per   file,  just be fore the first data block.  If the  receiver
        does  not  properly acknowlege this block (i.e.    MODEM7  thinks
        it's   a   bad  block) TELINK will not make further  attempts  at
        sending  it.    In  this  case,   TELINK will write all  received
        data  blocks as is  to  the disk,  which will cause the file size
        to  be  rounded off to the  next highest multiple  of  128  bytes
        (like MODEM7).   If the file size is received  properly, the file
        size will be exact.

        	The receiver uses one of two ASCII characters to indicate
        the sucess  of  the block just  transmitted:   ACK  (06  hex)  to
        acknowledge  correct  reception,   or  NAK  (15  hex),   Negative
        Acknowledgement, to indicate the block was received incorrectly.

        	Each   block   contains  a  block  number,   which   (not
        coincedentally)  corresponds to a CP/M file record number.  There
        are 128 data bytes per block,    and all other bytes in the block
        are overhead.

        	The data block format is like so:

         	SOH SEC /SEC data0 data1 ... data126 data127 CHKSUM
        or      SOH SEC /SEC data0 data1 ... data126 data127 CRCH CRCL

        	Where:

        	SOH is the ASCII Start Of Header character,

        	SEC is the 8 bit disk record number,

        	/SEC  is  the  ones complement of SEC,  the  disk  record
        number, used for error checking. (later...)








Appendix A	Block Mode File Transmission Page 15





        	data0 ...  data127 are the 128 bytes of data.  These  are
        all 8 bit quantities, with no contraints as to the contents.

        	CHKSUM  is an 8 bit checksum of the 128 data  bytes.  The
        idea  is that the receiver makes it's own check sum of the  data,
        adds it to the CHKSUM, and the result should become zero. This is
        one  of  the  criteria  used  in selecting  ACK  or  NAK  as  the
        aknowledgement.

                CRCH is the upper 8 bits of the CRC, and
                CRCL is the lower 8 bits.
             Like  the  checksum  method,  CRC is used  to  validate  the
        contents of the data block. The CRC is a polynomial that the data
        gets passed though. The CCITT method is used, which is:

                       X^16 + X^12 + X^5 + 1

             Each  data  byte is passed through this,  and the result  is
        sent to the receiving computer, which makes the same calculation.
        if both match, then the block was good.

             CRC  vs.  CHECKSUM method is selected just before  the  file
        transfer  starts;  when the receiving end is ready,  it sends  an
        initial character to tell the sender it is ready.  This character
        (sent  by the receiver) determines the transfer mode:  NAK  means
        CHECKSUM, C (capital C) means CRC. (Older systems don't recognize
        the  C  character;  it  waits for the  NAK,  which  never  comes;
        therefore  it  is  important  to select the  right  mode  on  the
        receiving end.

             The  accuracy  of the CRC method is:  detects  100%  of  all
        single  and double bit errors,  all errors with an odd number  of
        error  bits,  all burst errors of length 16 or less,  99.9969% of
        all  17 bit error bursts,  99.984% of all possible  longer  error
        bursts.

             The  original XMODEM CRC method and polynomial algorithm was
        done  by Paul Hanksknecht,  of Carpenter  Associates,  Bloomfield
        Hills, MI.





















Appendix A	Block Mode File Transmission Page 16







        	MINITEL   can   be used on any version of  MSDOS  or   PC
        DOS.  Version  2 or higher of either DOS,   however,   has a more
        complex file structure. MINITEL supports both.

        	Under older DOS's,  (before version 2) only "normal" file
        names can be used: The format is:

        	d:filename.ext

        	Where:

        	d:		is an optional drive specifier,
        	filename	is an 8 character maximum name,
        			* or ? being allowed for certain
        			commands,
        	.ext		is an optional filename extention,
        			wildcards * and ? the same as in
        			'filename'.

        	FRUMP.ASM, *.COM are typical examples.

        	Under later DOS's,  however,  full path names can be used
        wherever a filename is asked for. This takes the form:

        	pathname\filespec

        	Where:

        	pathname	is a valid path name specifier. It
        			may contain one or more directory
        	specifiers, seperated by a \, and also / if the
        	switch character has been set to - in CONFIG.SYS.

        	filespec	is a "normal" filename, described
        			above.
        	/BIN/*.COM
        	/MARCH/DOG/BARF	are typical examples.

        	You  can  of course enter a "simple"  filename  in  newer
        DOS's, as long as the file is in the current directory.

        	Any  filename  typed  in  to  MINITEL can  be  up  to  80
        charaters long.   In any case,   see the appropriate DOS  manuals
        for filename  and path name restrictions and operation.














Appendix B	Filenames and Pathnames                Page 17







        	Obviously some commands will require more input than just
        the  ESC/command  key;    filenames and baud rates are  the  most
        common. MINITEL prompts you for these as necessary. When ever you
        are prompted for a filename or whatever,   you enter it by typing
        the name,    and  a <cr> when done.  Up until you type the  <cr>,
        however, you can do some simple editing of the line.

        	Control keys are used to edit the line. Control keys that
        areen't    used   by MINITEL are ignored.     The following   are
        the control keys used:

        	^C	Delete the entire line
        	^X	Same as ^C
        	^U	Same as ^C
        	^Y	Same as ^C
        	^H	Delete the last character typed
        	^G	Same as ^H
        	^S	Same as ^H
        	DEL or RUBOUT
        		Same as ^H

        	Carriage return (CR),  linefeed (LF) and ESCape (ESC) are
        used to enter the line, executing it.

        	Two more special keys are:

        	^R	Retype the previous line
        	^D	Retype the last deleted character

        	These  can be useful if you want to enter the same  thing
        as last time.  If you delete the line (using ^C, ^X, etc) you can
        get it all back ("undelete" the line) by typing a  ^R,   and  the
        last character by typing a ^D.   Also,  you can get back the line
        you used for the last command by typing ^R before anything  else.
        After  you type any other key,  (exceptt an editing key) you lose
        the old contents.

        	All  commands  can be aborted by entering a  blank  line.
        Either enter <cr> at the prompt,  or delete the line,  then  type
        <cr>.


















	Appendix C	Line editing 			Page 18







        	MINITEL   does   some processing of the  characters   you
        see displayed  on  the console.   None of this processing affects
        the text collected in a disk file using the ESC C command.

        	This processing is done to ensure a "clean"  screen,  and
        to make sure that MINITEL can keep track of where the cursor is.

        	All  characters  have bit 8 stripped off,  to  make  sure
        they're 7 bit ASCII.  Some terminals respond differently to 8 bit
        characters,  and some strip them internally. In particular, files
        created by popular editors such as WordStar set bit 8 on carriage
        returns   (CR  ) to make "soft paragraphs",   and  MINITEL  would
        not otherwise know it was a carriage return.

        	Certain   code  sequences  make a mess  of  the  terminal
        display;   these  characters can be filtered out using the ESC  I
        com  mand,   and  not sent to the display.   Mainly this  is  the
        control-Z character,   which  clears  the screen on many  popular
        terminals, such  as the ADM-3A,  most Televideo models,  and  the
        Hazeltine Esprit.

        	Tabs  are  expanded within MINITEL to space over  to  the
        next  tab column,   which are fixed at every eight columns.  Tabs
        are put  as is into any ESC C disk file.

        	None  of this filtering ever affects characters put  into
        the text collection file, if one is used.































	Index






                Auto linefeed........................... 4,10,11
                Auto-dialing............................ 1
                Baud rate............................... 4,11
                Binary.................................. 7
                Collect text............................ 6
                Collecting text......................... 6
                Command key............................. 3
                Command letter.......................... 3
                Commands................................ 2
                Control-J............................... 11
                Control-Q............................... 6
                Control-S............................... 6
                Control-Z............................... 6,6,17
                CP/M.................................... 8
                CR...................................... 17
                Cursor.................................. 3,3
                DEL..................................... 16
                DIR command............................. 5
                Disk.................................... 1,6
                Error detection......................... 7
                Error handling.......................... 2
                Error messages.......................... 2
                Error recovery.......................... 2
                ESC ?................................... 4,6,10
                ESC B................................... 4,11
                ESC C................................... 4,6,6,10,17
                ESC ESC................................. 4,11
                ESC F................................... 4,11
                ESC H................................... 4,11
                ESC I................................... 17
                ESC L................................... 4,11
                ESC M................................... 4,11
                ESC N................................... 4,7,8
                ESC Q................................... 4,6,11
                ESC R................................... 4,7
                ESC S................................... 4,6
                ESC T................................... 4,7
                ESC V................................... 4,11
                ESC Y................................... 4,5
                ESCape)................................. 3
                Exit to DOS............................. 11
                Expert mode............................. 3
                File count.............................. 5
                File size............................... 5
                File transfer protocol.................. 4
                File transmission mode.................. 8
                Filenames............................... 7
                Files................................... 5
                Full duplex............................. 4,11
                Half duplex............................. 4,11
                Memory.................................. 1,6,6
                Menu.................................... 2,3,3







	Index





                MINITEL................................. 1
                Modem................................... 1,3
                MODEM7.................................. 1,7
                MODEM7:................................. 8
                Parity.................................. 4,11
                Pathname................................ 5
                Quit.................................... 4
                Receive file(s)......................... 4,7
                RUBOUT.................................. 16
                SmartModem.............................. 1
                TELINK.................................. 1,7
                TELINK:................................. 9
                Text.................................... 6
                Text collection......................... 6
                Text download........................... 1
                Text file............................... 6
                Transmission status..................... 7
                Transmission time....................... 5
                Transmission times...................... 5
                Transmit file(s)........................ 4,7
                Wildcards............................... 5
                XMODEM.................................. 1,7
                XMODEM:................................. 8
                ^C...................................... 16
                ^D...................................... 16
                ^G...................................... 16
                ^H...................................... 16
                ^R...................................... 16
                ^S...................................... 16
                ^U...................................... 16
                ^X...................................... 16
                ^Y...................................... 16



Directory of PC-SIG Library Disk #0188

 Volume in drive A has no label
 Directory of A:\

CRC      TXT       841  11-15-84   7:51a
CRCK4    COM      1536  10-21-82   7:54p
IBMMINI  EXE     30208   4-11-84   2:31p
MINITEL  ABS       384   4-11-84   2:30p
MINITEL  DOC     42624   4-11-84   2:54p
MINITEL  DQC     21888   4-11-84   2:31p
MINITEL  LBR     52736   4-11-84   1:30p
XXX                512   6-03-84  10:43p
        8 file(s)     150729 bytes
                        8704 bytes free