home *** CD-ROM | disk | FTP | other *** search
/ PC World 2000 November / PCWorld_2000-11_cd.bin / Akce / setup.exe / data1.cab / DataFilesModemCommandScripts / template.mdm < prev    next >
Text File  |  2000-08-20  |  37KB  |  892 lines

  1. ;                - A SAMPLE MODEM COMMAND FILE -
  2.  
  3. ; Last revision date: 03/07/99
  4.  
  5. ; The modem command files supplied with Lotus Notes (see EOF
  6. ; [Ctrl End] to learn how to obtain modem command files not 
  7. ; yet shipped with this Notes/Domino release) are written to support
  8. ; a variety of modems, incorporating the greatest possible 
  9. ; interoperability between different modem types. If 
  10. ; cross-brand-compatibility is not an issue, users may choose 
  11. ; to edit a command file to optimize it for a particular modem.
  12.  
  13. ; In addition, users can work with a modem for which no command 
  14. ; file is supplied by editing an existing file which uses 
  15. ; similar commands. The fact that Lotus provides command files 
  16. ; for specific modems should not be construed as an endorsement 
  17. ; of a particular brand or model of modem, nor should the 
  18. ; absence of a file be interpreted as a reflection upon any
  19. ; brand or modem. The majority of modems available will work 
  20. ; well with Lotus Notes if the proper commands and responses
  21. ; are used, and new command files are added to the current
  22. ; list regularly.
  23.  
  24. ; This file is a sample provided to help explain the contents of 
  25. ; a Lotus Notes modem command file. The attributes, commands, and 
  26. ; responses shown below are merely examples developed for a 
  27. ; "Hayes compatible" (any modem which uses the standard AT set for 
  28. ; basic commands) 9600 bps modem and should be regarded as examples 
  29. ; only. 
  30.  
  31. ; A Notes modem command file (or .mdm file) serves the purpose 
  32. ; of communicating between the Notes application and the Notes XPC
  33. ; modem driver. It does not communicate directly to the modem, that
  34. ; is done by the XPC driver. A Notes modem command file is a user 
  35. ; editable ASCII text file which, via the XPC driver, automatically
  36. ; performs the same operations which, in a simpler communications 
  37. ; application, the user may perform manually, by typing instructions
  38. ; directly at the keyboard.  In a normally successful call, the flow 
  39. ; of control from the user via the Notes user interface (UI) is as
  40. ; follows:
  41.  
  42. ; UI-> NOTES PRGM-> MDM FILE-> XPC DRIVER-> MODEM <-> REMOTE MODEM
  43.  
  44. ; A typical modem command file is divided into three sections 
  45. ; (four, for the atypical "auto-configure" file auto.mdm--the 
  46. ; install default, described in NOTE[1] at the end of this 
  47. ; document*). Each section begins with the name of the section 
  48. ; enclosed in square brackets (for example: [commands]). 
  49.  
  50. ; All blank lines and lines beginning with a semicolon are 
  51. ; ignored by the Notes XPC driver; they are for better user
  52. ; understanding and readability purposes only. All other lines
  53. ; are either section indicators, or parameters being specified
  54. ; for that section. The format of each parameter specifier
  55. ; depends upon the section in which it appears, but all 
  56. ; parameter specifiers consist of a parameter name followed 
  57. ; by an equal sign (=), followed by a value or values. The values 
  58. ; are all ASCII strings which are used exactly as they are 
  59. ; specified in the command file, with the exception of 
  60. ; "special character" processing. 
  61.  
  62. ; Briefly, there are two special characters, the backslash (\) 
  63. ; and the caret (^). These characters modify the Notes XPC 
  64. ; driver's interpretation of the characters that immediately 
  65. ; follow them. When a given modem uses either of them as part 
  66. ; of a command (for example \B1 or ^C2, as listed in the vendor's 
  67. ; manual), in a Notes command file this special character must 
  68. ; be preceded by a backslash (i.e., \\ or \^) in order for the modem
  69. ; not to return an ERROR response. In the examples just given, 
  70. ; the commands must be written \\B1 or \^C2.
  71.  
  72. ; (For more complete information on special character 
  73. ; processing, see the detailed NOTE[2] at the end of this 
  74. ; document.**)
  75.  
  76. ;===============================================================
  77.  
  78. ; In general, any given command file will contain only  a 
  79. ; subset of the possible parameters for each section. A fairly
  80. ; complete summary of the sections and their parameters 
  81. ; follows (all normally followed by an equal sign and an
  82. ; XPC-interpetable parameter setting):
  83.  
  84. ; 1.  [attributes] (modem characteristics)
  85. ; MODELS
  86. ; NULL MODEM
  87. ; MAXIMUM SPEED
  88. ; DEFAULT SPEED
  89. ; FIXED SPEED
  90. ; CARRIER CONNECT
  91.  
  92. ; 2.  [commands] (sent by the Notes XPC driver to the modem)
  93. ; ESCAPE
  94. ; ATTENTION
  95. ; INQUIRE
  96. ; HANGUP
  97. ; SETUP
  98. ; RTS/CTS ENABLED
  99. ; RTS/CTS IGNORED
  100. ; VOLUME OFF
  101. ; VOLUME LOW
  102. ; VOLUME MEDIUM
  103. ; VOLUME HIGH
  104. ; ANSWER
  105. ; MANUAL DIAL
  106. ; AUTO DIAL SETUP
  107. ; AUTO PULSE DIAL
  108. ; AUTO TONE DIAL 
  109. ; AUTO DIAL SUFFIX
  110.  
  111. ; 3.  [responses] (sent by the modem to the Notes XPC driver)
  112. ; OK
  113. ; BUSY
  114. ; NO ANSWER
  115. ; NO CARRIER
  116. ; NO DIAL TONE
  117. ; NO DIALTONE
  118. ; ERROR
  119. ; RING
  120. ; CONNECT
  121. ; CARRIER
  122.  
  123. ; 4.  [files] (used during "auto-configure" only)
  124. ; List of files to which the auto-configure file points based 
  125. ; on product code returned after the INQUIRE command (see NOTE[1]*
  126. ; at the end of this document)
  127.  
  128. ;=============================================================
  129.  
  130. [attributes]
  131.  
  132. ; This section of "A Sample Modem Command File" defines the 
  133. ; hardware attributes of the modem. 
  134.  
  135. MODELS=. A Sample Modem Command File
  136.  
  137. ; The MODELS attribute identifies the modem models this 
  138. ; command file controls. The information to the right of the 
  139. ; equal sign of the MODELS attribute is displayed in the Notes
  140. ; "Modem Type" listbox in the "Setup" dialog (in this case,
  141. ; "A Sample Modem Command File", as listed above). The 
  142. ; "MODELS=" information is for display purposes only, and is
  143. ; not used by the software for any other purpose. 
  144.  
  145. NULL MODEM=0
  146.  
  147. ; Setting the NULL MODEM attribute to 1 indicates that there 
  148. ; is no hardware to receive commands or issue responses. 
  149. ; Leaving the NULL MODEM line out or setting it to any other 
  150. ; value indicates that there really is a modem to receive the 
  151. ; commands and issue responses.
  152.  
  153. MAXIMUM SPEED=115200
  154.  
  155. ; The MAXIMUM SPEED attribute specifies the maximum speed 
  156. ; that can be used when the XPC driver is talking to the 
  157. ; modem locally, through the computer's COM port. 
  158.  
  159. ; The actual maximum speed used by the XPC driver is the 
  160. ; lesser of the MAXIMUM SPEED attribute specified in the 
  161. ; command file and the maximum port speed specified in 
  162. ; the UI "Setup" dialog. Command files for modems capable of 
  163. ; on-the-fly data compression (V.42 bis or MNP-5 protocols,
  164. ; for example) generally should have their MAXIMUM and DEFAULT 
  165. ; speeds set higher than the maximum carrier speed, in order to
  166. ; gain the advantage of such compression. A general rule of
  167. ; should be to set the port speed to up to four times that of
  168. ; the highest carrier speed of which the modem generally connects.
  169. ; Therefore, in the absence of special equipment designed for
  170. ; the purpose, 115200 bps is generally adequate.
  171.  
  172. DEFAULT SPEED=115200
  173.  
  174. ; No longer used by the XPC driver, the DEFAULT SPEED 
  175. ; attribute was formerly used to help the software
  176. ; software synchronize with the modem (pre-Rel. 4.0). 
  177.  
  178. FIXED SPEED=0
  179.  
  180. ; Needed only in null modem command files (in actual modems,
  181. ; speed should be controlled exclusively by appropriate modem 
  182. ; commands and responses; FIXED SPEED should be set to 0, or
  183. ; left out altogether). If the FIXED SPEED attribute is set 
  184. ; to a numeric value greater than 0, the driver will talk to 
  185. ; the modem at the maximum port speed (see the MAXIMUM SPEED 
  186. ; attribute) and will not adjust the port speed based on the 
  187. ; speed settings in the response parameters (discussed below).
  188.  
  189. CARRIER CONNECT=0
  190.  
  191. ; This attribute, recognized by Notes 3.2 and above on all
  192. ; platforms except the Macintosh (which does not recognize 
  193. ; actual carrier), is designed to allow Notes to recognize the 
  194. ; existence of a valid connection with a remote system on
  195. ; the basis of a high carrier signal from the modem via the
  196. ; RS-232 cable's carrier detect pin. If this attribute is set 
  197. ; equal to 1, any CONNECT responses become superfluous to the 
  198. ; function of Notes, and can be left as is, commented out, or 
  199. ; deleted without effect. The need for the addition of this 
  200. ; feature stems from the increasing use of Notes with assorted 
  201. ; types of "dumb" asynchronous communications equipment which 
  202. ; cannot be programmed to report a connection once achieved.
  203.  
  204. ;================================================================
  205.  
  206. [commands]
  207.  
  208. ; NOTE: Commands in this section are based on the basic AT--for 
  209. ; ATtention--command set developed by Hayes Microcomputer Products 
  210. ; Inc., a defacto standard recognized by most of today's modems, in
  211. ; which all commands are preceded by the letters AT. If your modem 
  212. ; recognizes commands other than Hayes commands, consult your user 
  213. ; manual or your modem vendor for equivalent commands.
  214.  
  215. ; This section lists the commands issued by the driver to the 
  216. ; modem for setup, dialing, etc. Unless otherwise specified, 
  217. ; at least one string should be specified for each command 
  218. ; type, and as many as 15 may be specified for each command 
  219. ; type. There are no defaults directly provided by the XPC driver
  220. ; for any commands, all commands come from the modem command file.
  221.  
  222. ; Note that, confusing though this may appear to the new user,
  223. ; most modems do not recognize commands after a space in a
  224. ; command string.  Thus an array of commands may be concatenated
  225. ; on one line, with no separation between them. To illustrate:
  226.  
  227. ;    ATE0V1
  228.  
  229. ; is actually two AT commands strung together: E0 (local Echo OFF) 
  230. ; and V1 (Verbose mode--or "word" mode--ON). The following string 
  231. ; would be considered illegal by most modems:
  232.  
  233. ;    AT E0 V1
  234.  
  235. ; Ordering of individual commands (e.g. &C1) within a command 
  236. ; file line (or horizontal string) is irrelevant, but all commands
  237. ; of a given type (e.g. ESCAPE, or SETUP) are issued by the Notes 
  238. ; XPC driver to the modem in the order specified (vertically, from
  239. ; the top down, each followed by a carriage return). Thus with the
  240. ; two discrete commands E0 and V1, the string:
  241.  
  242. ;    SETUP=ATE0VI
  243.  
  244. ; is interpreted by Notes and the modem the same as:
  245.  
  246. ;    SETUP=ATV1E0
  247.  
  248. ; would be interpreted. However,
  249.  
  250. ;    SETUP=ATEO
  251. ;    SETUP=ATV1
  252.  
  253. ; is not interpreted the same as:
  254.  
  255. ;    SETUP=ATV1
  256. ;    SETUP=ATEO
  257.  
  258. ; which is read as two discrete commands interpreted separately, 
  259. ; in reverse order to that of the previous set. Knowing this 
  260. ; becomes important when debugging a file which is producing an 
  261. ; error message resulting from issuing conflicting commands in
  262. ; separate command lines--it may be that the actual error is in 
  263. ; a line preceding the one which returns the apparent error.
  264.  
  265. ; The command type appears to the left of the equal sign and 
  266. ; tells the XPC driver which kind of command this is. The 
  267. ; command value appears to the right of the equal sign and is
  268. ; sent by the driver to the modem without case, white space 
  269. ; changes, or other modification; each command value should be 
  270. ; constructed such that it obeys the length, case, and 
  271. ; white-space rules particular to the modem for which the 
  272. ; command file is intended. 
  273.  
  274. ; The maximum number of characters permitted in a command 
  275. ; string can vary from one brand or model of modem to another. 
  276. ; This buffer may be anywhere between 40 and 255 (on a very 
  277. ; old modem the limit might be as low as 25). For ease of 
  278. ; editing, and to be on the safe side, it is advised 
  279. ; that strings to the right of the AT command not exceed 40 
  280. ; (usually more than adequate for normal purposes--if you need
  281. ; to exceed this, begin a new command line, with the command 
  282. ; string preceded by SETUP=AT).
  283.  
  284. ; Some command strings may contain more than one equal sign. 
  285. ; When this is the case, the first equal sign is treated as 
  286. ; the type/value delimiter (to the Notes XPC driver) and all 
  287. ; additional equal signs are considered as part of the command
  288. ; value to the modem (as with S-Registers, all of which are 
  289. ; phrased as Sn=n, where the first n specifies--stores in a
  290. ; memory "register"--a modem feature setting, and the second
  291. ; letter n quantifies a selected parameter, or bitmaps a 
  292. ; desired group of settings).
  293.  
  294. ESCAPE=+++
  295.  
  296. ; The driver sends the ESCAPE command to put the modem 
  297. ; into command mode. (Only the first ESCAPE command listed 
  298. ; in the command file is sent to the modem. Any subsequent 
  299. ; ESCAPE commands are ignored.) Among modem manufacturers
  300. ; it is customary to use the symbols "+++" for the escape
  301. ; sequence, usually both preceded and followed by a one
  302. ; second delay so as not to confuse the modem into going
  303. ; back into command mode should the actual ASCII characters
  304. ; "+++" be embedded in text which is being transmitted.
  305.  
  306. ; Since this method of escape from online mode is patented
  307. ; by Hayes Microcomputer Products, Inc., a few other modem
  308. ; manufacturers have opted NOT to pay for the license
  309. ; to use this method, and have simply used a "time independent
  310. ; escape sequence" (in which case steps 1 and 3 in the 
  311. ; following numbered paragraphs will not apply, but 2 and 4 
  312. ; remain true).
  313.  
  314. ATTENTION=ATE0V1
  315.  
  316. ; The XPC driver sends the ATTENTION command to elicit a 
  317. ; response from the modem so that the driver knows that it 
  318. ; has synchronized its port speed with the modem.
  319.  
  320. ; If the modem obeys the Hayes patented "time dependent 
  321. ; escape sequence," when the XPC driver tries to get the
  322. ; modem's attention in order to issue modem commands, it 
  323. ; performs the following steps:
  324.  
  325. ; 1. Waits one second.
  326.  
  327. ; 2. Issues the ESCAPE command string (+++) above described
  328. ;    (no response from the modem is required).
  329.  
  330. ; 3. Waits another second.
  331.  
  332. ; 4. Issues the first ATTENTION command listed in the 
  333. ;    command file (in most Notes .mdm command files, 
  334. ;    ATE0V1--ATtention, Echo OFF, Verbal mode ON, which are
  335. ;    basic Hayes commands recognized by the vast majority
  336. ;    of modems).
  337.  
  338. ; If the modem responds to the ATTENTION command with 
  339. ; an OK response, the driver sets the modem speed to the 
  340. ; Default Speed (as described in the "attributes" section 
  341. ; above), and then continues with the next ATTENTION 
  342. ; command listed in the command file. If the modem fails
  343. ; to respond with an OK to any ATTENTION command, the
  344. ; driver sets the port to another speed and starts again 
  345. ; at Step 1 (or step 2 if the modem does not employ a time
  346. ; dependent escape sequence).
  347.  
  348. ; The first ATTENTION command is used by Notes to "acquire" 
  349. ; the modem's "attention" and to set the modem speed as 
  350. ; just described. Any additional commands are issued once 
  351. ; the speed has been set. The response to each command is 
  352. ; checked by Notes and any AT command or string resulting 
  353. ; in an ERROR response from the modem (or failure to detect
  354. ; an expected OK response) will cause the escape and
  355. ; synchronization sequence to be resumed. In a perfectly
  356. ; functioning configuration, this process will repeat over
  357. ; and over until dial timeout on a workstation, or until
  358. ; shutdown on a server. In real life, an occasional glitch
  359. ; in CPU timing or brief occurrence of electromagnetic
  360. ; interference (EMI) may cause a problem, thus it makes
  361. ; sense that Notes is programmed to try again in the event
  362. ; of initial failure to get the modem's attention.
  363.  
  364. ; If the Notes log is enabled via the UI, the word "ERROR"
  365. ; will appear in the desktop database log.nsf, Miscellaneous
  366. ; Events view subsequent to the failure point in the
  367. ; initialization attempt.
  368.  
  369. INQUIRE=ATI0
  370.  
  371. ; The INQUIRE command is specified only in the so called 
  372. ; "auto-configure" command files (described more completely in 
  373. ; NOTE[1] at the end of this document*). An auto-configure command 
  374. ; file (such as the auto.mdm) contains an INQUIRE command and a 
  375. ; "[file]" section (described in greater detail later in this 
  376. ; document). When the INQUIRE command is specified in a command 
  377. ; file, the driver issues the command immediately after the 
  378. ; ATTENTION command sequence. The modem's response to the INQUIRE
  379. ; command is used by the XPC driver to identify which of the 
  380. ; .mdm command files listed later in the "files" section of the 
  381. ; auto-configure command file is to be used to control the modem.
  382.  
  383. HANGUP=ATH0
  384.  
  385. ; After the last ATTENTION command (if no INQUIRE command 
  386. ; has been specified) the driver issues the HANGUP commands. 
  387. ; The HANGUP command is needed in case the modem has not yet 
  388. ; hung up from a previous call.  (Since not all modems may
  389. ; respond correctly to a hangup command if there is no current 
  390. ; call in progress, the XPC driver ignores all modem responses
  391. ; to the HANGUP command.)
  392.  
  393. SETUP=AT&F
  394. SETUP=ATE0V1
  395. SETUP=AT&D2&C1S0=00X4
  396.  
  397. ; Next, the driver issues each SETUP command or string in the 
  398. ; order specified in the command file. These commands set up 
  399. ; the modem's basic operating characteristics. The Notes XPC 
  400. ; driver requires that these characteristics include the 
  401. ; following:
  402.  
  403. ; 1. Under normal operation (irrespective of the previous ATH0 
  404. ; command, which forces HANGUP during modem initialization), 
  405. ; the XPC driver hangs up a call by lowering the DTR 
  406. ; (Data Terminal Ready) signal. Therefore, the modem must 
  407. ; be configured so that lowering DTR causes hangup and return 
  408. ; to command state (&D2 or, in a few cases, &D3).
  409.  
  410. ; 2. The modem senses that a call has hung up by noticing 
  411. ; that the carrier signal has dropped. Therefore, the modem 
  412. ; must be set up such that DCD (Data Carrier Detect) tracks 
  413. ; the carrier signal from the remote modem (&C1).
  414.  
  415. ; 3. Auto-answer must be disabled (S0=0). The XPC driver has 
  416. ; been designed to issue an ANSWER command when it 
  417. ; encounters a RING from the local modem. This makes 
  418. ; auto-answer unnecessary. Auto-answer is not desirable 
  419. ; since a modem in this mode will answer a ringing phone 
  420. ; even if the software is not running, thus incurring
  421. ; needless telephone charges. 
  422.  
  423. ; It is recommended that command echoing be disabled (E0), 
  424. ; that factory defaults be set before specifying the above
  425. ; three settings (&F, usually), and that verbose (word)
  426. ; responses be employed by the modem (V1) when working in 
  427. ; Notes Version 2 or later releases.
  428.  
  429. VOLUME OFF=ATM0
  430. VOLUME LOW=ATM1L1
  431. VOLUME MEDIUM=ATM1L2
  432. VOLUME HIGH=ATM1L3
  433.  
  434. ; After the SETUP command, the driver issues one VOLUME 
  435. ; command (M0 or M1). Any additional VOLUME commands listed 
  436. ; in the driver are ignored. 
  437.  
  438. ; The VOLUME command which is issued, either VOLUME OFF, 
  439. ; VOLUME LOW, VOLUME MEDIUM, or VOLUME HIGH (L1, L2, or L3),
  440. ; is set based upon the option specified in the UI "Setup" 
  441. ; dialog.
  442.  
  443. RTS/CTS ENABLED=AT&K3
  444. RTS/CTS IGNORED=AT&K0
  445.  
  446. ; After the VOLUME command sequence, the driver issues 
  447. ; either the RTS/CTS ENABLED or RTS/CTS IGNORED command, 
  448. ; depending upon the option specified in the UI "Setup" 
  449. ; dialog (hardware flow control between computer and
  450. ; modem).
  451.  
  452. ; After the RTS/CTS command, the driver waits either for 
  453. ; an incoming call (i.e., a RING response from the modem) 
  454. ; or for the local software to request a dial. 
  455.  
  456. ; MACINTOSH NOTE: Many Macintosh models do not support 
  457. ; hardware flow control between the computer and the 
  458. ; modem unless a special high-speed serial cable is 
  459. ; employed. Should remote data transfer fail using a 
  460. ; Macintosh, try lowering the speed to the maximum carrier
  461. ; speed possible between the local and remote modems.
  462.  
  463. ANSWER=ATA
  464.  
  465. ; On incoming calls, the driver issues a single ANSWER 
  466. ; command. Any additional ANSWER commands are ignored. 
  467. ; The driver then waits for the modem to respond with a 
  468. ; CONNECT response or with one of the error responses. 
  469. ; All other responses are regarded as merely informational 
  470. ; messages being sent by the modem for logging purposes, 
  471. ; and are ignored.
  472.  
  473. ; There are two types of outgoing calls: Manual and automatic. 
  474. ; Each will be discussed separately.
  475.  
  476. MANUAL DIAL=ATX3S9=1D,
  477.  
  478. ; The XPC driver issues the MANUAL DIAL command when the 
  479. ; user, rather than the modem, does the actual dialing. This 
  480. ; is necessary, for example, whenever operator assistance 
  481. ; is required, or whenever the phone system being used 
  482. ; does not recognize the tones generated by the modem.
  483.  
  484. ; MANUAL DIAL is not available on the server. It may only 
  485. ; be done via the workstation "Call..." option: the user instructs 
  486. ; the software to issue the MANUAL DIAL commands after 
  487. ; hearing the phone ring at the remote modem's end or after 
  488. ; hearing the remote modem generating carrier (depending 
  489. ; on the modem). Since the modem does not do the dialing 
  490. ; in this case, no telephone number will be appended to the 
  491. ; MANUAL DIAL command.
  492.  
  493. ; It has been found that some modems operating in this mode 
  494. ; have special requirements for sensing the carrier signal. 
  495. ; This is the reason for the "S9" setting shown in our example 
  496. ; shown below. 
  497.  
  498. ; Also, this mode requires that the modem must not wait for 
  499. ; the dial tone, as this is done by the user. This is the 
  500. ; reason for the "X3" setting shown in our example (check your
  501. ; modem vendor's manual for a more complete explanation of the 
  502. ; various parameters controlled by the "X" command).
  503.  
  504. ; The driver will issue only the first MANUAL DIAL command 
  505. ; contained in this file. Any additional MANUAL DIAL 
  506. ; commands will be ignored.
  507.  
  508. AUTO DIAL SETUP=ATS9=6
  509. AUTO PULSE DIAL=ATDP
  510. AUTO TONE DIAL=ATDT
  511. AUTO DIAL SUFFIX=,
  512.  
  513. ; Automatic dialing is the only form of dialing used by the 
  514. ; server.  It may also be selected at the workstation for
  515. ; immediate or scheduled dialing. 
  516.  
  517. ; Before issuing any of the auto-dialing commands, the 
  518. ; driver first initializes the modem, as outlined above, up 
  519. ; to and including the VOLUME command.
  520.  
  521. ; The driver issues each of the SETUP command strings
  522. ; included in the command file, waiting for the modem to issue 
  523. ; an OK response after each string. The driver then 
  524. ; constructs the actual dial command by appending the phone 
  525. ; number to either the AUTO PULSE DIAL or AUTO TONE 
  526. ; DIAL command, and then appending the AUTO DIAL SUFFIX 
  527. ; string. The pulse (ATDP) vs. tone (ATDT) command decision 
  528. ; is based on the dial mode selected via the workstation 
  529. ; Notes UI "Setup" dialog.
  530.  
  531. ; Note that the driver will issue only the first AUTO PULSE 
  532. ; DIAL or AUTO TONE DIAL command contained in the file.
  533. ; Note also that the AUTO DIAL SUFFIX is appended to that 
  534. ; dial command after the phone number, and is not a 
  535. ; separately issued command. It is intended to be used for 
  536. ; dial modifiers. (In the example given, one comma tells the 
  537. ; modem to pause two seconds after dialing, generally to 
  538. ; wait for line "noise" to diminish; this delay may be 
  539. ; extended by additional commas, or removed altogether, 
  540. ; depending on the needs of the local telephone system.)
  541.  
  542. [responses]
  543.  
  544. ; Responses are sent by the modem to the Notes XPC driver.
  545.  
  546. ; The response type appears on the left of the equal sign. 
  547. ; Each response type may be listed more than once, but 
  548. ; not more than 300 times. Ordering is irrelevant. 
  549.  
  550. ; The response value sent by the modem appears to the 
  551. ; right of the equal sign. The response value should be the 
  552. ; exact response issued by the modem (bearing in mind the
  553. ; case and white space sensitivity of the XPC driver). 
  554.  
  555. ; Optionally, a comma followed by a port speed may be 
  556. ; included after the response type. Where this occurs, the 
  557. ; driver sets the port to the speed after receiving the 
  558. ; specified response value. This is generally done only 
  559. ; for the CONNECT responses.
  560.  
  561. ; Note: The driver will not set its speed greater than the 
  562. ; value specified in the workstation UI "Setup" dialog.  If
  563. ; the modem is capable of dynamically adjusting its speed to
  564. ; that of the remote modem subsequent to connecting at the
  565. ; speed specified within Notes, refer to the commands and
  566. ; S-registers in the documentation for the means to disable
  567. ; this feature.
  568.  
  569. ; Optionally, a comma followed by a carrier speed may 
  570. ; be included after the port speed (with many modems, the 
  571. ; port speed may be left blank). In files for those modems 
  572. ; which respond this way, the Notes XPC driver records the
  573. ; carrier speed for display purposes. This does not affect
  574. ; the port speed; it is generally done only for either 
  575. ; the CONNECT or CARRIER responses.
  576.  
  577. ; All responses received from the modem that are not in this 
  578. ; list are treated as response type INFORMATIONAL, and 
  579. ; are ignored by Notes' XPC driver.
  580.  
  581. OK=OK
  582.  
  583. ; The OK response indicates a command correctly processed 
  584. ; by the modem.
  585.  
  586. BUSY=BUSY
  587.  
  588. ; The modem issues a BUSY response to indicate that the 
  589. ; remote phone was busy following a DIAL command.
  590.  
  591. NO ANSWER=NO ANSWER
  592.  
  593. ; The modem issues a NO ANSWER response to indicate 
  594. ; that the remote phone did not answer in a reasonable time 
  595. ; (as defined by the modem SETUP commands) following 
  596. ; a DIAL command.
  597.  
  598. NO CARRIER=NO CARRIER
  599.  
  600. ; The modem issues a NO CARRIER response to indicate that
  601. ; it could not establish a carrier within a reasonable 
  602. ; time (as defined by the modem SETUP commands or by 
  603. ; factory default) after the phone connection was established.
  604.  
  605. NO DIALTONE=NO DIALTONE
  606. NO DIALTONE=NO DIAL TONE
  607.  
  608. ; The modem issues a NO DIALTONE or NO DIALTONE response 
  609. ; to indicate that the modem could not detect a valid 
  610. ; dial tone after going off-hook to dial the remote system.
  611.  
  612. ; (Some modems respond with DIALTONE as one word, others 
  613. ; respond with "DIAL TONE". Both are included in many .mdm
  614. ; files to ensure that the XPC driver recognizes the 
  615. ; modem's phrasing in the event no dial tone is sensed,
  616. ; and the occurrence must be reported to the user or 
  617. ; administrator via the Notes program or its log.nsf.)
  618.  
  619. ERROR=ERROR
  620.  
  621. ; Seen in the Notes log.nsf, ERROR indicates that the modem 
  622. ; did not recognize the command last issued by the XPC driver. 
  623. ; This can result from an incorrect command within the file 
  624. ; (as often happens when the wrong command file is selected 
  625. ; via the Notes UI "Setup" dialog, when writing a file for a 
  626. ; new modem, or when CPU timing glitches or electromagnetic 
  627. ; interference garble the command between computer issuance 
  628. ; and modem receipt of same).
  629.  
  630. RING=RING
  631.  
  632. ; The modem issues a RING response locally when its internal 
  633. ; phone is ringing, i.e., upon receiving an incoming phone 
  634. ; call.
  635.  
  636.  
  637. CONNECT, 230400, 230400=CONNECT 230400*
  638. CONNECT, 115200, 115200=CONNECT 115200*
  639. CONNECT, 115200, 64000=CONNECT 64000*
  640. CONNECT, 115200, 62666=CONNECT 62666*
  641. CONNECT, 115200, 61333=CONNECT 61333*
  642. CONNECT, 115200, 60000=CONNECT 60000*
  643. CONNECT, 115200, 58666=CONNECT 58666*
  644. CONNECT, 115200, 57600=CONNECT 57600*
  645. CONNECT, 115200, 57333=CONNECT 57333*
  646. CONNECT, 115200, 56000=CONNECT 56000*
  647. CONNECT, 115200, 54666=CONNECT 54666*
  648. CONNECT, 115200, 54000=CONNECT 54000*
  649. CONNECT, 115200, 53333=CONNECT 53333*
  650. CONNECT, 115200, 52000=CONNECT 52000*
  651. CONNECT, 115200, 50666=CONNECT 50666*
  652. CONNECT, 115200, 50000=CONNECT 50000*
  653. CONNECT, 115200, 49333=CONNECT 49333*
  654. CONNECT, 115200, 48000=CONNECT 48000*
  655. CONNECT, 115200, 46666=CONNECT 46666*
  656. CONNECT, 115200, 46000=CONNECT 46000*
  657. CONNECT, 115200, 45333=CONNECT 45333*
  658. CONNECT, 115200, 44000=CONNECT 44000*
  659. CONNECT, 115200, 42666=CONNECT 42666*
  660. CONNECT, 115200, 42000=CONNECT 42000*
  661. CONNECT, 115200, 41333=CONNECT 41333*
  662. CONNECT, 115200, 40000=CONNECT 40000*
  663. CONNECT, 115200, 38666=CONNECT 38666*
  664. CONNECT, 115200, 38400=CONNECT 38400*
  665. CONNECT, 115200, 38000=CONNECT 38000*
  666. CONNECT, 115200, 37333=CONNECT 37333*
  667. CONNECT, 115200, 36000=CONNECT 36000*
  668. CONNECT, 115200, 34666=CONNECT 34666*
  669. CONNECT, 115200, 34000=CONNECT 34000*
  670. CONNECT, 115200, 33600=CONNECT 33600*
  671. CONNECT, 115200, 33333=CONNECT 33333*
  672. CONNECT, 115200, 32000=CONNECT 32000*
  673. CONNECT, 115200, 31200=CONNECT 31200*
  674. CONNECT, 115200, 30666=CONNECT 30666*
  675. CONNECT, 115200, 29333=CONNECT 29333*
  676. CONNECT, 115200, 28800=CONNECT 28800*
  677. CONNECT, 115200, 28000=CONNECT 28000*
  678. CONNECT, 115200, 26400=CONNECT 26400*
  679. CONNECT, 115200, 24000=CONNECT 24000*
  680. CONNECT, 115200, 21600=CONNECT 21600*
  681. CONNECT, 115200, 19200=CONNECT 19200*
  682. CONNECT, 115200, 16800=CONNECT 16800*
  683. CONNECT,  57600, 14400=CONNECT 14400*
  684. CONNECT,  19200, 12000=CONNECT 12000*
  685. CONNECT,   9600,  9600=CONNECT 9600*
  686. CONNECT,   9600,  7200=CONNECT 7200*
  687. CONNECT,   4800,  4800=CONNECT 4800*
  688. CONNECT,   2400,  2400=CONNECT 2400*
  689. CONNECT,   1200,  1200=CONNECT 1200*
  690.  
  691. ; The CONNECT responses are generated after a phone 
  692. ; connection has been made (either incoming or outgoing), 
  693. ; a carrier has been established, and any protocols to be 
  694. ; used internally by the modem have been negotiated with 
  695. ; the remote modem. 
  696.  
  697. ; Note that the speed indicator to the left of the equal 
  698. ; sign is critical to the XPC driver's setting the port 
  699. ; speed properly.
  700.  
  701. ; Also note that if CARRIER CONNECT in the attributes
  702. ; section is set greater than 0, Notes will ignore all
  703. ; connect responses and will assume a valid connection on
  704. ; the basis of carrier signal alone. The only platform
  705. ; for which this will not be true is the Macintosh, which
  706. ; does not recognize the presence of a physical carrier.
  707.  
  708. CARRIER,,115200=CARRIER 64000*
  709. CARRIER,,115200=CARRIER 62666*
  710. CARRIER,,115200=CARRIER 61333*
  711. CARRIER,,115200=CARRIER 60000*
  712. CARRIER,,115200=CARRIER 58666*
  713. CARRIER,,115200=CARRIER 57600*
  714. CARRIER,,115200=CARRIER 57333*
  715. CARRIER,,115200=CARRIER 56000*
  716. CARRIER,,115200=CARRIER 54666*
  717. CARRIER,,115200=CARRIER 54000*
  718. CARRIER,,115200=CARRIER 53333*
  719. CARRIER,,115200=CARRIER 52000*
  720. CARRIER,,115200=CARRIER 50666*
  721. CARRIER,,115200=CARRIER 50000*
  722. CARRIER,,115200=CARRIER 49333*
  723. CARRIER,,115200=CARRIER 48000*
  724. CARRIER,,115200=CARRIER 46666*
  725. CARRIER,,115200=CARRIER 46000*
  726. CARRIER,,115200=CARRIER 45333*
  727. CARRIER,,115200=CARRIER 44000*
  728. CARRIER,,115200=CARRIER 42666*
  729. CARRIER,,115200=CARRIER 42000*
  730. CARRIER,,115200=CARRIER 41333*
  731. CARRIER,,115200=CARRIER 40000*
  732. CARRIER,,115200=CARRIER 38666*
  733. CARRIER,,115200=CARRIER 38400*
  734. CARRIER,,115200=CARRIER 38000*
  735. CARRIER,,115200=CARRIER 37333*
  736. CARRIER,,115200=CARRIER 36000*
  737. CARRIER,,115200=CARRIER 34666*
  738. CARRIER,,115200=CARRIER 34000*
  739. CARRIER,,115200=CARRIER 33600*
  740. CARRIER,,115200=CARRIER 33333*
  741. CARRIER,,115200=CARRIER 32000*
  742. CARRIER,,115200=CARRIER 31200*
  743. CARRIER,,115200=CARRIER 30666*
  744. CARRIER,,115200=CARRIER 29333*
  745. CARRIER,,115200=CARRIER 28800*
  746. CARRIER,,115200=CARRIER 28000*
  747. CARRIER,,115200=CARRIER 26400*
  748. CARRIER,,115200=CARRIER 24000*
  749. CARRIER,,115200=CARRIER 21600*
  750. CARRIER,,115200=CARRIER 19200*
  751. CARRIER,,115200=CARRIER 16800*
  752. CARRIER,,115200=CARRIER 14400*
  753. CARRIER,,19200=CARRIER 12000*
  754. CARRIER,, 9600=CARRIER 9600*
  755. CARRIER,, 9600=CARRIER 7200*
  756. CARRIER,, 4800=CARRIER 4800*
  757. CARRIER,, 2400=CARRIER 2400*
  758. CARRIER,, 1200=CARRIER 1200*
  759.  
  760.  
  761. ; The CARRIER responses are generated by some modems (notably 
  762. ; Hayes, Practical Peripherals, and others which closely 
  763. ; follow Hayes' lead in AT command format) after the carrier 
  764. ; has been established, either incoming or outgoing. This 
  765. ; response is treated solely as information being sent by 
  766. ; the modem for logging purposes, and the only action taken
  767. ; by the Notes XPC driver is to "remember" the carrier speed 
  768. ; for display purposes. (This format, which includes the Hayes
  769. ; CARRIER responses, is less common among many other 
  770. ; manufacturers. More commonly the CONNECT syntax is (for 
  771. ; example): CONNECT=38400 (maximum DTE to DCE), 9600 (down 
  772. ; through lowest acceptable link rate--1200 for Notes), 
  773. ; (optionally followed by protocol syntax, e.g.:) 
  774.  
  775. ;       CONNECT, 57600,19200=CONNECT 19200 LAP-M
  776.  
  777. ; (Review several non-Hayes Modem Command Files [response] 
  778. ; code sections for a broader overview.)
  779.  
  780. ; Note: The CONNECT speed listed in the I/O log is usually 
  781. ; the speed between a modem and the port it is connected to 
  782. ; (DCE to DTE). These speeds may be different on 
  783. ; modems that can internally buffer the incoming and 
  784. ; outgoing byte streams. In Notes, however, with certain
  785. ; modems, the listed speed may be the DTE speed, depending
  786. ; upon the design of the modem's firmware.
  787.  
  788. ; The carrier speed (also called the "link rate") is the 
  789. ; speed between the two modems over the telephone lines.
  790.  
  791. ; The last CONNECT or CARRIER line of the command file must 
  792. ; be followed by ; a carriage return.  It is important to 
  793. ; remember this when cutting and pasting a printed .mdm file 
  794. ; from a word processor.
  795.  
  796. ;=============================================================
  797.  
  798. ; * NOTE[1] on INQUIRE command: The following .mdm file section 
  799. ; is included only in the so-named "auto-configure" command 
  800. ; file, i.e., a file which contains an INQUIRE command.  Other 
  801. ; "auto-configured" TARGET command files than those below should
  802. ; never appear under an auto-configured .mdm file's "[file]" 
  803. ; section, since they would only point to yet an additional 
  804. ; command file. 
  805.  
  806. [file]
  807.  
  808. ;GEN12.MDM=12 (for 1200 bps modems)
  809. ;GEN12.MDM=13 (for 1200 bps modems)
  810. ;GEN24.MDM=24 (for 2400 bps modems)
  811.  
  812. ; And for modems that are capable of a carrier speed 4800 bps
  813. ; or greater:
  814.  
  815. ;GEN9614.MDM=9 (for V.32 4800-9600 bps modems)
  816. ;GEN9614.MDM=1 (for V 32.bis 14400 or greater bps modems)
  817. ;GEN9614.MDM=2 (for V.34 28800 bps modems)
  818. ;GEN9614.MDM=3 (for V.34+ and higher speed modems modems)
  819.  
  820. ; The purpose of an auto-configure command file is to allow the 
  821. ; XPC driver to automatically select its "best guess" as to the 
  822. ; command file to be used in controlling the modem based on a 
  823. ; standard AT inquiry command. Among other things, this feature 
  824. ; can allow the modem attached to the port to be changed at any 
  825. ; time (even while Notes is running) without reconfiguring the 
  826. ; port control parameters via the "Setup Modem" dialog. 
  827.  
  828. ; This file section lists the command file to be loaded and used 
  829. ; by the Notes XPC driver based on the modem's response to the 
  830. ; INQUIRE command (ATI or ATI0). When a portion of the response 
  831. ; to the right of the equal sign is detected, the file named to 
  832. ; the left of the equal sign is used. Each command file may be 
  833. ; listed more than once (as with the GEN12.MDM, which might 
  834. ; return from the modem either a 12 or 13 in response to the ATI 
  835. ; command, or GEN9614.MDM which will select the utility generic
  836. ; file for modems which are capable of 4800 bps or greater).
  837.  
  838. ; In an auto-configure .mdm file, the response from the modem 
  839. ; does not have to exactly match the value to the right of the
  840. ; equal sign; the XPC driver reads only the first two digits 
  841. ; of the modem's response. In the example given above, a modem 
  842. ; response of "247" will cause the software to select the 
  843. ; GEN24.MDM command file. This is because, in most cases, the
  844. ; ATI command tells a modem to return the modem's product code, 
  845. ; the first two digits of which normally indicate the maximum
  846. ; carrier speed of which the modem is capable.  (This is not
  847. ; always true of modems capable of better than 9600 bps,
  848. ; for which a correct high-speed file should normally be used.)
  849.  
  850. ;==================================================================
  851.  
  852. ; ** NOTE[2] on Special Characters: There are two special 
  853. ; characters, the backslash (\) and more rarely the caret, or 
  854. ; circumflex (^). These characters modify the interpretation 
  855. ; of the characters which immediately follow them.
  856.  
  857. ; The backslash character (\) is used to specify arbitrary 8 
  858. ; bit values. The three characters following the backslash 
  859. ; must each be digits between 0 and 7, and together 
  860. ; are treated as a 3 digit octal integer. For example, the 
  861. ; sequence \015 is treated as the value 15 (octal) or 13 
  862. ; (decimal) and is equivalent to a carriage return.
  863.  
  864. ; The two exceptions to the standard four character backslash 
  865. ; sequence (for example \015) are the sequences \\ and \^ 
  866. ; which are used to represent, respectively, the backslash 
  867. ; character and the circumflex character.
  868.  
  869. ; Any character following the caret, or circumflex character (^) 
  870. ; will have its bit 6 cleared. For example, the two character 
  871. ; sequence ^M (octal 15) becomes the carriage-return 
  872. ; character (octal 15). This rule is true for all characters 
  873. ; following the caret/circumflex, including the caret/circumflex 
  874. ; itself. In order to include a circumflex character as part of a
  875. ; parameter value, use the backslash character escape sequence \^.
  876.  
  877. ;=================================================================
  878.  
  879.  
  880. ;  ADDITIONAL LOTUS NOTES MODEM COMMAND FILES NOT SHIPPED WITH
  881. ;  THE POINT RELEASE WITH WHICH YOU ARE CURRENTLY WORKING MAY BE 
  882. ;  OBTAINED THROUGH THE LOTUS "NOTES MOBILE SURVIVAL KIT," A 
  883. ;  CONTINUOUSLY UPDATED LOTUS NOTES DATABASE PUBLISHED VIA:
  884.  
  885. ;  LOTUS NOTES NETWORK (MOST RECENT REPLICA)
  886.  
  887. ;  IRIS DEVELOPMENT WEBSITE: http://www.notes.net/mod_surv.nsf
  888.  
  889. ;  LOTUS INFORMATION LIBRARY CD (UPDATED MONTHLY AND QUARTERLY)
  890.  
  891.  
  892.