$Janus Systems              Spartus 2   Documentation

    Spartus 2  IS A COMMUNICATIONS PROGRAM THAT ALLOWS THE TRS-80 MICROCOMPUTER TO ACT AS A TERMINAL AS WELL AS PROVIDE SEVERAL OTHER FEATURES USEFUL TO USE IN A COMMUNICATIONS ENVIRONMENT.

    SPARTUS 2  CAN PERFORM ALL THE FOLLOWING FUNCTIONS:

        1. ACT AS A SERIAL ASYNC ASCII TERMINAL
           (PRODUCES MOST CONTROL AND CHARACTER CODES)
        2. SAVE SELECTED RECEIVED DATA TO DISK
        3. PRINT SELECTED RECEIVED DATA ON SYSTEM PRINTER
        4. TRANSMIT ASCII FILES FROM DISK
            A. AT UNINTERUPTED FULL TRANSFER RATE
            B. UNDER CONTROL OF RECEIVING SYSTEM BY USE OF A
               PROMPT CHARACTER ( 0E HEX )
            C. UNDER CONTROL OF THE OPERATOR

    CONTROL OF SPARTUS 2  IS ACHIEVED BY USE OF THE FOLLOWING
    COMMANDS  (ALL COMMANDS ARE SHIFTED CHARACTER KEYS)

        P -  PRINT TOGGLE.  THIS COMMAND WILL START/STOP
                PRINTING OF ALL RECEIVED DATA ON THE SYSTEM
                PRINTER. (TRANSMISSION OF NULLS MAY BE
                REQUIRED BY THE HOST SYSTEM AFTER A CARRIAGE
                RETURN/LINE FEED TO OPERATE CORRECTLY)
        B -  BUFFER TOGGLE.  START/STOP BUFFERING OF RECEIVED
                DATA INTO MEMORY BY SPARTUS FOR LATER SAVING
                TO DISK.  THE SIZE OF THE MEMORY BUFFER IS
                LIMITED TO 32K FOR THE 48K TRS-80 AND 16K FOR
                THE 32K TRS-80.  BUFFERING BY SPARTUS IS
                INDICATED BY DISPLAY OF CHARACTERS BEING
                SAVED IN THE UPPER RIGHT HAND CORNER OF THE
                DISPLAY.  AN ASTERISK WILL APPEAR TO THE
                LEFT OF THESE CHARACTERS WHEN THE BUFFER IS
                1K FROM BEING FULL AND WILL REMAIN THERE
                UNTIL THE BUFFER FILLS.  WHEN THE BUFFER IS
                FULL, SPARTUS WILL AUTOMATICALLY CAUSE A 'U'
                COMMAND TO BE PERFORMED.
        U -  UNLOAD BUFFER TO DISK.  THIS COMMAND WILL ASK
                THE OPERATOR FOR A FILESPEC AND WILL SAVE
                THE CURRENT CONTENTS OF THE MEMORY BUFFER
                TO DISK UNDER THE SPECIFIED FILESPEC.  (SEE
                'B' COMMAND).  THE FILE CREATED WILL BE A
                REGULAR SEQUENTIAL FILE AND CAN BE EDITED BY
                MOST FILE EDITORS AVAILABLE FOR THE TRS-80.
                IF LINES IN THE FILE ARE PREFIXED BY THE
                APPROPRIATE LINE NUMBERS, IT CAN ALSO BE
                LOADED BY DISK BASIC.
        T -  TRANSMIT A DISK FILE.  WILL ASK OPERATOR FOR
                A FILESPEC AND WILL TRANSMIT THE SPECIFIED
                FILE AT FULL TRANSFER RATE.  IT IS UP TO THE
                RECEIVING SYSTEM TO BE READY TO RECEIVE THE
                DATA TO INSURE NO DATA WILL BE LOST.  (MOST
                LARGE DATA COMMUNICATIONS COMPUTERS HAVE
                RECEIVING BUFFERS CAPABLE OF HANDLING TRANS-
                MISSION OF DATA USING THIS COMMAND, BUT MOST
                SMALL MICROCOMPUTER NETWORKS DO NOT. SEE THE
                'F' COMMAND FOR HELP ON TRANSMITTING TO
                THESE SMALLER MACHINES.)
                SPARTUS WILL DISPLAY <TRANSMIT COMPLETE> WHEN
                THE ENTIRE FILE HAS BEEN SENT.
        F -  FILE TRANSMIT WITH PROMPTS.  WILL ASK OPERATOR
                FOR A FILESPEC AND WILL TRANSMIT THE FILE IN
                A CONTROLLED MANNER.  NO TRANSMIT WILL OCCUR
                UNTIL SPARTUS RECEIVES A 'PROMPT' OF 0E HEX
                FROM THE RECEIVING COMPUTER OR UNTIL THE
                OPERATOR USES THE 'N' COMMAND.  WHEN TRANSMIT
                DOES OCCUR, SPARTUS ONLY SENDS THE NEXT LINE
                OF THE FILE. (CURRENT POSITION TO NEXT CR)
                CURRENT BULLETIN BOARDS DESIGNED FOR USE
                MAINLY BY TRS-80 USERS ALREADY SEND THIS
                PROMPT WHEN THEY ARE READY FOR THE NEXT INPUT
                TO BE ENTERED.  REMEMBER YOU CAN USE THE 'N'
                COMMAND TO FORCE SPARTUS TO SEND THE NEXT
                LINE WITHOUT WAITING FOR THE PROMPT.
                SPARTUS WILL DISPLAY <TRANSMIT COMPLETE> WHEN
                THE ENTIRE FILE HAS BEEN SENT.
        A -  ABORT TRANSMIT.  WILL STOP A FILE TRANSMIT THAT
                WAS STARTED BY EITHER THE 'T' OR 'F' COMMANDS
        N -  NEXT LINE FORCE.  FORCES SPARTUS TO SEND THE
                NEXT LINE OF THE FILE WHEN TRANSMITTING USING
                THE 'F' COMMAND.  USEFUL WHEN SPARTUS MISSES
                A PROMPT OR THE RECEIVING SYSTEM DOES NOT
                SEND PROMPTS.  (0E HEX)
        X -  EXIT.   RETURNS CONTROL OF SYSTEM TO DOS.


    SPARTUS 2  WILL CONFIGURE THE RS232 INTERFACE TO THE BAUD RATE, STOP BITS, WORD LENGTH, PARITY, ETC.  SPECIFIED BY THE CONFIGURATION SWITCHES ON THE RS232 BOARD.  SEE YOUR OWNER'S MANUAL FOR DETAILS ON SWITCH SETTINGS.

    SPARTUS 2 WILL GENERATE ASCII CONTROL CODES BY DEPRESSING THE SHIFT, DOWN-ARROW, AND A CHARACTER KEY  IN THAT ORDER.  FOR DETAILS ON THE ASCII CODES GENERATED BY YOUR TRS-80 KEYBOARD WHEN UNDER CONTROL OF SPARTUS 2, SEE APPENDIX A.

    SPARTUS 2 WAS CREATED AND TESTED UNDER TRSDOS VERSION 2.3 AND IT IS THEREFORE RECOMMENDED IT BE USED UNDER THIS OPERATING SOFTWARE.  JANUS SYSTEMS ASSUMES NO RESPONSIBILITY FOR USE UNDER ANOTHER SYSTEM.

   ANY  QUESTIONS ON THE USE OF SPARTUS, COMMENTS ON HOW YOU LIKE IT, OR  SUGGESTIONS FOR FUTURE VERSIONS ARE WELCOMED!
     PLEASE WRITE:         STEVE STEWART
                           JANUS SYSTEMS
                           816 LOEB
                           MEMPHIS, TN   38111

     OR LEAVE A COMMENT ON ONE OF THESE MESSAGE SYSTEMS:
        FORUM-80 OF MEMPHIS                HOBBYIST FORUM
        (901) 276-8196                     (901) 362-2222

     JANUS SYSTEMS THANKS YOU FOR YOUR BUSINESS !
     APPENDIX A

NOTE: CTRL IS PRODUCED BY DEPRESSING SHIFT AND DOWN-ARROW TOGETHER

HEX CODE            KEY SEQUENCE              CHARACTER

  00                                            NUL
  01        BREAK  SHIFT-BREAK  CTRL+A          SOH
  02                    CTRL+B                  STX
  03                    CTRL+C                  ETX
  04                    CTRL+D                  EOT
  05                    CTRL+E                  ENQ
  06                    CTRL+F                  ACK
  07                    CTRL+G                  BEL
  08        LEFT-ARROW  CTRL+H                  BS
  09       RIGHT-ARROW  CTRL+I                  HT
  0A        DOWN-ARROW  CTRL+J                  LF
  0B                    CTRL+K                  VT
  0C                    CTRL+L                  FF
  0D       ENTER  SHIFT-ENTER  CTRL+M           CR
  0E                    CTRL+N                  SO
  0F                    CTRL+O                  SI
  10                    CTRL+P                  DLE
  11                    CTRL+Q                  DC1
  12                    CTRL+R                  DC2
  13                    CTRL+S                  DC3
  14                    CTRL+T                  DC4
  15                    CTRL+U                  NAK
  16                    CTRL+V                  SYN
  17                    CTRL+W                  ETB
  18       SHIFT LEFT-ARROW  CTRL+X             CAN
  19      SHIFT RIGHT-ARROW  CTRL+Y             EM
  1A       SHIFT DOWN-ARROW  CTRL+Z             SUB
  1B         SHIFT UP-ARROW                     ESC
  1C                                            FS
  1D                                            GS
  1E                                            RS
  1F            CLEAR  SHIFT-CLEAR              US
  20       SPACE  SHIFT-SPACE  SHIFT-0          BLANK
  21                !                           !
  22                "                           "
  23                #                           #
  24                $                           $
  25                %                           %
  26                &                           &
  27                '                           '
  28                (                           (
  29                )                           )
  2A                *                           *
  2B                +                           +
  2C                ,                           ,
  2D                -                           -
  2E                .                           .
  2F                /                           /
  30                0                           0
  31                1                           1
  32                2                           2
  33                3                           3
  34                4                           4
  35                5                           5
  36                6                           6
  37                7                           7
  38                8                           8
  39                9                           9
  3A                :                           :
  3B                ;                           ;
  3C                <                           <
  3D                =                           =
  3E                >                           >
  3F                ?                           ?
  40                @                           @
  41                A                           A
  42                B                           B
  43                C                           C
  44                D                           D
  45                E                           E
  46                F                           F
  47                G                           G
  48                H                           H
  49                I                           I
  4A                J                           J
  4B                K                           K
  4C                L                           L
  4D                M                           M
  4E                N                           N
  4F                O                           O
  50                P                           P
  51                Q                           Q
  52                R                           R
  53                S                           S
  54                T                           T
  55                U                           U
  56                V                           V
  57                W                           W
  58                X                           X
  59                Y                           Y
  5A                Z                           Z
  5B             UP-ARROW              LEFT SQUARE BRACKET
  5C                                        BACKSLASH
  5D              SHIFT-@              RIGHT SQUARE BRACKET
  5E                                          CARAT
  5F                                         UNDERLINE
  60                                          ACCENT
------------------------------------------------------------
THE FOLLOWING ARE RESERVED FOR SPARTUS2  CONTROL COMMANDS
  61    A       ABORT TRANSMIT
  62    B       BUFFER TOGGLE
  63    C
  64    D
  65    E
  66    F       FILE TRANSMIT WITH PROMPT WAIT
  67    G
  68    H
  69    I
  6A    J
  6B    K
  6C    L
  6D    M
  6E    N       NEXT LINE TRANSMIT FORCE
  6F    O
  70    P       PRINT TOGGLE
  71    Q
  72    R
  73    S
  74    T       TRANSMIT FILE AT FULL SPEED
  75    U       UNLOAD BUFFER TO DISK
  76    V
  77    W
  78    X       EXIT SPARTUS TO DOS
  79    Y
  7A    Z
----------------------------------------------------------
  7B                                        LEFT BRACE
  7C                                       VERTICAL BAR
  7D                                       RIGHT BRACE
  7E                                           TILDE
  7F                                            DEL


 