PC-VT - VT100/102/52 Terminal Emulator (C) Copyright 1984 Mark C. DiVecchio Version 7.0 Forward Many trademarks are used through out this document. I will list and acknowledge them here. IBM, IBM PC, and PC-DOS are trademarks of International Business Machines Corporation. DEC, VMS, VAX and VT are trademarks of Digital Equipment Corporation. Smartmodem is a trademark of Hayes Microcomputer Products. For more details on the operation of a VT102 or a VT100, refer to the VT102 and VT100 Video Terminal User Guides published by Digital Equipment Corp, Educational Services Department, Maynard, Massachusetts 01754. Throughout this document, hexidecimal numbers are followed by the letter "H". All other numbers are decimal. Also, the ENTER key on the keyboard sends a carriage return character - ASCII code 13. A carriage return function moves the cursor to the beginning of the current line. "ESC" refers to the ASCII character whose decimal value is 26. PC-VT WARRANTY This program is provided on an "as is" basis without warranty of any kind, expressed or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to quality and performance of this program is with you. Should the program prove defective, you assume the entire cost of all necessary repair, servicing, or correction. In no event will the author be liable to you for any damages, including any lost profits, lost savings, or other incidental or consequential damages arising out of the use or inability to use this program. This warranty gives you specific legal rights, and you may have other rights which may vary from state to state. Some states do not allow the exclusion of implied warranties or exclusion of liability for incidental or consequential damages so the above may not apply to you. You acknowledge that you have read this agreement, understand it, and agree to be bound by its terms and conditions. You further agree that it is the complete and exclusive statement of the agreement between us, which supercedes any proposal or prior agreement, oral or written, and any other communications between us. THANKS I would like to thank all of the users who have been kind enough to send me their ideas and comments. It is through feedback of this nature that I can make PC-VT a better and more useful program. Mark C. DiVecchio 9067 Hillery Drive San Diego, CA 92126 619-566-6810 If you received this copy of the PC-VT manual from a Bulletin Board System, it is a condensed version. To receive the complete documentation, follow the directions in the appendix. Copyright 1984 Mark C. DiVecchio Page 3 Introduction PC-VT Chapter 1 Introduction PC-VT is a software emulator which makes the IBM PC function as a DEC VT102 or a VT100 Video Terminal. Selection of terminal type is made in the SETUP B display (Chapter 6). PC-VT defaults to VT102 emulation. PC-VT also supports VT52 compatibility mode. PC-VT emulates the majority of the functions of the VT100/102. Because of either hardware limitations of the IBM PC or limitations of PC-DOS, some functions cannot be emulated. Other functions have been slightly modified. Throughout this document, references are made to these changes and deletions. PC-VT handles all of the necessary functions to perform as a VT100/102 emulator. The vast majority of users will never notice these hardware and PC-DOS mandated changes. The typical user will only need to read Chapters 2 through 5 of this manual. Chapter 6 is only necessary if any of the selectable features need to be changed from the default settings. PC-VT comes pre-configured for the most popular set of features. Communications parameters default to 300 baud, 7 data bits, no parity and 2 stop bits. Chapter 7 describes the VT100/102 "USER MEMORY" which PC-VT emulates by creating and using a disk file. Chapter 8 describes the Receive File (Download) and Transmit File (Upload) features. Chapter 9 describes the use of the Dialing facility which is Hayes command compatible. The more sophisticated user will find that the Appendices give a complete description of the internal workings of PC-VT. DOS path names are supported for upload/download if you are using DOS 2 or later. - Here is a brief list of the functions handled by PC-VT. * Emulates both VT100 and VT102 Terminals. Emulates VT52 compatibility Mode of the VT100. * Communication over an RS232 port configured as either COM1 or COM2 selectable from the SETUP display. Page 4 Copyright 1984 Mark C. DiVecchio PC-VT Introduction * Communications support for all of the popular baud rate and data bit/parity bit combinations. * Full Duplex with no EIA modem control. Only data leads have to be connected (FDX A mode). Suitable for use 1 with a null modem (direct) connection to the host computer or with a modem which does not require modem control signals. * VT52 Compatibility Mode. * Support for Hayes dialing commands and includes a Dialing Directory with 10 entries. * Full receive parity checking can be enabled. * Both Numeric and Application Keypad modes. * Full cursor control. * Full feature Upload and Download file capability. Both ASCII and XMODEM (CRC capable) are supported. Path name support is included if you are using DOS 2 or later. * Capability to transmit a sustained Break. * NO SCROLL key XON/XOFF support. * Connection of a printer as LPT1 including local print screen operations. * Capability to echo all displayed characters to LPT1 as hardcopy record of a terminal session. * Using special ALT key keystrokes, access to several special function procedures. * SETUP A and SETUP B displays. * Full XON/XOFF support for both transmit and receive. * ON LINE, LED "Lx" and KBD LOCKED lights are supported via the use of line 25 of the PC display as a status line. (4 LED are supported for the VT100 emulation, 1 for the VT102.) ---------- 1. Throughout this manual, the host refers to the computer "on the other end of the line" with which PC-VT is communicating. Copyright 1984 Mark C. DiVecchio Page 5 Introduction PC-VT * For the more sophisticated user, the majority of the ANSI standard and DEC private Escape sequences are supported. - Here is a brief list of what PC-VT can not handle. * Half duplex modes (HDX A and HDX B) and special full duplex modes (FDX B and FDX C). * Features used only in these non supported communications modes. * Test and Adjustments Escape sequences. * Certain display attribute handling for normal and reverse video. The IBM PC does not handle reverse video (black on white) the same way as the VT100/102. The differences are detailed throughout this manual. * As mentioned earlier, functions with no IBM PC hardware such as Smooth Scroll mode, 132 column mode, underscore on PC's using the color graphics display card, Alternate Character ROM modes, and double height/width character modes. As an aid to the user of PC-VT, PC-VT uses the speaker built into the IBM PC to indicate attempted illegal operations. PC-VT beeps under the following conditions: 1. When the keyboard has been locked by the host and a key is typed, 2. When an undefined key is pressed on the keyboard, 3. When a control character of 7 (Bell) is received, 4. When an attempt is made to perform an illegal or undefined operation in a SETUP or the DIALING display. 5. When the MODEM has lost communications or cannot transmit, PC-VT times-out after trying to send a character for one-half second. Page 6 Copyright 1984 Mark C. DiVecchio PC-VT Required Hardware and Software Chapter 2 Required Hardware and Software PC-VT requires an IBM PC with either the Monochrome or Color/Graphics card, an 80 column display, 64K of memory (a better way to put this, is enough for DOS plus about 22K for PC-VT), one disk drive and one RS-232 port. The RS-232 port can be jumpered as COM1 or COM2. A line printer, if present, is supported if it is connected to a parallel port jumpered as LPT1. The PC-DOS MODE command can be used to route LPT1 output to a COM port if a serial printer is attached. PC-VT will operate under PC-DOS 1.1 or 2.x . PC-VT more closely emulates the VT100/102 if the IBM PC has a Color/Graphics card and display. Only minor reductions in user friendlyness occur with 2 the Monochrome display. PC-VT supports the IBM fixed disk . PC-VT will support the Hayes Smartmodem or compatible cards. Chapter 9 gives the details for their use. The modem card can be configured as COM1 or COM2. If a standalone Modem is used, the RS-232 port in the IBM PC can also be configured either as COM1 or COM2. A comment on DOS : If you don't have DOS 2.0 or 2.1, please invest the money and buy it. The new versions of DOS added a lot of functionality to the IBM PC, if you are running DOS 1.1 , you will not see that increased functionality. ---------- 2. The next chapter describes how to use this program with the fixed disk. Copyright 1984 Mark C. DiVecchio Page 7 Starting PC-VT PC-VT Chapter 3 Starting PC-VT Place the supplied diskette into one of your diskette drives. Set the default diskette letter in DOS to that drive. If you have a modem which requires manual dialing, dial up the host computer and turn on the Modem. Start the program by typing PC-VT. PC-VT comes preinitialized to communicate at 300 baud with 7 data bits, no parity, and 1 stop bit. If these parameters are not correct for your installation they can be changed. See the discussion of the SETUP displays for instructions on how to change parameters. As PC-VT starts up, it will initialize the COMx port and establish the connection to the modem. The CRT will show the communications display . Lines 1 through 24 are used as the emulated VT100/102 screen which has 24 lines. Line 25 is used as a status line. The first thing that you will see on line 25 is the word "ON LINE" and the version number of PC-VT in the lower left. This indicates that PC-VT is operating normally and is ready to communicate. If you have a Hayes or other compatible Modem, you can now automatically dial the host's number. Type CTRL-F9 to enter the DIALING display. See Chapter 9 for detailed instructions on how to use this DIALING facility. Most host systems require that the terminal initiate communications so type ENTER (or any other character). Your host computer should now be responding. From this point on, PC-VT runs as a VT100/102 Video 3 Terminal . In addition to the items described above, the Status line also shows the status of the attached modem if the cable to the modem carries all signals or if the modem is an internally mounted unit. These three icons are displayed: ---------- 3. If at this point, nothing is working or the PC beeps with every key you depress, most likely the COMx to Modem interface was not correctly initialized. Cancel and restart the program. PC-VT will reset and will re-initialize the COMx port. Page 8 Copyright 1984 Mark C. DiVecchio PC-VT Starting PC-VT - DSR - Data Set Ready - the modem is ready to accept data. - CD - Carrier Detect - the modem has detected a carrier on the phone line. - CTS - Clear To Send - the modem has completed the establishment of a connection and is ready to send data to the Host. If you are using a "smart" modem, the modem may signal CD and CTS even when not connected to the Host. There is usually a switch on the modem to switch these two lines to their more correct operation. Using PC-VT on the IBM fixed disk is possible. The only requirement is that the files DIALER.DAT and PARAMS.DAT be in the default directory and that the fixed disk be the default drive at the time PC-VT is started. Copy the program PC-VT.EXE, DIALER.DAT and PARAMS.DAT to the fixed disk. Then just start up PC-VT as described above. Copyright 1984 Mark C. DiVecchio Page 9 Stopping PC-VT PC-VT Chapter 4 Stopping PC-VT Since CTRL-C is a valid key for the VT100/102, PC-VT intercepts both that key and CTRL-BREAK before DOS can use them to terminate the program. You can terminate PC-VT in one of two ways: - Type CTRL-F8 or - Go to the SETUP or DIALING display and then type CTRL-BREAK or CTRL-C. As with other PC-DOS programs, the type ahead buffer must be empty for CTRL-C to work correctly. The screen will clear, control will return to PC-DOS and the PC-DOS prompt should appear. The host connection is not broken (DTR and RTS are kept active) and restarting PC-VT will re-establish communications. Page 10 Copyright 1984 Mark C. DiVecchio PC-VT Keyboard assignments Chapter 5 Keyboard assignments Since the keyboard on the IBM PC is not the same as the VT100/102, certain keys have to be mapped. The basic keyboard is the same of course. The keypad, cursor keys and certain other control keys are in different positions on the two keyboards. The other major difference is the lack of separate cursor keys on the PC (the cursor keys and the keypad occupy the same keys). Delete Key : The backspace key on the IBM PC keyboard emulates the DELETE key on the VT100/102. Cursor Keys : The four cursor keys on the IBM PC keyboard emulate the four cursor keys on the VT100/102. NUM LOCK must be off for these keys to function. If NUM LOCK is set, the keypad generates the numeric characters shown on the keys. Function Keys : In Numeric Keypad mode, F1 thru F4 on the IBM PC keyboard emulate the PF1 thru PF4 keys on the VT100/102. In Application Keypad mode, F1 thru F10 map onto the VT100/102 keypad as follows (PC-VT displays the Greek letter "alpha" on the status to indicate that this mode is set): IBM PC key VT100/102 key F1 PF1 F2 PF2 F3 7 F4 8 F5 4 F6 5 F7 1 F8 2 F9 0 F10 0 Shift F1 PF3 Copyright 1984 Mark C. DiVecchio Page 11 Keyboard assignments PC-VT Shift F2 PF4 Shift F3 9 Shift F4 - (minus sign) Shift F5 6 Shift F6 , (comma) Shift F7 3 Shift F8 ENTER Shift F9 . (period) Shift F10 ENTER This assignment was selected to closely follow the physical layout of the keypad on the VT100/102. Observe that the VT100/102 has four columns of keys in the keypad. PC-VT emulates the two left columns with the function keys and emulates the two right columns with the shifted function keys. It is expected that a user who is familiar with the VT100/102 keypad and has memorized the position of each key, will have little trouble using this function key mapping. Note that the "0" key and the "ENTER" key are mapped onto two of the PC keys. This is because on the VT100/102, the "0" and "ENTER" keys are double width. The drawing on the next page shows this mapping in a pictorial format. The name of the IBM PC key is in the upper left of each "key" pictorial. The emulated key or function is then shown in the center of the pictorial. Note : NUM LOCK is handled locally in the IBM PC. For the keypad keys to work correctly when using PC-VT, NUM LOCK should not be set. Special key mapping for the EDT Editor : In application keypad mode, which is set by the DEC EDT text editor, the following keys cause special Escape sequences to be transmitted. Observe that some of these special keys transmit sequences that would require two or more keystrokes on the VT100/102. PC-VT displays the Greek letter "alpha" in the status line to indicate that this mode is active. IBM PC key EDT function performed Del key DEL C Backspace Deletes the character to the left of the cursor (DELETE key on the VT100/102) Ins key OPEN LINE Home key TOP Page 12 Copyright 1984 Mark C. DiVecchio PC-VT Keyboard assignments End key BOTTOM PgUp key BACKUP SECT PgDn key ADVANCE SECT CTRL-Home key Deletes the word to the left or of the cursor (LINEFEED key CTRL-Enter on the VT100/102) CTRL-End key ADVANCE DEL EOL - Erases from the cursor to the end of the line. CTRL-PgUp key BACKUP PAGE CTRL-PgDn key ADVANCE PAGE CTRL-Left Arrow key BACKUP EOL - Move cursor to the end of the previous line. CTRL-Right Arrow key ADVANCE EOL - Move the cursor to the end of the current line. SHIFT-Tab Moves the cursor to the beginning of the line (BACKSPACE key on the VT100/102). Copyright 1984 Mark C. DiVecchio Page 13 Keyboard assignments PC-VT Shift Tab : The shift tab key sends a backspace character to the host. Emulates the VT100/102 BACKSPACE key. CTRL-ENTER : This key combination sends a line feed character to the host. CTRL-@ : This key combination sends a NUL character (ASCII 0) to the host. Used by Emacs running on DEC VAX. SCROLL LOCK : The SCROLL LOCK key on IBM PC alternately sends XON and XOFF and emulates the NO SCROLL key on the VT100/102. PC-VT displays the word "SCR" on the status line of the display to remind you that the SCROLL LOCK key has been depressed once. Depressing the key again resets SCROLL LOCK and clears the reminder. NUM LOCK : The NUM LOCK key places the IBM PC keypad in numeric mode. The NUM LOCK key functions locally in the PC only and does not transmit any characters to the host computer. PC-VT displays the word "NUM" on the status line of the display to remind you that the NUM LOCK key has been depressed once. Depressing the key again resets NUM LOCK and clears the reminder. CAPS LOCK : The CAPS LOCK key places the IBM PC keyboard in uppercase mode. The CAPS LOCK key functions locally in the PC only and does not transmit any characters to the host computer. PC-VT displays the word "CAP" on the status line of the display to remind you that the CAPS LOCK key has been depressed once. Depressing the key again resets CAPS LOCK and clears the reminder. CTRL-F1 : PC-VT enters the SETUP display. See Chapter 6. CTRL-F2 : This command lets you change the default directory for uploading and downloading files. See Chapter 8. CTRL-F3 : See Chapter 8. CTRL-F4 : See Chapter 8. CTRL-F5 : Print screen. The screen is printed on LPT1, if present. Performs the same function as receipt of a "ESC [ i" sequence. If the Print Termination Character is set in the SETUP B display, a Form Feed will be performed after the Page 14 Copyright 1984 Mark C. DiVecchio PC-VT Keyboard assignments screen is printed. CTRL-F6 : Echo to LPT1. Toggles On/Off echoing to LPT1, if present. Prints all characters received or transmitted to/from the host. Characters displayed on the status line (line 25) are never printed. Performs the same function as receipt of "ESC [ ? 5 i" and "ESC [ ? 4 i" sequences. CTRL-F7 : To send a sustained break to the host, type CTRL-F7. Confirmation of the operation is a beep at the start of the break and a display of the word "<>" along with another beep at the end of the operation. If the disconnect character feature is selected in the SETUP B display, PC-VT sends an EOT character (ASCII 4) before it sends the break. The screen is cleared. CTRL-F8 : Terminates PC-VT and returns to DOS. CTRL-F9 : Enters the DIALING display. See Chapter 9 for instructions. CTRL-F10 : Complete restart. Performs the same function as receipt of a "ESC c" sequence. All features and tab stops are reloaded from the USER MEMORY disk file. PC-VT then restarts. This will not change the COM port. You must terminate PC-VT and then restart it to change the COM port. Copyright 1984 Mark C. DiVecchio Page 15 SETUP Displays PC-VT Chapter 6 SETUP Displays The SETUP displays are accessed by typing CTRL-F1 from the communications display. SETUP A is entered first. If you have a Color/Graphics card, the contents of the communications display are preserved and are restored when you exit SETUP. If you have a Monochrome card, the communications display is cleared when you enter SETUP. The SETUP display can also used to cancel PC-VT. The CTRL-C and CTRL-BREAK keys are disabled while in the communications display. To cancel PC-VT, type CTRL-F1 to enter this display and then type CTRL-C or CTRL-BREAK. 6.1 SETUP A The SETUP A display is used to perform the functions listed below. The bottom two lines of the display represent the tab stops which are set. The bottom line counts the columns and the line above it shows a "T" in each column where a tab is set. Here are the functions available in SETUP A: Exit SETUP : The ESC key or the CTRL-F1 key combination returns PC-VT to the communications display. Reset : The "0" key clears the tabs and features and reloads them from the USER MEMORY disk file, PARAMS.DAT, on the default drive. PC-VT then returns to the communications display. Set/Clear Tabs : The "2" key sets or clears a tab at the columm position of the cursor. The left and right arrows, the tab key, the space bar, and the ENTER key can be used to move the cursor to the column in which you want to set or clear the tab. A "T" will appear to indicate that a tab was set or the "T" will be blanked to indicate that a tab was Page 16 Copyright 1984 Mark C. DiVecchio PC-VT SETUP Displays cleared. In either case, the character will be highlited to indicate that a change was made. Clear All Tabs : The "3" key clears all tab stops. All of the "T" tab stop indicators will be cleared. Go to SETUP B : The "5" key selects the SETUP B display. Store into USER MEMORY : The "shift S" key stores all currently set tab stops and features selected by SETUP B into a disk file on the PC-DOS default drive. The name of the file is PARAMS.DAT. Reset : The "shift R" key clears the tabs and features and reloads them from the USER MEMORY disk file, PARAMS.DAT, on the default drive. PC-VT remains in the SETUP A display. Select General Default : The "shift D" key clears any user set tabs and features (from SETUP B) and resets them to PC-VT defined defaults. Select Tab Default : The "shift T" key clears any user set tabs and resets them to every 8 columns as follows: Columns 9, 17, 25, 33, 41, 49, 57, 65, and 73. A "T" will appear in each of these columns on the second line from the bottom of the SETUP A display to indicate that a tab is set. 6.2 SETUP B The SETUP B display is used to perform the functions listed below. The bottom line of the display represents the features which are set or reset. See the next section for details of the features. The number of data bits and the parity type are displayed. The COM port speed is displayed. The selected COM port is displayed. LPT1 is displayed to indicate that if a printer is attached to LPT1, it can be used by PC-VT. Here are the functions available in SETUP B: Copyright 1984 Mark C. DiVecchio Page 17 SETUP Displays PC-VT Exit SETUP : Hit the ESC key or type CTRL-F1 to exit SETUP B and return to the communications display. Go to SETUP A : The "5" key selects the SETUP A display. Toggle 1/0 : The "6" key sets(1) or resets(0) a feature at the columm position of the cursor. The left and right arrows, the tab key, the space bar, and the ENTER key can be used to move the cursor to the column which you want to set or clear the feature. Features displayed with an "X" are set to an automatic default and cannot be changed. Other features will change from a "1" to a "0" or from a "0" to a "1" to indicate that the state of the feature has been changed. The digit will be highlited to indicate that a change was made. To preserve these features in your USER MEMORY disk file you must perform a "shift S - Store into USER MEMORY" command in the SETUP A display. Otherwise, the old values will be reloaded when you again start up PC-VT. COM Port Selection : COM1 or COM2 can be selected by flipping the 4th bit of the 6th group of feature bits shown on the bottom of the SETUP B display. The word COM1 or COM2 will display next to the word MODEM on this this display to indicate which RS232 port is in use by PC-VT. If you want to change ports, you should first go to SETUP B display, space over to the 4th bit of the 6th group and then type the "6" key. This will cause the 1 or 0 in the feature bit to flip. Then return to the SETUP A display by typing "5" and store the new value into USER MEMORY by typing Shift-"s". To make the change take effect, cancel PC-VT by typing CTRL-C and then restart the program by typing PC-VT at the DOS prompt. Modem Speed Control : The "7" key causes PC-VT to display the various Modem speeds supported. The currently selected speed is displayed under the MODEM title on the CRT. Type the "7" key repeatedly until the speed you need is displayed. The new speed selected will be highlited to indicate that a change was made. The supported speeds are: 100 baud 150 baud 300 baud (default) 600 baud 1200 baud 2400 baud Page 18 Copyright 1984 Mark C. DiVecchio PC-VT SETUP Displays 4800 baud 9600 baud To preserve this speed selection in your USER MEMORY disk file you must perform a "shift S - Store into USER MEMORY" command in the SETUP A display. Otherwise, the old values will be reloaded when you again start up PC-VT. Select Data/Parity Bits : The "shift P" key causes PC-VT to display the various data bits/parity bits supported. The currently selected Data bits/Parity bits combination is displayed on the CRT under the MODEM title. Type the "shift P" key repeatedly until the data bits/parity bits combination you need is displayed. The new selection will be highlited to indicate that a change was made. The supported combinations are: 7O 7 data bits - odd parity 7E 7 data bits - even parity 7N 7 data bits - no parity (default) 8O 8 data bits - odd parity 8E 8 data bits - even parity 8N 8 data bits - no parity To preserve these Data bit/Parity bit combinations in your USER MEMORY disk file you must perform a "shift S - Store into USER MEMORY" - command in the SETUP A display. Otherwise, the old values will be reloaded when you again start up PC-VT. If you are running a 212A modem, certain of the data bits/parity/stop bit combinations are invalid. Check your modem manual for the valid combinations. Note that actual parity checking is enabled by setting a feature in this display. Parity checking defaults to off. Set Answerback Message : The "shift A" key permits you to enter a message with which PC-VT will use to respond to an Enquire control character. Any character with an ASCII code from 0 to 127 can be entered in this message (Including the use of the ALT key and the keypad to enter special characters). To enter the message, type "shift A". PC-VT will display the prompt "A=". The prompt will be highlited and blinking. You may then type in the message. The first character typed is considered a delimiter by PC-VT. This character must not be Copyright 1984 Mark C. DiVecchio Page 19 SETUP Displays PC-VT present in the answerback message itself and is used only to bracket the message since control characters like carriage return can be part of the message. Following the message, type the delimiter character and the message will be stored in memory. If you make a typing mistake, you must type the delimiter character and start the process over again. This is because the backspace key will not act as a text editor but will actually be entered as part of the answerback message. While you are entering this message, non-displayable characters will be shown as a diamond. The message will be highlited to indicate that a change is being made.To preserve this message in your USER MEMORY disk file you must perform a "shift S - Store into USER MEMORY" - command in the SETUP A display. Otherwise, the old message, if any, will be reloaded when you again start up PC-VT. The default answerback message is null, that is, nothing is transmitted in response to an Enquire control character. 6.2.1 SETUP B Features and Defaults The SETUP B display is used to select features of PC-VT. The features are listed below along with their defaults. The procedures for changing and saving these features was described in the first part of this subsection. Group 1 Default Value X = feature is not supported Scroll X The IBM PC does not support smooth scroll. Auto Repeat 1 0 = Disable autorepeat. PC-VT can only approximate this function since it is handled within the keyboard. 1 = Enable autorepeat. Screen 0 0 = dark background Background 1 = light background Cursor 0 0 = underline cursor 1 = block cursor Group 2 Default Value X = feature is not supported Page 20 Copyright 1984 Mark C. DiVecchio PC-VT SETUP Displays Margin Bell X Margin bell is not supported. Keyclick X Keyclick is not supported. ANSI/VT52 1 Select terminal mode. 0 = VT52 compatibility mode. 1 = ANSI mode. That is, either VT100 or VT102 depending on the setting of the bit in Group 6 below. Auto XON/XOFF 1 XON/XOFF support is always on. PC-VT will stop transmitting characters when an XON is received and will transmit an XOFF when 90% of its receive buffer is full (230 characters). It will then transmit XON when the buffer has been emptied to 10% full (26 characters). If the host ignores the XOFF character and continues to send, PC-VT will display a checkerboard character to indicate that data has been lost. When PC-VT receives an XOFF, an 'X' is displayed in column 41 of the status line. If you try to type a character when the 'X' is displayed, PC-VT beep and reject the character. See the 'alt-x' key definition in the appendix for more details. Group 3 Default Value X = feature is not supported Character Set 0 0 = Select US Characters. The US character set is selected as the default. 1 = Select UK Characters. The UK character set is selected as the default. (Note that the only difference between the two is the shift 3 character. In the US set, it is the "#" sign. In the UK set, it is the UK Pound sign.) Auto Wrap 0 0 = Auto wrap off. If the cursor is at the right margin and another character is received, PC-VT displays that character and all following received characters at the right margin position effectively writing over one another. Copyright 1984 Mark C. DiVecchio Page 21 SETUP Displays PC-VT 1 = Auto wrap on - If the cursor is at the right margin and another character is received, PC-VT will perform a carriage return and line feed before displaying that character. Line Feed / 0 0 = LF/NL off - Typing ENTER New Line sends only a carriage return to the host. The host must echo a carriage return and line feed to move the cursor to the beginning of the next line. 1 = LF/NL on - Typing ENTER sends both a carriage return and a line feed to the host. A line feed is processed just like a carriage return. Local Echo 0 0 = Local echo off. - The host must echo back all typed characters in order for them to be displayed on the screen. 1 = Local echo on - PC-VT will automatically display all characters typed. The host need not echo them back. Group 4 Default Value X = feature is not supported Print 1 0 = none - No control characters Termination are sent to LPT1 following a print Character screen operation. 1 = Form feed - A form feed is sent to LPT1 following a print screen operation. Print Extent 1 0 = Scrolling region - A print screen operation will print the scrolling region as set by the host computer only. 1 = Full screen - A print screen operation will print the entire screen. Stop Bits 0 0 = 1 stop bit is used by the RS232 interface. 1 = 2 stop bits are used by the RS232 interface. Receive Parity 0 0 = Parity on received data is not checked. Page 22 Copyright 1984 Mark C. DiVecchio PC-VT SETUP Displays 1 = Parity checking is enabled. PC-VT displays a checkerboard in place of the character with the bad parity. Group 5 Default Value X = feature is not supported Break Enable X A Break can always be sent by typing CTRL-F7. Disconnect 0 0 = Terminal ignores the Character disconnect character. Enable 1 = If PC-VT receives the disconnect character ( an EOT with an ASCII value of 4), it transmits a sustained Break and disconnects from the host computer. Disconnect X Not supported. Delay Auto X Not supported. This feature does Answerback not affect transmission of the Enable answer back message if a control character 5 (Enquire) is received. Group 6 Default Value X = feature is not supported Initial X Initial direction is always transmit. Direction Auto X PC-VT always operates in Full Turnaround Duplex Mode so this feature is not needed. Terminal type 0 0 = PC-VT emulates a VT102 1 = PC-VT emulates a VT100. Comm Port 0 0 = PC-VT uses COM1 as the communications port 1 = PC-VT uses COM2 as the communications port NOTE: In order for this change to become effective, PC-VT must be terminated and then restarted. Just flipping this bit will not change the COM port. Group 7 Default Value X = feature is not supported Copyright 1984 Mark C. DiVecchio Page 23 SETUP Displays PC-VT Power X Not under PC-VT control. WPS Terminal X Not yet supported. Keyboard Clock 1 0 = Do not display the clock and MODEM status on the Status Line. 1 = Display the time of day clock and MODEM status on the Status Line 256 Char 0 0 = If 8 bit data is selected for receive, the 8th bit is cleared to binary zero if it is on received data. PC-VT will display characters only from the first 128 ASCII codes. (XMODEM always uses all 8 bits.) 1 = If 8 bit data is selected for receive, the 8th bit is interpreted as the high order bit of an 8 bit ASCII character. this permits 256 character codes to be displayed on the screen. This is NOT a VT function and the use of this option may cause unreliable results. Page 24 Copyright 1984 Mark C. DiVecchio PC-VT Transmitting and Receiving Files Chapter 7 Transmitting and Receiving Files PC-VT has complete transmitting (upload) and receiving (download) facilities. These facilities are accessed using the CTRL-F4 and CTRL-F3 keys. These keys can be activated whenever you are in the communications display. PC-VT performs these functions on any ASCII character or binary file. The Binary file transfer uses the XMODEM protocol and must be over a communications line set at 8 data bits, no parity, and 1 stop bit. XMODEM can be used to transfer ASCII files for greater error detection capability. Both the ASCII and XMODEM protocols are compatible with RBBS software. In the descriptions which follow, the computer refered to as the host, is assumed to be a VAX-11 running VMS. All references to an IBM PC filename include a drive letter, the path, the filename and the file extension, for example - a:\usr\bin\file.ext. If no drive letter or path is given, PC-VT will access the current PC-DOS default directory. You can change the default drive and directory by typing CTRL-F2. See the last section in this chapter for details. 7.1 Transmitting ASCII Files (Uploading) To transmit or upload an ASCII file to the host, the host must be set to receive the file and then PC-VT can be told to transmit it. The host computer can be told to execute a program which reads the terminal or more simply, the VMS COPY command can be used. Once you have started PC-VT and logged on to the host, you will see the "$" command line prompt. You can use the COPY command as follows: COPY TT: The host will then wait for characters to be transmitted by the terminal. To request PC-VT to start uploading, type CTRL-F4. You will be prompted for the name of the PC file to upload. Type Copyright 1984 Mark C. DiVecchio Page 25 Transmitting and Receiving Files PC-VT the filename followed by ENTER. Typing just ENTER cancels the transmit request. If PC-VT finds the file as specified, it will transmit it to the host. If the file is not found, you will be prompted again for the filename. The file is displayed as it is transmitted. At the end of the file, PC-VT inquires if you want a CTRL-Z (ASCII code 26) sent to the host. The CTRL-Z will terminate the VMS COPY command. An upper or lower case "y" must be typed followed by ENTER to send the CTRL-Z. PC-VT strips all Line Feed characters before it transmits the file (ASCII code 10). All other characters are transmitted. PC-VT detects the end of the PC file by looking for a CTRL-Z as it reads the disk file. A very useful feature of this routine, is that it handles XOFF/XON characters received from the host during the uploading. This prevents the host from losing data if it is busy. The host will send an XOFF if its buffer is filling. PC-VT will automatically stop transmitting until a XON is received indicating that the host has emptied its buffer. You should be sure that this feature is enabled under your logon on the VMS system. To do this, use the VMS SET command: SET TERMINAL /HOSTSYNC This command should also be put in your LOGIN.COM file unless your VMS system sets this feature as a default. If you wish to cancel the transmission while the file is being transmitted, simply type CTRL-F4 at any time. PC-VT will prompt with the CTRL-Z message and then terminate the upload. PC-VT ignores all other keys typed during an upload except the CTRL-F4 key. If you don't request the transmission of a CTRL-Z, you can type CTRL-F4 again and send another file. The new file transmitted will be read by the same COPY command entered earlier. You can use this to append many files to one another as you transmit them. There are several messages generated by PC-VT while transmitting a file: "Current default directory is >": The current default directory is displayed. For DOS 1.1 users, this is just the default drive. "Drive d: xxxxxx bytes free": The number of free bytes on the default drive is displayed. This is displayed only if you are Page 26 Copyright 1984 Mark C. DiVecchio PC-VT Transmitting and Receiving Files using DOS 2.0 or later. "Enter Name of the PC File to Transmit [d:][path][filename[.ext]][={x,c}] (Hit ENTER to cancel upload and return to emulator):": PC-VT is asking for the name of the PC file to transmit. Type the filename in the standard PC-DOS format and hit ENTER. Typing just ENTER cancels the transmitting routine. If your DOS supports path names, they can be used here. If you do not specify a drive or path, PC-VT will access the default directory. The default directory can be changed with the CTRL-F2 command. See the last section in this chapter for details. "Should a CTRL-Z be transmitted? (y or n) :": PC-VT detects CTRL-Z as an end of file indicator and does not transmit that code to the host unless you respond positively to this query. Type an upper or lower case "y" followed by ENTER and PC-VT will transmit a CTRL-Z. If you type any other character or just ENTER, CTRL-Z will not be transmitted. With this feature, CTRL-F4 can be activated again and several PC files can be concatenated into one host file. "Transmission Complete": File uploading is complete. "Transmission Canceled": A CTRL-F4 was typed during a file transmission. The uploading is immediately canceled. "Filename is not in correct format": The filename entered in response to the filename inquiry is not in the standard PC-DOS format. You may reenter the filename. "File not found as specified": PC-VT could not find the file on the specified disk. Usually caused by either the wrong drive letter, directory or a mistyped filename. You may reenter the filename. 7.1.1 Example of a transmission session This is typical of what you would see and type to transmit a file to the host. Copyright 1984 Mark C. DiVecchio Page 27 Transmitting and Receiving Files PC-VT $ copy tt: up.fil "hit the CTRL-F4 key" Current default directory is >a:\usr\me\pcvt Drive a: 3435423 bytes free Enter Name of the PC File to Transmit [d:][path][filename[.ext]][={x,c}] (Hit ENTER to cancel upload and return to emulator) b:\mydire\pc.asc "Now the PC file named b:\mydire\pc.asc is transmitted, you will see the file displayed on the CRT as it is echoed back from the host. The path name is accepted only if you are running PC-DOS 2.0 or later." Should a CTRL-Z be transmitted? (y or n) : y "A CTRL-Z(ASCII code 26) is sent to the host." Transmission complete ^Z "The host file named up.fil is closed. The host COPY command is terminated." $ 7.1.2 A Useful VAX .COM Upload file This simplified Upload facility will upload a file from a PC disk file to a VAX system running VMS. Create a file on the VAX system named "pcup.com" consisting of the following commands: $ on error then goto err1 $ on control_y then goto ctrl $ if p1.eqs."" then - inquire p1 "Enter Name of VAX File to Contain Uploaded Data " $ if p1 .eqs. "" then goto ctrl $ set term/nobroad $ write sys$output "[?22h" $ copy tt: 'p1' $ exit: $ set term/broad $ exit $ err1: $ write sys$output "A VAX error has occured. Please try again." $ ctrl: $ write sys$output "Upload Canceled." $ goto exit The symbol is the ESCAPE character 27. Once you have started PC-VT on the PC and you have logged onto a VAX, upload files from the PC to the VAX by: Page 28 Copyright 1984 Mark C. DiVecchio PC-VT Transmitting and Receiving Files 1. type this in response to the "$" VMS prompt: @pcup 2. If you did not enter the filename on the command line, the facility will ask you for the name of the VAX file which you wish to create with the uploaded data (include directory information if needed) for example : dra1:[user1.dire.lev2]z.com If you just enter carriage return, the upload is canceled. 3. the facility will ask you for the name of the PC file which you wish to upload (include disk drive letter if needed) for example : zzzzz.com If you just enter carriage return, the upload is canceled. 4. the rest is automatic. The data will display on the PC's CRT while it is being uploaded. The upload is complete when the "$" VMS prompt appears. 5. To abort the upload before it is complete, type: CTRL-F4 The VAX file will contain whatever data was uploaded to the point where you aborted the upload. You may see some extra characters displayed on the CRT screen, this is just the communications buffer emptying. 7.2 Transmitting Binary Files (Uploading) PC-VT supports the XMODEM protocol for binary or ASCII file transfer. Support is included for both checksum error checking compatible with PC-TALKIII and for Cyclic Redundancy Code(CRC) error checking. This transfer method requires that the host computer be capable of handling this protocol. To run XMODEM, follow the instructions for transmitting ASCII files but include "=x" after the filename("=c" is equivalent for transmit). The XMODEM module is automatically started and the transfer proceeds without further intervention. The transfer is started in checksum mode, the receiver has the option of switching to CRC mode. To cancel the transfer while it is progress, type CTRL-X. This may require a few seconds to take effect because PC-VT must gracefully terminate the protocol. Copyright 1984 Mark C. DiVecchio Page 29 Transmitting and Receiving Files PC-VT Refer to already published texts for details on the XMODEM protocol. 7.3 Receiving ASCII Files (Downloading) To receive an ASCII file, PC-VT must be told to start receiving and then the host must be told to transmit it. To activate Receive File, type CTRL-F3. This can be done at any time in the communications display. PC-VT will ask for the filename on which to write the received characters. Just typing ENTER terminates the receive request. If the file already exists, PC-VT will ask if you wish to overwrite it. If you type "y" followed by ENTER, PC-VT deletes the old file and starts to create another. Once Receive File (or downloading) is activated, and a Line Feed character is received, ALL further characters received from the host except 00H and 7FH are written onto the disk file. You can now tell the host to type out a file and PC-VT will write it onto the IBM PC disk. To VMS, type: Type (PC-VT does not write out data to disk until a Line Feed is received in order to permit you to enter the "Type" command. This prevents the "Type" command from being written to the file.) When you wish to terminate Receive File, simply type CTRL-F3 again. PC-VT closes the disk file and resumes normal mode. Note that since PC-VT cannot tell the difference between a file and any other characters sent by the host, all characters (except as noted - 00H and 7FH) received go onto the disk file. This includes ESCAPE sequences and all VMS command language interaction. This can be a useful feature if you are programming with some of these sequences and your program is not working correctly. PC-VT preserves these characters on disk for your inspection. Once the file is closed, you will have to exit from PC-VT and enter a text editor to strip off any unwanted characters from the file. PC-VT puts an End of File indicator at the end of the disk file before it closes the file. For the IBM PC this is a CTRL-Z character, ASCII code 26. As a reminder, "RCV" is displayed on line 25 while Receive File is active. Page 30 Copyright 1984 Mark C. DiVecchio PC-VT Transmitting and Receiving Files The receipt of a CTRL-Z character will terminate Receive File and close the received file. If you type CTRL-BREAK to terminate PC-VT, the received file is closed as if a CTRL-Z character was received. Receive File terminates if it runs out of disk space for the downloaded file. The last block (up to 512 characters) received is lost and no CTRL-Z - End of File indicator is written. The file, however, is closed. There are several messages generated by PC-VT while receiving a file: "Current default directory is >": The current default directory is displayed. For DOS 1.1 users, this is just the default drive. "Drive d: xxxxxx bytes free": The number of free bytes on the default drive is displayed. This is displayed only if you are using DOS 2.0 or later. "Enter Name of the PC File to Receive [d:][path][filename[.ext]][={x,c}] (Hit ENTER to cancel download and return to emulator):": PC-VT is asking for the name of the PC file to receive. Type the filename in the standard PC-DOS format and hit ENTER. Typing just ENTER cancels the receiving routine. If your DOS supports path names, they can be used here. If you do not specify a drive or path, PC-VT will access the default directory. The default directory can be changed with the CTRL-F2 command. See the last section in this chapter for details. "Filename is not in correct format": The filename entered in response to the filename inquiry is not in the standard PC-DOS format. You may reenter the filename. "Insert diskette with received file. Hit ENTER to continue....": PC-VT found a different diskette in the disk drive than the one it opened the download file on. Replace the original diskette in the drive and hit the ENTER key. "File already exists. Do you want to overwrite it? (y or n)": The filename which you entered already exists. If you respond with a lower or upper case "Y" followed by the ENTER key, PC-VT will delete the Copyright 1984 Mark C. DiVecchio Page 31 Transmitting and Receiving Files PC-VT file and create a new one with the same name. Any other response, preserves the file and receive file is cancelled. "File is being overwritten": PC-VT confirms that the old file has been deleted and a new file is being created. "Not enough directory space. Receive terminated": PC-VT could not create the file because the directory on the specified diskette was full ,the file was marked read-only, or the path specified is invalid. "Disk full. Receive terminated": PC-VT ran out of space on the disk. The file already written is closed. A CTRL-Z is not placed at the end of the file. The last block (up to 512 characters) received is lost. 7.3.1 Example of a receive session This is typical of what you would see and type to receive a file from the host. Comments are quoted. $ "hit the CTRL-F3 key" Current default directory is >a: Drive a: 32234 bytes free Enter Name of the PC File to Receive [d:][path][filename[.ext]][={x,c}] (Hit ENTER to cancel download and return to emulator) b:receive.txt "RCV is displayed on line 25 and any characters sent by the host are copied to the PC disk file." type host.dat "The host file named host.dat is received by PC-VT and placed on the PC disk file named b:receive.txt." $ "hit the CTRL-F3 key" "The file is closed and RCV is cleared from line 25." 7.3.2 A Useful VAX .COM Download file This simplified Download facility will download a file from a VAX system running VMS to a PC disk file. Create a file on the VAX system named "pcdown.com" consisting of the following commands: Page 32 Copyright 1984 Mark C. DiVecchio PC-VT Transmitting and Receiving Files $ on error then goto err2 $ on control_y then goto ctrl $ if p1.eqs."" then - inquire p1 "Enter Name of VAX File to Download " $ if p1 .eqs. "" then goto ctrl $ open for008 'p1'/error=err1 $ close for008 $ set term/nobroad $ write sys$output "[?21h" $ copy 'p1' tt: $ write sys$output "^Z" $ exit: $ set term/broad $ exit $ err1: $ write sys$output "VAX File Not Found." $ ctrl: $ write sys$output "Download Canceled." $ goto exit $ err2: $ write sys$output "A VAX error has occured, Please try again." $ goto ctrl The symbol is the ESCAPE character 27. The symbol ^Z is the CTRL-Z character 26. Once you have started PC-VT on the PC and you have logged onto a VAX, download files from the VAX to the PC by: 1. type this in response to the "$" VMS prompt: @pcdown 2. If you did not enter the filename on the command line, the facility will ask you for the name of the VAX file which you wish to download (include directory information if needed) for example : [upload]xmit.com If you just enter carriage return, the download is canceled. 3. the facility will ask you for the name of the PC file which you wish to create with the downloaded data (include disk drive letter if needed) for example : a:pcfile.dat If you just hit carriage return, the download is canceled. If the name which you give for the PC file already exists, PC-VT ask if you want to overwrite the file. If you answer "y", all the new data will replace the old data on the PC file. If you answer "n" or just hit carriage return, the download is canceled. 4. the rest is automatic. The data will display on the Copyright 1984 Mark C. DiVecchio Page 33 Transmitting and Receiving Files PC-VT PC's CRT while it is being downloaded. The download is complete when the "$" VMS prompt appears. 5. To abort the download before it is complete, type: CTRL-F3 The PC file will contain whatever data was downloaded to the point where you aborted the download. You may see some extra output on the CRT screen, this is just the communications buffer emptying. 7.4 Receiving Binary Files (Downloading) PC-VT supports the XMODEM protocol for binary or ASCII file transfer. Support is included for both checksum error checking compatible with PC-TALKIII and for Cyclic Redundancy Code(CRC) error checking. This transfer method requires that the host computer be capable of handling this protocol. To run XMODEM, follow the instructions for receiving ASCII files but include "=x" after the filename for checksum mode or "=c" for CRC mode. The XMODEM module is automatically started and the transfer proceeds without further intervention. Since PC-VT is the receiver, you have the option of selecting the error checking mode. Checksum mode will detect all burst errors of less than 8 bits in length and 99.6% of all burst errors longer than 8 bits. CRC mode will detect all single and double bit errors, all errors with an odd number of bits, all burst errors of length 16 or less and 99.997% of all 17 bit and longer bursts. The CRC supported is the CCITT reccommended x^16 + x^12 + x^5 + 1. To cancel the transfer while it is progress, type CTRL-X. This may require a few seconds to take effect because PC-VT must gracefully terminate the protocol. PC-VT does not delete the partial file already created on disk but closes it and leaves it for you to examine and delete. Refer to already published texts for details on the XMODEM protocol. Page 34 Copyright 1984 Mark C. DiVecchio PC-VT Transmitting and Receiving Files 7.5 Changing the Default Directory For users of PC-DOS version 2.0 or later, PC-VT supports path names. PC-VT will access the default drive and path unless you explicitly enter them. You can change the default values by typing CTRL-F2 from the communications display. PC-VT will display the current default, ask for the new default, and then display the complete new default path. The input to this command follows the syntax for the CHDIR command to DOS. The amount of free space on the default drive is also displayed. Here is what you would see and type: Current default directory is >c:\level1 Drive c: 34543 bytes free Enter new default directory [[d:][\][dirname][\dirname[...]]] >level2 ;here you type the change Default directory is now >c:\level1\level2 Drive c: 34543 bytes free When you type in the new directory, you can enter the change just as you would enter a change to the CHDIR command: - a drive letter followed by a ":" will change the drive only (since DOS remembers the path associated with each disk drive, the default directory will be set to whatever path had been active on the specified drive) - b: - a path name starting at the root - a:\mydir\nextdir - the root - a:\ - a directory name starting at the current directory - nextdir The only word of caution is that the PARAMS.DAT and DIALER.DAT files ALWAYS access the current default directory. If you change the default and then update either of these files, they will be rewritten to the new default directory. The versions on the default directory when PC-VT was started are not changed. If the path is illegal or not found, an error message is displayed. Copyright 1984 Mark C. DiVecchio Page 35 DIALING Display PC-VT Chapter 8 DIALING Display The DIALING display is accessed by typing CTRL-F9 from the communications display. If you have a Color/Graphics card, the content of the communications display is preserved and is restored when you exit DIALING. If you have a Monochrome card, the communications display is cleared when you exit DIALING. 8.1 Instructions for DIALING The DIALING display is used to handle Hayes or Hayes compatible modems. The display can hold 10 names and phone numbers. Each entry is broken into two fields. A name can be typed in columns 1 to 20. This is for your information only. PC-VT does not use this information but it is stored on the diskette file. The dialing commands and phone number can be stored in columns 21 to 70. The "!" above column 21 is to remind you that, when dialing, PC-VT sends the data in columns 21 thru 70 to the modem as the dialing command. When PC-VT starts up, it looks for a Dialing Directory on the default drive. If it does not find one, PC-VT creates a blank directory. The name field is filled with dashes. The command field contains "ATDT" in the first four columns and is then filled with blanks. The first thing that you need to do is enter the name of the number's owner. You can use the cursor keys, the Enter key, the Tab key, the Home key and the End key to position the cursor to any line. Then "Ins" key will insert a space at the cursor position and the "Del" key will delete a character at the cursor position. Move the cursor to column 1 and type in the name. It should not go past column 20. Then to enter the phone number, move the cursor to column 24 using the TAB key and type in the number. The new directory can be saved by hitting the F4 key. The number can be dialed by hitting the F1 key. Page 36 Copyright 1984 Mark C. DiVecchio PC-VT DIALING Display Here is how each of cursor control keys function in this display: - Left arrow - moves the cursor one column to the left. If the cursor is already in column 1, the speaker beeps and no action is taken. - Right arrow - moves the cursor one column to the right. If the cursor is already in column 70, the speaker beeps and no action is taken. - Up arrow - moves the cursor up one row. If the cursor is already in the top row of the directory, the speaker beeps and no action is taken. - Down arrow - moves the cursor down one row. If the cursor is already in the bottom row of the directory, the speaker beeps and no action is taken. - Home - moves the cursor to column 1 of the top row of the directory. - End - moves the cursor to column 1 of the bottom row of the directory. - Enter - moves the cursor to column 1 of the next row of the directory. If the cursor is already in the bottom row of the directory, the cursor is moved to column 1 of that row and the speaker beeps. - Tab - moves the cursor to column 24 of the current row. - Ins - inserts a blank at the cursor position. This key operates within either the name field (columns 1 thru 20) or the number field (columns 21 thru 70). All characters from the cursor to right of the field are moved one column to the right. Anything in the rightmost column of the field is lost. If you Ins within the name field, the number field is not affected. - Del - deletes a character at the cursor position. This key operates within either the name field (columns 1 thru 20) or the number field (columns 21 thru 70). All characters from the right of the cursor to the rightmost column of the field are moved one column to the left. A blank is inserted into the rightmost column of the field. If you Del within the name field, the number field is not affected. Special notes on the directory: You have complete control over the entire directory from columns 1 to 70. You can type over the "ATDT" command and you can type any special modem commands like "," or ";". You can enter any key except the cursor control keys Copyright 1984 Mark C. DiVecchio Page 37 DIALING Display PC-VT listed above (including the Backspace key) into the line. PC-VT filters out blanks and dashes from the number field when it sends the number to the Modem. Therefore you can use blanks and dashes for readability. You can change the "ATDT" to any other modem command. For example, you can change the last line to "ATM2;" and when you move the cursor to that line and hit F1, the Modem will be commanded to turn on the speaker at all times. Just remember that PC-VT will send any non-blank, non-dash character in columns 21 to 70 to the Modem when you hit the F1 key. Here are some possible entries: ! Mark C DiVecchio----ATDT,,555-1212 The computer--------ATDT 1 - 506 - 555 - 1234,,,,,222* 432# Speaker on----------ATM2; Here are the functions available in DIALING : Exit DIALING : The CTRL-F9 key combination returns PC-VT to the communications display. Dial : The "F1" key dials the number in the line pointed to by the cursor. PC-VT then returns to the communications display. Read Directory : The "F3" key clears the displayed dialing directory and reloads it from the disk file, DIALER.DAT, on the default drive. PC-VT remains in the DIALING display. Store Directory : The "F4" key stores the displayed dialing directory into a disk file on the PC-DOS default drive. The name of the file is DIALER.DAT. A message will appear at the bottom of the display to indicate that the new directory is written to diskette. Hang up : The "F5" key sends the commands to the MODEM to hang up the phone. This procedure takes about 2-3 seconds due to the MODEM protocol. A message will appear at the bottom of the display to indicate that the line is hung up. Page 38 Copyright 1984 Mark C. DiVecchio PC-VT PC-VT Status Line Chapter 9 PC-VT Status Line PC-VT uses line 25 of the monitor as a status line when in the communications display. The VT10x only requires 24 lines for proper operation. The meaning of each of the fields displayed is summarized in this chapter. ON LINE PC-VT is actively monitoring the comm port. It is on line to a host only if you have established the connection. LOCAL PC-VT is performing some local function and data received on the comm port will not be display. The data will not be lost but will be buffered and then displayed when PC-VT returns to ON LINE mode. Note that on the PCjr this may not be true. If the PCjr is doing a diskette operation, all other interrupts are masked off. If data is received on the comm line, it will be lost. Vx.x The version number of PC-VT. Please include this number if you write to the author. KBD LOCKED The host computer has locked the keyboard. The host is also responsible for unlocking the keyboard. CAP The Caps Lock key has been depressed on the keyboard. NUM The Num Lock key has been depressed on the keyboard. SCR The Scroll Lock key has been depressed on the keyboard. This key functions as the NO SCROLL key on the VT10x. "alpha" The Greek letter "alpha" is displayed to indicate that PC-VT is in applications keypad mode. This permits the PC's function and keypad keys to transmit special codes. See chapter 5. Copyright 1984 Mark C. DiVecchio Page 39 PC-VT Status Line PC-VT X The letter 'X' indicates that the host's buffer has filled up and that the host will not accept any more characters from the PC. This will clear automatically when the host's buffer has emptied. See the definition of the alt-x key for more details. HH:MM:SS The time of day is displayed. This can be turned off by setting a bit in the SETUP B display. DSR This indicates that the MODEM has raised its Data Set Ready line. This can be turned off by setting a bit in the SETUP B display. CTS This indicates that the MODEM has raised its Clear To Send line. Some MODEMs maintain this line high at all times. There is usually a switch on the MODEM which will cause this line to function normally. Note that PC-VT does not really care. It displays this only for information. CD This indicates that the MODEM has raised its Carrier Detect line. Some MODEMs maintain this line high at all times. There is usually a switch on the MODEM which will cause this line to function normally. Note that PC-VT does not really care. It displays this only for information. L1L2L3L4 These represent the LED's on the VT10x. All four are used on the VT100, only L1 is used on the VT102, and none are used on the VT52. Page 40 Copyright 1984 Mark C. DiVecchio PC-VT PC-VT Status Line Appendix A User-Supported Software Permission to copy: Clubs and other non-profit organizations are granted permission by the author to freely copy this program and documentation and share it with their members, so long as: - No price is charged for the software or documentation. However, a distribution cost may be charged for the cost of the diskette, so long as it is not more than $6 total. - Club members are informed of the user-supported concept and encouraged to support it with their donations. - The program or documentation are not modified in any way and are always distributed together. The User-Supported concept. User-Supported Software If you are using this program and find it to be of value your contribution will be appreciated. ($35 is suggested) Mark C. DiVecchio 9067 Hillery Drive San Diego, CA 92126 Regardless of whether you make a contribution, you are encouraged to use, copy and share this program. User-supported software is an experiment in distributing computer programs, based on these beliefs: - That the value and utility of software is best assessed by the user on his/her own system. - That the creation of personal computer software can and should be supported by the computing community. Copyright 1984 Mark C. DiVecchio Page 41 PC-VT Status Line PC-VT - That copying of programs should be encouraged, rather than restricted. Anyone may request a copy of a user-supported program by sending a blank double sided double density, formatted disk to the author of the program. An addressed, postage-paid return mailer must accompany the disk (no exceptions, please). A copy of the program, with documentation on the disk, will be sent by return mail. The program will carry a notice suggesting a contribution to the program's author. Making a contribution is completely voluntary on the part of each user. Free distribution of software and voluntary payment for its use eliminates costs for advertising and copy protection schemes. Users obtain quality software at reduced cost. They can try it out before buying, and do so at their own pace and in the comfort of their own home or office. The best programs will survive, based purely on their quality and usefulness. Please join the experiment. If you believe in these ideals, your contribution is solicited to help make them work. The following invoice is provided for those of you who wish an invoice for your tax records. Perhaps it will serve the purpose. Page 42 Copyright 1984 Mark C. DiVecchio PC-VT PC-VT Status Line -------------------- INVOICE -------------------- Purchased from: Mark C. DiVecchio 9067 Hillery Drive San Diego, CA 92126 DATE: / / Invoice No. 101 -------------------------------------------------------------- PRICE PRICE PRODUCT QTY EACH EXTENDED ------------------------- --- ----- -------- PC-VT Terminal Emulator and Condensed Manual 1 $35 $35 PC-VT Distribution Disk $9 PC-VT Complete Printed $10 Documentation Copy of PC-VT and Documentation on your Preformatted DSDD Diskette Returned in your Postage Paid Mailer N/C -------------------------------------- SUBTOTAL Sales Tax (CA Residents only) -------------------------------------- PLEASE PAY THIS AMOUNT TOTAL ----------------------------------------------------------- Please make check payable to :Mark C. DiVecchio You may retain this Invoice for your tax records. Copyright 1984 Mark C. DiVecchio Page 43 PC-VT Status Line PC-VT Page 44 Copyright 1984 Mark C. DiVecchio PC-VT Index 8 Bit ASCII 24 Application Keypad mode 11 Autorepeat 20 Beep 6 BREAK 15 CAPS LOCK 14 Changing the default directory 35 Clearing all Tabs 17 COM Port Selection 18, 23 Communications Display 8 Default directory, changing 14 Dialing Directory Fetching 38 Dialing Directory Saving 38 Dialing Facility 15 DIALING key 36 EDT Editor 12 Feature Defaults 20 Feature Saving 17 Hanging up the phone 38 NO SCROLL 14 NUL Character Key 14 NUM LOCK 12, 14 Parity Checking 22 Printer Echo 15 Printing the Screen 14 Receiving (Downloading) Files 14 Restart 15 SCROLL LOCK 14 Selecting Autowrap 21 Selecting Cursor Mode 20 Selecting Defaults 17 Selecting Features 18 Selecting Local Echo 22 Selecting Modem Parameters 19 Selecting Modem Speed 18 Selecting Screen Background 20 Selecting Stop Bits 22 Selecting Tab Defaults 17 Setting and Clearing Tabs 16 Setting Answerback Message 19 SETUP 14 SETUP key 16 Status Line 5, 8, 14, 21, 39 Terminating PC-VT 10, 15 Time of Day 24 Transmitting (Uploading) Files 14 PC-VT UK Character Set 21 Using the IBM fixed disk 9 VT BACKSPACE Key 14 VT CURSOR keys 11 VT DELETE key 11 VT FUNCTION keys 11 VT LINEFEED Key 14 VT100/VT102 Selection 23 VT52 Selection 21 XMODEM 29, 34 PC-VT Table of Contents Chapter 1 Introduction 4 Chapter 2 Required Hardware and Software 7 Chapter 3 Starting PC-VT 8 Chapter 4 Stopping PC-VT 10 Chapter 5 Keyboard assignments 11 Chapter 6 SETUP Displays 16 6.1 SETUP A 16 6.2 SETUP B 17 6.2.1 SETUP B Features and Defaults 20 Chapter 7 Transmitting and Receiving Files 25 7.1 Transmitting ASCII Files (Uploading) 25 7.1.1 Example of a transmission session 27 7.1.2 A Useful VAX .COM Upload file 28 7.2 Transmitting Binary Files (Uploading) 29 7.3 Receiving ASCII Files (Downloading) 30 7.3.1 Example of a receive session 32 7.3.2 A Useful VAX .COM Download file 32 7.4 Receiving Binary Files (Downloading) 34 7.5 Changing the Default Directory 35 Chapter 8 DIALING Display 36 8.1 Instructions for DIALING 36 Chapter 9 PC-VT Status Line 39 Appendix A User-Supported Software 41