-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 UPDATED: 03 MAR 1998 ====================================================================== TTY INTERFACE 1.51b Copyright (C) 1993-2008, Skot Fred Industries All rights Reserved =======================================-============================== NOTE... The WINDOWS release of TTY INTERFACE will be available shortly, the Win-95/NT (32bit) pre-release may be emailed to you upon request, the Win 3.XX (16bit) release will be available via FTP when complete. ====================================================================== LEGAL DISCLAIMER THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PRODUCT IS WITH YOU. SHOULD THE PRODUCT PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT WILL SKOT FRED INDUSTRIES, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PRODUCT (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTY OR A FAILURE OF THE PRODUCT TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. USE OF THIS SOFTWARE INDICATES YOUR ACCEPTANCE OF THESE TERMS AND CONDITIONS. =======================================-============================== Purpose of Program: =================== TTY INTERFACE greatly simplifies the steps required to pass messages retreived via various means into ONE message handling and retreival program. With the (FRED-ALT) radio-room modification all submarine teletypewriter circuits may be directly received on an IBM-PC or compatible computer. The author believes that this program, used with MDU, exceeds the abilities of the Submarine Message Buffer (SMB) with much less expense to taxpayers! ABOUT THE AUTHOR : ================== The author was a Submarine Radioman Second Class (RM2/SS) that was enlisted in the U.S. Navy from 17JUL89 to 18JUL95 and was stationed onboard USS Helena SSN-725 from 13FEB91 to 16JUL95. This program was initially conceived and developed during that time to aid in Radio Room message handling. The author is currently a student at DeVry Institute of Technology - DuPage Campus (Addison, IL) majoring in Computer Information Systems. CONTACTING THE AUTHOR : ======================= Dean 'Scott' Fredrickson Phone : +1 815-556-9080 E-Mail : skotfred@skotfred.com Internet URL : https://www.skotfred.com/ NOTE: The most recent release of TTY INTERFACE will always be available online for download from the Internet. BENEFITS OF REGISTRATION: ========================= This program is released fully-functional, however, the UNREGISTERED version will display a notice at startup. The UNREGISTERED version will also route a message concerning registration information to your message handling software. Registered Users will be added to our mailing list and may be notified of major program improvements and program bugs. Upon registering you will be notified of several undocumented features available in this release. If you require information on the FRED-ALT radio room modification, it may also be sent to you. HOW TO REGISTER: ================ This program is released as SHAREWARE, if you find it useful you shouldsend a donation to the programmer in order to fund additional efforts and upgrades. Contact me via Email, Mail, or phone with the information provided in the file REGISTER.TXT. Your registration fee may be monetary, a letter or recognition from your command, station or company. Ships and subs may also use ship memorabilia. This DOES NOT have to be expensive, but any letter or proof of use by any user may help the programmer land a better job in the civilain world. INSTALLATION : ============== When the program is initially run it will create all of the required files in the same directory as the program. Several screens will be displayed explaining the registration procedure and your computer systems configuration. You will then be forced to the CONFIGURATION menu. Be sure to verify ALL information prior to proceeding. The default setup utilizes only COM1: and COM2: setup for typical SSIXS data (1200 bps [ITA-2=Baudot]). Also all circuits are selected as installed, significant increases in program speed can be obtained by removing circuits that will not be passed to the computer for processing. To prevent TTY INTERFACE from placing different copies of TTY.INI in several directories, the following line will be automatically added to your AUTOEXEC.BAT file... SET TTYPATH=C:\xxxxxxxx (where xxxxxxxx is the directory TTY INTERFACE was started from.) USING THE PROGRAM : =================== At the DOS prompt ( i.e. C:\ ) enter the following: TTY.EXE [expression list (filename) ] Valid expressions: /R = Receiver /T = Transmitter (filename may be used) /C = CC:Mail (filename may be used) /A = ASCII (filename may be used) /E = TTY Emulator [TESTING of TDD Dialer Continues] /D = Read all Messages from Disk /V = Message Viewer /S = Setup Configuration /? or /H = Show Help Screen /RESET = Reset ALL Program Settings to Default Also Erases Files... NOTE: When first executing the program, you should check all CONFIGURATION menu's. The default values allow use of both serial communication ports (COM1 and COM2) and all radio circuits. Significant speed improvements can be obtained by optimizing the program to your radio room equipment capabilities. HARDWARE/SYSTEM REQUIREMENTS : ============================== IBM PC (or compatible computer) MS-DOS or PC-DOS 3.21 or later At least one open serial communications port (COM1 or COM2) A Datasette-Adapter (DSA) or equivalent device DATASETTE ADAPTER (as available in the Navy Supply System) : - ------------------------------------------------------------ Nomenclature : DATA Set Adapter Part Number : 14353A Model number : R42M CAGE/FSCM : 17297 Manufacturer : VERSITRON - http://www.versitron.com/ Stock Number : 1H 7050-01-196-3446 Price : $354.17 / Each (as of JUN1995) Function : Converts MIL-188 signals to/from RS-232 signals. PROGRAM COMPATIBILITY & TESTING : ================================= This program has been thoroughly tested to be compatible with the following software onboard USS HELENA (SSN-725) on or before July 1995: MDU 2.11C MDU 2.4 M-T-V 2.97 MTF Editor 3.5 MTF Editor 4.0 cc:MAIL REMOTE 3.20 Microsoft Windows 3.xx NOTE: While TTY INTERFACE will operate properly 'under' Windows, the program functions best in MS-DOS mode. Windows may cause ERRORs from COMM PORTS, cause the Receive Buffer to overflow occassionally, or cause monitor output to appear slow or jerky. FILENAME ATTRIBUTES : ===================== TTY_____.EXE - The executable program file TTY_____.INI - Program Setup Information (human readable!) TTY_____.DAT - Receiver Status Information TTY-HELP.TXT - "THIS FILE" - PROGRAM INFORMATION TTY-INFO.TXT - Program History REGISTER.TXT - Message containing Registration Information NOTE: This file is created when program is executed. TTY-MSG .NDX - Master Index of Messages (by Filename) 1.47+ TTY-DTG .NDX - Index of Messages (By DTG) 1.47+ TTY-ORIG.NDX - Index of Messages (By Originator) 1.47+ TTY-SUBJ.NDX - Index of Messages (By Subject) 1.47+ ________.TTY - Raw Teletye Traffic (created by receiver & emulator) NOTE: .TTY filenames are in the format of "ddhhmmss.???" (*** New in Version 1.41 *** - Can be turned on by setting DTG files=Yes) NOTE: Message Filenames are now in the version 'MMddmmhh.Y##' where: MM = Month (01-12) dd = Date hh = Hour mm = Minute Y = Last digit of Year ## = Number starting at 00 (*** Old message format *** - DEFAULT Setting) NOTE: 1) This feature is still available by manually setting TTY.INI file value of 'DTG Files=Yes'. 2) Message filenames are in the format of "ddhhmmss.???" ________.MSG - Teletype Messages ________.ZBO - Teletype ZBO's ________.CCM - CC:MAIL Messages ________.CCZ - CC:MAIL ZBO's (future use?) RECEIVER INTERFACE: ==================== 1) Current program limitations limit receiver capability to COM1,COM2,COM3 and COM4 ports only as selected from the CONFIGURATION Menus (LPT1/LPT2 may be possible?). 2) Can translate ITA-2(Baudot) or ITA-5 to ASCII code for further processing. 3) Received data is saved in a file named 4) Displays current (V)6 Status (i.e. SIDS, (V)6 TIME, and NET) 5) After all data is received, press any key and the program will automatically PARTITION the messages into the DISSEMINATION directory for use by MDU/MDS or MTV. TRANSMITTER INTERFACE: ======================= 1) Can translate ASCII to ITA-2(Baudot) or ITA-5(ASCII) for use by teletype equipment. 2) Transmitted messages can also be placed into the DISSEMINATION directory as the message is sent to the teletype. 3) An automatic End-Of-Message (2CR, 8LF, NNNN) may be sent at the EOM Flag, currently set at '@'. TTY EMULATOR : (Currently TESTING & DEVELOPING) =============== 1) This routine will allow the computer to Emulate(Act like) a Teletype. This will allow a physical(real) teletype to be used for other purposes, or shut-off simply to save paper. 2) Color Codes Used: YELLOW - Transmitted Characters WHITE - Received Characters GREEN - Control Characters (XMIT & RCV) LTRS, FIGS, CR, and LF. 3) Received data is processed and placed in the DISSEMINATION Directory. 4) LOCAL ECHO causes entries on the keyboard to be displayed on the Monitor, This may not be desired in some configurations where the equipment or circuit already ECHOs data back to the computer. (NOTE: Only turn this OFF if letters appear twice each time a key is pressed) 5) XMIT NULLS - this may be enabled to maintain 'SYNC' with some equipment. It works by sending BLANKS to the device when data is not being sent. 6) All parameters can be selected in the CONFIGURATION Menus. NOTE: The TTY EMULATOR may also be used to communicate with TDD machines. This option can be enabled by manually editing TTY.INI and setting 'TDD DIALER=Yes'. WARNING: THIS FEATURE IS STILL UNTESTED. DISK READER: ============ 1) Works like PARTITION ASCII but requires no user intervention. 2) Files are retreived from the 'ASCII' directory as selected in the SETUP menus. PARTITION ASCII: ================= 1) This routine will seperate several merged files saved in ASCII format. 2) VERDIN, SSIXS, OTCIXS and TADIXS status lines can be automatically removed to prevent confusion (and Manual Routing) by MDU, MDS, or MTV. 3) Information is extracted from the message and placed in the MESSAGE LOG. 4) Messages are saved as 5) Z.B.O.'s are saved as ________.ZBO, the broadcast designator (i.e. PSBA) is also added to the ORIGINATOR as an office code (i.e. COMSUBGRU SEVEN//PSBD//) to prevent confusion and SUSPECTED DUPLICATES by the MDU and MDS programs. 6) 'NNNN' at the beginning of a line is recognized as an End-Of-Message function. INTERPRET cc: Mail: =================== 1) This routine works the same way as the PARTITION routine, however it also has an understanding of the cc:Mail file structure used by COMSUBPAC N65. Routing headers and footers are removed automatically. 2) Traffic other than messages will NOT be processed!, this includes any memo's and/or E-Mail that may be included in the download. Local procedures should be developed and tailored to the end-users. With the frequent change in message formats and headers by CC:MAIL POST OFFICES, feedback to the programmer will be required to incorporate the changes in this program. 3) Messages are saved as 4) Z.B.O.'s are saved as ________.CCZ cc:Mail Instructions for use : ------------------------------ 1) At MAIN MENU select 'Retreive Messages' 2) At RETRIEVE MENU select 'Scan Message Headings' a) Tag all messages desired with the [F5] key then press [ENTER]. b) Select 'Write to ASCII File' at C:\CCMAIL\... prompt, select a temporary filename. c) {IF DESIRED} Select 'Delete Messages' 3) At MAIN MENU select 'EXIT CC:MAIL' MESSAGE VIEWER : (Currently TESTING & DEVELOPING) ================ 1) "Why use another program to view and print your message traffic." This feature will soon allow you to make TTY INTERFACE the only program you need for all you message requirements. Commands... - ----------- right Arrow - View Next Message Left Arrow - View Previous Message Up Arrow - Scroll Up Down Arrow - Scroll Down PgUp - Move One Page Up PgDn - Move One Page Down Home - Move to Top/Left of Message End - Move to Bottom/Left of Message - - Scroll Left + - Scroll right D - Delete Message (TOGGLE), messages will be DELETED upon exit from VIEWER. P - Print Message T or X - [NEW] Transmit to TTY Equipment C or S - VIEWER/PRINTER Configuration ? or I - Show System Information MESSAGE LOG : ============= NOTE: With VERSION 1.47 you may delete the filename to prevent use of this file. 1) Contains information about all files transmitted and received by TTY INTERFACE. 2) READDRESSALS are plainly marked and listed. 3) D-T-G's are listed in several formats in different columns allowing rapid sorting and searching by Seperate Programs. 4) Only valid precedence and classification abbreviations are used in the MESSAGE LOG. 5) SUBJECT is selected as; SUBJ, MSGID; or SIC in descending order. 6) CLASSIFICATION is selected from Format Line #3; (i.e. ZNR ..... or ZNY .....). 7) PRECEDENCE is selected from format line #4. 8) D-T-G's are selected from format line #4 (up to 10 RADDR's per message). 9) Records time and method that message file was received. MESSAGE LOG FORMAT: ------------------- 1 / 2 /3/4/ 5 / 6 / 7 / 8 /9/ 10 / 26224552.MSG� 17�P�U�260101ZDEC95�ZEN�USS HELENA �SUBJ/OUTGOING MSG// �T�199712260101.NPU� 26224553.MSG� 18�R�U�260202ZDEC95�ZYB�SKOT FRED INDUSTRIES�SUBJ/TEST MESSAGE// �P�199712260202.NRU� 26224554.ZBO� 30�O�C�260400ZDEC95�---�COMSUBPAC PEARL HARB�PSBC ZBO �R�199712260400.NOC� 26224555.CCM� 18�O�C�260404ZDEC95�---�COMSUBGRU SEVEN �SUBJ:OPSKED �C�199712260404.NOC� 26224556.CCM� 7�O�C�012000ZJAN01�---�CTF SEVEN FOUR �Unknown �C�200101012000.NOC� Fields ------ 1 - Filename ex. ddhhmmss. 2 - Lines in Message 3 - Precedence Y -EMERGENCY Z -FLASH W -CRITIC O -IMMEDIATE P -PRIORITY R -ROUTINE 4 - Classification T - TOP SECRET S - SECRET c - CONFIDENTIAL R - RESTRICTED E - EFTO U - UNCLAS 5 - DTG (Date-Time-Group) 6 - Opsig from FL#4 7 - Originator 8 - SUBJ/MSGID/or SIC 9 - Method Received R - RECEIVER T - TRANSMITTER C - cc: Mail P - Partition ASCII 10 - DTG for sorting/searching ex. yyyymmddhhmm.123 1 - Sectional/Normal (S, N) 2 - Precedence (Y, Z, W, O, P, R) 3 - Classification (T, S, C, R, E, U) SYSTEM LOG : ============ NOTE: With VERSION 1.47 you may delete the filename to prevent use of this file. 1) Contains information about program upgrades and any errors that occur. 2) Contains a record of all program usage and times. 3) In the event of difficulty executing the TTY INTERFACE program this file may be required for troubleshooting. CONFIGURATION : =============== 1) Allows selection of COMM Ports; File Management and various other aspects of the program. 2) File Management : Incoming MSG Path - directory where incoming messages are to be sent (default C:\MDU\MSGIN for MDU, C:\MDS\MSGIN for MDS, or (C:\MTV for M-T-V) Outgoing MSG Path - directory where ougoing messages are to be retreived (default B:\RADIO) ASCII Directory - directory where ASCII files (for Partitioning) are held. cc:Mail Directory - message where CC:MAIL messages are held. {See CC:MAIL instructions listed above for details !} (default C:\CCMAIL) Send Outgoings to MDU - should program automatically send a copy of the outgoing message to MDU/MDS/MTV when the message is Transmitted to the teletype. (default : Yes) 3) EOM (End of Message) Flag - prompts computer to send 2CR, 8LF and NNNN to the teletype at end of message if other material (such as routing info) is stored on the disk file. DEFAULT SETTING IS '@'. 4) Unlisted Commands: ? = Display System Information QUIT TO DOS : ============= 1) Does exactly as it says, it exits the program... 2) Prior to terminating, if any CONFIGURATION changes are made and not saved, the user will be prompted. RECOGNIZED (AND REMOVED) STATUS MESSAGES : ========================================== (Lines beginning with... Where "_" indicates a SPACE, and "?" indicates any character, and "#" indicates a number.) SSIXS (BGIXS): GM#_ TR#_ AS#_ AR#_ AB#_ BY#_ RNTU#_ RAKU#_ ?SB?/? (Added in 1.46 09APR1997) _SID__ TT_MSG_0000 SSIXS_ID'S:_ SSIXS_TIME_ (Still working on this one... 1.49 12MAY1997) SSIXS_TT_RCV_MSG SSIXS_TT_XMIT_MSG ILLEGAL_FORMAT GROUP_BCST_RCVD QUERY_BCST_RCVD RCV_INTERRUPTED MESSAGE_REJECTED ENTER_SSIXS_NET_ID'S: SSIXS_TT_XMIT____QUEUE_DELETED SSIXS BUOY(BIU): BUOY_INTERFACE_ERR RETURN_TO_SSIXS OTCIXS: DL_MSN_ SB_MSN_ OTCIXS_TIME_ (V)6/TDP_INTERFACE_ SCHED_BCST_COMPLETE SCHED_BCST_PREEMPTED TDP_ENTERED_DL_XMIT_MSN_ OTCIXS__SUBSURFACE_RELEASE OTCIXS_EDIT_RECEIVE_GUARD_LIST OTCIXS_ACTIVE_RECEIVE_GUARD_LIST TADIXS-A: TAD_DL TADIXS_TIME_ TADIXS__RELEASE_ TADIXS_JOTS_DEMO_ TADIXS/TDP_INTERFACE_ TADIXS/OTCIXS_INTERFACE_ TADIXS_ACTIVE_RECEIVE_GUARD_LIST UPDATED_LIST_FROM_TADIXS_REJECTED SID_####_ADDED_TO_TRANSMIT_LIST SID_####_DELETED_FROM_TRANSMIT_LIST VERDIN: ZIA ZKA_ NO_SYNC__ RCVR_TESTS:__ E_E_E_E_E_E_E_E_AR ELF: (added to user menu's for future program upgrades) USER-DEFINED: (Added in 1.43) (allows for user-defined screening [selective removal] of status lines appended to messages) MISCELLANEOUS (Always checked) : NO_NET_CONTROL TIME_CORRECTED_FROM_ MESSAGE_QUEUE_REPORT ________TOTAL____ SID_####_IS NET CONTROL UNTESTED FEATURES: ================== TDD DIALER KNOWN BUGS AND PROGRAM LIMITATIONS : ==================================== 1. The EMULATOR may become sluggish when XMIT NULLS is selected ON. 2. Directory display does not scroll and becomes distorted after 100 files. 3. Maximum message length = 2000 lines. 4. Speeds below 75 baud may not work due to Computer HARDWARE limitations ? 5. Higher baud rates >1200 baud may not work on older-slower computers. 6. TTY EMULATOR transmit function has LTRS/FIGS swapped... (version 1.48 and before) 7. 'SSIXS TIME ' ON-143(V)6 Status line is not always removed (version 1.48 and before) - ---------------------------------------------------------------------- - -------------- NOTE: User feedback provides much needed input and information that ultimately affects all users. Your feedback is desired and required by the author to aid in further improvements this program. All program improvements and suggestions will be considered for addition. skotfred@skotfred.com -----BEGIN PGP SIGNATURE----- Version: PGP 6.5.1i iQA/AwUBOFXZA958X6uERn77EQKvowCcCn8f7JYOIP9AQ5lC0A/I9c1hfzMAn2RJ NmaG9ORWVoE6KB5QZhSGSaWx =J+F2 -----END PGP SIGNATURE-----