home *** CD-ROM | disk | FTP | other *** search
/ kermit.columbia.edu / kermit.columbia.edu.tar / kermit.columbia.edu / archives / ck9196.zip / ckcbwr.txt < prev    next >
Text File  |  2000-01-02  |  54KB  |  1,115 lines

  1. CKCBWR.TXT           "Beware File" for C-Kermit Version 7.0        -*- text -*-
  2.  
  3. As of C-Kermit version:  7.0.196
  4. This file last updated:  Sat Jan  1 14:13:33 2000
  5.  
  6. Authors: Frank da Cruz and Christine M. Gianone, Columbia University.
  7.  
  8.   Copyright (C) 1985, 2000,
  9.     Trustees of Columbia University in the City of New York.
  10.     All rights reserved.  See the C-Kermit COPYING.TXT file or the
  11.     copyright text in the ckcmai.c module for disclaimer and permissions.
  12.  
  13. Report problems, suggestions, fixes, etc, to:
  14.  
  15.   The Kermit Project
  16.   Columbia University
  17.   612 West 115th Street
  18.   New York NY 10025-7799
  19.   USA
  20.   Email: kermit-support@columbia.edu
  21.   Web:   http://www.columbia.edu/kermit/
  22.   News:  comp.protocols.kermit.misc
  23.  
  24.  
  25. DOCUMENTATION
  26.  
  27.   Frank da Cruz and Christine M. Gianone, "Using C-Kermit", Second Edition,
  28.   1997, Digital Press / Butterworth-Heinemann, Woburn, MA, ISBN 1-55558-164-1
  29.   US single-copy price: $44.95; quantity discounts available.  Available in
  30.   computer bookstores or directly from Columbia University:
  31.  
  32.     The Kermit Project
  33.     Columbia University
  34.     612 West 115th Street
  35.     New York NY  10025-7799  USA
  36.     Telephone: +1 (212) 854-3703
  37.     Email: kermit-orders@columbia.edu
  38.     Web: http://www.columbia.edu/kermit/
  39.  
  40.   The CKERMIT2.TXT file contains supplementary info for C-Kermit 7.0 to be
  41.   used until the 3rd edition of the manual is ready.
  42.  
  43.  
  44. WHAT IS IN THIS FILE
  45.  
  46. This is the "beware file" for C-Kermit.  It contains hints and tips,
  47. frequently asked questions (and answers), troubleshooting advice, limitations
  48. and restrictions, known bugs, etc, that apply to all C-Kermit variations.
  49. This file is supplemented by a platform-specific "beware file" for each major
  50. system where C-Kermit runs:
  51.  
  52.   ckubwr.txt - All variations of UNIX: Linux, HP-UX, AIX, SCO, Solaris, etc.
  53.   ckvbwr.txt - Compaq / Digital Equipment Corporation VMS and OpenVMS
  54.   cklbwr.txt - Stratus VOS
  55.   ckdbwr.txt - Data General AOS/VS
  56.   ckmbwr.txt - Apple Macintosh
  57.   ckibwr.txt - Commodore Amiga
  58.   cksbwr.txt - Atari ST
  59.   ck9bwr.txt - Microware OS-9
  60.   ckpbwr.txt - Bell Labs Plan 9
  61.  
  62. This file contains the following sections:
  63.  
  64.    (1) INCOMPATIBLE CHANGES IN VERSION 6.0
  65.    (2) THE C-KERMIT COMMAND PARSER
  66.    (3) MULTIPLE SESSIONS
  67.    (4) NETWORK COMMUNICATION
  68.    (5) THE SERVICES DIRECTORY
  69.    (6) MODEMS AND DIALING
  70.    (7) DIALING HINTS AND TIPS
  71.    (8) TERMINAL SERVERS
  72.    (9) TERMINAL EMULATION
  73.   (10) KEY MAPPING
  74.   (11) THE TRANSMIT COMMAND
  75.   (12) FILE TRANSFER
  76.   (13) SCRIPT PROGRAMMING
  77.  
  78.  
  79. (1) INCOMPATIBLE CHANGES
  80.  
  81. These are not necessarily exhaustive lists.
  82.  
  83. The following incompatible changes were made in C-Kermit 6.0:
  84.  
  85.  . Unless you tell C-Kermit otherwise, if a serial or network connection
  86.    seems to be open, and you attempt to EXIT or to SET LINE or SET HOST or
  87.    TELNET, C-Kermit warns you that an active connection appears to be open
  88.    and asks you if you really want to close it.  If you do not want these
  89.    warnings, add SET EXIT WARNING OFF to your customization file.
  90.  
  91.  . The default for SET { SEND, RECEIVE } PATHNAMES was changed from ON
  92.    to OFF, to prevent unexpected creation of directories and depositing of
  93.    incoming files in places you might not know to look.
  94.  
  95.  . The default for SET FILE INCOMPLETE was changed from DISCARD to KEEP to
  96.    allow for file transfer recovery.
  97.  
  98.  . The default file-transfer block-check is now 3, rather than 1.  If the
  99.    other Kermit does not support this, the two will drop back to type 1
  100.    automatically.
  101.  
  102.  . The default flow-control is now "auto" ("do the right thing"), not Xon/Xoff.
  103.  
  104.  . Backslash (\) is no longer a command continuation character.  Only -
  105.    (hyphen, dash) may be used for this in C-Kermit 6.0 and later.
  106.  
  107.  . Negative INPUT timeout now results in infinite wait, rather than 1 second.
  108.  
  109. And in version 6.1:
  110.  
  111.  . The "multiline GET" command is gone.  Now use:
  112.  
  113.      get <remote-name> <local-name>
  114.  
  115.    or:
  116.  
  117.      get /as-name:<local-name> <remote-name>
  118.  
  119.    If either name contains spaces, enclose it in braces.
  120.  
  121.  . To request list of files from the server, you must now use MGET rather
  122.    than GET:
  123.  
  124.       mget file1 file2 file3 ...
  125.  
  126. See ckermit2.txt Section 0 for additional items and further detail.
  127.  
  128.  
  129. (2) THE C-KERMIT COMMAND PARSER
  130.  
  131. When using the command-line processor ("kermit -l /dev/tty00 -b 19200", etc),
  132. note that in some cases the order of the command-line options makes a
  133. difference, contrary to the expectation that order of command-line options
  134. should not matter.  For example, the -b option must be given after the -l
  135. option if it is to have any effect.
  136.  
  137. In the interactive command parser:
  138.  
  139.  . VMS-style command editing (arrow keys, etc) is not supported.
  140.  . EMACS- or VI-style command line editing is not supported.
  141.  . Editing keys are hardwired (Ctrl-U, Ctrl-W, etc).
  142.  
  143. If you interrupt C-Kermit before it has issued its first prompt, it will exit.
  144. This means that you cannot interrupt execution of the initialization file, or
  145. of an "application file" (file whose name is given as the first command-line
  146. argument), or of an alternative initialization file ("-y filename"), and get
  147. to the prompt.  There is, however, one exception to this rule: you *can*
  148. interrupt commands -- including TAKE commands -- given in the '-C "command
  149. list"' command-line argument and -- if there were no action commands among the
  150. command-line arguments -- you will be returned to the C-Kermit prompt.  So,
  151. for example, if you want to start C-Kermit in such a way that it executes a
  152. command file before issuing its first prompt, and you also want to be able to
  153. interrupt the command file and get to the prompt, include a TAKE command for
  154. the desired command in the -C argument, for example:
  155.  
  156.    kermit -C "take dial.scr"
  157.  
  158. If you use the backslash (\) prefix to enter a control character, space, or
  159. question mark into a command literally, the backslash disappears and is
  160. replaced by the quoted character.  If it was a control character, it is shown
  161. as a circumflex (^).  This allows editing (backspace, delete, Ctrl-W) to work
  162. correctly even for control characters.
  163.  
  164. The only way to include a comma literally in a macro definition -- as opposed
  165. to having it separate commands within the definition -- is to enter its ASCII
  166. value (44) in backslash notation, e.g.:
  167.  
  168.   DEFINE ROWS MODE CO80\{44}\%1
  169.  
  170. If you quote special characters in a filename (e.g. in the SEND command),
  171. filename completion may seem to work incorrectly.  For example, if you have a
  172. file whose name is a*b (the name really contains an asterisk), and you type
  173. "send a\\*<ESC>", the "b" will not appear, nor will Ctrl-R redisplay the
  174. completed name correctly.  But internally the file name is recognized anyway.
  175.  
  176. Question-mark help does not work during execution of an ASKQ command.  The
  177. question marks are simply accepted as text.
  178.  
  179. The maximum length for a variable name is between 256 and 4096 characters,
  180. depending on the platform; for array declarations and references, that
  181. includes the subscript.
  182.                                                      Sample
  183. Some other maximums to watch out for:      Symbol    Value Defined in
  184.  
  185.  Nesting level for command files:           MAXTAKE      30  ckuusr.h
  186.  Nesting level for macros:                  MACLEVEL     50  ckuusr.h
  187.  Nesting level for FOR / WHILE loops:       FORDEPTH     10  ckuusr.h
  188.  Number of macros:                          MAC_MAX     256  ckuusr.h
  189.  Size of INPUT buffer:                      INPBUFSIZ   256  ckuusr.h
  190.  Maximum files to match a wildcard:         MAXWLD   varies  ck?fio.c
  191.  Filespecs in MSEND command:                MSENDMAX    100  ckuusr.h
  192.  Length of MSEND or GET string:             FSPECL      300  ckuusr.h
  193.  Length for GOTO target label:              LBLSIZ       50  ckuusr.h
  194.  Number of characters in a command:         CMDBL      1024  ckucmd.h
  195.  Number of chars in a field of a command:   ATMBL       256  ckucmd.h
  196.  \fexecute() recursion depth limit:         CMDDEP       20  ckucmd.h
  197.  
  198. The actual values of most of these items can vary with version and
  199. configuration, and are listed by SHOW FEATURES.
  200.  
  201. ASK and ASKQ strip leading and trailing spaces from what the user types.  This
  202. happens way down deep in the command parser -- it's nothing special about ASK
  203. and friends.  The only way around this that works in both C-Kermit and MS-DOS
  204. Kermit is for the user (the one who is responding to the ASK prompt) to type
  205. (the first) leading space as "\32" and the (final) trailing space as "\32".
  206. In this example, the password begins with 2 leading blanks and ends with two
  207. trailing blanks, and "Passwd:" is the ASK prompt:
  208.  
  209.  Passwd:\32 secret \32
  210.  
  211. Of course, the user could also type *all* blanks as \32.
  212.  
  213. In OUTPUT commands only, \B and \\B send a BREAK signal, and \L and \\L send a
  214. Long BREAK signal, and \N and \\N send a NUL (ASCII 0).  BREAK and Long BREAK
  215. are special signals, not characters, and NUL is a character that normally
  216. cannot be included in a C string, since it is the C string terminator.
  217.  
  218. If you really want to output a backslash followed by a B, an L, or an N (as is
  219. needed to configure certain modems, etc), use "output \\B".
  220.  
  221. In C-Kermit 6.1 or later, you can disarm and re-arm the special OUTPUT-command
  222. escapes (\B, \L, and \N) with SET OUTPUT SPECIAL-ESCAPES { OFF, ON }.
  223.  
  224.  
  225. (3) MULTIPLE SESSIONS
  226.  
  227. C-Kermit does not support multiple sessions.  When you SET LINE (or SET PORT,
  228. same thing) to a new device, or SET HOST to a new host, the previous SET LINE
  229. device or network host connection is closed, resulting in hangup of the modem
  230. or termination of the network connection.  In windowing environments like
  231. HP-VUE, NeXTSTEP, OS/2, etc, you can run separate copies of Kermit in different
  232. windows to achieve multiple sessions.
  233.  
  234. To achieve multiple sessions through a single serial port (e.g. when dialing
  235. up), you can install SLIP or PPP on your computer and then use C-Kermit's
  236. TCP/IP support over the SLIP or PPP connection, assuming you also have
  237. TCP/IP networking installed on your computer.
  238.  
  239. On UNIX systems that support the "term" program, you can establish a
  240. connection to another UNIX system with C-Kermit and then achieve multiple
  241. sessions using "term" client programs like trsh (see ckubwr.txt and the term
  242. documentation for details).
  243.  
  244.  
  245. (4) NETWORK COMMUNICATION
  246.  
  247. The most frequently asked question in many newsgroups is "Why does it take
  248. such a loooong time to make a telnet connection to (or from) my (e.g.) Linux
  249. PC?" (this applies to C-Kermit or to regular Telnet).  This question has
  250. two answers, one of them specific to C-Kermit 7.0:
  251.  
  252.  1. Most telnet servers nowadays perform reverse DNS lookups on the client
  253.     (for security and/or logging reasons).  If the Telnet client cannot be
  254.     found by the local DNS server, the DNS request goes out to the Internet at
  255.     large, and this can take quite some time.  The solution to this problem is
  256.     to make sure that both client and host are registered in DNS.
  257.  
  258.  2. C-Kermit 7.0 strictly enforces Telnet protocol rules.  One such rule is
  259.     that all negotiations must be responded to.  If C-Kermit sends a
  260.     negotiation and the host does not respond, C-Kermit will wait a long time
  261.     for the reply (in case the network is congested or the host is slow), but
  262.     eventually will time out.  To eliminate the waits (and therefore risk
  263.     possible protocol mismatches -- or worse --  between Telnet client and
  264.     server), tell C-Kermit to SET TELNET WAIT OFF (or include the /NOWAIT
  265.     switch with the TELNET command).
  266.  
  267. C-Kermit itself performs reverse DNS lookups unless you tell it not to.  This
  268. is to allow C-Kermit to let you know which host it is actually connected to
  269. in case you have made a connection to a "host pool" (multihomed host).  You
  270. can disable C-Kermit's reverse DNS lookup with SET TCP REVERSE-DNS-LOOKUP OFF.
  271.  
  272. In multiuser operating systems such as UNIX and VMS, TCP/IP RLOGIN connections
  273. are available only to privileged users, since "login" is a privileged socket.
  274. And assuming you are allowed to use it in the first place, it is likely to
  275. behave differently depending on what type of host you are rlogging in to, due
  276. to technical reasons having to do with conflicting interpretations of RFC793
  277. (Out-Of-Band Data) and Rlogin (RFC1122)...  "Specifically, the TCP urgent
  278. pointer in BSD points to the byte after the urgent data byte, and an
  279. RFC-compliant TCP urgent pointer points to the urgent data byte. As a result,
  280. if an application sends urgent data from a BSD-compatible implementation to an
  281. RFC-1122 compatible implementation then the receiver will read the wrong
  282. urgent data byte (it will read the byte located after the correct byte in the
  283. data stream as the urgent data byte)."  Rlogin requires the use of OOB data
  284. while Telnet does not.  Therefore, it is possible for Telnet to work between
  285. all systems while BSD and System V TCP/IP implementation are almost always a
  286. bad mix.
  287.  
  288. On a TCP/IP TELNET connection, you should normally have PARITY set to NONE and
  289. (except in VMS C-Kermit) FLOW-CONTROL also set to NONE.  If file transfer does
  290. not work with these settings (for example, because the remote TELNET server
  291. only gives a 7-bit data path), use SET PARITY SPACE.  Do not use SET PARITY
  292. MARK, EVEN, or ODD on a TELNET connection -- it interferes with TELNET
  293. protocol.
  294.  
  295. If echoing does not work right after connecting to a network host or after
  296. dialing through a TCP/IP modem server, it probably means that the TELNET
  297. server on the far end of the connection is executing the TELNET protocol
  298. incorrectly.  After initially connecting and discovering incorrect echoing
  299. (characters are echoed twice, or not at all), escape back, give the
  300. appropriate SET DUPLEX command (FULL or HALF), and then CONNECT again.
  301. For a consistently misbehaving connection, you can automate this process in
  302. a macro or TAKE file.
  303.  
  304. TELNET sessions are treated just like serial communications sessions as far as
  305. "terminal bytesize" and "command bytesize" are concerned.  If you need to view
  306. and/or enter 8-bit characters during a TELNET session, you must tell C-Kermit
  307. to SET TERMINAL BYTESIZE 8, SET COMMAND BYTESIZE 8, and SET PARITY NONE.
  308.  
  309. If you SET TERMINAL DEBUG ON or SET DEBUG SESSION (same thing), TELNET
  310. protocol negotiations will be displayed on your screen.  But most of the
  311. interesting negotiations happen at the time the SET HOST or TELNET command
  312. is given, before CONNECT mode is entered, so you won't see them on your
  313. screen.  However, you can still capture them in the debug log ("log debug").
  314.  
  315. C-Kermit version 6.0 has a new set of SET TCP commands, to control TCP-level
  316. parameters, such as "keepalive" protocol (that allows C-Kermit to detect
  317. more quickly and reliably when a connection is broken).  Use SHOW NET to see
  318. their values and SET TCP to change them.
  319.  
  320.  
  321. (5) THE SERVICES DIRECTORY
  322.  
  323. Is explained fully in "Using C-Kermit", 2nd Edition, Chapter 7.
  324.  
  325.  
  326. (6) MODEMS AND DIALING
  327.  
  328. Warning: Some phone companies are eliminating the busy signal.  Instead,
  329. they issue a voice message such as "press 1 to automatically redial until
  330. the number answers, or...".  Obviously this is a disaster for modem calls.
  331. If your service has this feature, there's nothing Kermit can do about it.
  332. Your modem will respond with NO CARRIER rather than BUSY, and Kermit will
  333. declare the call a failure, rather than trying to redial the same number.
  334.  
  335. The list of modem types supported by C-Kermit is obtained by typing:
  336.  
  337.   set modem type ?
  338.  
  339. at the C-Kermit> prompt.  Note that the ITU-T (V.25bis) modem type is
  340. supported only in asynchronous mode, not synchronous (HDLC) mode -- there is
  341. no support in C-Kermit for synchronous communication (except for SET NET X.25,
  342. which is only available on certain platforms).
  343.  
  344. If a built-in modem type doesn't work for you, and the modem is a modern
  345. high-speed (data compressing, error correcting) modem that uses the Hayes AT
  346. command set, try:
  347.  
  348.   SET MODEM TYPE GENERIC-HIGH-SPEED
  349.  
  350. Modems can be used by C-Kermit only when they are visible as or through a
  351. regular serial port device.  Note that certain modems can not be used in this
  352. normal way on many kinds of computers: Winmodems, RPI modems, Controllerless
  353. modems, the IBM Mwave, etc; all of these require special drivers that perform
  354. some, most, or all of the modem's functions in software.  Such drivers are
  355. generally NOT available in UNIX or other non-Windows (or non-OS/2, in the case
  356. of the Mwave) platforms.
  357.  
  358. An important change in C-Kermit 6.0 is that when you give a SET MODEM TYPE
  359. command to tell Kermit what kind of modem you have, Kermit also sets a number
  360. of other modem-related parameters automatically from its internal modem
  361. database.  Thus, the order in which you give modem-related commands is
  362. significant, whereas in prior releases they could be given in any order.
  363.  
  364. In particular, MODEM SPEED-MATCHING is set according to whether the modem
  365. is known to be capable of speed buffering.  SET MODEM TYPE HAYES-2400
  366. automatically turns SPEED-MATCHING ON, because when the Hayes 2400 reports
  367. a particular speed in its CONNECT message, that means its interface speed
  368. has changed to that speed, and C-Kermit's must change accordingly if it is
  369. to continue communicating.  This might cause some confusion if you use
  370. "set modem type hayes" for dialing a more advanced type of modem.
  371.  
  372. The new default for flow control is "auto", meaning "do the right thing".
  373. So (for example) if your version of C-Kermit supports SET FLOW RTS/CTS and
  374. your modem also supports RTS/CTS, then Kermit will automatically set its
  375. flow control to RTS/CTS *and* set modem's flow control to RTS/CTS too before
  376. attempting to use the modem.
  377.  
  378. For this reason, don't assume that "set modem type hayes" should be used for
  379. any modem that uses the Hayes AT command set.  "set modem type hayes" really
  380. does mean Hayes 1200 or 2400, which in turn means no hardware flow control,
  381. and no speed buffering.  This choice will rarely work with a modern high-speed
  382. modem.
  383.  
  384.  
  385. (7) DIALING HINTS AND TIPS
  386.  
  387. If you want to dial a number that starts with #, you'll need to quote the
  388. "#" character (as \# or \{35}), since it is also a comment introducer:
  389.  
  390.   C-Kermit>dial #98765421-1-212-5551212   ; Looks like a comment
  391.   ?You must specify a number to dial
  392.   C-Kermit>dial \#98765421-1-212-5551212  ; Works OK
  393.  
  394. When using a dialing directory, remember what happens if a name is not found:
  395.  
  396.   C-Kermit>dial xyzcorp
  397.   Lookup: "xyzcorp" - not found - dialing as given
  398.  
  399. This normally does no harm, but some modems might behave strangely when given
  400. dial strings that contain certain letters.  For example, a certain German
  401. modem treats any dial string that contains the letter "s" as a command to
  402. fetch a number from its internal list, and replies OK to the ATD command,
  403. which is normally not a valid response except for partial dialing.  To avoid
  404. this situation, use:
  405.  
  406.   lookup xyzcorp
  407.   if success dial
  408.  
  409. Remember: In many C-Kermit implementations (depending on the underlying
  410. operating system -- mostly Windows, OS/2, and System-V-based UNIX versions,
  411. and in C-Kermit 6.1, also VMS), you can't CONNECT to a modem and type the
  412. modem's dialing command (like "ATDT7654321") manually, unless you first tell
  413. C-Kermit to:
  414.  
  415.   SET CARRIER-WATCH OFF
  416.  
  417. This is because (in these implementations), the CONNECT command requires the
  418. modem's Carrier Detect (CD) signal to be on, but the CD signal doesn't come on
  419. until after dialing is complete.  This requirement is what allows C-Kermit to
  420. pop back to its prompt automatically when the connection is hung up.  See the
  421. description of SET CARRIER-WATCH in "Using C-Kermit".
  422.  
  423. Similarly, if your dialed connection drops when CARRIER-WATCH is set to AUTO
  424. or ON, you can't CONNECT back to the (now disconnected) screen to see what
  425. might have happened unless you first SET CARRIER-WATCH OFF.
  426.  
  427. Don't SET FLOW RTS/CTS if your modem is turned off, or if it is not presenting
  428. the CTS signal.  Otherwise, the serial device driver might get stuck waiting
  429. for this signal to appear.
  430.  
  431. The HANGUP command has no effect when C-Kermit is in remote mode.  This is
  432. on purpose.  If C-Kermit could hang up its own controlling terminal, this
  433. would (a) most likely leave behind zombie processes, and (b) pose a security
  434. risk.
  435.  
  436. If you have a high-speed, error-correcting, data-compressing, speed-buffering
  437. modem, you should fix the modem's interface speed as high as possible,
  438. preferably (at least) four times higher than its maximum connection
  439. (modulation) speed to allow compression to work at full advantage.  In this
  440. type of setup, you must also have an effective means of flow control enabled
  441. between C-Kermit and the modem, preferably hardware (RTS/CTS) flow control.
  442. On platforms that do not support hardware flow control, it is usually possible
  443. to select software flow control (Xon/Xoff), and C-Kermit will do its best to
  444. set the modem for local Xon/Xoff flow control too (but then, of course,
  445. Ctrl-S and Ctrl-Q characters can not be transmitted on the connection).
  446.  
  447. C-Kermit knows about a large number of modems, depending on how it was built
  448. (type "set modem type ?" and "show features" for further info).  This
  449. knowledge is imbedded in the SET MODEM and DIAL commands.  If you are having
  450. trouble dialing your modem, SET DIAL DISPLAY ON to watch the dialing
  451. interactions between C-Kermit and your modem.  Consult Chapters 3-4 of "Using
  452. C-Kermit" (2nd Ed) for modem-dialing troubleshooting instructions.
  453.  
  454. If it takes your call longer to be completed than the timeout interval that
  455. C-Kermit calculates, you can use the SET DIAL TIMEOUT command to override
  456. C-Kermit's value.  But beware: the modem has its own timeout for completing
  457. the call.  If it is a Hayes-like modem, C-Kermit adjusts the modem's value
  458. too by setting register S7.  But the maximum value for S7 might be smaller
  459. than the time you need!  In that case, C-Kermit sets S7 to 0, 255, or other
  460. (modem-specific) value to signify "no timeout".
  461.  
  462. WARNING: Certain modems might have a maximum dial timeout shorter than what
  463. Kermit expects it to be.  If Kermit attempts to set register S7 to a value
  464. higher than your modem's maximum, the modem will say "ERROR" and you will get
  465. a "Failure to initialize modem" error.  In that case, use SET DIAL TIMEOUT to
  466. override C-Kermit's calculation of the timeout value with the highest value
  467. that is legal for your modem, e.g. 60.
  468.  
  469. If you DIAL a modem, disconnect, then SET HOST or TELNET, and then HANGUP,
  470. Kermit sends the modem's hangup command, such as "+++ATHO".  There is no good
  471. way to avoid this, because this case can't reliably be distinguished from the
  472. case in which the user does SET HOST <terminal-server>, SET MODEM TYPE <name>,
  473. DIAL.  In both cases we have a valid modem type selected and we have a network
  474. connection.  If you want to DIAL and then later make a regular network
  475. connection, you will have to SET MODEM TYPE NONE or SET MODEM HANGUP RS232 to
  476. avoid this phenomenon.
  477.  
  478. The SET MODEM KERMIT-SPOOF command works only for Telebit and US Robotics
  479. modem types; it is OFF by default.  You may wish to experiment with large
  480. packets (1K or greater) and various window sizes with spoofing disabled in the
  481. modem.  In most situations the transfer rates achieved by Kermit with sliding
  482. windows and long packets are better than with protocol spoofing turned on.
  483. Also, attribute (A) packets are not passed by Telebit modems with spoofing
  484. enabled so if they are desired spoofing must be turned off.
  485.  
  486. Some modems have a feature called adaptive dialing.  When they are told to
  487. dial a number using Tone dialing, they check to make sure that dialtone has
  488. gone away after dialing the first digit.  If it has not, the modem assumes the
  489. phone line does not accept Tone dialing and so switches to Pulse.  When
  490. dialing out from a PBX, there is almost always a secondary dialtone.
  491. Typically you take the phone off-hook, get the PBX dialtone, dial "9" to get
  492. an outside line, and then get the phone company's dialtone.  In a situation
  493. like this, you need to tell the modem to expect the secondary dialtone.  On
  494. Hayes and compatible modems, this is done by putting a "W" in the dial string
  495. at the appropriate place.  For example, to dial 9 for an outside line, and
  496. then 7654321, use ATDT9W7654321.  In Kermit 95, this is accomplished with:
  497.  
  498.   SET PBX-OUTSIDE-PREFIX 9W
  499.  
  500. (replace "9" with whatever your PBX's outside-line prefix is).
  501.  
  502. DEC modems...  Reportedly, these don't work right when connected to a DEC
  503. terminal server -- result codes are never reported (on the other hand, this
  504. might be a modem configuration problem).  Dialing "by hand", "blind" still
  505. works.  Also, reportedly "For people who do have DEC modems directly connected
  506. to DEC computers the DF03, DF100-series, and DF200-series modem dialers should
  507. work.  The only thing that is not straightforward is that the DF124-CA,
  508. DF124-CM modems must use the DF200-series since they speak Digital Modem
  509. Command Language (DMCL) and AT commands.  The Digital Scholar Plus is a DF242
  510. so it uses the DF200-series."
  511.  
  512. If C-Kermit's dialing methods are insufficient for your purposes, you can
  513. write a C-Kermit script program to do the dialing.
  514.  
  515. (7.1) DIALING AND FLOW CONTROL
  516.  
  517. Most modern modems support RTS/CTS (if they support any hardware flow control
  518. at all), but some computers use different RS-232 circuits for the same
  519. purposes, e.g. DTR and CD, or DTR and CTS.  In such cases, you might be able
  520. to make your computer work with your modem by appropriately cross-wiring the
  521. circuits in the cable connector, for example the computer's DTR to the modem's
  522. RTS, and modem's CD to the computer's CTS.  HOWEVER, C-Kermit does not know
  523. you have done this.  So if you have (say) SET FLOW DTR/CD, C-Kermit will make
  524. no attempt to tell the modem to use RTS/CTS.  You probably did this yourself
  525. when you configured the modem.
  526.  
  527. (7.2) ESCAPE SEQUENCE GUARD TIME
  528.  
  529. A "TIES" (Time-Independent Escape Sequence) modem does not require any guard
  530. time around its escape sequence.  The following text:
  531.  
  532. +++ATH0
  533.  
  534. if sent through a TIES modem, for example because you were uploading this
  535. file through it, could pop the modem back into command mode and make it hang
  536. up the connection.  Newer versions of the Telebit T1600 and T3000 (version
  537. LA3.01E firmware and later), and all WorldBlazers, use TIES.
  538.  
  539. Although the probability of "+++" appearing in a Kermit packet is markedly
  540. lower than with most other protocols (see the File Transfer section below), it
  541. can still happen under certain circumstances.  It can also happen when using
  542. C-Kermit's TRANSMIT command.  If you are using a Telebit TIES modem, you can
  543. change the modem's escape sequence to an otherwise little-used control
  544. character such as Ctrl-_ (Control-Underscore):
  545.  
  546.   AT S2=31
  547.  
  548. A sequence of three consecutive Ctrl-_ characters will not appear in a
  549. Kermit packet unless you go to extraordinary lengths to defeat more than a few
  550. of Kermit's built-in safety mechanisms.  And if you do this, then you should
  551. also turn off the modem's escape-sequence recognition altogether:
  552.  
  553.   AT S48=0 S2=255
  554.  
  555. But when escape sequence recognition is turned off, "modem hangup"
  556. (<pause>+++<pause>ATH0<CR>) will not work, so you should also be sure to SET
  557. DIAL MODEM-HANGUP OFF.
  558.  
  559.  
  560. (8) TERMINAL SERVERS
  561.  
  562. How to DIAL from a TCP/IP reverse terminal server (modem server):
  563.  
  564.  1. (only if necessary) SET TELNET ECHO REMOTE
  565.  2. SET HOST <terminal-server-ip-name-or-address> [ <port> ]
  566.  3. SET MODEM <modem-type>
  567.  4. (only if necessary) SET DIAL HANGUP OFF
  568.  5. DIAL <phone-number>
  569.  
  570. The order is important.
  571.  
  572. Watch out for terminal server's escape character -- usually a control
  573. character such as Ctrl-Circumflex (Ctrl-^).  Don't unprefix it in Kermit !
  574.  
  575. Ciscos -- must often be told to "terminal download"...  Cisco ASM models don't
  576. have hardware flow control in both directions.
  577.  
  578. Many terminal servers only give you a 7-bit connection, so if you can't make
  579. it 8-bit, tell Kermit to "set parity space".
  580.  
  581. The following story, regarding trouble transferring 8-bit files through a
  582. reverse terminal server, was contributed by an Annex terminal server user
  583. (begin quote):
  584.  
  585. Using C-Kermit on an HP 9000 712/80 running the HP-UX 10.0 operating system.
  586. The HP was connected to a Xylogics Annex MICRO-ELS-UX R7.1 8 port terminal
  587. server via ethernet.  On the second port of the terminal server is an AT&T
  588. Paradyne 3810 modem, which is connected to a telephone line.  There is a
  589. program which runs on the HP to establish a Telnet connection between a serial
  590. line on the Annex and a character special file on the HP (/dev file).  This is
  591. an Annex specific program called rtelnet (reverse telnet) and is provided with
  592. the terminal server software. The rtelnet utility runs on top of the
  593. pseudo-terminal facility provided by UNIX.  It creates host-originiated
  594. connections to devices attached ot Annex serial ports.  There are several
  595. command line arguments to be specified with this program: the IP address of
  596. the terminal server, the number of the port to attach to, and the name of the
  597. pseudo-device to create.  In addition to these there are options to tell
  598. rtelnet how to operate on the connect: -b requests negotiation for Telnet
  599. binary mode, -d turns on socket-leve debugging, -f enables "connect on the
  600. fly" mode, -r removes the device-name if it already exists, etc.  The most
  601. important of these to be specified when using 8 data bits and no parity, as we
  602. found out, was the -t option.  This creates a transparent TCP connection to
  603. the terminal server.  Again, what we assumed to be happening was that the
  604. rtelnet program encountered a character sequence special to itself and then
  605. "eating" those kermit packets.  I think this is all of the information I can
  606. give you on the configuration, short of the values associated with the port on
  607. the terminal server.  If I can provide any other details, just let me know.
  608. Thanks again for your help.
  609.  
  610. (end quote)
  611.  
  612.  
  613. (9) TERMINAL EMULATION
  614.  
  615. Except for the Windows, OS/2, and Macintosh versions, C-Kermit does not
  616. emulate any kind of terminal.  Rather, it acts more or less as a "transparent
  617. pipe", passing the characters you type during a CONNECT session to the remote
  618. host, and sending the characters received from the remote host to your screen.
  619. Whatever is controlling your keyboard and screen provides the specific
  620. terminal emulation: a real terminal, a PC running a terminal emulator, etc, or
  621. (in the case of a self-contained workstation) your console driver, a terminal
  622. window, xterm, etc.
  623.  
  624. There are several exceptions to the "transparent pipe" rule:
  625.  
  626.  - During a TELNET ("set host") session, C-Kermit itself executes the
  627.    TELNET protocol and performs TELNET negotiations.  (But it does not
  628.    perform TN3270 protocol or any other type of 3270 terminal emulation.)
  629.  
  630.  - If you have changed your keyboard mapping using SET KEY, C-Kermit replaces
  631.    the characters you type with the characters or strings they are mapped to.
  632.  
  633.  - If you SET your TERMINAL CHARACTER-SET to anything but TRANSPARENT,
  634.    C-Kermit translates your keystrokes (after applying any SET KEY
  635.    definitions) before transmitting them, and translates received characters
  636.    before showing them on your screen.
  637.  
  638.  - If your remote and/or local TERMINAL CHARACTER-SET is an ISO 646 7-bit
  639.    national character set, such as German, French, Italian, Swedish, etc, or
  640.    Short KOI used for Cyrillic, C-Kermit's CONNECT command automatically skips
  641.    over ANSI escape sequences to avoid translating their characters.  Only
  642.    ANSI/ISO standard (VT100/200/300-like) 7-bit escape sequence formats are
  643.    supported for this purpose, no proprietary schemes like H-P, Televideo,
  644.    Tektronix, etc.
  645.  
  646.  - If your version of C-Kermit includes SET TERMINAL APC command, then
  647.    C-Kermit's CONNECT command will handle APC escape sequences if TERMINAL
  648.    APC is not set to OFF (which is the default).
  649.  
  650. If you are running C-Kermit under a console driver, or in a terminal window,
  651. that emulates the VT100, and use C-Kermit to log in to a VMS system, the
  652. console driver or terminal window (not Kermit) is supposed to reply to the
  653. "what are you?" query (ESC Z) from the VAX.  If it doesn't, and you can't make
  654. it do so, then you can (a) live with the "unknown terminal" problem; (b) tell
  655. VMS to SET TERMINAL/DEVICE=VT100; (c) program a key using SET KEY to send the
  656. appropriate sequence and then punch the key at the right time; or (d) use the
  657. VMSLOGIN macro that is defined in CKERMIT.INI to do this for you
  658. automatically.
  659.  
  660. SET SESSION-LOG { TEXT, BINARY }, which is effective in UNIX and AOS/VS but
  661. not other C-Kermit versions, removes CR, DEL, NUL, XON, and XOFF characters
  662. ("Using C-Kermit" neglects to mention that XON and XOFF are removed).  The
  663. TEXT-mode setting is ineffective during SCRIPT command execution, as well as
  664. on X.25 connections.
  665.  
  666.  
  667. (10) KEY MAPPING
  668.  
  669. Except in the terminal-emulating versions, C-Kermit's key mapping facilities
  670. are limited to normal "ASCII" keys, and cannot be used with function keys,
  671. arrow keys, arcane key combinations, etc.  Since C-Kermit runs on such a wide
  672. variety of hardware platforms (including, for example, more than 360 different
  673. UNIX platforms), it is not possible for C-Kermit to support every conceivable
  674. keyboard under every release of every UNIX (or VMS, or ...) product on every
  675. different kind of computer possibly under all manner of different console
  676. drivers.
  677.  
  678. In technical terms, C-Kermit uses the read() function to read keystrokes, and
  679. read() returns a single byte (value 0 through 255).  C-Kermit's SET KEY
  680. function applies to these single-byte codes.  "Extended function" keys, such
  681. as F-keys, arrow keys, etc, usually return either a 2-byte "scan code" or else
  682. a character string (such as an escape sequence like "ESC O p").  In both
  683. cases, C-Kermit has no way to tell the difference between such multibyte key
  684. values, and the corresponding series of single-byte key values.  This could
  685. only be done by accessing the keyboard at a much lower level in a highly
  686. system-dependent manner, probably requiring tens of thousands of lines of code
  687. to support even a sampling of the most popular workstation / OS combinations.
  688.  
  689. However, most workstation console drivers (terminal emulation windows, etc)
  690. include their own key-mapping facility.  For example, on an IBM RS/6000, the
  691. AIXterm program (in whose window you would run C-Kermit) allows rebinding of
  692. the F1-F12 keys to arbitrary strings.  The same might or might not be true of
  693. DECterm windows, Sun "vttool" or "crttool" windows, etc.  Consult the
  694. technical documentation for your workstation or emulator.
  695.  
  696. The SET KEY command (except in OS/2) does not allow a key definition to be
  697. (or contain) the NUL (\0) character.
  698.  
  699.  
  700. (11) THE TRANSMIT COMMAND
  701.  
  702. Session logging is inactive during the TRANSMIT command, even if you have
  703. given a LOG SESSION command.
  704.  
  705.  
  706. (12) FILE TRANSFER
  707.  
  708. C-Kermit 7.0 is the first release of C-Kermit to use fast (rather than robust
  709. and therefore slow) protocol defaults: long packets, sliding windows,
  710. control-character unprefixing, and streaming where possible.  This makes most
  711. transfers (partner willing) dramatically faster "out of the box" but might
  712. break some combinations that worked before.  If transfers with C-Kermit 7.0
  713. fail where transfers worked with earlier C-Kermit versions, try the following:
  714.  
  715.  a. ROBUST: this command reverts to the most conservative protocol settings.
  716.  b. CAUTIOUS: Selects medium but cautious protocol settings.
  717.  c. SET PREFIXING ALL: Disables control-character unprefixing.
  718.  d. SET STREAMING OFF: Disables streaming.
  719.  
  720. File transfer failures can occur for all sorts of reasons, many of them listed
  721. in Chapter 10 of the manual.  Another one came up recently when using Kermit
  722. on a certain laptop with its built-in modem: the modem's "auto timeout delay"
  723. was hanging up the connection in the middle of a file transfer.  Most modems,
  724. even if they have this feature, do not have it enabled by default.  But if you
  725. experience otherwise inexplicable disconnections in the midst of your Kermit
  726. sessions, check the modem manual for such things as "idle timeout", "auto
  727. timeout", etc, and add the command to disable this feature to Kermit's init
  728. string for this modem.
  729.  
  730. If you have a multihop connection, with the interior nodes in CONNECT
  731. mode (Kermit, Telnet, Rlogin, or any other), you can expect (a) file transfer
  732. to be slower, and (b) the connection to be less transparent (to control
  733. characters, perhaps to the 8th bit) than a more direct connection.  C-Kermit
  734. 7.0 has a "-0" (dash-zero) command-line option to make it 100% transparent
  735. in cases where it is to be used in the middle.
  736.  
  737. The recovery feature (RESEND command) that was added in edit 190 works only
  738. for binary-mode transfers.  In order for this feature to be useful at all, the
  739. default for SET FILE INCOMPLETE was changed from DISCARD to KEEP.  Otherwise
  740. an interrupted transfer would leave no partial file behind unless you had
  741. remembered to change the default.  But now you have to pay closer attention to
  742. Kermit's messages to know whether a transfer succeeded or failed --
  743. previously, if it failed, the file would not show up on the receiving end at
  744. all; in edit 190 and later, you'll get a partial file which could easily be
  745. mistaken for the complete file unless you change the default back to DISCARD
  746. or read the screen messages, or keep a transaction log.
  747.  
  748. Watch out for SET FILE COLLISION RENAME, especially when used in conjunction
  749. with recovery.  Recall that this option (which is NOT the default) renames
  750. the incoming file if a file already exists with the same name (the default is
  751. to rename the previously existing file, and store the incoming file with its
  752. own name).  It is strongly recommended that you do not use SET FILE COLLISION
  753. RENAME if you ever intend to use the recovery feature:
  754.  
  755.  . When the file is first received by C-Kermit, its name will be changed if
  756.    another file already has the same name.  When you RESEND the same file
  757.    after a failure, C-Kermit will probably try to append the re-sent portion
  758.    to the wrong file.
  759.  
  760.  . Assuming that you get RESEND to work with FILE COLLISION RENAME, C-Kermit,
  761.    when receiving the remainder of the file during a RESEND operation, will
  762.    report back the wrong name.  Nothing can be done about this because the
  763.    name is reported back before the receiving Kermit program finds out that
  764.    it is a recovery operation.
  765.  
  766. Also watch out for DISABLE DELETE, since this implicitly sets FILE COLLISION
  767. RENAME.  And note tht DELETE is DISABLEd automatically any time you Kermit
  768. is in local mode (i.e. it makes a connection).  Also note that for purposes
  769. of DISABLE and ENABLE, "set host *" connections do not count as local mode
  770. even though, strictly speaking, they are.
  771.  
  772. When using ADD SEND-LIST and entering a wildcard in the list, there is no way
  773. to specify "automatic switching" -- the file type still must be text or
  774. binary.  To work around, use regular expressions to create separate wildcards
  775. for the text and binary files.
  776.  
  777. Automatic directory creation for received files does not work for pathnames
  778. given in the "-a" command-line argument.
  779.  
  780. There are no command-line arguments for "set file names { literal, converted }"
  781. or "set { send, receive } pathnames { on, off }", but you can include these
  782. (or any other) commands on the command line in the -C option string.
  783.  
  784. When referring to MS-DOS, Windows, Atari ST, OS/2, or other file
  785. specifications that contain backslash characters in a C-Kermit command, you
  786. might have to double each backslash, for example:
  787.  
  788.   C-Kermit>get c:\\directory\\foo.txt
  789.  
  790. This is because backslash is used in C-Kermit commands for introducing special
  791. character codes, variables, functions, etc.  If you are sending this GET
  792. command to another copy of C-Kermit running as a server, for example on OS/2
  793. or the Atari ST, it too treats backslashes as prefix characters, so you will
  794. need 4 (yes, 4) copies of each backslash:
  795.  
  796.   C-Kermit>get c:\\\\directory\\\\foo.txt
  797.  
  798. But read about SET COMMAND QUOTING OFF in the manual.
  799.  
  800. ANOTHER NOTE: In Kermit 95, this restriction is lifted as far as referring
  801. to files on the local PC.  You can now refer to these files using natural PC
  802. notation, e.g.
  803.  
  804.   C-Kermit>send c:\letters\oofa.txt
  805.  
  806. in any command field that knowingly parses a filename.
  807.  
  808. Attempting to cancel local-mode file reception at a very early stage (i.e.
  809. before data packets are exchanged) with X or Z does not work.  Workarounds:
  810. Use E or Ctrl-C instead, or wait until the first data packets are sent.
  811.  
  812. If you cancel a transfer that is underway using X or Z, and a lot of window
  813. slots are in use, it might take a long time for the cancellation to take
  814. effect, especially if you do this on the receiving end; that's because a lot
  815. of packets might already be on their way to you.  In that case, just be
  816. patient and let Kermit "drain" them.
  817.  
  818. If C-Kermit is sending a file, remote-mode packet-mode breakout (Ctrl-C Ctrl-C
  819. by default) is not effective until after C-Kermit sends its first packet.  If
  820. C-Kermit is receiving a file or is in server mode, it will be effective right
  821. away.  In the former case, the SET DELAY value determines the earliest time at
  822. which you can break out of packet mode.
  823.  
  824. Some communication programs have errors in their implementation of Kermit
  825. attribute packets.  If you get an error message from your communication
  826. program like "Attribute error", tell C-Kermit to SET ATTRIBUTES OFF.  Better
  827. yet, switch to a real Kermit program, such as MS-DOS Kermit.
  828.  
  829. When using C-Kermit to transfer files with the HP48SX calculator, you must
  830. SET FLOW NONE.  The HP48SX does not support flow control, and evidently also
  831. becomes confused if you attempt to use it.  You might also need to use
  832. SET SEND PAUSE 100 (or other number).
  833.  
  834. The fullscreen file transfer display will not work right if your terminal type
  835. is set incorrectly, or is not known to the host operating system.  Even when
  836. it does work, it might slow down your file transfers a bit, especially on
  837. high-speed network connections.  On certain small computers, it has been
  838. reported to cause increased disk activity due to swapping or paging.  The
  839. fullscreen display is not particularly useful with speaking or Braille devices.
  840. In these cases, use SET FILE DISPLAY CRT or SET FILE DISPLAY SERIAL.
  841.  
  842. If you have trouble transferring files over a TCP/IP connection, give the
  843. command:
  844.  
  845.   SET PARITY SPACE
  846.  
  847. and try again.  If that doesn't work, also try a shorter packet length.
  848.  
  849. On the other hand, if file transfers through a TCP/IP connection work, but are
  850. very slow, use a longer packet length, 2000 or more, and also try increasing
  851. the window size.  Also, make sure FLOW is NONE since TCP/IP handles flow
  852. control itself, and XON/XOFF processing only slows things down.
  853.  
  854. Some communication software claims to implement sliding windows, but does so
  855. incorrectly.  If sliding window transfers fail, set C-Kermit's window size to
  856. the smallest one that works, for example:
  857.  
  858.   SET WINDOW 1
  859.  
  860. The UNIX version of C-Kermit discards carriage returns when receiving files
  861. in text mode.  Thus, "bare" carriage returns (sometimes used to achieve
  862. overstriking) are lost.
  863.  
  864. SET FILE COLLISION BACKUP is the default.  This means:
  865.  
  866.  - If you send the same file lots of times, there will be many backup files.
  867.    There is no automatic mechanism within Kermit to delete them, no notion of
  868.    a "version retention count", etc, but you can use the PURGE command to
  869.    clean them up.
  870.  
  871.  - If a file arrives that has the same name as a directory, the file transfer
  872.    fails because Kermit will not rename a directory.  Send the file with
  873.    another name, or use SET FILE COLLISION RENAME.
  874.  
  875.  - If the directory lacks write permission, the file transfer fails even if
  876.    you have write access to the file that is being backed up; in that case,
  877.    switch to SET FILE COLLISION OVERWRITE or APPEND, or send to a different
  878.    directory.
  879.  
  880. SET FILE COLLISION UPDATE depends on the date/time stamp in the attribute
  881. packet.  However, this is recorded in local time, not Universal Time (GMT),
  882. and there is no indication of time zone.  The time is expressed to the
  883. precision of 1 second, but some file systems do not record with this precision
  884. -- for example, MS-DOS records the file date/time only to the nearest 2
  885. seconds.  This might cause update operations to send more files than
  886. necessary.
  887.  
  888. (This paragraph does NOT apply to UNIX, where, as of C-Kermit 6.1, C-Kermit
  889. pipes incoming mail and print material directly the mail or print program):
  890. When C-Kermit is receiving files from another Kermit program that has been
  891. given the MAIL or REMOTE PRINT command, C-Kermit follows the current filename
  892. collision action.  This can be disconcerting if the action was (for example)
  893. BACKUP, because the existing file will be renamed, and the new file will be
  894. mailed (or printed) and then deleted.  Kermit cannot temporarily change to
  895. RENAME because the file collision action occurs when the filename packet is
  896. received, and the PRINT or MAIL disposition only comes later, in the Attribute
  897. packet.
  898.  
  899. Execution of multiple file transfers by C-Kermit from a command file when
  900. in remote mode might exhibit long delays between each transfer.  To avoid
  901. this, just include the command "SET DELAY 0" in your command file before any
  902. of the file-transfer commands.
  903.  
  904.  
  905. (13) SCRIPT PROGRAMMING
  906.  
  907. 13.1. Comments Versus the SCRIPT Command
  908.  
  909. Remember that ";" and "#" introduce comments when (a) they are the first
  910. character on the line, or (b) they are preceded by at least one blank or
  911. tab within a line.  Thus constructions like:
  912.  
  913.   INPUT 5 ;
  914.   SCRIPT ~0 #--#--#
  915.  
  916. must be coded using backslash notation to keep the data from being ignored:
  917.  
  918.   INPUT 5 \59            ; 59 is the decimal ASCII code for ";"
  919.   SCRIPT ~0 \35--#--#        ; 43 is the decimal ASCII code for "#"
  920.  
  921. or, more simply:
  922.  
  923.   INPUT 5 \;                    ; Just quote the semicolon
  924.   SCRIPT ~0 \#--#--#            ; Just quote the "#"
  925.  
  926. 13.2. Alphabetic Case and the INPUT Command
  927.  
  928. INPUT and REINPUT caseless string comparisons do not work for non-ASCII
  929. (international) characters.  Workaround: SET INPUT CASE OBSERVE.  Even then,
  930. the "lexically less than" and "lexically greater than" operations (IF LLT, IF
  931. LGT) probably won't work as expected.  The same is true for the
  932. case-conversion functions \Flower() and \Fupper().  C-Kermit does not know the
  933. collating sequence for different character sets and languages.  (On the other
  934. hand, it might work depending on such items as how Kermit was linked, whether
  935. your operating supports "locales", etc)
  936.  
  937. 13.3. NUL (0) Characters in C-Kermit Commands
  938.  
  939. You can't include a NUL character (\0) in C-Kermit command text without
  940. terminating the character string in which it appears.  For example:
  941.  
  942.   echo In these brackets [\0] is a NUL
  943.  
  944. will echo "In these brackets [".  This applies to ECHO, INPUT, OUTPUT, and all
  945. other commands (but you can represent NUL by "\N" in an OUTPUT string).  This
  946. is because C-language strings are terminated internally by the NUL character,
  947. and it allows all of C-Kermit's string comparison and manipulation functions
  948. to work in the normal "C" way.
  949.  
  950. To illustrate:
  951.   INPUT 5 \0
  952. is equivalent to:
  953.   INPUT 5
  954. and:
  955.   INPUT 5 ABC\0DEF
  956. is equivalent to:
  957.   INPUT 5 ABC
  958.  
  959. INPUT operations discard and ignore NUL characters that arrive from the
  960. communication device, meaning that they do not figure into matching operations
  961. (e.g. A<NUL>B matches AB); they are not deposited in the INPUT buffer
  962. (\v(input)); and they are not counted in \v(incount), with two exceptions:
  963.  
  964.   1. An arriving NUL character restarts the INPUT SILENCE timer.
  965.  
  966.   2. An arriving NUL character terminates the INPUT command with the
  967.      SUCCESS condition if the INPUT command was given an empty search
  968.      string.  In this case \v(incount) is set to 1.
  969.  
  970. Also, the \v(inchar) variable is null (completely empty) if the last INPUT
  971. character was NUL.  That is, there is no way to tell only by looking at
  972. \v(inchar) the difference between a NUL that was INPUT and no INPUT at all.
  973. If the INPUT command succeeded but \v(inchar) is empty, then a NUL character
  974. was input.  Also, \v(incount) will be set to 1.
  975.  
  976. \v(incount) and \v(inchar) are NOT affected by the CLEAR command.
  977.  
  978. 13.4. \ffiles() and \fnextfile() Peculiarities
  979.  
  980. The following script program:
  981.  
  982.   for \%i 1 \ffiles(oofa.*) 1 {
  983.       send \fnextfile()
  984.   }
  985.  
  986. did not work as expected in C-Kermit 6.0 and earlier but does work in
  987. C-Kermit 6.1 and later.
  988.  
  989. 13.5. Commands That Have Only Local Effect
  990.  
  991. Certain settings are local to each command level, meaning that subordinate
  992. command levels (macros or command files) can change them without affecting
  993. their values at higher command levels.  When a new command level is invoked,
  994. the value is inherited from the previous level.  These settings are:
  995.  
  996.   CASE
  997.   COUNT and \v(count)
  998.   INPUT CASE
  999.   INPUT TIMEOUT
  1000.   MACRO ERROR
  1001.   TAKE ERROR
  1002.  
  1003. This arrangement allows CASE, TIMEOUT, and ERROR settings, which are used to
  1004. control automatic exit from a command file or macro upon error, to be
  1005. automatically restored when the command file or macro exits.
  1006.  
  1007. The COUNT variable follows this rule too, which permits nested SET COUNT /
  1008. IF COUNT loops, as in this example in which the inner loop counts down from
  1009. the current COUNT value of the outer loop (try it):
  1010.  
  1011.   DEFINE INNER WHILE COUNT { WRITE SCREEN {   Inner:}, SHOW COUNT }
  1012.   SET COUNT 5
  1013.   WHILE COUNT { WRITE SCREEN Outer:, SHOW COUNT, DO INNER }
  1014.  
  1015. Keep in mind that an inferior command level cannot manipulate the COUNT
  1016. value held by a higher level.  For example:
  1017.  
  1018.   DEFINE OOFA SHOW COUNT, IF COUNT GOTO LOOP
  1019.   SET COUNT 5
  1020.   :LOOP
  1021.   OOFA
  1022.   ECHO Done
  1023.  
  1024. results in an infinite loop; the COUNT value remains at 5 because it is never
  1025. decremented at the same level at which it was set.
  1026.  
  1027. NOTE: "WHILE COUNT" did not work prior to edit 095 of ckuusr.c, 19 Jan 93.
  1028.  
  1029. 13.6. Literal Braces in Function Calls
  1030.  
  1031. Since braces are used in function calls to indicate grouping, there is no way
  1032. to pass literal braces to the function itself.  Solution: Define a variable
  1033. containing the string that has braces.  Example:
  1034.  
  1035.   define \%a ab{cd
  1036.   echo \fsubstring(\%a)
  1037.   ab{cd
  1038.  
  1039. If the string is to start with a leading brace and end with a closing brace,
  1040. then double braces must appear around the string (which itself is enclosed in
  1041. braces):
  1042.  
  1043.   define \%a {{{foo}}}
  1044.   echo \fsubstring(\%a)
  1045.   {foo}
  1046.  
  1047. This also works for any other kind of string:
  1048.  
  1049.   define \%a {{ab{cd}}
  1050.   echo \fsubstring(\%a)
  1051.   ab{cd
  1052.  
  1053. 13.7. Defining Variables on the C-Kermit Command Line
  1054.  
  1055. To define variables on the C-Kermit command line, use the -C command-line
  1056. option with one or more DEFINE or ASSIGN commands.  Note that the C-Kermit
  1057. command line must cope with the quoting rules of your shell.  Examples:
  1058.  
  1059.   kermit -C "define \\%a foo, define phonenumber 7654321"
  1060.  
  1061. In this case we follow UNIX quoting rules by doubling the backslash.  Once
  1062. C-Kermit starts, the \%a and \m(phonenumber) variables are defined as
  1063. indicated and can be used in the normal way.
  1064.  
  1065. In DOS or Windows or OS/2 the command would be:
  1066.  
  1067.   kermit -C "define \%%a foo, define phonenumber 7654321"
  1068.  
  1069. Here we need to double the percent sign rather than the backslash because
  1070. of DOS shell quoting rules.
  1071.  
  1072. 13.8. Per-Character Echo Check with the OUTPUT Command
  1073.  
  1074. Sometimes the OUTPUT command must be used to send commands or data to a device
  1075. in "echoplex" mode, meaning that characters must be sent one at a time, and
  1076. the next character can not be sent until the echo from the previous one has
  1077. been received.  For example, a certain PBX might have this characteristic.
  1078. Let's say a Kermit script is used to program the PBX.  If characters are sent
  1079. too fast, they can be lost.  It would seem that the command:
  1080.  
  1081.   SET OUTPUT PACING <milliseconds>
  1082.  
  1083. could be used to take care of this, but the pacing interval is constant and
  1084. must be set large enough to allow even the slowest echo to finish.  If the
  1085. script is large (an actual example is 14,000 lines long), this can cause it
  1086. to take hours longer than it needs to.
  1087.  
  1088. Here is a macro you can use to OUTPUT a string in an Echoplex environment:
  1089.  
  1090.   define XOUTPUT {
  1091.       local \%c \%i
  1092.       set output pacing 0
  1093.       for \%i 1 \flen(\%*) 1 {
  1094.       asg \%c \fsubstr(\%*,\%i,1)
  1095.           output \%c
  1096.       input 2 \%c
  1097.       }
  1098.   }
  1099.  
  1100. C-Kermit 7.0 or later is required.
  1101.  
  1102. It sends one character at a time and then waits up to 2 seconds for the
  1103. character to be echoed back, but continues to the next character as soon
  1104. as the echo appears, so no time is wasted.  You can add an IF FAIL clause
  1105. after the INPUT in case you want to do something special about failure
  1106. to detect an echo within the timeout period.  Obviously you can also change
  1107. the 2-second limit, and adjust the script in any other desired way.
  1108.  
  1109. 13.9. Other...
  1110.  
  1111. Escape sequences (or any strings that contain control characters) can't be
  1112. used as labels, GOTO targets, or SWITCH cases.
  1113.  
  1114. (End of CKCBWR.TXT)
  1115.