home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / k95source / dialing.ipf < prev    next >
Text File  |  2020-01-01  |  73KB  |  1,780 lines
  1. :userdoc.
  2. :title.C-Kermit's Dialing Directory
  3. :docprof toc=12345.
  4. :h1 id=preface.Preface
  5.   ---   PREPUBLICATION OUTLINE/DRAFT   ---
  6. :p.
  7.   Copyright (C) 1995, Frank da Cruz and Christine M. Gianone,
  8. .br
  9.   All rights reserved.
  10. :p.
  11. Most recent update&colon. Sun Jan 28 13&colon.34&colon.02 1996
  12. :p.
  13. :hp4.
  14. THIS IS AN UPDATE TO CHAPTER 3, "GETTING CONNECTED", OF "USING C-KERMIT",
  15. AND A SUPPLEMENT TO THE "KERMIT 95" MANUAL.
  16. :ehp4.
  17. :p.
  18. :h1 id=note.Important Notes to Users of Kermit 95 and Kermit/2
  19. This file describes the dialing mechanisms that are invoked by the
  20. the point-and-click K-95 Dialer.  If the Dialer works satisfactorily
  21. for you, you should not have to read this file unless you are curious
  22. about what's going on behind the scenes.  Also, please be aware of the
  23. distinction between the K-95 Dialer, which has its own database of
  24. connections, and Kermit's dialing and network directory files, which are
  25. simply "phone lists" or "address lists", some of which are used by the
  26. Dialer, and others are furnished for your reference.
  27. :p.
  28. When a K-95 Dialer dialup entry (telephone icon) has a "phone number" that
  29. starts with a letter (rather than a digit or a plus sign), that means that
  30. it will be looked up in the specified Kermit dialing directory file(s) and
  31. replaced by the phone number(s) found there.  This is normally done when
  32. we have more than one phone number for the same service.  For example, we
  33. have over 1400 numbers for Tymnet, and so the "Tymnet" entry builds a list
  34. of all the numbers and tries them (normally) in "cheapest-first" order
  35. until one of them answers.  This file contains the details of how it all
  36. works.
  37. :h1 id=dirfiles.Dialing Directory Files
  38. Kermit's dialing directory is a plain-text file that associates names with
  39. phone numbers, allowing you to dial by name so you don't have to remember
  40. specific numbers.  For example, you can type "dial mcimail" rather than
  41. "dial 18004566245".
  42. :p.
  43. This file can be maintained by a text editor that reads and saves plain-text
  44. files in plain-text (ASCII) format, such as Windows EDIT or WordPad.
  45.  
  46. :h1 id=notation.Notation
  47.  
  48. The following notation is used in this document&colon.
  49. :xmp.
  50. :font facename=Courier size=10x8.
  51. <xxxx> = parameter to be replaced by a real value (number, filename, etc)
  52. [    ] = items inside brackets are optional, e.g. [ <number> ]
  53. {    } = encloses a comma-separated list of options, e.g. { ON, OFF }
  54. :font facename=default size=0x0.
  55. :exmp.
  56.  
  57. :h1 id=dirformat.Dialing Directory Format
  58.  
  59. Each entry consists of a name followed by a telephone number, followed by an
  60. optional comment.  The name is a "word" that does not contain any spaces(*);
  61. alphabetic case distinctions in names are ignored.  The number can be in any
  62. format at all that is acceptable to your dialout modem, meaning, in most
  63. cases, it can include spaces and/or certain punctuation.  The comment, if any,
  64. begins with a semicolon preceded by at least one space or tab.
  65. :xmp.
  66. :font facename=Courier size=10x8.
  67. IBM       +1 (800) 874 2881    ; IBM BBS
  68. Hayes      1 800 874-2937      ; Hayes Online BBS
  69. DJNR       1 212 7418100       ; Dow Jones News Retrieval via NYC Sprint
  70. DECstore   18002341998         ; Digital Equipment Corporation store
  71. Heise      011 49 511 5352301  ; Verlag Heinz Heise c't BBS, Germany
  72. :font facename=default size=0x0.
  73. :exmp.
  74. :p.
  75. (*) A name may contain spaces if it is surrounded by braces, for example&colon.
  76. :xmp.
  77. :font facename=Courier size=10x8.
  78. {Heise MailBox}   011 49 511 5352301
  79. :font facename=default size=0x0.
  80. :exmp.
  81. :p.
  82. Full-line comments may also be entered.  These begin with a semicolon.  Blank
  83. lines in the dialing directory are ignored.
  84.  
  85. :h1 id=portable.Portable and Literal Entries
  86.  
  87. Each entry can "portable" or "literal".  In portable entries, phone numbers
  88. start with a plus sign (+), as in the first entry in the sample directory
  89. above.  The advantage of a portable-mode entry is that the same entry can be
  90. used from different locations -- the drawback is that it in order to use it,
  91. you must first tell Kermit where you are (usually just two commands).
  92. :p.
  93. The advantage of literal mode is that it is very easy to use.  When you use
  94. the directory in this way, the number is dialed exactly as given in the
  95. directory and you need not be concerned with any of the locale-related
  96. features described below.  Literal mode is perfectly adequate for
  97. directories that are always used from the same place.
  98.  
  99. :h1 id=whynot.Why You Might Not Want to Use Literal Mode
  100.  
  101. The problem with literal mode is that if you are going to be using the same
  102. dialing directory to call the same number from different locations, you'll
  103. need multiple entries.  For example, for the Dow Jones / Sprint number&colon.
  104. :xmp.
  105. :font facename=Courier size=10x8.
  106. DJNRNYC     741 8100               ; From within NYC
  107. DJNRNYCPBX  9,741 8100             ; From a PBX in NYC
  108. DJNRNA      1 212 741 8100         ; From elsewhere in North America
  109. DJNRNAPBX   93,1 212 741 8100      ; From a different PBX outside NYC
  110. DJNRUK      00 1 212 741 8100      ; From the UK
  111. DJNRUKHR    102 00 1 212 741 8100  ; From a hotel room in the UK
  112. :font facename=default size=0x0.
  113. :exmp.
  114. :p.
  115. Thus you'll have to remember which name depending on where you are calling
  116. from.  Or else you will need multiple dialing directories, one for each place
  117. that you call from, which becomes problematic when numbers change.
  118.  
  119. :h1 id=portmode.Portable Mode
  120.  
  121. Portable mode is for people who travel, or for dialing directories that are
  122. to be distributed to and used from diverse locations, such as the sample
  123. dialing directory that you received with Kermit.
  124. :p.
  125. By entering the phone number in a specific format, and providing some
  126. additional "locale" information, you enable Kermit to figure out, in most
  127. cases, whether a call is internal, local, toll-free, long-distance, or
  128. international, and then dial it in the appropriate way automatically.
  129. :p.
  130. The format for a portable entry is&colon.
  131. :xmp.
  132. :font facename=Courier size=10x8.
  133. + <country-code> ( <area-code> ) <local-number>
  134. :font facename=default size=0x0.
  135. :exmp.
  136. :p.
  137. For example&colon.
  138. :xmp.
  139. :font facename=Courier size=10x8.
  140. IBM        +1 (800) 874 2881    ; IBM BBS
  141. Hayes      +1 (800) 874 2937    ; Hayes Online BBS
  142. DJNR       +1 (212) 741 8100    ; Dow Jones News Retrieval NYC
  143. DECstore   +1 (800) 234 1998    ; Digital Equipment Corporation store
  144. Heise     +49 (511) 535 2301    ; Verlag Heinz Heise c't BBS, Germany
  145. :font facename=default size=0x0.
  146. :exmp.
  147. :p.
  148. The plus sign (+) means two things.  First, it means that the phone number is
  149. in a standard format that Kermit can parse.  Second, it means that the digits
  150. between the plus sign and the opening parenthesis are a country code.  And
  151. then&colon.
  152. :ul.
  153. :li.The number in parentheses is the area code within the country.
  154. :li.The number following the number in parentheses is the local number
  155. within the area.
  156. :li.The plus sign and parentheses are discarded before passing the number
  157. to the modem.
  158. :eul.
  159. :p.
  160. The use of punctuation characters other than plus sign, parentheses, and space
  161. is not recommended unless you know what you are doing, nor is the use of
  162. characters other than digits in the phone number.  Such characters are passed
  163. to the modem literally, so the result depends on your modem.  For example,
  164. most Hayes and compatible modems ignore hyphens and periods in phone numbers,
  165. so the following notation works with Hayes modems, but might not work with
  166. other kinds&colon.
  167. :xmp.
  168. :font facename=Courier size=10x8.
  169. +1 (212) 555-1212  ; Phone number contains hyphen
  170. +1 (212) 555.1212  ; Phone number contains period
  171. :font facename=default size=0x0.
  172. :exmp.
  173.  
  174. :h1 id=mixedmode.Mixed-Mode Directories
  175.  
  176. You can mix literal- and portable-mode entries in the same directory.  Each
  177. entry is treated individually, depending on whether it starts with a plus
  178. sign.
  179.  
  180. :h1 id=mentries.Multiple Entries
  181.  
  182. If you have multiple entries with the same name, then each such entry is tried
  183. until the phone is answered successfully or until no more entries remain.
  184. These entries need not be adjacent, thus the directory can be sorted and
  185. shuffled any way you like.
  186. :p.
  187. Entry names can be abbreviated in the DIAL command, as long as there are no
  188. entries in the dialing directory that start with the same abbreviation but
  189. which are different from each other.  For example, if your directory has
  190. entries with the following names&colon.
  191. :xmp.
  192. :font facename=Courier size=10x8.
  193. aardvark
  194. abba
  195. abccorp
  196. abdicate
  197. abccorp
  198. acorn
  199. :font facename=default size=0x0.
  200. :exmp.
  201. :p.
  202. then "abc" would select the two "abccorp" entries, but "ab" would be
  203. ambiguous and the lookup would fail.
  204.  
  205. :h1 id=mdirs.Multiple Directories
  206.  
  207. You can have more than one dialing directory active at once.  If you specify a
  208. list of dialing directory files, Kermit searches through all of them looking
  209. for matching entries when building up its list of numbers to dial.
  210. :p.
  211. On LANs or computers that are shared by multiple users, it might be
  212. desirable to have one central dialing directory shared by all users, another
  213. shared by users within a particular group, another in each user's home
  214. directory, and still another in each directory the user might CD to (just
  215. one of many possible setups).
  216.  
  217. :h1 id=orderof.Order Of Dialing
  218.  
  219. After Kermit builds up its list of numbers to dial, it sorts them into
  220. six categories, which are supposed to be (but obviously cannot be guaranteed
  221. to be) "cheapest first"&colon.
  222. :xmp.
  223. :font facename=Courier size=10x8.
  224. Internal PBX   (0)
  225. Toll-Free      (1)
  226. Local          (2)
  227. Literal        (3)
  228. Long-Distance  (4)
  229. International  (5)
  230. :font facename=default size=0x0.
  231. :exmp.
  232. :p.
  233. and dials them in that order (the category numbers are displayed by Kermit
  234. when you give a LOOKUP command).  No sorting is done within each category.
  235. Literal numbers are those that do not begin with "+" in the dialing directory,
  236. and therefore can't be categorized.
  237. :p.
  238. In some cases, this sorting might produce unwanted effects -- e.g. when a
  239. toll-free number actually results in higher charges to you than (say) a local
  240. call, or when literal numbers (whose "geography" can't be recognized by
  241. Kermit) don't fall where you want them to, or when a long-distance call is
  242. actually cheaper than a local call.  In such cases, you can inhibit
  243. sorting and force Kermit to dial the numbers in the same order in which they
  244. are encountered with the command&colon.
  245. :p.
  246. :hp4.SET DIAL SORT { OFF, ON }:ehp4.
  247. .br
  248. :lm margin=3.
  249. OFF inhibits sorting, ON (the default) enables it.
  250. :lm margin=1.
  251. :p.
  252. You also have another control.  In the general case, when there are lots of
  253. numbers for a particular entry that range from local to international, you
  254. can put a cap on how "far" Kermit is allowed to dial&colon.
  255. :p.
  256. :hp4.SET DIAL RESTRICT { INTERNATIONAL, LOCAL, LONG-DISTANCE, NONE }:ehp4.
  257. .br
  258. :lm margin=3.
  259. INTERNATIONAL means that international calls are restricted, i.e. not
  260. allowed.  LONG-DISTANCE means that long-distance and international
  261. calls are restricted.  LOCAL means all calls except internal PBX calls
  262. are restricted.  NONE is the default, meaning that all calls are allowed.
  263. .br
  264. :hp8.
  265. NOTE&colon. This command has nothing to do with your phone -- telephones may or
  266. may not have their own restrictions, which are independent of Kermit's.
  267. :ehp8.
  268. :lm margin=1.
  269. :p.
  270. Use the LOOKUP command to check the sort order to see whether you might
  271. want to SET DIAL SORT OFF before calling a particular destination from a
  272. particular location.
  273.  
  274. :h1 id=using.Using the Dialing Directory
  275.  
  276. There are three basic commands for setting up and using a dialing directory&colon.
  277. :p.
  278. :hp4.
  279. SET DIAL DIRECTORY [ <file1> [ <file2> [ <file3> [ ... ] ] ] ]
  280. :ehp4.
  281. .br
  282. :lm margin=3.
  283. Selects zero, one, or more dialing directories.  If you do not include any
  284. filenames, then the dialing directory feature is disabled and phone numbers
  285. must be given directly to the DIAL command.  If you include one or more
  286. filenames, then the DIAL command looks in each file and collects all the
  287. matching entries, if any, prior to dialing.
  288. :lm margin=1.
  289. :p.
  290. When you give a SET DIAL DIRECTORY command, specifying a filename, Kermit
  291. tries to find the file in the normal way.  If it can't find the file, then, if
  292. the filename that you gave was not "absolute" -- that is, it did not include a
  293. full path specification -- then Kermit looks in either your home directory or
  294. your Kermit software installation area, depending on the operating system.  In
  295. OS/2, it looks in the CKERMIT directory.  In Windows NT or Windows 95, it
  296. looks in the PHONES subdirectory of the Kermit 95 directory.
  297. :p.
  298. So, for example, in Windows 95, if your Kermit 95 directory is D&colon.\K95, then
  299. your dialing directory (phonelist) files go in D&colon.\K95\PHONES, and you can give
  300. SET DIAL DIRECTORY commands for them by name only, no matter what your current
  301. directory is&colon.
  302. :xmp.
  303. :font facename=Courier size=10x8.
  304. [C&colon.\TMP] K-95> :hp4.set dial directory oofa.kdd:ehp4.
  305. :font facename=default size=0x0.
  306. :exmp.
  307. :p.
  308. Of course, you can also specify a full path name.
  309. :p.
  310. If you installed C-Kermit according to instructions and you are using the
  311. standard initialization file (*), then the default dialing directory name is&colon.
  312. :xmp.
  313. :font facename=Courier size=10x8.
  314. &period.kdd        (UNIX, OS-9)
  315. CKERMIT.KDD (elsewhere)(*)
  316. :font facename=default size=0x0.
  317. :exmp.
  318. :p.
  319. and if such a file exists, it it used.  In the absence of an initialization
  320. file, C-Kermit uses the file(s) given by the environment variable
  321. K_DIAL_DIRECTORY, if it is defined, for example (in UNIX ksh)&colon.
  322. :xmp.
  323. :font facename=Courier size=10x8.
  324. export K_DIAL_DIRECTORY="/usr/share/lib/kermit/ckermit.kdd  $HOME/.kdd"
  325. :font facename=default size=0x0.
  326. :exmp.
  327. :p.
  328. In this example, which might be added to the system-wide login profile on
  329. a multiuser UNIX computer, sets up two dialing directories&colon. the first is a
  330. corporate-wide directory, centrally administered and shared by everyone,
  331. and the second is a personal dialing directory in each user's home directory.
  332. A similar technique might be useful on a corporate PC-based LAN, where the
  333. corporate-wide directory would be placed on the file server, and the user's
  334. directory on her or his own disk; the LAN login procedure would then set up
  335. the environment variable.
  336. :p.
  337. (*) The concept of "initialization file" is less important in Kermit 95,
  338. because the graphical Dialer sets everything up for you.  In Kermit 95,
  339. the dialing directory file(s) is/are specified in the File menu, and
  340. there are several of them.
  341. :p.
  342. :hp4.
  343. LOOKUP <name>
  344. :ehp4.
  345. .br
  346. :lm margin=3.
  347. Looks up the <name> in your dialing directory or directories, and displays
  348. the entries, if any, that match.  If any matching entries are found, then
  349. the <name> becomes the default name for the next DIAL command.
  350. :lm margin=1.
  351. :p.
  352. :hp4.
  353. DIAL [ <text> ]
  354. :ehp4.
  355. .br
  356. :lm margin=3.
  357. Dials a phone call.  If the <text> is omitted, then the name, if any, from
  358. the most recent DIAL command or successful LOOKUP command becomes the
  359. <text>.  Then&colon.
  360. :ul.
  361. :li.If the name does not begin with a letter, it is not looked up in the
  362. dialing directory / directories.
  363. :li.If the name begins with an equals sign ("="), the equals sign is
  364. discarded (the <text> becomes the part after the equals sign) and the
  365. name is not looked up in the dialing directory/ies, even if it does
  366. begin with a letter.
  367. :li.If the original name began with a letter, and if one or more dialing
  368. directories have been specified, the <text> is looked up.  If it is
  369. found, it is replaced by one or more phone numbers; if the <text> is
  370. not found, then it becomes the phone number.
  371. :li.If the phone number (as given, or as found in the dialing directory) does
  372. not start with "+", it is sent as-is to the modem.
  373. :li.If the phone number starts with "+", it is converted to the appropriate
  374. form before dialing.
  375. :eul.
  376. :p.
  377. If <text> is found more than once in the directory (or directories), then each
  378. number listed under <text> is dialed until one answers.
  379. :p.
  380. If the DIAL command is successful, then&colon.
  381. :ul.
  382. :li.If it was given directly from the Kermit command prompt, Kermit enters
  383. terminal emulation (CONNECT mode) automatically.
  384. :li.If the DIAL command was executed from a command file or macro, Kermit
  385. does not enter CONNECT mode automatically, but rather, reads and executes
  386. the next command, if any, from the command file or macro definition or,
  387. if there are no more commands left in the command file or macro
  388. definition, Kermit returns to its command prompt.
  389. :eul.
  390. :lm margin=1.
  391. :p.
  392. You can modify this behavior if you want to with the command&colon.
  393. :p.
  394. :hp4.
  395. SET DIAL CONNECT { ON, OFF, AUTO }
  396. :ehp4.
  397. .br
  398. :lm margin=3.
  399. Tells Kermit whether to CONNECT automatically after successful dialing.
  400. AUTO (the default) means do so only if DIAL command was given from top
  401. level, i.e. not from a macro or command file.  ON means always CONNECT
  402. automatically after successful dialing; OFF means never CONNECT
  403. automatically.
  404. :lm margin=1.
  405. :p.
  406. The next two commands make it easy to dial repeatedly&colon.
  407. :p.
  408. :hp4.
  409. SET DIAL RETRIES <number>
  410. :ehp4.
  411. .br
  412. :lm margin=3.
  413. Tells Kermit to make up to <number> tries to dial the number again if the
  414. original call fails (the default is 0).  When multiple numbers for the same
  415. name have been fetched from the dialing directory, the entire sequence is
  416. retried <number> times.  Retries are not done if there is an unrecoverable
  417. error, but they are done if there is a busy signal, no answer, etc.
  418. :lm margin=1.
  419. :p.
  420. :hp4.
  421. SET DIAL INTERVAL <seconds>
  422. :ehp4.
  423. .br
  424. :lm margin=3.
  425. How many seconds to pause between dial retries.  The default interval
  426. is 10 seconds.  This interval applies when retrying the same number or
  427. group, but not between multiple entries in a group because in that case,
  428. presumably, each number is different so there is no reason to pause.
  429. :lm margin=1.
  430. :p.
  431. :hp8.
  432. IMPORTANT&colon. THE LAWS OF MANY COUNTRIES PROHIBIT AUTOMATIC REDIALING, or
  433. restrict the intervals at which and/or number of times a call can be redialed.
  434. Do not use Kermit's automatic redial feature in any way that is against the
  435. your local laws.
  436. :ehp8.
  437. :p.
  438. Several other commands that control dialing, but are not related to dialing
  439. directory, are presented here for completeness&colon.
  440. :p.
  441. :hp4.
  442. ANSWER [ <timeout> ]
  443. :ehp4.
  444. .br
  445. :lm margin=3.
  446. Answer an incoming call.  If a <timeout> value is given, it specifies the
  447. number of seconds to wait for the call to come in.  If a <timeout> is not
  448. given, Kermit is to wait forever, or until interrupted.
  449. :lm margin=1.
  450. :p.
  451. :hp4.
  452. SET DIAL METHOD { DEFAULT, PULSE, TONE }
  453. :ehp4.
  454. .br
  455. :lm margin=3.
  456. Specifies pulse or tone dialing.  The default is, of course, DEFAULT,
  457. meaning don't tell the modem which method to use, i.e.  the modem should
  458. use its default dialing method.
  459. :p.
  460. Note that pulse dialing is not available in many areas, which is why tone
  461. dialing is not the default method.  However, pulse dialing is not the default
  462. method either, because the extra telephone keys "*" and "#" cannot be dialed
  463. on a non-tone telephone line.
  464. :p.
  465. Hence we expect the modem to already be configured to use the appropriate type
  466. of dialing.  In case it is not, errors can result.  For example, if you try to
  467. send "*70" to the modem to disable call waiting, but the modem is configured
  468. for pulse dialing, this will usually result in a modem command error.
  469. :lm margin=1.
  470. :p.
  471. :hp4.
  472. SET DIAL HANGUP { ON, OFF }
  473. :ehp4.
  474. .br
  475. :lm margin=3.
  476. Normally, Kermit hangs up the phone when you give a DIAL or ANSWER
  477. command, on the assumption that if you are going to dial a phone
  478. number, you want to be sure that any previous connection is hung up.
  479. In cases where that assumption is incorrect, or when the very act of
  480. hanging up causes problems, you can SET DIAL HANGUP OFF.
  481. :lm margin=1.
  482. :p.
  483. :hp4.
  484. SET DIAL TIMEOUT <seconds> [ <differential> ]
  485. :ehp4.
  486. .br
  487. :lm margin=3.
  488. The dial timeout is the number of seconds that Kermit waits to get back
  489. a response from the modem telling whether a call succeeded or failed.
  490. Normally Kermit figures this out itself, but you can use this command to
  491. give your own timeout interval.  0 means Kermit decides.  The differential,
  492. if given, is the number of seconds between when the modem is supposed to
  493. time out and report NO CARRIER (or whatever), and when Kermit itself
  494. times out in case the modem does not respond at all; the default
  495. differential is 10 seconds.  Adjust the differential only if the default
  496. causes problems for you.
  497. :lm margin=1.
  498. :p.
  499. You can display these and all other DIAL-related settings with the SHOW
  500. DIAL command.
  501. :p.
  502.  
  503. :h1.About Country and Area Codes
  504. Every country has a country code -- a short number, presently one to three
  505. digits long, that identifies your country to the worldwide telephone system.
  506. Most countries have their own country code, such as 39 for Italy, 47 for
  507. Norway, 351 for Portugal.  Some countries share a country code; for example,
  508. country code 1 is shared under the North American Numbering Plan (NANP) by the
  509. USA, Canada, and various Carribean and Pacific islands.  Likewise, country
  510. code 7 is presently shared among Russia and some of the other former Soviet
  511. Republics.  A partial list of the world's country codes appears in Appendix I
  512. (according to our best knowledge as of September 1995).  In case you don't
  513. know what your country code is, you can probably find it there.  If not, look
  514. in your telephone book.
  515. :p.
  516. Just as the world is divided into countries, most countries are divided into
  517. calling areas, identified by area codes, sometimes called city codes.  For
  518. example, in North America, 212 is the area code for the Borough of Manhattan
  519. in New York City; 416 is the area code for Toronto, Ontario; 808 is the area
  520. code for Hawaii.  In other countries area codes might be longer or shorter,
  521. while some countries, such as Costa Rica, Luxembourg, and Singapore,
  522. do not have area codes at all.
  523. :p.
  524. Be careful not to confuse your country code or area code with your
  525. long-distance dialing prefix.  For example, in the NANP dialing area, the
  526. country code is 1 and the normal long-distance dialing prefix is also 1,
  527. whereas in most other places, the long-distance dialing prefix is different
  528. from the country code.
  529. :p.
  530. In most West European countries, the long-distance dialing prefix is 0, and it
  531. is not part of the area code.  So, for example, if you live in Central London,
  532. your country code is 44 and your area code is 171 (not 0171).  Only a few
  533. countries have area codes that begin with 0; examples include Australia,
  534. Finland, and Russia.
  535.  
  536. :h1.Using Portable Mode
  537.  
  538. To use portable dialing directory entries, Kermit must know the country code
  539. and area code you are dialing from.  If it doesn't have this information,
  540. portable ("+") entries can't be dialed.  The commands are&colon.
  541. :p.
  542. :hp4.
  543. SET DIAL COUNTRY-CODE <number>
  544. :ehp4.
  545. .br
  546. :lm margin=3.
  547. The numeric country code of the country you are dialing FROM.  Examples&colon. 1
  548. for USA and Canada (etc), 44 for the UK, 33 for France, 49 for Germany.
  549. This command tells Kermit what your local country code is, so it can compare
  550. it with the country codes given in portable dialing directory entries to
  551. tell whether calls are national or international.  If you have not set a
  552. long-distance or international dialing prefix at the time you give this
  553. command, Kermit sets default ones for you&colon. for country code 1, these are 1
  554. and 011, respectively, and for all others they are 0 and 00.  If these are
  555. not correct (as they will not be for many countries), please use the
  556. commands described below to specify the right ones.
  557. :lm margin=1.
  558. :p.
  559. :hp4.
  560. SET DIAL AREA-CODE [ <number> ]
  561. :ehp4.
  562. .br
  563. :lm margin=3.
  564. The numeric area code you are dialing FROM.  If your country does not have
  565. area codes, omit the <number>.  Be careful not to include your long-distance
  566. dialing prefix as part of the area code (e.g. 0 in England or Germany, 9 in
  567. Finland).  Examples&colon.
  568. :sl compact.
  569. :li.0      for Helsinki, Finland (prior to 12 October 1996)
  570. :li.9      for Helsinki, Finland (beginning 12 October 1996)
  571. :li.69     for Frankfurt, Germany
  572. :li.171    for Central London, England (note&colon. not 0171)
  573. :li.212    for Manhattan, New York City, USA
  574. :li.516    for Long Island, New York, USA
  575. :li.511    for Hannover, Germany
  576. :li.6431   for Marburg, Germany
  577. :li.38427  for Blowatz, Germany
  578. :li.(blank) for Singapore, no area codes
  579. :esl.
  580. :lm margin=1.
  581. :p.
  582. :hp4.
  583. SET DIAL LD-PREFIX <number>
  584. :ehp4.
  585. .br
  586. :lm margin=3.
  587. The prefix for dialing long-distance (non-local) calls from where you are.
  588. This is the access code you must dial in order to place a call outside your
  589. own dialing area, but inside your country (or countries covered by your
  590. country code). Examples&colon. 1 for USA and Canada (etc), 0 for Germany, England,
  591. and most others.  Strictly speaking, this item need not be a number; it may
  592. contain commas or other dial modifiers if needed, which are sent to the
  593. modem literally.  It can also be a long-distance-carrier access code, such
  594. as 10288 for "10-ATT" or 10652 for "10-NJB".
  595. :lm margin=1.
  596. :p.
  597. :hp4.
  598. SET DIAL INTL-PREFIX <number>
  599. :ehp4.
  600. .br
  601. :lm margin=3.
  602. The prefix for dialing international calls from where you are.  Examples&colon.
  603. 011 for USA and Canada (etc), 00 for many other countries, with many
  604. notable exceptions (reportedly, 0061 for Japan, 810 for Russia, 98 for
  605. Mexico, etc).  This one, too, might also contain non-numeric characters if
  606. necessary, and can also be an international-carrier access code.
  607. :lm margin=1.
  608. :p.
  609. Versions of C-Kermit that come with installation scripts collect this
  610. information from you at install time.  Otherwise, you will have to add this
  611. information to your C-Kermit customization file yourself.
  612. :p.
  613. Kermit does not have built-in defaults for these items, but it will
  614. pick up initial values for them from the environment, if they are defined
  615. there.  The environment variable names are K_AREACODE, K_COUNTRYCODE,
  616. K_INTL_PREFIX, K_LD_PREFIX.
  617. :p.
  618. Kermit also makes these values available to you in variables so you can
  619. use them in macros and script programs&colon.
  620. :sl compact.
  621. :li.\v(d$ac) = DIAL AREA-CODE
  622. :li.\v(d$cc) = DIAL COUNTRY-CODE
  623. :li.\v(d$lp) = DIAL LD-PREFIX
  624. :li.\v(d$ip) = DIAL INTL-PREFIX
  625. :esl.
  626. :p.
  627. (See chapters on script programming in "Using C-Kermit"; a use for these
  628. variables is suggested below.)
  629.  
  630. :h1.France
  631.  
  632. Beginning 18 October 1996, France, like Germany, England, and other European
  633. Union countries, will have "0" as its long-distance prefix and "00" as its
  634. international dialing prefix, but with a difference.
  635. :p.
  636. All calls within France, even local ones, MUST be dialed with an area code.
  637. Thus all calls within France will start with "01", "02", ... "06".
  638. :p.
  639. In fact, the area code consists of a one-digit "long-distance" prefix ("0")
  640. and a one-digit area code ("1"-"6").  This is a subtle distinction inside
  641. France, because it makes no difference what the digits are called.  When
  642. calling into France from outside, however, the leading zero must be dropped.
  643. :p.
  644. So for new French numbers to entered portably in the dialing directory, the
  645. leading zero must be dropped (according to our usual rule)&colon.
  646. :xmp.
  647. :font facename=Courier size=10x8.
  648. paris  +33 (1) 55 55 55 55
  649. :font facename=default size=0x0.
  650. :exmp.
  651. :p.
  652. Kermit users within France, beginning 18 October 1996, should configure
  653. themselves as follows&colon.
  654. :sl compact.
  655. :li.SET DIAL COUNTRY-CODE 33
  656. :li.SET DIAL AREA-CODE 999
  657. :li.SET DIAL LD-PREFIX 0
  658. :li.SET DIAL INTL-PREFIX 00
  659. :esl.:p.
  660. The use of an area code, "999", that will never occur in a real phone number
  661. forces all calls to be dialed with the long-distance prefix and the area code.
  662.  
  663. :h1.Toll-Free Calls
  664.  
  665. The following command allows Kermit to recognize toll-free calls in your
  666. dialing directory, and to dial toll-free numbers in preference to (presumably)
  667. more-expensive calls when you have multiple entries with the same name&colon.
  668. :p.
  669. :hp4.
  670. SET DIAL TOLL-FREE-AREA-CODE [ <number> [ <number> [ ... ] ] ]
  671. :ehp4.
  672. .br
  673. :lm margin=3.
  674. Specify zero, one, or more toll-free area codes in your country, such as 800
  675. and 888 in the North American dialing area.  If one or more toll-free area
  676. codes are specified, then dialing-directory entries with these area codes
  677. within your country are considered toll-free, rather than long-distance, for
  678. purposes of "cheapest-first" sorting.  Synonym&colon. SET DIAL TF-AREA-CODE.
  679. :lm margin=1.
  680. :p.
  681. The following command can be used to specify a dialing prefix for toll-free
  682. calls that is different from your long-distance dialing prefix&colon.
  683. :p.
  684. :hp4.
  685. SET DIAL TOLL-FREE-PREFIX [ <number> ]
  686. :ehp4.
  687. .br
  688. :lm margin=3.
  689. Prefix to be used when making toll-free calls.  If not set, then your
  690. long-distance prefixe (DIAL LD-PREFIX) is used.  Synonym&colon. SET DIAL TF-PREFIX.
  691. :lm margin=1.
  692. :p.
  693. These items will also be picked up by Kermit at startup from the environment
  694. variables K_TF_PREFIX and K_TF_AREACODE.  The latter can include multiple
  695. area codes separated by spaces.
  696.  
  697. :h1.Unconditional Prefixes and Suffixes
  698.  
  699. The following two commands give you a simple and straightforward way to modify
  700. phone numbers -- a prefix and a suffix that are blindly added to all phone
  701. numbers prior to dialing, no matter whether the number was obtained from the
  702. dialing directory, nor whether it is internal, local, long-distance, or
  703. international.  (If you are dialing out from a PBX, however, the PBX
  704. outside-line prefix precedes the dial prefix.) 
  705. :p.
  706. :hp4.
  707. SET DIAL PREFIX [ <text> ]
  708. :ehp4.
  709. .br
  710. :lm margin=3.
  711. An item to precede the phone number, for example, to get a tie-line or to
  712. disable call waiting.  This goes before anything else in the phone number
  713. except the PBX-OUTSIDE-PREFIX (if any).  Example&colon.
  714. :sl compact.
  715. :li.SET DIAL PREFIX *70,
  716. :esl.
  717. :p.
  718. which is used in many parts of North America to disable call-waiting for the
  719. duration of the call, generally desirable when making modem calls.
  720. :lm margin=1.
  721. :p.
  722. :hp4.
  723. SET DIAL SUFFIX [ <text> ]
  724. :ehp4.
  725. .br
  726. :lm margin=3.
  727. An item to follow the phone number.
  728. :lm margin=1.
  729. :p.
  730. There is no default prefix or suffix.  Use these commands to create them.
  731. Use these commands without including any <text> to remove them, once created.
  732.  
  733. :h1.Characters Used In Telephone Numbers
  734.  
  735. Kermit does not translate letters in phone number to digits.  If a letter is
  736. included in a phone number, Kermit sends the letter to the modem literally.
  737. Thus, 1 800 COLLECT should be entered in the dialing directory as&colon.
  738. :xmp.
  739. :font facename=Courier size=10x8.
  740. +1 (800) 2655328
  741. :font facename=default size=0x0.
  742. :exmp.
  743. :p.
  744. if that is, indeed, the number that should be dialed.  In a portable entry,
  745. Kermit discards the plus sign and parentheses before passing the phone number
  746. to the dialer.
  747. :p.
  748. Kermit does NOT understand or interpret non-numeric characters (other than
  749. plus sign and parentheses) in telephone numbers.  Nevertheless, certain
  750. conventions apply to Hayes and compatible modems and are widely used; even
  751. many non-Hayes compatibles accept the same characters and treat them the
  752. same way.  So in many cases they can be safely used in phone numbers (but NOT
  753. in country codes or area codes)&colon.
  754. :sl compact.
  755. :li., = pause (usually 2 seconds)
  756. :li.W = wait for secondary dialtone, e.g. when getting an outside line
  757. :li.@ = wait for quiet answer, i.e. phone is answered, but not by a modem
  758. :li.! = flash (try to get dialtone)
  759. :li.; = return to command state immediately after dialing
  760. :li.$ = wait for "bong", e.g. to enter calling-card number
  761. :esl.
  762. :p.
  763. At present, Kermit ignores these characters (and all others) them and passes
  764. them directly to the modem, but in the future Kermit might be able to handle
  765. them intelligently (e.g. translating to non-Hayes notation when necessary).
  766. Most likely, if this happens, the notation listed above will be used.  
  767.  
  768. :h1.Having the Last Word
  769.  
  770. When obtaining a phone number from the directory, Kermit performs various
  771. transformations prior to dialing, which are described immediately following
  772. this section.  But the result might not be exactly what is needed.  In cases
  773. where Kermit is likely to err, you can ask it to display the phone number
  774. before it dials, and give you a chance to change it&colon.
  775. :p.
  776. :hp4.
  777. SET DIAL CONFIRMATION { ON, OFF }
  778. :ehp4.
  779. .br
  780. :lm margin=3.
  781. Requests confirmation of the phone number before dialing.  Normally OFF.
  782. When ON, Kermit displays the number, exactly as it is about to be dialed,
  783. and you may respond Yes or No.  If you respond No, Kermit prompts you for
  784. a replacement number (editing in place is not supported at this time).
  785. You may also enter Ctrl-C to cancel dialing altogether and return to
  786. C-Kermit prompt.  (Not recommended for unattended dialing &colon.-)
  787. :lm margin=1.
  788. :p.
  789.  
  790. :h1.Simple Portable Mode
  791.  
  792. Kermit understands several types of dialing including local, long-distance,
  793. and international.  When a dialing-directory entry is in portable format, or
  794. you give a portable-format number directly in your DIAL command, Kermit
  795. chooses the dialing method as follows&colon.
  796. :ol.
  797. :li.If your local COUNTRY-CODE is unknown, then Kermit prints a warning
  798. message and stops dialing.  Otherwise&colon.
  799. :li.If your COUNTRY-CODE is different from the number's country-code,
  800. then Kermit makes an international call using its INTL-PREFIX,
  801. the country code, area code (if any), and subscriber number.  Otherwise&colon.
  802. :li.If the country codes match, but your AREA-CODE is not blank and it differs
  803. from the number's area-code, Kermit makes a long-distance call&colon. the
  804. country code is ignored and the call is placed using the LD-PREFIX, the
  805. area code, and the subscriber number (toll-free calls fall into this
  806. category too).  Otherwise;
  807. :li.Kermit makes a local call.  The country code and area code are ignored,
  808. and Kermit dials the subscriber number directly.
  809. :eol.
  810. :p.
  811. If this is sufficient for your needs, you are now portable enough; read no
  812. further.
  813.  
  814. :h1.Permissive Portable Mode
  815.  
  816. :hp8.
  817. * * * *
  818. .br
  819. Most readers can (and should) skip over this section.  It is intended
  820. only for people for whom Kermit's normal handling of country and area
  821. codes is not flexible enough.
  822. :ehp8.
  823. :p.
  824. It is permissible to omit parentheses from around the area code in a
  825. portable dialing directory entry, for example&colon.
  826. :xmp.
  827. :font facename=Courier size=10x8.
  828. +1 212 555 1212
  829. :font facename=default size=0x0.
  830. :exmp.
  831. :p.
  832. or&colon.
  833. :xmp.
  834. :font facename=Courier size=10x8.
  835. +12125551212
  836. :font facename=default size=0x0.
  837. :exmp.
  838. :p.
  839. (Remember, spaces are ignored.)  If you do this, Kermit treats the entry a bit
  840. differently.  Since it can't "parse" this type of phone number (i.e. separate
  841. its country code, area code, and subscriber number), it tries to match the
  842. concatenated DIAL COUNTRY-CODE and DIAL AREA-CODE (if any) with the beginning
  843. of the phone number, ignoring the inital "+", as well as any "/", ".", and
  844. spaces.  Thus permissive entries can also look like this&colon.
  845. :xmp.
  846. :font facename=Courier size=10x8.
  847. +1 / 212 / 555-1212
  848. +1/212/555-1212
  849. +1.212.555.1212
  850. :font facename=default size=0x0.
  851. :exmp.
  852. :p.
  853. (This notation is not recommended, but it does agree with notation that is
  854. commonly used in some parts of the world, and might aid in importing dialing
  855. directories from other applications or databases.)
  856. :p.
  857. This type of entry is intended for use in parts of the world where the
  858. distinction between area code and subscriber number are blurry.  Thus, by
  859. setting a different length DIAL AREA-CODEs, you can "move" digits between
  860. the area code and subscriber number for purposes of matching.  For example,
  861. suppose you have this dialing directory entry&colon.
  862. :xmp.
  863. :font facename=Courier size=10x8.
  864. +9876543210
  865. :font facename=default size=0x0.
  866. :exmp.
  867. :p.
  868. If you&colon.
  869. :xmp.
  870. :font facename=Courier size=10x8.
  871. SET DIAL COUNTRY-CODE 9
  872. SET DIAL AREA-CODE 87
  873. :font facename=default size=0x0.
  874. :exmp.
  875. :p.
  876. then Kermit dials "6543210".  But if you&colon.
  877. :xmp.
  878. :font facename=Courier size=10x8.
  879. SET DIAL COUNTRY-CODE 9
  880. SET DIAL AREA-CODE 8765
  881. :font facename=default size=0x0.
  882. :exmp.
  883. :p.
  884. then Kermit dials "43210".
  885.  
  886. :h1.Private Branch Exchanges
  887.  
  888. A private branch exchange (PBX) is a telephone system installed within a
  889. building, company, hotel, organization, or other thing, that (for our
  890. purposes) has the following properties&colon.
  891. :ol.
  892. :li.If you are dialing out from the PBX to the public telephone network, you
  893. must dial a special prefix, such as "9", to get an outside line (the
  894. prefix could be anything at all, and there might be more than one of
  895. them, and it might include some kind of account code for internal
  896. charging purposes).
  897.  
  898. :li.If you are dialing from your PBX phone to another phone on the same
  899. PBX, the dialing method is different from what it would be if you were
  900. making a local call into the PBX from outside.  For example, if your
  901. local phone number (as seen from outside) is 987-6543, it might be
  902. dialed internally as 6543, or 8-6543.
  903. :eol.
  904. :p.
  905. The following commands allow you to use the same dialing directory entry for
  906. internal calls within the PBX, calls to the outside from within the PBX, and
  907. calls into the PBX from outside&colon.
  908. :p.
  909. :hp4.
  910. SET DIAL PBX-OUTSIDE-PREFIX [ <number> ]
  911. :ehp4.
  912. .br
  913. :lm margin=3.
  914. Tells the prefix you must dial in order to get an outside line.  
  915. Issue this command to specify the prefix when you are using a PBX phone.
  916. And be sure that no PBX-OUTSIDE-PREFIX is defined when you are
  917. dialing on the public telephone network (issuing this command without
  918. a <number> removes the prefix).
  919. :lm margin=1.
  920. :p.
  921. :hp4.
  922. SET DIAL PBX-EXCHANGE [ <number> ]
  923. :ehp4.
  924. .br
  925. :lm margin=3.
  926. Tells the leading digits of a subscriber number within the AREA-CODE
  927. that identify it as belonging to the PBX, typically a 3- or 4-digit number.
  928. Kermit does not presently handle PBXs with multiple exchanges.
  929. :lm margin=1.
  930. :p.
  931. :hp4.
  932. SET DIAL PBX-INSIDE-PREFIX [ <number> ]
  933. :ehp4.
  934. .br
  935. :lm margin=3.
  936. Specifies the prefix, if any, that must be used to dial an internal number.
  937. :lm margin=1.
  938. :p.
  939. These commands work as follows&colon.
  940. :p.
  941. If a PBX-OUTSIDE-PREFIX is defined, then if a call is determined to be
  942. local (same area code), the PBX-EXCHANGE (if any) is compared with the
  943. beginning of the local phone number.  If they match, then those digits are
  944. removed from the local phone number before dialing.  In addition, if a
  945. PBX-INSIDE-PREFIX is specified, it is added to the beginning of the phone
  946. number before dialing.
  947. :p.
  948. Here's an example.  Suppose we have the following dialing directory entries&colon.
  949. :xmp.
  950. :font facename=Courier size=10x8.
  951. MARKETING  +1 (617) 555 1234
  952. BOONDOCKS  +1 (617) 444 6789
  953. :font facename=default size=0x0.
  954. :exmp.
  955. :p.
  956. and suppose we have given the following commands&colon.
  957. :xmp.
  958. :font facename=Courier size=10x8.
  959. SET PBX-OUTSIDE-PREFIX 9
  960. SET PBX-EXCHANGE 555
  961. SET PBX-INSIDE-PREFIX 4
  962. :font facename=default size=0x0.
  963. :exmp.
  964. :p.
  965. Then, if we "dial boondocks", the number that is actually dialed is
  966. 916174446789 because, since our PBX exchange does not match the beginning of
  967. the "boondocks" local number, we treat it as an external local call; the
  968. outside-line prefix is dialed, followed by the local number.
  969. :p.
  970. But if we "dial marketing", we note that the exchange "555" matches ours, so
  971. we strip the "555" and replace it by "4", resulting in an internal call,
  972. "41234".
  973. :p.
  974. On the other hand, if we are dialing from outside (e.g. from home), we use&colon.
  975. :xmp.
  976. :font facename=Courier size=10x8.
  977. SET PBX-OUTSIDE-PREFIX
  978. :font facename=default size=0x0.
  979. :exmp.
  980. :p.
  981. (no prefix) to indicate we are not using a PBX (the normal case), and then
  982. "dial marketing" is just like dialing any other number; it is dialed as a
  983. local, long-distance, or international call, depending on our location.
  984. :p.
  985. On LANs or multiuser computers that use PBXs for dialing out, the following
  986. environment variables can be set to ensure that Kermit does the right thing
  987. for all users by default&colon.
  988. :sl compact.
  989. :li.K_PBX_INSIDE   -  PBX-INSIDE-PREFIX
  990. :li.K_PBX_OUTSIDE  -  PBX-OUTSIDE-PREFIX
  991. :li.K_PBX_EXCHANGE -  PBX-EXCHANGE
  992. :esl.
  993. :h1.Looking Up and Checking Numbers
  994.  
  995. If you want to see the effect that the various SET DIAL settings have on
  996. telephone numbers, make a test dialing directory containing many entries
  997. with the same name (say "test"), but with different country and area codes,
  998. and then see the effect of setting different DIAL COUNTRY-CODEs and DIAL
  999. AREA-CODEs (and PREFIXes, and SUFFIXes, and PBX items, and TOLL-FREE items,
  1000. etc etc) by changing these settings and then giving a LOOKUP command on the
  1001. test name.  Example for "lookup test" (all phone numbers are fictional)&colon.
  1002. :xmp.
  1003. :font facename=Courier size=10x8.
  1004. 7 telephone numbers found for "test"&colon.
  1005.   1. Test         +1 (212) 555 1234    =>  7 1234                (0)
  1006.   2. Test         +1 (800) 555 4321    =>  1800555 4321          (1)
  1007.   3. Test         +1 (888) 555 4321    =>  1888555 4321          (1)
  1008.   4. Test         +1 (212) 555 5432    =>  555 5432              (2)
  1009.   5. Test         5559924              =>  5559924               (3)
  1010.   6. Test         +1 (201) 555-6543    =>  1201555-6543          (4)
  1011.   7. Test         +49 (551) 7654321    =>  011495517654321       (5)
  1012. :font facename=default size=0x0.
  1013. :exmp.
  1014. :p.
  1015. This lists all the matching entries, in the order they will be dialed,
  1016. showing the name, the number from the directory entry and then, after the
  1017. arrow (=>), the number that will actually be dialed, and finally the type
  1018. of call&colon.
  1019. :sl compact.
  1020. :li.Internal PBX   (0)
  1021. :li.Toll-Free      (1)
  1022. :li.Local          (2)
  1023. :li.Literal        (3)
  1024. :li.Long-Distance  (4)
  1025. :li.International  (5)
  1026. :esl.
  1027. :p.
  1028. If the ordering is not what you desire, tell Kermit to SET DIAL SORT OFF
  1029. and do the LOOKUP again.  This forces Kermit to dial the numbers in the
  1030. same order they were encountered in the directory or directories.
  1031.  
  1032. :h1.When Portable Mode Isn't Portable Enough
  1033.  
  1034. The rules presented above are adequate in many cases, but there will always
  1035. be exceptions(*)&colon.
  1036. :p.
  1037. :lm margin=3.
  1038. :hp1.
  1039. "For example, here in Toronto, we're in area code 416.  If I want to call
  1040. 416-488-XXXX, that's a local call, and it's in my area code, so I dial
  1041. 7 digits, 488-XXXX.  If I want to call 905-276-XXXX, that's a local call,
  1042. and it's outside my area code, so I dial 10 digits&colon. 905-276-XXXX.  And
  1043. if I want to call 905-528-XXXX, that's long distance, so I dial 11 digits&colon.
  1044. 1-905-528-XXXX.  Finally, if I want to dial 976-XXXX, that's a premium
  1045. call, which is like long distance, so I have to dial 1-416-976-XXXX,
  1046. using the 416 even though that's my own area code.  (It happens that there
  1047. are no long distance calls within 416, so I use the premium call to show
  1048. the dialing.)
  1049. :p.
  1050. "Ottawa is in area code 613.  If they dial 232-XXXX, that's a local call
  1051. and reaches 613-232-XXXX.  But if they dial 778-XXXX, they reach
  1052. 819-778-XXXX.  Why?  Because that number is in their local calling area,
  1053. while 613-778-XXXX either would be long distance, or doesn't exist.  When
  1054. the call *is* long distance (or premium), they dial it the same as in
  1055. Toronto&colon. 11 digits.  (Historically, until quite recently they would have
  1056. dialed long distance calls within their area code as 8 digits&colon. 1-778-XXXX
  1057. to reach 613-778-XXXX.  This had to change when area codes 334, 360, 630,
  1058. etc. were introduced in 1995.)"
  1059. :ehp1.
  1060. :lm margin=1.
  1061. :p.
  1062. (*) Mark Brader, SoftQuad Inc., Toronto
  1063. :p.
  1064. Another story(*)&colon.
  1065. :p.
  1066. :lm margin=3.
  1067. :hp1.
  1068. "There are 400-500 active exchanges in area code 508.  Of those, 27 are in
  1069. what Nynex has defined as my local area.  I am not permitted to dial
  1070. 1-508 before any of those 27 exchanges, but I am REQUIRED to dial 1-508
  1071. to reach any of the remaining exchanges in area code 508.
  1072. :p.
  1073. "I could put these in as fixed numbers, but all I would have to do would
  1074. be to take my laptop computer 1.5 miles north from here and then I would 
  1075. be in a different local area where some of my old local area would still be
  1076. local, but some would now require a 1-508, and some that previously needed
  1077. 1-508 would now only be able to be dialed without the 1-508."
  1078. :lm margin=1.
  1079. :ehp1.
  1080. :p.
  1081. (*) Ken Levitt, Informed Computer Solutions, Wayland, MA.
  1082. :p.
  1083. And another(*)&colon.
  1084. :p.
  1085. :lm margin=3.
  1086. :hp1.
  1087. "San Marino is country code 378, and Italy is country code 39.  If you're
  1088. dialing from Italy to any other country code except San Marino, you dial
  1089. 00 country-code city-code local-number, but if you're dialing San Marino,
  1090. you must dial it as 0549 local-number (instead of 00-378 local-number).
  1091. Likewise, if you dial from San Marino to any country except Italy, you
  1092. dial 00 country-code city-code local-number, but if you're dialing Italy,
  1093. you dial 0 city-code local-number (instead of 00-39 city-code
  1094. local-number).  Such special arrangements also exist between Singapore
  1095. and Malaysia, Mexico to US/Canada/Carribean, Ireland and Northern
  1096. Ireland, Estonia and Russia, Switzerland/Austria/France/Germany/Italy
  1097. (often between just pairs of cities across the border from each other),
  1098. Uganda/Kenya/Tanzania/Rwanda/Burundi, etc."
  1099. :ehp1.
  1100. :lm margin=1.
  1101. :p.
  1102. (*) Toby Nixon, Program Manager, Windows Telephony (TAPI),
  1103. Microsoft Corporation. 
  1104. :p.
  1105. Rather than build error-prone and inadequate knowledge-based "intelligence"
  1106. into the software, we draw the line at this point and recommend that such
  1107. pathological cases be handled by&colon.
  1108. :ul.
  1109. :li.Inserting literal-mode entries into the directory, even if that means
  1110. different entries are needed for dialing the same number from different
  1111. locations, or&colon. 
  1112.  
  1113. :li.SET DIAL CONFIRMATION ON, or&colon.
  1114.  
  1115. :li.Bypassing the dialing directory and dialing such numbers literally, i.e.
  1116. "dial 987654321" (hint&colon. use LOOKUP to look it up first, then enter it
  1117. correctly in the DIAL command).
  1118.  
  1119. :li.Sneaky tricks.
  1120. :eul.
  1121. :p.
  1122. Here are some sneaky tricks that can be used to handle certain common cases&colon.
  1123. :ol.
  1124. :li.North American 10-digit dialing to a different area code&colon.
  1125. .br
  1126. Just "set dial ld-prefix" to nothing prior to dialing the number.
  1127. Then set it back to your normal long-distance prefix before dialing
  1128. any numbers that need it (illustrated below).
  1129.  
  1130. :li.
  1131. North American 10-digit dialing to same area code&colon.
  1132. .br
  1133. Normally, Kermit removes the area code if it is the same as your local
  1134. one prior to dialing.  To force Kermit to keep it on, "set dial
  1135. area-code" to nothing prior to dialing the number.  Then Kermit will
  1136. treat it as a "long" local number.  This is the same technique that is
  1137. used in countries that do not have area codes (such as Singapore).
  1138.  
  1139. :li.North American 11-digit dialing to same area code&colon.
  1140. .br
  1141. Set your area code to one that does not exist, e.g. "set dial area-code
  1142. 000" prior to dialing and then put it back to normal afterwards.  This is
  1143. the same technique that is used in countries in which all calls must be
  1144. dialed with the area code, such as France beginning 18 October 1996.
  1145. :eol.
  1146. :p.
  1147. Use your imagination to extend these examples to other difficult
  1148. situations.  Tricks such as these can be accomplished conveniently by
  1149. defining macros that save and restore your long-distance prefix or area code
  1150. around dialing, for example&colon.
  1151. :xmp.
  1152. :font facename=Courier size=10x8.
  1153. DEFINE SN1 -                ; Sneaky Trick 1
  1154.   ASSIGN \%9 \v(d$lp), -    ; Save current LD-PREFIX
  1155.   SET DIAL LD-PREFIX, -     ; Set LD-PREFIX to nothing
  1156.   DIAL \%1, -               ; DIAL the given number
  1157.   ASSIGN \%8 \v(status), -  ; Save DIAL command status
  1158.   SET DIAL LD-PREFIX \%9, - ; Restore LD-PREFIX
  1159.   END \%8                   ; Return with DIAL's status
  1160. :font facename=default size=0x0.
  1161. :exmp.
  1162. :p.
  1163. If you added this macro definition to your C-Kermit customization file,
  1164. then you would type "sn1 oofa" to force 10-digit dialing for the dialing
  1165. directory entry named "oofa".
  1166. :p.
  1167. See Chapters 11-13 of "Using C-Kermit" for a complete explanation of
  1168. macros and script programming.
  1169.  
  1170. :h1.Long-distance Carriers and Credit-Card/Calling-Card Numbers
  1171.  
  1172. Thanks, at least in the USA, to deregulation, it is now possible to use
  1173. different companies to make long-distance and international calls.  Each
  1174. telephone has a default long-distance company, which is used if you make
  1175. these calls in the normal way, but you can also choose a different
  1176. long-distance company on a per-call basis by dialing phone numbers in a
  1177. different way.  Furthermore, you can charge calls made on other phones to
  1178. your own account by dialing in (perhaps another) special way and then
  1179. specifying your account number.
  1180. :p.
  1181. The easy case involves specification of an alternative long-distance prefix.
  1182. For example, to use New Jersey Bell in the USA, the prefix is "10-NJB" (i.e.
  1183. "10652") rather than the customary "1".  Everything works exactly as described
  1184. previously, except your long-distance bill comes from a different company&colon.
  1185. :xmp.
  1186. :font facename=Courier size=10x8.
  1187. SET DIAL LD-PREFIX 10652
  1188. :font facename=default size=0x0.
  1189. :exmp.
  1190. :p.
  1191. Now suppose you also need to supply a credit-card number, but only on
  1192. long-distance calls.  We assume that this must come either before the area
  1193. code or after the phone number (rather than imbedded in the phone number),
  1194. so therefore it can be part of the LD-PREFIX or it can be a
  1195. suffix.  Not the DIAL SUFFIX, which is always applied (if defined), but
  1196. rather&colon.
  1197. :p.
  1198. :hp4.
  1199. SET DIAL LD-SUFFIX [ <text> ]
  1200. :ehp4.
  1201. .br
  1202. :lm margin=3.
  1203. The text, if any, is appending to the phone number prior to dialing
  1204. if Kermit has determined the call is long-distance and not toll-free.
  1205. :lm margin=1.
  1206. :p.
  1207. For example, suppose that in order to have a long-distance call billed
  1208. to your credit card, you must dial 0, the area code, the number, and
  1209. then pause for several seconds, and then enter your credit-card number&colon.
  1210. :xmp.
  1211. :font facename=Courier size=10x8.
  1212. SET DIAL LD-PREFIX 0
  1213. SET DIAL LD-SUFFIX ,,xxxxxxxxxxxxxxxxxx
  1214. :font facename=default size=0x0.
  1215. :exmp.
  1216. :p.
  1217. where the x's represent your card number.  Depending on the capabilities of
  1218. your modem and the behavior of the long-distance carrier, you might be
  1219. able to replace the comma(s) by a "wait for bong" character (normally "$").
  1220. :p.
  1221. In another scenario, you might be using your default long-distance carrier
  1222. to call another long-distance carrier, and then calling the desired number
  1223. from there, also supplying a credit- or calling-card number.  Here you are
  1224. really making a phone-call-within-a-phone-call.  For example, you dial&colon.
  1225. :xmp.
  1226. :font facename=Courier size=10x8.
  1227. 1 800 nnnnnnn
  1228. :font facename=default size=0x0.
  1229. :exmp.
  1230. :p.
  1231. (where the n's are replaced by the second carrier's number), wait for a
  1232. "quiet answer" (no carrier), then enter 0, the area code, the subscriber
  1233. number, then wait for a bong, then enter the credit card number.  The
  1234. appropriate commands would be&colon.
  1235. :xmp.
  1236. :font facename=Courier size=10x8.
  1237. SET LD-PREFIX 1,800,nnnnnnn@0
  1238. SET LD-SUFFIX $xxxxxxxxxxxxxxxxxx
  1239. :font facename=default size=0x0.
  1240. :exmp.
  1241. :p.
  1242. Finally, allowing for the possibility that the billing method for
  1243. international calls might be different from long-distance calls within one's
  1244. country, we also have&colon.
  1245. :xmp.
  1246. :font facename=Courier size=10x8.
  1247. SET DIAL INTL-PREFIX [ <text> ]
  1248. SET DIAL INTL-SUFFIX [ <text> ]
  1249. :font facename=default size=0x0.
  1250. :exmp.
  1251. :p.
  1252. OBVIOUSLY, you DO NOT want to put credit-card or account information in the
  1253. dialing directory or any other file, as that is a classic security risk.
  1254. Therefore, you are going to have to provide this information to Kermit each
  1255. time you run it and you know that you will be making toll calls.  In other
  1256. chapters, you can find out how to do this easily with macros, script
  1257. programs, etc.
  1258.  
  1259. :h1.When the Dialing String is Too Long
  1260.  
  1261. Some modems, even modern ones, might have a command buffer that is too
  1262. short for a long dialing string like&colon.
  1263. :xmp.
  1264. :font facename=Courier size=10x8.
  1265. ATDT1,800,nnnnnnn@02125551234$xxxxxxxxxxxxxxxxxx
  1266. :font facename=default size=0x0.
  1267. :exmp.
  1268. :p.
  1269. In some cases, 40 characters is the maximum length for a command, including
  1270. a dialing command, as shown above.  If you dial a number that's too long,
  1271. the modem will respond with a message or code indicating a command error
  1272. (such as ERROR from Hayes compatible modems in word-result mode).  Rather
  1273. than try to build additional "magic" into the software to handle this
  1274. situation, we recommend that you dial too-long numbers in multiple stages.
  1275.  
  1276. :h1.Partial and Multistage Dialing
  1277.  
  1278. Some types of modems can be told to return to command mode immediately after
  1279. being given a dial command, without waiting for carrier.  For Hayes and
  1280. compatible modems, this is done by including a semicolon (;) as the last
  1281. character of the phone number.  This is useful in several circumstances&colon.
  1282. :ol.
  1283. :li.The number you are calling is not a modem and it will never send carrier.
  1284. For example, it is a voice number, a numeric pager, or a long-distance
  1285. or international carrier number.
  1286.  
  1287. :li.The dial string is too long for the modem and needs to be broken into
  1288. pieces.
  1289. :eol.
  1290. Thus, to dial a numeric pager, whose number is 555-1234, you might&colon.
  1291. :xmp.
  1292. :font facename=Courier size=10x8.
  1293. DIAL 5551234@xxxxxxxxx#;
  1294. :font facename=default size=0x0.
  1295. :exmp.
  1296. :p.
  1297. where "xxxxxxxxx" is the pager message.  This way, Kermit returns immediately
  1298. rather than waiting a long time only to get a NO CARRIER message.
  1299. :p.
  1300. Similarly to dial a credit-card call that is too long for your modem, you
  1301. could&colon.
  1302. :xmp.
  1303. :font facename=Courier size=10x8.
  1304. dial 10288,0,212,5551234,,,;
  1305. dial 4114 9999 9999 9999
  1306. :font facename=default size=0x0.
  1307. :exmp.
  1308. :p.
  1309. This is fine when typing in the phone number directly at the DIAL command.
  1310. But you don't want to include semicolons in your dialing directory, because
  1311. you might also want to dial the same number in other ways.  So we need a
  1312. special command for partial dialing&colon.
  1313. :p.
  1314. :hp4.
  1315. PDIAL <number>
  1316. :ehp4.
  1317. .br
  1318. :lm margin=3.
  1319. Like DIAL, but issues the dialing command in the modem-specific way
  1320. that causes the modem to return to command state immediately after
  1321. dialing the number, rather than waiting for carrier.  Furthermore,
  1322. Kermit remembers that the previous call was partial, and so does not
  1323. reinitialize or hang up the modem when the next DIAL or PDIAL command
  1324. is issued.
  1325. :lm margin=1.
  1326. :p.
  1327. So now, if the numbers you need to call are recorded in your dialing
  1328. directory in the normal way, for example&colon.
  1329. :xmp.
  1330. :font facename=Courier size=10x8.
  1331. OFFICE +1 (212) 555 1234
  1332. :font facename=default size=0x0.
  1333. :exmp.
  1334. :p.
  1335. and you have to make a credit-card call to them, but you have to use
  1336. multistage dialing because the combined numbers are too long&colon.
  1337. :xmp.
  1338. :font facename=Courier size=10x8.
  1339. SET LONG-DISTANCE PREFIX 10288,0,
  1340. SET LONG-DISTANCE SUFFIX
  1341. PDIAL OFFICE
  1342. DIAL ,,,4114 9999 9999 9999
  1343. :font facename=default size=0x0.
  1344. :exmp.
  1345. :p.
  1346. Here again, a macro can make this easier for you&colon.
  1347. :xmp.
  1348. :font facename=Courier size=10x8.
  1349. DEFINE LONGDIAL -
  1350.   SET LONG-DISTANCE PREFIX 10288,0,,-
  1351.   SET LONG-DISTANCE SUFFIX,-
  1352.   PDIAL \%1,-
  1353.   IF SUCCESS DIAL ,,,4114 9999 9999 9999
  1354. :font facename=default size=0x0.
  1355. :exmp.
  1356. :p.
  1357. REDIAL does not work with partially dialed numbers, nor does the automatic
  1358. retry feature.
  1359. :p.
  1360. Finally, suppose you issue a partial dialing command but then wish to cancel
  1361. the partially-dialed status, so that the next DIAL or PDIAL command does not
  1362. skip the modem hangup or initialization stages.  To accomplish this, either&colon.
  1363. :p.
  1364. :hp4.
  1365. HANGUP
  1366. :ehp4.
  1367. .br
  1368. :lm margin=3.
  1369. Which hangs up any open connection and also clears the dial status.
  1370. :lm margin=1.
  1371. :p.
  1372. or&colon.
  1373. :hp4.
  1374. CLEAR DIAL-STATUS
  1375. :ehp4.
  1376. .br
  1377. :lm margin=3.
  1378. Which clears Kermit's dial status without doing anything to the modem.
  1379. :lm margin=1.
  1380. :p.
  1381.  
  1382. :h1.Declaring Your Locale
  1383.  
  1384. If you've read this far, you know that it's important to separate the concepts
  1385. related to the number to be dialed from those relating to the location where
  1386. dialing occurs and the method of dialing, at least if you want to have a
  1387. portable dialing directory.  So the dialing directory contains no information
  1388. at all about your locale.
  1389. :p.
  1390. You have also learned the commands for setting up your dialing locale and
  1391. method.  All that's left to be said is that the process need not be painful
  1392. and laborious.  Kermit's command-file and macro capabilities, explained in
  1393. Chapters 11-13 of "Using C-Kermit", let you assign complicated configurations
  1394. to friendly words of your choice.  For example, suppose you carry a laptop
  1395. around to various locations&colon.
  1396. :xmp.
  1397. :font facename=Courier size=10x8.
  1398. DEFINE USA -
  1399.   SET DIAL COUNTRY-CODE 1,-
  1400.   SET DIAL LD-PREFIX 1,-
  1401.   SET DIAL INTL-PREFIX 011
  1402. :font facename=default size=0x0.
  1403. :exmp.
  1404. :p.
  1405. :xmp.
  1406. :font facename=Courier size=10x8.
  1407. DEFINE GERMANY -
  1408.   SET DIAL COUNTRY-CODE 49,-
  1409.   SET DIAL LD-PREFIX 0,-
  1410.   SET DIAL INTL-PREFIX 00
  1411. :font facename=default size=0x0.
  1412. :exmp.
  1413. :p.
  1414. :xmp.
  1415. :font facename=Courier size=10x8.
  1416. DEFINE MANHATTAN   USA,     SET DIAL AREA-CODE 212
  1417. DEFINE LONG-ISLAND USA,     SET DIAL AREA-CODE 516
  1418. DEFINE HANNOVER    GERMANY, SET DIAL AREA-CODE 511
  1419. DEFINE MARBURG     GERMANY, SET DIAL AREA-CODE 6421
  1420. :font facename=default size=0x0.
  1421. :exmp.
  1422. :p.
  1423. And when at work in Manhattan where you have a PBX&colon.
  1424. :xmp.
  1425. :font facename=Courier size=10x8.
  1426. DEFINE WORK -
  1427.   MANHATTAN, -
  1428.   SET DIAL PBX-OUT 93, SET DIAL PBX-EX 987, SET DIAL PBX-IN 7
  1429. :font facename=default size=0x0.
  1430. :exmp.
  1431. :p.
  1432. And then for Hoboken, New Jersey, where you need to dial using a particular
  1433. long-distance carrier&colon.
  1434. :xmp.
  1435. :font facename=Courier size=10x8.
  1436. DEFINE HOBOKEN -
  1437.   USA, -
  1438.   SET DIAL AREA-CODE 201, -
  1439.   SET DIAL LD-PREFIX 10652
  1440. :font facename=default size=0x0.
  1441. :exmp.
  1442. :p.
  1443. These macro definitions would be kept in your Kermit customization file.  And
  1444. then, whenever you start up Kermit to make a call, just enter one word&colon.
  1445. MANHATTAN, HOBOKEN, HANNOVER, WORK, etc, to declare your location.  Then DIAL
  1446. away.
  1447. :p.
  1448. A macro library of such "rule sets" can be built up over time and included
  1449. with in your Kermit customization file, so these macros will be available to
  1450. you whenever you use Kermit.  You can create and modify macro definitions
  1451. easily, since they are plain text and not part of the binary executable
  1452. Kermit program or any particular kind of database.
  1453.  
  1454. :h1.APPENDIX I&colon. Country Codes
  1455. :xmp.
  1456. :font facename=Courier size=10x8.
  1457. Afghanistan ......................................  +93
  1458. Albania .......................................... +355
  1459. Algeria .......................................... +213
  1460. American Samoa ...................................   +1
  1461. Andorra .......................................... +376
  1462. Angola ........................................... +244
  1463. Anguilla .........................................   +1
  1464. Antigua &. Barbuda ................................   +1
  1465. Argentina ........................................  +54
  1466. Armenia ..........................................   +7
  1467. Aruba ............................................ +297
  1468. Ascension Island ................................. +247
  1469. Australia ........................................  +61
  1470. Austria ..........................................  +43
  1471. Azerbaijani Republic ............................. +994
  1472. Azores ........................................... +351
  1473. Bahamas ..........................................   +1
  1474. Bahrain .......................................... +973
  1475. Balearic Islands .................................  +34
  1476. Bangladesh ....................................... +880
  1477. Barbados .........................................   +1
  1478. Belarus ..........................................   +7
  1479. Belgium ..........................................  +32
  1480. Belize ........................................... +501
  1481. Benin ............................................ +229
  1482. Bermuda ..........................................   +1
  1483. Bhutan, Kingdom of ............................... +975
  1484. Bolivia .......................................... +591
  1485. Bosnia-Herzegovina (former Yugoslav Republic of) . +387
  1486. Botswana ......................................... +267
  1487. Brazil ...........................................  +55
  1488. Brunei Darussalam ................................ +673
  1489. Bulgaria ......................................... +359
  1490. Burkina Faso (Upper Volta) ....................... +226
  1491. Burma (Union of Myanmar) .........................  +95
  1492. Burundi .......................................... +257
  1493. Caicos and Turks Islands .........................   +1
  1494. Cambodia (Kampuchea) ............................. +855
  1495. Cameroon ......................................... +237
  1496. Canada ...........................................   +1
  1497. Canal Zone (Panama) .............................. +507
  1498. Canary Islands ...................................  +34
  1499. Cape Verde Islands ............................... +238
  1500. Caroline Islands ................................. +691
  1501. Cayman Islands ...................................   +1
  1502. Central African Republic ......................... +236
  1503. Chad ............................................. +235
  1504. Chile ............................................  +56
  1505. China, People's Republic of ......................  +86
  1506. China, Republic of ............................... +886
  1507. Colombia .........................................  +57
  1508. Congo ............................................ +242
  1509. Cook Islands ..................................... +682
  1510. Costa Rica ....................................... +506
  1511. Croatia .......................................... +385
  1512. Cuba .............................................  +53
  1513. Cyprus ........................................... +357
  1514. Czech Republic ...................................  +42
  1515. Dahomey (Benin) .................................. +229
  1516. Denmark ..........................................  +45
  1517. Diego Garcia ..................................... +246
  1518. Djibouti Republic ................................ +253
  1519. Dominica .........................................   +1
  1520. Dominican Republic ...............................   +1
  1521. Dubai ............................................ +971
  1522. Ecuador .......................................... +593
  1523. Egypt, Arab Republic of ..........................  +20
  1524. El Salvador ...................................... +503
  1525. Equitorial Guinea ................................ +240
  1526. Eritrea .......................................... +291
  1527. Estonia .......................................... +372
  1528. Ethiopia ......................................... +251
  1529. Falkland Islands ................................. +500
  1530. Faroe Islands .................................... +298
  1531. Fiji ............................................. +679
  1532. Finland .......................................... +358
  1533. France ...........................................  +33
  1534. French Antilles .................................. +596
  1535. French Guiana .................................... +594
  1536. French Polynesia ................................. +689
  1537. Gabon Republic ................................... +241
  1538. Gambia ........................................... +220
  1539. Georgia ..........................................   +7
  1540. Germany ..........................................  +49
  1541. Ghana ............................................ +233
  1542. Gibraltar ........................................ +350
  1543. Greece ...........................................  +30
  1544. Greenland ........................................ +299
  1545. Grenada ..........................................   +1
  1546. Grenadines .......................................   +1
  1547. Guadeloupe ....................................... +590
  1548. Guam ............................................. +671
  1549. Guatemala ........................................ +502
  1550. Guinea-Bissau .................................... +245
  1551. Guyana ........................................... +592
  1552. Haiti ............................................ +509
  1553. Honduras ......................................... +504
  1554. Hong Kong ........................................ +852
  1555. Hungary ..........................................  +36
  1556. Iceland .......................................... +354
  1557. India ............................................  +91
  1558. Indonesia ........................................  +62
  1559. Iran .............................................  +98
  1560. Iraq ............................................. +964
  1561. Ireland, Repuplic of (Eire) ...................... +353
  1562. Israel ........................................... +972
  1563. Italy ............................................  +39
  1564. Ivory Coast ...................................... +225
  1565. Jamaica ..........................................   +1
  1566. Japan ............................................  +81
  1567. Jordan ........................................... +962
  1568. Kazahkstan .......................................   +7
  1569. Kenya ............................................ +254
  1570. Kirghizstan ......................................   +7
  1571. Kiribati Republic ................................ +686
  1572. Korea, Democratic Peoples Repulic of ............. +850
  1573. Korea, Republic of ...............................  +82
  1574. Kuwait ........................................... +965
  1575. Laos ............................................. +856
  1576. Latvia ........................................... +371
  1577. Lebanon .......................................... +961
  1578. Lesotho .......................................... +266
  1579. Liberia .......................................... +231
  1580. Libya ............................................ +218
  1581. Liechtenstein ....................................  +41
  1582. Lithuania ........................................ +370
  1583. Luxembourg ....................................... +352
  1584. Macao ............................................ +853
  1585. Macedonia (former Yugoslav Republic of) .......... +389
  1586. Madagascar ....................................... +261
  1587. Madeira .......................................... +351
  1588. Malawi ........................................... +265
  1589. Malaysia .........................................  +60
  1590. Maldives ......................................... +960
  1591. Mali ............................................. +223
  1592. Malta ............................................ +356
  1593. Mariana Islands .................................. +670
  1594. Martinique ....................................... +596
  1595. Mauritania ....................................... +222
  1596. Mauritius ........................................ +230
  1597. Mexico ...........................................  +52
  1598. Micronesia ....................................... +691
  1599. Moldova .......................................... +373
  1600. Monaco ...........................................  +33
  1601. Mongolian People's Republic ...................... +976
  1602. Monserrat ........................................   +1
  1603. Morocco .......................................... +212
  1604. Mozambique ....................................... +258
  1605. Myanmar, Union of (Burma) ........................  +95
  1606. Namibia .......................................... +264
  1607. Nauru ............................................ +674
  1608. Nepal ............................................ +977
  1609. Netherlands ......................................  +31
  1610. Netherlands Antilles ............................. +599
  1611. Nevis ............................................   +1
  1612. New Caledonia .................................... +687
  1613. New Guinea, Papua ................................ +675
  1614. New Zealand ......................................  +64
  1615. Nicaragua ........................................ +505
  1616. Niger ............................................ +227
  1617. Nigeria .......................................... +234
  1618. Niue Island ...................................... +683
  1619. Norfold Island ................................... +672
  1620. Norway ...........................................  +47
  1621. Oman ............................................. +968
  1622. Pakistan .........................................  +92
  1623. Palau ............................................ +680
  1624. Panama ........................................... +507
  1625. Papua New Guinea ................................. +675
  1626. Paraguay ......................................... +595
  1627. Peru .............................................  +51
  1628. Philippines ......................................  +63
  1629. Poland ...........................................  +48
  1630. Portugal ......................................... +351
  1631. Puerto Rico ......................................   +1
  1632. Qatar ............................................ +974
  1633. Reunion .......................................... +262
  1634. Romania ..........................................  +40
  1635. Russia ...........................................   +7
  1636. Rwanda ........................................... +250
  1637. Saint Helena ..................................... +290
  1638. Saint Kitts ......................................   +1
  1639. Saint Lucia ......................................   +1
  1640. Saint Vincent and Grenadines .....................   +1
  1641. Samoa, American ..................................   +1
  1642. Samoa, Western ................................... +685
  1643. San Marino .......................................  +39
  1644. Sao Tome and Principe ............................ +239
  1645. Saudi Arabia ..................................... +966
  1646. Senegal .......................................... +221
  1647. Serbia-Montenegro ................................ +381
  1648. Seychelles ....................................... +248
  1649. Sierra Leone ..................................... +232
  1650. Singapore ........................................  +65
  1651. Slovak Republic ..................................  +42
  1652. Solomon Islands .................................. +677
  1653. Somali ........................................... +252
  1654. South Africa .....................................  +27
  1655. Spain ............................................  +34
  1656. Sri Lanka ........................................  +94
  1657. Sudan ............................................ +249
  1658. Suriname ......................................... +597
  1659. Swaziland ........................................ +268
  1660. Sweden ...........................................  +46
  1661. Switzerland ......................................  +41
  1662. Syrian Arab Republic ............................. +963
  1663. Tahiti ........................................... +689
  1664. Taiwan (Republic of China) ....................... +886
  1665. Tajikistan .......................................   +7
  1666. Tanzania ......................................... +255
  1667. Thailand .........................................  +66
  1668. Togo ............................................. +228
  1669. Tonga ............................................ +676
  1670. Trinidad &. Tobago ................................   +1
  1671. Tunisia .......................................... +216
  1672. Turkey ...........................................  +90
  1673. Turkmenistan .....................................   +7
  1674. Turks &. Caicos Islands ...........................   +1
  1675. Tuvalu ........................................... +688
  1676. Uganda ........................................... +256
  1677. Ukraine ..........................................   +7
  1678. United Arab Emirates ............................. +971
  1679. United Kingdom ...................................  +44
  1680. United States of America .........................   +1
  1681. Uruguay .......................................... +598
  1682. Uzbekistan .......................................   +7
  1683. Vanuatu .......................................... +678
  1684. Vatican City .....................................  +39
  1685. Venezuela ........................................  +58
  1686. Vietnam ..........................................  +84
  1687. Virgin Islands, British ..........................   +1
  1688. Virgin Islands, USA ..............................   +1
  1689. Yemen Arab Republic .............................. +967
  1690. Yugoslavia (Serbia-Montenegro) ................... +381
  1691. Zaire ............................................ +243
  1692. Zambia ........................................... +260
  1693. Zimbabwe ......................................... +263
  1694. :font facename=default size=0x0.
  1695. :exmp.
  1696.  
  1697. :h1.APPENDIX II&colon. Summary of Kermit Environment Variables
  1698.  
  1699. :table cols='20 20 20'.
  1700. :row.
  1701. :c.Environment variable   
  1702. :c.Corresponding command      
  1703. :c.Kermit variable
  1704. :row.
  1705. :c.K_DIAL_DIRECTORY       
  1706. :c.SET DIAL DIRECTORY
  1707. :row.
  1708. :c.K_COUNTRYCODE          
  1709. :c.SET DIAL COUNTRY-CODE           
  1710. :c.\v(d$cc)
  1711. :row.
  1712. :c.K_AREACODE             
  1713. :c.SET DIAL AREA-CODE              
  1714. :c.\v(d$ac)
  1715. :row.
  1716. :c.K_INTL_PREFIX          
  1717. :c.SET DIAL INTL-PREFIX            
  1718. :c.\v(d$ip)
  1719. :row.
  1720. :c.K_LD_PREFIX            
  1721. :c.SET DIAL LD-PREFIX              
  1722. :c.\v(d$lp)
  1723. :row.
  1724. :c.K_PBX_OUTSIDE          
  1725. :c.SET DIAL PBX-OUTSIDE-PREFIX
  1726. :row.
  1727. :c.K_PBX_INSIDE           
  1728. :c.SET DIAL PBX-INSIDE-PREFIX
  1729. :row.
  1730. :c.K_PBX_EXCHANGE         
  1731. :c.SET DIAL PBX-EXCHANGE
  1732. :row.
  1733. :c.K_TF_PREFIX            
  1734. :c.SET DIAL TOLL-FREE-PREFIX
  1735. :row.
  1736. :c.K_TF_AREACODE          
  1737. :c.SET DIAL TOLL-FREE-AREACODE
  1738. :etable.
  1739.  
  1740. :h1.APPENDIX III&colon. Dialing Command List
  1741.  
  1742. Actions&colon.
  1743. :sl compact.
  1744. :li.DIAL [ <number> ]
  1745. :li.PDIAL [ <number> ]
  1746. :li.REDIAL
  1747. :li.ANSWER [ <seconds> ]
  1748. :li.HANGUP
  1749. :li.LOOKUP <name>
  1750. :li.CLEAR DIAL-STATUS
  1751. :esl.
  1752. :p.
  1753. Configuration&colon.
  1754. :sl compact.
  1755. :li.SET DIAL AREA-CODE [ <number> ]
  1756. :li.SET DIAL CONFIRMATION { ON, OFF }
  1757. :li.SET DIAL COUNTRY-CODE [ <number> ]
  1758. :li.SET DIAL CONVERT-DIRECTORY { ASK, ON, OFF }
  1759. :li.SET DIAL DIRECTORY [ <filename> ]
  1760. :li.SET DIAL DISPLAY { ON, OFF }
  1761. :li.SET DIAL HANGUP { ON, OFF }
  1762. :li.SET DIAL INTERVAL <seconds>
  1763. :li.SET DIAL INTL-PREFIX <number>
  1764. :li.SET DIAL INTL-SUFFIX [ <text> ]
  1765. :li.SET DIAL LD-PREFIX <number>
  1766. :li.SET DIAL LD-SUFFIX [ <text> ]
  1767. :li.SET DIAL METHOD { PULSE, TONE, DEFAULT }
  1768. :li.SET DIAL PBX-EXCHANGE [ <number> ]
  1769. :li.SET DIAL PBX-INSIDE-PREFIX [ <number> ]
  1770. :li.SET DIAL PBX-OUTSIDE-PREFIX [ <number> ]
  1771. :li.SET DIAL PREFIX [ <text> ]
  1772. :li.SET DIAL RETRIES <number>
  1773. :li.SET DIAL SORT { ON, OFF }
  1774. :li.SET DIAL SUFFIX [ <text> ]
  1775. :li.SET DIAL TIMEOUT <number>
  1776. :li.SET DIAL TOLL-FREE-AREA-CODE [ <number> ]
  1777. :li.SET DIAL TOLL-FREE-PREFIX [ <number> ]
  1778. :li.SHOW DIAL
  1779. :esl.
  1780. :euserdoc.i