Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 181 ALT-N The NUKE key exits from the term function with a message and cancels any scripts or functions that may have been executing. ALT-1 Prompts for a DOS command, then executes that command as a subroutine. EXAMPLE: ALT-1 whereis *.lst ALT-2 Prompts for a ZCOMM command, then executes that command. A particularly useful command is "create file" which creates a capture file without having to return to the main command prompt. Care should be exercised not to force excessive recursion by issuing a command (such as t or f) which would invoke the term function recursively. EXAMPLE: ALT-2 create capture.fil EXAMPLE: ALT-2 display vt100 ALT-E Resets the elapsed time indication to zero. ALT-F Full Duplex resets local echo of keyboarded characters. ALT-H Toggles Half duplex in the sequence 0 (full duplex), 1 (local echo), and 2 (local echo CR as CR LF). SEE ALSO: h numeric parameter ALT-I Three way toggle of i and I (Image) mode. When toggling to I (super image) mode, ZCOMM's display emulation is set to dumb to disable all escape sequences, most importantly those that do strange things when used in the wrong context. When toggling out of I mode, dumb terminal emulation is turned off. ALT-J Toggles j (Jabberwrite) mode (q.v.).* ALT-K Displays the contents of the soft keys. ALT-L Ctrl-PrtSc Toggles the line printer on flag. If the printer is being turned on, printing commences with the next character received from the remote. ALT-M Toggles keyboard mapping. SEE ALSO: display mapkb command ALT-O Toggles the Overstrike display mode, and restores the normal CRT attribute. (C) 1990 Omen Tech Inc Chapter 22 Term Function Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 182 ALT-P Toggles the parity the term function uses between 8 bits no parity, 8 bits graphics, 7 bits plus even parity, 7 bits plus odd parity, 7 bits marking parity (8th bit set), and 7 bits spacing parity (8 bit reset). ALT-V Four way toggles v mode between normal, show control characters as ^C, denote characters with parity bit (in addition to the above) set by prepending a tilde (~), and display all characters in hex.* 22.3 Control Characters The following characters are recognized by the term function when they are received from the remote. ENQ, DLE If c or C (Compuserve) mode and v mode is not in effect, engage the Compuserve B+ Protocol. This protocol is used with the FILTRN program and the SIG/ACCESS DOW and UPL commands. See Compuserve's CP-MIG user group documentation for more information. Iff enabled, these codes are acted upon when drained from the interrupt input buffer and are not passed to the circular buffer. The following received characters are recognized by the term function, regardless of parity, when they are fetched from the circular buffer for the display. Modem Error Detected modem errors (parity error, framing error, break, overrun) are counted in the e numeric parameter. The E numeric parameter may be used to represent modem errors as specific, searchable characters. A detected overrun is displayed as a large fuzzy rectangle (hex B2). ETX EOT Ctrl-Z When receiving a message with the TWX protocol (in Host Operation) these control characters will terminate the message. ENQ Iff q (TWX) mode or VT100 emulation ("display vt") is in effect, transmit the answerback string parameter to the remote. This is equivalent to HEREIS on a Teletype(TM) machine. BELL Generates a tone in the speaker unless visual bell display is enabled ("display bell=visual"). If the display has fallen behind the incoming data, ZCOMM suppresses the bell due to the relatively long time required to perform a bell ring. If a file is being transmitted with the term function, a bell character will pause transmission for a short time. (Some computers send bell characters to indicate their input buffers are becoming overloaded.) FF If c mode is enabled, erase the screen. XOFF Suspends file transmission from ZCOMM. XOFF is excluded from pattern searches and does not display unless v mode is set. After a (C) 1990 Omen Tech Inc Chapter 22 Term Function Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 183 timeout determined by the Kermit s numeric parameter (default 60 seconds), transmission will resume even if no XON character is received.[3] XON Resumes file transmission from ZCOMM. XON is excluded from pattern searches and does not display unless v mode is set. NULL, Rubout (Hex 7F) and NULL (0) are not displayed unless ZCOMM is in i (image) or v mode. They are excluded from pattern searches. 22.4 Buffer Writing If e (Emacs) mode is set, a buffer dump is performed before each keyboarded character is sent to the remote, since normal XOFF based flow control is assumed to be disabled. When the free space in the circular buffer is nearly exhausted, ZCOMM sends an XOFF character to the remote[4] and writes the buffer contents to the receive file[5] (if any). The circular buffer is also written to the receive file as a result of a "w" command, ALT-W key, or once per second if j mode is in effect. When the circular buffer is written to a receive file, several control characters are treated specially if i (image) mode is not set. Iff s mode is set, all control characters, except for those listed below, are excluded from the received file. NULL ACK BELL XON XOFF RUBOUT ESC These characters are excluded from the file. Most "escape sequences" are also filtered form the cpature file. NULL, DELETE, XON, and XOFF are excluded from pattern searches. ETX, EOT These characters close the file if q mode is in effect, as when ZCOMM is receiving a message in host state using TWX protocol. Ctrl-Z (CPMEOF) Iff z mode is enabled, close the file. Otherwise this character is discarded. LF Iff n (nlmode) mode is on, a CR is written to the file before the LF. Linefeed is always passed to the file. __________ 3. There is no timeout if the parameter is 0. 4. Assuming e mode is not in effect. 5. An XON is sent to the remote after this automatic buffer write operation. (C) 1990 Omen Tech Inc Chapter 22 Term Function Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 184 CR Iff a mode is in effect, a CR LF sequence is written to the file. Otherwise, if s mode is on, CR is only written to the file as a response to an LF in the circular buffer. BS Backspace is written to the file unless s mode is in effect, in which case it, and the last character written in the disk file, are deleted by backspacing the file write pointer. This simulates the function of backspace on common CRT terminals. NOTE: This backspacing of the file write pointer operates the same as Teco and Emacs editors; it does not stop at the beginning of the line. Backspacing over tab characters is tricky because it may take several backspaces to eliminate the spaces corresponding to one tab character, but only one is needed to eliminate the tab character in the output file. HT, FF These characters are always passed to the file, even if s mode is in effect. If ss mode is in effect, FF is not passed to the file. 22.5 Real Time Status Line A real time status line is displayed when DOS and OS/2 ZCOMM are in the term function. The left part of this status line is also displayed when ZCOMM is in Host Operation awaiting a call. The first character position shows a blinking W if the circular buffer is being written to disk. Otherwise, the first character position shows an L if the keyboard has been locked by a kbdlock command, or C if the Caps Lock key is activated. The second position shows an X if hardware handshaking is enabled and Clear to Send (CTS) is not received from the modem, or if an XOFF character has been received (software handshake). This also happens when a file upload is using the p mode with GOchar = 17 (17 is decimal for XON) and ZCOMM has stopped at the end of a line. Otherwise, an M is shown to indicate Keypad Mapped operation for terminal emulation. Otherwise, an N appears if the Num Lock key is activated and the K numeric parameter is 0 (84 key keyboard). SEE ALSO: handshake command, Terminal Emulation, Chapter 29. The third position displays the real time status of the following five conditions. If more than one of the conditions is active at once, the displayed character will represent the condition listed first. X if the buffer has nearly filled up and ZCOMM has sent an XOFF to suspend data transmission from the remote. E when ZCOMM has sent an XOFF to suspend data transmission for Error Containment(TM). (C) 1990 Omen Tech Inc Chapter 22 Term Function Status Line Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 185 S if the term function is searching for one or more strings (defined by the pattern command). W if term is waiting for a character echo before resuming transmission. w if term is waiting for a fixed time before sending the next character or returning from a putw or wait command. The display column and row numbers are displayed next with the home position equivalent to 1, 1. DOS's idea of the time of day is next. The minutes of elapsed time follow the time of day, modulo 24 hours (1440 minutes). The elapsed time is reset by the ALT-E function key, restime command, and telephone number autodial. If carrier detect is absent, an L( Local) appears after the elapsed time. The X.PC version will display c, p, or L in this position depending on whether ZCOMM is in character state, packet state, or Local (no carrier detect). The number of free characters in the Circular Buffer appears next. A user programmed message may be displayed in right side of the status line with the statliner string parameter. Otherwise, the right side of the status line shows the communications port,[6] transmission speed ("baud rate") and the parity. The next field represents the modes that are enabled. If the b, n, p, r, or w mode is set, that letter shows. If p mode is set with with GOchar equal to XON (decimal 17), a P is shown. The v mode causes the view indicator to show ^ if control characters are being displayed in the style ^C where C is the alphabetic character corresponding to the control character. The indicator shows ~ if characters with the 8th bit set are being displayed with a leading ~. Setting the a, c, e, h, i, j, l, q, s, t, u, x, and z modes causes the corresponding letter to be displayed. The c, h, and s modes are displayed in upper case if their value is greater than 1. ON HOOK is displayed if the computer has disabled DTR (Data Terminal Ready). The speed command should be used to assert DTR and allow the modem to go off hook (connect to line), e.g., "speed 1200". __________ 6. Virtual channel number for X.PC (C) 1990 Omen Tech Inc Chapter 22 Term Function Status Line Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 186 If a transmit file is open, a < followed by the transmit file name is shown. If the file upload has been stopped by a grab command, Stopped(grab) is diplayed. If a receive capture file is open, a > followed by the file name is shown. EXAMPLE: LX 01 24 23:57 ET 0:46 L 31424 1:1200 8n p^t ), and the PC's keyboard Num-Lock state. 0 causes ZCOMM to set the PC's keyboard Num_Lock state to match Numeric Keypad mode when DECKPNM or DECKPAM is received. 32 causes ZCOMM to set the PC's keyboard Num_Lock state to the opposite of Numeric Keypad mode when DECKPNM or DECKPAM is received. 1 causes ZCOMM to set the PC's keyboard Num_Lock on in response to either DECKPNM or DECKPAM. 2 causes ZCOMM to set the PC's keyboard Num_Lock off in response to either DECKPNM or DECKPAM. SEE ALSO: display, mk and ALT-M commands O Controls OverThruster(TM) operation with XMODEM, XMODEM-1k, YMODEM, and YMODEM-1k downloads. This parameter should be set as follows: (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 195 CompuServe XMODEM This OverThruster mode is known to be effective on CompuServe. Negative numbers control the number of bytes added to the window on XMODEM downloads from the network. Larger numbers increase throughput, but cause improperly interfaced MNP modems and network nodes to drop characters under stress, disrupting the file transfer. EXAMPLE: pO-512; ro file1.ext Other XMODEM Positive numbers up to a system dependent value less than the protocol block size increase throughput. Larger values induce timeouts and/or retransmitted blocks. The optimum value must be determined by experiment. If you see the message: Retry 0: Received dup Sector very often, the value should be reduced. 60 usually give best results with MNP modems at 2400 bps. The optimum value varies depending on the remote computer, modem(s), system traffic, and the network node. EXAMPLE: pO60; ro file1.ext R If non zero, remove incomplete files received with a protocol except those received with the + option (default 0). S Timeout interval in seconds waiting for XON characters or positive flow control (default 15). If an XON is not received within this time, transmission resumes anyway. A value of 0 disables this timeout. T If Command Reentry has been enabled with the history command, the T parameter prevents commands with fewer than T characters from being stored in the history file. Excluding short and easy to type commands from the history file makes it easier to find the commands that are difficult to keyboard. Setting T to a large number disables the storage of commands and strings. This may be used to exclude passwords and other sensitive information from the history file. SEE ALSO: history command V VIDEO BIOS display mode to switch the display to 132 columns in response to a VT-100 DECCOLM mode set command. To support boards using an extended code in the bl register, calculate N = bl + (256 * al). A popular value is 35 for the Tseng, ATI, and other extended EGA boards. The Genoa Super EGA Hi-Res likes 96. The Everex EVGA uses 28684. The default value of 0 inhibits this function. (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 196 W This numeric parameter supports Video7 and similar boards which require a non 0 value in the AH register on INT 10h bios calls for setting video modes (e.g., 132 columns). The value of the W numeric parameter (default 0) is placed in the AH register when attempting to switch video modes. X On Unix flavors, preset to +1 if the XTERM environment variable contains xterm, preset to -1 if the variable contains the string 401 indicating a Tektronix storage tube graphics terminal, otherwise remains at 0. Positive values allow the term function to use the X Windows xterm status line. Negative values inhibit status line updates while Tek graphics are active. Z Hot zone column used for keyboard entry with the message and privatecommands. A space character keyboarded within the hot zone finishes the line. a The a parameter calibrates certain XMODEM and YMODEM protocol timeouts. The default value is set during initialization to an appropriate value for an IBM Personal Computer, PC-jr, DG/One, or 8mHz PC-AT (2000 for 4.77 mHz PC, 4000 for a PS2/30, 6000 for an 8 mHz AT, 12000 for a PS2/80). If ZCOMM is run on a non standard machine, accelerator, or under a time slicing operating environment such as TopView, these timeouts may be recalibrated with the a numeric parameter. Larger numbers give longer timeouts. This parameter should then be set with a pa# command in the telephone directory setup entry. The value for this parameter will change if ZCOMM is used with a different computer type or multitasking operating system. b Sets the video color for the screen border. The mapping of b parameter values to color is hardware dependent. New values of the b parameter take effect with the next screen clear. c The c parameter sets the callout interval in seconds between scans for outgoing messages. The default is 300 seconds (five minutes). EXAMPLE: pc600 sets the interval between callout queue scans to 10 minutes. SEE ALSO: Callout queue d A non zero value (the default) causes incoming files received with ZMODEM and full YMODEM Batch protocol to have their Date set to that sent in the file header. ZMODEM's file management features depend on the transmission of each file's modification date. Files between two copies of ZCOMM will have the same creation date, even if the two machines are in different time zones. When transferring files to/from a Unix system, creation dates are interpreted according to GMT or Universal Coordinated Time. File dating should (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 197 be enabled with a pd1 command in the telephone directory setup entry. SEE ALSO: z numeric parameter, ZONE environment variable NOTE: Backdating file creation times may confuse some backup programs. e Indicates the number of errors, failed file transfers and the number of characters received by the term function with parity error, framing error or overrun. EXAMPLE: if e>30 goto badline If the term function increments the error count to 0[2] (from a negative number), and E mode is set, the term function exits. This allows the script to regain control in the event of a noisy line. This condition is indicated by the e test condition being false (0). EXAMPLE: pe-20; ... wait; if !e goto badline This parameter is reset to 0 by the call command. SEE ALSO: E mode SEE ALSO: e test condition (if, while commands) Unless the q file transfer option is used, each file skipped as a result of ZMODEM selective transfer increments this parameter. f Fail time. Sets the default timeout in seconds for matching a pattern. This timeout is reset whenever a character is received from the remote. Timeout is suspended whenever a XOFF (DC3 or Control-S) is keyboarded, and resumed when XON (DC1 or Control-Q) is keyboarded. The f parameter value may be overridden for one command by the ftime mode. EXAMPLE: pf15 sets a default 15 second inactivity timeout for pattern searches. g Set the "gochar" (decimal). (See the ASCII/Decimal conversion table in Chapter 37). The g parameter is reset to its default __________ 2. Refer to E mode description for caveats. (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 198 (linefeed, 10) by the call command. (See documentation on the p mode.) Some remote systems accept uploads with a ? (decimal 63) prompt for each line. Optimum operation with such a system might call for pg63 pp1000 pt4 f -tp file1 The pg63 sets the goahead character to question mark. The pp1000 sets the timeout to a long delay (10 seconds). The pt4 sets the upload throttle to 40 milliseconds per characters, a speed which allows the remote to echo somewhat slowly (assuming no tabs). Finally, the command f -tp file sends file1 with Throttle and wait for Prompt at end of line. As a special case, if the "gochar" is set to 17 (called XON, DC1, or ^Q) before the p mode is set, file transmission is stopped until an XON is keyboarded or received from the remote. EXAMPLE: pg17; ena -p h Iff the h numeric parameter is set non zero, the h (Half Duplex) mode causes characters transmitted by the term function to be stored in the circular buffer as if they had been received from the remote. This allows the review function to display them. Since the echoed characters appear to have come from the remote, scripts may be affected, especially pattern searches. EXAMPLE: ph1; ena -h i Set the interval between retries to n seconds. EXAMPLE: pi4; call -200 busysys attack dials up to 201 times at 4 second intervals. SEE ALSO: call -n command j Sets the maximum connect time in seconds allowed restricted callers in host operation. The default value of 0 does not restrict connect time. EXAMPLE: pj300 disconnects restricted callers at the first command prompt after 5 minutes' connect time. k When receiving data from the remote at high speeds (9600 or faster), the display may fall behind data from the remote. Under these conditions, keyboarding an interrupt character (often Ctrl-C, (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 199 or Break) will immediately stop the output from the remote, but the display will continue to scroll for some time while the data in the circular buffer is displayed. If this is objectionable, the k parameter may be set to the remote's particular interrupt character (in decimal). This parameter also affects the link command. When this character is keyboarded, undisplayed data pending in the circular buffer is skipped over. (This data is still available to the review command. The call command resets this parameter to -1, disabling its function. EXAMPLE: Many DEC systems use ETX (Ctrl-C) to interrupt programs. Many Unix users also use ETX for interrupting programs. The command pk3 causes ZCOMM to skip buffered output from the remote. Unix users using the default interrupt character of RUBOUT may give the command pk127 l Selects LPTn for term function output when the l mode is set. In addition, adding 8 to the number allows terminal emulation escape codes to select "printer controller mode" iff the printer is ready at the time. Adding 16 to the number allows "printer controller mode" to be selected even if the printer is not ready at the time. Default is 1 (LPT1). EXAMPLE: pl2 selects LPT2. EXAMPLE: pl9 selects LPT1 and allows the remote application to enable "printer controller mode". m Causes file transmission with the f file command to pause when a character matching the decimal value is read from the file. That character is NOT transmitted. When the file uploading is paused, a keyboarded Ctrl-Q will resume transmission. The call command resets the m parameter to -1 (which matches nothing). EXAMPLE: pm12 Causes file uploading to pause on FormFeed (FF). n Set the normal display attribute. The default of 7 gives a normal white on black display. The numbers associated with the s, r, and n are stored in the attribute byte of each character position written in the corresponding mode. The bit configuration (color display) is: Blink R G B Intensity R G B with the leftmost the most significant. Users with color monitors often use 2 (green) to avoid color fringes caused by misconverged color monitors. NOTE: the actual writing color attribute is not changed until the next time the display is reset. Some attributes generate (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 200 unreadable displays. Other attributes generate text that can only be seen on some monitors. EXAMPLE: pn3 sets cyan; pn2 sets green. o Iff non zero, allows overlap of file writing and incoming data from the remote. This increases throughput when receiving files with B, Extended Quick B, XMODEM, and YMODEM Batch protocols. ZCOMM sets this to 1 on startup unless a PC-jr is detected. p Pause sets the echo wait period (in hundredths of seconds) used with the pattern command and the w and p modes. Larger numbers give longer pauses. The default works well with most micro based bulletin board systems. The p parameter is reset to its default of 70 (700 milliseconds approximately) by the call command. SEE ALSO: p mode q Sets the "gopause". When sending a file with a wait for "gochar" ( p mode), ZCOMM waits Gopause hundredths of seconds AFTER it receives the "gochar". The q parameter also controls the time delay after a normal pattern match or putw command. The q parameter is reset to its default of 70 (700 milliseconds approximately) by the call command. The default value allows time for immediate echoes to be displayed and for the Hayes SmartModem(TM) to respond to most commands. SEE ALSO: p mode r Set the attribute for "reverse video". EXAMPLE: pr97 sets "reverse video" to blue on yellow. Adding 1024 to this parameter forces ANSI SGR 7 to use this color. SEE ALSO: n numeric parameter s Set the attribute of the status line display (default 7, for white). A value of 8 (grey) may be chosen to prevent the status line display from distracting from the information being printed. The low intensity grey also minimizes phosphor burn. Some other possibilities are 2 for green, and 1 for blue (or underlined on the monochrome board). SEE ALSO: n numeric parameter t Sets the throttle speed (delay between characters in hundredths of seconds) used by the term function when uploading files with an f -t file command. Throttle controls the term function sending speed (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 201 only when t mode is enabled. The default value of 4 corresponds to about 20 characters per second. Larger numbers give slower transmission. The effective resolution of the t parameter is limited by the timekeeping resolution of the operating system; on PC-DOS the resolution is about 18 per second. A negative value (-1 to -32767) may be used to specify a software timing loop, with more negative values giving slower transmission. The speed effect of a negative t value depends on the processor speed and operating environment. The t parameter is reset to its default by the call command. SEE ALSO: t mode u Sets the video attribute used to represent underline. EXAMPLE: pu14 sets "underline" to yellow. Adding 1024 to this parameter forces ANSI SGR 3 or 4 to use this color. SEE ALSO: n numeric parameter v Sets the verbose level (default 0). A value less than zero inhibits some routine messages. A value og 1 or greater enables logging of files skipped by selective ZMODEM file transfers. A value greater then zero causes the set command to list all string parameters, including empty string parameters. The screen erase after data calls in host operation is disabled. Values greater than 1 display script commands as they are fetched from the script file.* Larger values give more detailed tracing information. A value of 50+ causes data read by the read command to be displayed and acted upon by the term function (when called) as if it had arrived from the remote. NOTE: A v parameter value greater than zero affects scripts that generate files with the > command. w Controls the block length used by the CompuServe B Protocol. A longer length increases throughput, but may overload some networks, resulting in excessive retransmissions or failed transfers. With the new Extended Quick-B protocol, the maximum block length is 1024 data bytes. A value of 0 (the default) allows the Compuserve computer to control the block length, up to 1024 with Extended Quick-B. A negative value controls the upload block length but still allows Compuserve to control the download block length (1024 with Extended Quick B). (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 202 Uploads to Compuserve using longer block lengths are especially sensitive to poor flow control, especially when error correcting modems (MNP, etc.) are used. If B protocol uploads fail or require excessive retransmissions, correct the flow control arrangements, disable the modem's error correction, or try a smaller upload block size. The data contents of successfully transferred file(s) are not affected by this parameter. x Sets the port number linked with the link command. SEE ALSO: link command, y numeric parameter y Sets the transmission speed used by the linked port. SEE ALSO: link command, x numeric parameter z Set the timeZone in minutes behind GMT (Greenwich Mean Time). EXAMPLE: pz300 sets timezone 300 minutes behind GMT for EST. EXAMPLE: pz480 sets timezone 480 minutes behind GMT for PST. SEE ALSO: d numeric parameter, ZONE environment variable _ The _ numeric parameter controls the action taken by ZCOMM when a fatal error (one that generates the "ZCOMM: Error..." message). Any non zero value causes DTR to be dropped (disconnect the modem). A value greater than 100 causes ZCOMM to exit to the operating system. The NUKE key does not invoke this processing. EXAMPLE: p_101 24.1 Kermit Numeric Parameters The Super-Kermit parameters control Kermit protocol transfers. They are set with the kermit px# command. Their current values may be displayed with a kermit p command. These parameters rarely need changing for most systems. They can be changed in case of difficulty with Kermit transfers, especially with mainframe programs or obscure microcomputer Kermit impelementations. Certain of these parameters require character values expressed in decimal. The ASCII code chart in Chapter 37 gives the decimal value of all ASCII characters. When transferring files with Kermit programs operating on IBM (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 203 mainframes with half duplex front ends, the kermit i parameter should be set to 1, and the kermit s parameter set to the longest response time expected, perhaps 45 seconds. EXAMPLE: kermit pi1; kermit ps45 SEE ALSO: Kermit protocol in Chapter 13 7 If non zero, force seven bit line transmission with eighth bit quoting Kermit transmission even if ZCOMM is otherwise using eight bits no parity. This parameter is reset by the call command. 8 If non zero, force 8 bit transparent Kermit transmission even if ZCOMM is otherwise using seven bit line transmission. Normally, the Kermit file transfer commands use 7 bit line transmission and attempt to negotiate 8th bit quoting if one of the 7 bit modes (7e, 7o, 7m, 7s) is used. This parameter is reset by the call command. a Incoming packet-start character, default 1 (SOH). A Outgoing packet-start character, default 1 (SOH). b Block check type requested: 1=1 byte checksum, 2=2 byte checksum, 3=3 byte CRC-16 (default). Selecting a type 1 checksum instead of type 3 will increase throughput by 2-4 percent[3] at the expense of weaker error checking. The probability of undetected errors when using Kermit in checksum mode instead of CRC-16 increases dramatically with noisy lines and longer packets. c Control prefix in incoming data, default 35 (pound sign). C Control prefix in outgoing data, default 35 (pound sign). d Delay in seconds before initial sending, default 0. e Incoming end of line character, default 13 (CR). E Outgoing end of line character, default 13 (CR). i Use IBM line turnaround, default 0 (don't use IBM line turnaround). The Kermit x numeric parameter sets the turnaround character. This may be necessary when communicating with IBM mainframes with half duplex front ends. __________ 3. for 96 byte packets (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 204 l Maximum outgoing packet length, default 1000, 1000 maximum. A value greater than 94 implies Kermit long packets. The receiving program may force shorter packets. L Maximum incoming packet length, default 1000, 1000 maximum. A value greater than 94 implies Kermit long packets. This sets a limit; the sending program may use shorter packets. p Sets the number of padding characters (default 0) to send before and after each transmitted packet. SEE ALSO: kermit y numeric parameter r If non zero, remove incomplete files received with a protocol except those received with the + option (default 0). s Timeout interval in seconds waiting for XON characters or positive flow control (default 15). If an XON is not received within this time, transmission resumes anyway. A value of 0 disables this timeout. t Override timeout interval in seconds for incoming packets. The default of 0 allows the other program to specifiy the timeout. T Timeout interval for outgoing packets, default 4 seconds. v Eighth bit quoting character, default 38 (ampersand). Sliding Window size in Kermit packets, 1 minimum, 31 maximum, 15 default. Setting w to zero disables the sliding window. x IBM turnaround character, default 17 (XON). y Pad character to send, default 0 (NUL). SEE ALSO: kermit p numeric parameter 24.2 X/Y/ZMODEM Numeric Parameters These parameters control XMODEM, YMODEM, and ZMODEM protocol transfers. They are set with the z px# command available with ZMODEM flavors of ZCOMM. EXAMPLE: z pl16384 Forces ZMODEM packet length of 16384 (default packet length is infinite). Their current values can be displayed with a z p command. These parameters rarely need changing in normal environments. b If non zero, ZMODEM sends a break when it is sending a file and receives a retransmission request. This mode of operation may be (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 205 used with high speed modems to clear unwanted characters from the modem's buffer during error recovery. Usually, the modem must be given a configuration command to set the proper action to take when receiving a break signal. B Sets the duration of the break signal in tenths of a second, default 2 (200 milliseconds). c Enables Cybernetic Data Recovery(TM) on XMODEM and YMODEM transfers. Setting this parameter to 0 accommodates programs with non standard XMODEM/YMODEM protocols and slightly quickens file transfers. The default value of 1 provides optimum reliability for XMODEM and YMODEM transfers with programs that meet the XMODEM/YMODEM spec. Setting this parameter to -1 disables the quick file compare provided by the r option. C Sets the number of times ZMODEM will attempt to send a command (as a result of a zcommand command) (default 11). d Sets a delay time in tenths of seconds that the sz command will wait for a ZMODEM packet in response to the rz string it sends to the remote before sending a ZMODEM packet. This facilitates automatic ZMODEM uploads to VMS, which interrupts programs with the Ctrl-X character. The call command resets this parameter to its default of 1. Higher values increase the startup time when the receiving ZMODEM program is started before the sender. e If non zero, escape all control characters. This allows ZMODEM transfers to operate over data PBX and other systems that freak out when they receive control characters. f Flow control mask, only used with Unix/Xenix systems. Setting this to 0 (the default) disables hardware (RTS/CTS) flow control for Xenix/Unix systems with broken hardware flow control. On Xenix/Unix systems where only CTS flow control works properly, set this to 8192 to allow CTS flow control only. If both RTS and CTS flow control work properly (rare!) you can use a value of -1 to enable both bits. F Sets the pause after each data subpacket sent with the sz command when the F option is used, or when failing flow control is detected. The default value of 1 causes a one tenth second delay. SEE ALSO: F option On some Unix operating systems the pause will be rounded up to the next second or two. l Normally, the ZMODEM "packet length" ("block length") is the file length. Setting this parameter non zero forces ZMODEM to close a frame and wait for an ACK after each # bytes (default 0). This makes ZMODEM behave like XMODEM, YMODEM, or JMODEM, which wait after each block/packet for an acknowledgement before going on to the next (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 206 block. The packet length may be adjusted to prevent buffer overflow in data PBX systems. The call command resets this parameter to 0. L (Default 0) If non zero, overrides the nominal length of data subpackets within each ZMODEM frame. A smaller value speeds error recovery on noisy lines, a large value (maximum 1024) reduces the overhead of CRC characters. The call command resets this parameter to 0. Please note that streaming ZMODEM has no direct equivalent to XMODEM/YMODEM/JMODEM block length unless the zmodem l parameter is set non zero. In the absence of errors, ZMODEM normally sends the entire file without pause. If somebody claims ZMODEM's 1024 byte subpacket length is slowing things down by more than one half per cent, he doesn't understand ZMODEM and should be ignored. n Sets the number of NULLS (default 0) sent before each ZDATA frame. Some buffered modems (Fastcomm) have a firmware bug which loses characters when changing the direction of transmission. This causes data frames to fail with a CRC or other error. ZMODEM n parameter values in the range of 100 to 150 have obviated this syndrome. P When set to 2 (the default), purge the transmit buffer and force a receiver response when a CR/LF sequence (indicating a PC-Pursuit DATA LOSS message) is detected. A value of 1 does not purge the transmit buffer. A value of 0 disables special processing of CR/LF sequences received by the sending ZMODEM. w If non 0, restrict the ZMODEM transmit window to the specified number of bytes. Setting this parameter to N requests acknowledgements from the receiver every N/4 characters. ZCOMM then waits for acknowledgements from the receiver whenever it has sent N more characters than it has received acknowledgements for. This parameter is useful with networks with defective flow control, and with networks that store an excessive number of characters in transit. The call command resets this parameter to 0. W Adjusts the number of characters the ZMODEM receiver will silently ignore when searching for the beginning of a new frame. This may be set larger to accomodate networks with excessive in transit storage, smaller to speed error recovery from long error bursts on direct connections. The call command resets this parameter to the default (1400). Z Number of minutes (default 0) to adjust the file modification date when using the Telink or Clink/SEAlink file transfer protocol to transfer a file between different time zones. The timeout parameters below may be set lower for faster X/YMODEM error recovery when transferring files between two micros, higher to accomodate extremely sluggish systems. Only in pathological cases is (C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 207 it necessary to modify these parameters. The call command resets these parameter to their defaults. p Timeout in tenths of seconds for gaps within a packet (default 100). r If non zero, remove incomplete files received with a protocol except those received with the + option (default 0). R When non 0, limits the number of bytes of file comparision used with the sz and rz -rr option. This parameter may be set to a value between 2048 and 32000 (1 billion on 32 bit systems). This parameter is given to the receiving program. EXAMPLE: z pR30000 SEE ALSO: -rr option s Timeout interval in seconds waiting for XON characters or positive flow control (default 15). If an XON is not received within this time, transmission resumes anyway. A value of 0 disables this timeout. t XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds waiting for a packet or command acknowledgement (default 100). T Transmitter timeout in tenths of seconds waiting for a packet (default 600). (C) 1990 Omen Tech Inc Chapter 24 String Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 208 25. STRING PARAMETERS Case is significant in parameter names. ZCOMM provides two types of string parameters, permament and temporary. Permanent string parameters are always defined, and most perform specific defined functions. The permanent string parameters are described below. The names of the permament string parameters may be displayed with the command sequence pv1; set given at the command prompt. Without the pv1 only non empty string parameters are displayed. Temporary string parameters* are created by the set, sets, accept, and grab commands when they do not reference a permament string parameter. Temporary string parameter names begin with any letter except y and may have up to 16 letters or digits. The contents of temporary string parameters may be accessed and modified when ZCOMM is Restricted. New temporary string parameter names may not be created when ZCOMM is Restricted. The set command without arguments displays the current values and maximum string length for each of the non-empty string parameters. To set a parameter empty, enter "" as the parameter string (e.g., set txlog ""). Certain string parameters may be entered with ZCOMM's character escapes. When a string parameter is executed, it may be either sent to the remote as a string or executed as a command if its first character is @. EXAMPLE: set f7 "logout\r" programs F7 to send a string to the remote. EXAMPLE: set f7 "@echo logout" programs F7 to display logout on the screen. In strings sent to the remote, a \336 (octal 336) character causes a pause in transmission[1] (controlled by the p numeric parameter), which may be used to send multiple commands with one string. An optional underscore prepended to the name of a permament string parameter causes that string parameter to be cleared by the next call command. __________ 1. Not including the mput command (C) 1990 Omen Tech Inc Chapter 25 String Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 209 The following string parameters may not be accessed or modified by the set command or in string expansions when ZCOMM is Restricted: backtab bbs break bs esc etx exrc f1...f12 fs1...fs12 fc1...fc12 fa1...fa12 fcdel* fcdown* fcend* fchome* fcins* fcleft* fcpgdn* fcpgup* fcright* fcup* fdel fdown fhome fins fleft fnp5* fpgdn fpgup fright fup id0...id3 intolink* l linkpass* m oncloserx onclosetx onexit outahost outalink* password pw0...pw3 quitcmd rub tab unrestrict xpassword* The following may not be modified by the set command when ZCOMM is restricted: MODEM answerback altprompt baudstr blankfill call1** call2 call3* callers* calllog* callpath** challenge dircx dirpx dirfx dirrx dirsx disks dport e emdir entstr eolstr helpfile home hprompt lib lpnono mcommand mconnect menu messages mprefix mprompt msuffix n1 n2 n3 phones picture plog private rcmdlog* rdisks remote rname* rxlog* telno tmp tname* twxfile txlog* welcome xhelpfile The following parameters can never be modified by the set command: ano args c d drive e h nodename oname1...oname5 parity pwd s speed t w y y0...y127 yb yf String Parameters for Remote Operation: answerback baudstr bbs call1** call2 call3* callers callpath** challenge dircx dirfx dirrx dirsx disks emdir exrc helpfile home hprompt intolink* linkpass* menu messages oncloserx onclosetx outahost outalink* password private pwd rcmdlog* rdisks rmtcmd* rname* rmtcheck* tname* twxfile unrestrict welcome xhelpfile String Parameters for Protocol File Transfer: adlopts aulopts dirrx dirsx oncloserx onclosetx String Parameters for Non Protocol File Transfer: blankfill dircx dirfx eolstr tmodes String Parameters for Interactive Operation: Soft Keys altprompt backtab break bs dirpx entstr esc etx lpnono mprompt parity rub tab tmodes xpassword* String Parameters for Scripts: ano args c d e h ifs item lib oncloserx onclosetx onexit nodename oname1...oname5 remote rxcnt s s0...s9 t tmodes tmp y y0...y127 yb yf String Parameters for Making Calls: MODEM l m mcommand mconnect mprefix msuffix telno String Parameters for Log Keeping: callers* calllog* plog rcmdlog* rxlog* txlog* Other String Parameters: helpfile home kermreset menu onexit picture phones quitcmd MODEM (Note this variable name is UPPER CASE.) When the advanced dialer described in Chapter 9 is used, MODEM contains the file name of the modem specific dial routine to use. (C) 1990 Omen Tech Inc Chapter 25 String Parameters Version 17.78 TurboDial 2.35 Universal Line Printer Edition ZCOMM User Manual 210 adlopts Contains option(s) to be used for ZMODEM AutoDownloads. EXAMPLE: set adlopts "r" Use the r option (crash recovery) for files automatically downloaded with ZMODEM. alds An optional string to be used for controlling Alternate Long Distance Services. On Unix systems, allows assignments to the ALT keys a to z. ano After invoking one of the date related string parameters, the ano string contains the last two digits of the year. answerback When term is in q (TWX) mode, an answerback is sent in response to an incoming ENQ. The format of Answerback is determined by the Western Union Telegraph Company. It typically consists of \r\nNAME CITY\r\n\021 as entered by the set command using character escapes. (In the TWX protocol, the 021 (XON) at the end of the answerback turns on the tape reader.) The answerback string must begin with CR,LF. args contains the complete calling sequence to the current script level. EXAMPLE: call ge,upl accesses the genie telephone directory entry and stores ge.upl in args. altprompt Overrides the default auxilliary command prompt generated by the ALT-2 key. EXAMPLE: set altprompt "\r\E[1m%drive:\L%pwd >>>\E[m " Display the current disk drive (%c) and directory (%pwd) highlighted (\E[1m) and in lower case (\L). N.B.: If you access Unix systems with ZCOMM, choose an altprompt string that is distinct from your Unix prompt. SEE ALSO: hprompt, mprompt, nodename, drive, pwd string parameters aulopts Contains option(s) to be used with the sz command. aulopts is processed by the sz command before any options given to the command itself. backtab Assigns a string or command to the BACKTAB (Shift TAB) key. baudstr When ZCOMM gets a connect in host operation, ZCOMM executes baudstr. EXAMPLE: set baudstr "@gosub .%lib/baud.t" (C) 1990 Omen Tech Inc Chapter 25 String Parameters