home *** CD-ROM | disk | FTP | other *** search
/ Computer Shopper 108 / gp2demo.iso / business / mshare / disk2 / MSRFILES.2 / CLIENT.CON
Encoding:
Text File  |  1996-06-27  |  34.5 KB  |  834 lines

  1. @@Main Menu Choices
  2. From the Main menu you must select either a parameter file
  3. type (ModemShare server or ModemShare client) or choose
  4. the Quit option to exit from the Parameter Editor.
  5.  
  6. Choosing a parameter file type will automatically begin an
  7. editing session for the parameter type you selected.
  8. @@Client Edit Menu Choices
  9. From the Client Edit menu you select one of the general
  10. categories shown to change the values. To end the edit
  11. session, select the File option and choose either Quit
  12. (which discards any changes) or Save (which saves any
  13. changes that you have made).
  14. @@Done
  15. Choose this option when you have finished editing all of
  16. the categories for the object you have selected.
  17. @@Buffer Size
  18. Specify the amount of space (in bytes) to be reserved for
  19. buffers. Buffers are used to hold information sent to and
  20. received from the ModemShare server. Generally, the
  21. movement of information across the network (between the
  22. server and ModemShare client) is much faster than the
  23. movement of data across communication lines. Data is
  24. therefore saved in buffers until it can be sent by the
  25. server or received by the communications program being
  26. run in the client. Providing more buffer space in a client
  27. allows the system to more efficiently process your
  28. communication data since there will be fewer conditions in
  29. which the system will need to wait for buffer space. The
  30. default value is 8192 bytes and the minimum value is 6144
  31. bytes.
  32. @@Client Communications Parameters
  33. Specify communications parameters (baud rate, parity,
  34. data bits, and stop bits) and select the type of flow
  35. control desired. While the type of flow control desired
  36. should always be specified, the remaining communications
  37. parameters should not be supplied if you want to use the
  38. default parameters provided by the ModemShare server.
  39.  
  40. Communications values specified by the ModemShare client
  41. will override the server values when a connection is made.
  42. @@Client Flow Control
  43. Specify whether or not you want to use flow control and,
  44. if so, the type of flow control desired. You shouldn't
  45. specify flow control if you want to use the default flow
  46. control provided by the ModemShare server, as any value
  47. you specify here will override the server value when a
  48. connection is made.
  49. @@Client Server Name
  50. In ModemShare, servers are not separated by name.
  51. Any ModemShare server that has a line available which
  52. matches the ModemShare client request can make the
  53. connection.
  54.  
  55. Server names can have a maximum of 16 characters unless
  56. you're using the NASI interface, in which case the server
  57. name can have a maximum of eight characters.
  58.  
  59. IMPORTANT NOTE for NASI users - the NASI architecture
  60. expects that each server will have a different name. In
  61. addition, NASI expects that -
  62.  
  63.   o  Every line will belong to at least one group
  64.   o  You will not have duplicate group/line pair names
  65.      on different Servers
  66.  
  67. INSYNC ModemShare permits duplicate group/line pair names
  68. to exist. Having duplicate group/line pair names may
  69. cause problems for communications programs using the NASI
  70. interface.
  71.  
  72. You can avoid any problems using the NASI interface if you
  73.  
  74.   o  Ensure that server, group, and line names don't
  75.      exceed the maximum lengths for the NASI interface
  76.   o  Make sure that each line name is unique across all
  77.      servers
  78.   o  Make sure that each line belongs to at least one
  79.      group
  80. @@Client Connection Values
  81. Specify the information used to request a connection from
  82. a ModemShare server. This information includes the name of
  83. the server, the name of a group of lines or a specific
  84. line name requested. You also select whether or not you
  85. want:
  86.   o  The ModemShare client to automatically retry the
  87.      connection request if no server answers
  88.   o  A server to queue the request if all the lines that
  89.      could be used to satisfy the request are in use.
  90.  
  91. A connection can also be requested by passing a string
  92. (usually a phone number) which will be automatically sent
  93. to the modem (the modem must be Hayes-compatible).
  94. @@Client Network Parameters
  95. Specify various parameters that control such things as how
  96. long a ModemShare client will wait for a response for
  97. service, and the size of and frequency of sending packets
  98. (blocks of data) over the network. All parameters in this
  99. area have default values and you shouldn't specify any of
  100. these parameters unless you have a specific reason to do
  101. so.
  102. @@Client Inbound Service
  103. Specify the default service name that the ModemShare
  104. client will respond to (accept) if a ModemShare server
  105. requests a client to accept an incoming call. The name
  106. supplied here is used only if the client is conditioned
  107. to accept an incoming call using the INHOST program
  108. without specifying a service name.
  109.  
  110. Note that the inbound facility isn't the same as a client
  111. using a modem to auto-answer an incoming phone call.
  112. @@Client Group/Line Name
  113. This name is used when requesting a port from a
  114. ModemShare server.
  115.  
  116. The name can be either the name of a group, which is a
  117. collection of lines having common characteristics so
  118. that they are interchangeable from the user point of view,
  119. or the name of a specific line being requested.
  120.  
  121. You may not specify this value if you supply a value for
  122. the Phone connect option.
  123.  
  124. The maximum length of a group or line name for
  125. installations that don't use the NASI interface is 16
  126. characters. If you use the NASI interface, group names
  127. are limited to eight characters and line names must not
  128. be longer than 14 characters.
  129. @@Client Phone String
  130. This value is used when you want to automatically dial the
  131. specified number on making a connection with a ModemShare
  132. server. In order to use this feature-
  133.  
  134.  o Your server must support a group name of NULL
  135.  
  136.  o You must have a Hayes-compatible modem connected to the
  137.    line selected by the server
  138.  
  139.  o You must not supply a value for the ModemShare client
  140.    group/line option
  141. @@Save or Quit
  142. Select "Save" to save any changes that you've made or
  143. "Quit" to abandon this edit session without saving your
  144. changes.
  145. @@Station Type
  146. You must select a parameter file type (ModemShare server
  147. or ModemShare client) to create or edit.
  148. @@Save Changes
  149. This option will save any changes that you've made to the
  150. parameter file and then exit from the edit session.
  151. @@Flat Network
  152. A flat network is one that has only one leg (no bridges or
  153. routers) or uses transparent bridges. During
  154. initialization, all stations attempt to dynamically
  155. locate any bridges on the network by sending broadcast
  156. messages. This process is repeated until all bridges have
  157. been located;it may require many broadcast messages to be
  158. sent over the network. If your network has only one leg,
  159. the process is unnecessary. If your network uses
  160. transparent bridges, the process is also not necessary
  161. since a transparent bridge doesn't require special
  162. handling to send packets to the other side of the bridge.
  163.  
  164. The value specified here has no meaning for the Lite
  165. version since the Lite version supports only a single
  166. network leg.
  167. @@Abandon Edit
  168. This option will provide exit from your edit session
  169. without saving any changes you have made to the parameter
  170. file.
  171. @@Quit Program
  172. Selecting this option will cause the Parameter Editor
  173. to return to DOS.
  174. @@Server
  175. Choose this option if you want to edit a Parameter Set for
  176. use by a ModemShare server.
  177. @@Client
  178. Choose this option if you want to edit a Parameter Set for
  179. use by a ModemShare client.
  180. @@File Name
  181. This is the DOS file name for the parameter file. Be sure
  182. to use a fully qualified name (a name that includes the
  183. path) if the file you're editing doesn't exist in the
  184. current directory.
  185.  
  186. If you're creating a new parameter file, you should also
  187. specify a fully qualified name if you don't want the file
  188. created in the current directory.
  189. @@Parameter Set
  190. Parameter files can contain up to 99 different collections
  191. of parameters, called parameter sets. When you start a
  192. ModemShare server or ModemShare client, you can select
  193. both the name of the parameter file and the parameter set
  194. within the parameter file to use for initialization.
  195. @@Line Speed
  196. The baud rate desired for the communication line being
  197. used.
  198. @@Parity
  199. The parity value desired for the communication line being
  200. used.
  201. @@Data Bits
  202. The number of data bits desired for the communication line
  203. being used. Only certain combinations of data bits and
  204. stop bits are allowed. The valid combinations are:
  205.  
  206. Data Bits     Stop Bits
  207.  
  208.     5          1 or 1.5
  209.     6          1 or 2
  210.     7          1 or 2
  211.     8          1 or 2
  212. @@Stop Bits
  213. The number of stop bits desired for the communication line
  214. being used. Only certain combinations of data bits and
  215. stop bits are allowed. The valid combinations are:
  216.  
  217. Data Bits     Stop Bits
  218.  
  219.     5          1 or 1.5
  220.     6          1 or 2
  221.     7          1 or 2
  222.     8          1 or 2
  223. @@XON
  224. The Xon character (used only with Xon/Xoff protocols) is
  225. used to indicate that sending or receiving should be
  226. resumed. The character specified can be a decimal
  227. number, or you can specify the value as a hexadecimal
  228. number by adding the character "h" after the number.
  229. For example, the values 17 and 11h are the same.
  230. @@XOFF
  231. The Xoff character (used only with Xon/Xoff protocols) is
  232. used to indicate that sending or receiving should be
  233. suspended. The character specified can be a decimal
  234. number, or you can specify the value as a hexadecimal
  235. number by adding the character "h" after the number.
  236. For example, the values 19 and 13h are the same.
  237. @@Server Edit Menu Choices
  238. From the Server Edit menu you select one of the general
  239. categories shown to change the values. To end the edit
  240. session select the File option and choose either Quit
  241. (which discards any changes) or Save (which saves any
  242. changes that you have made).
  243. @@Inactivity Timer
  244. This value, specified in minutes, indicates that a
  245. connection should be released if the ModemShare client is
  246. inactive (hasn't sent or received any data) for the period
  247. specified. Setting this value to zero indicates that no
  248. inactivity timer should be used.
  249. @@Server Timeout
  250. This value, specified in seconds, indicates how long the
  251. ModemShare client should wait after requesting a
  252. connection for a response. This value need be adjusted
  253. only if your network contains multiple "bridges" or
  254. special configurations which cause the network response to
  255. be delayed.
  256. @@Packet Size
  257. Specifies the size of individual network transmissions.
  258. Unless you have a specific need to do so, you shouldn't
  259. specify this value.
  260.  
  261. Since packets are always sent when they're full,
  262. specifying a lower value will cause more frequent network
  263. transmissions (which may make a computer more responsive)
  264. at the cost of higher network overhead. Setting the value
  265. to a number greater than the physical packet size on a
  266. network will result in packets being split, which requires
  267. multiple transmissions for a single packet.
  268.  
  269. If you choose to adjust the packet size you should also
  270. review the value for the Packet Timer.
  271. @@Character Timer
  272. This value, specified in milliseconds, forces packet
  273. (network) transmission if the time elapses without a
  274. character being sent. This can be useful in improving the
  275. responsiveness of the system when a terminal user is
  276. typing data, but it will be at the cost of increasing
  277. network overhead.
  278.  
  279. Network packets are always sent when they're filled, or if
  280. the Packet Timer expires (see Packet Timer for more
  281. information). To have any effect, this value must be lower
  282. than the Packet Timer.
  283. @@Packet Timer
  284. This value, specified in milliseconds, forces packet
  285. (network) transmission if the time elapses without a
  286. packet being filled. This time starts when the first
  287. character is placed in a packet and can be useful in
  288. improving the responsiveness of the system when the
  289. typical data transmissions are smaller than a packet.
  290.  
  291. When transmitting a file, this timer will also force
  292. transmission of the last packet (if it isn't full).
  293. @@NASI Level
  294. Selects the NASI API specification to use. A value of 2
  295. indicates that the NASI interface should return data as
  296. specified in the Novell NASI API Reference published in
  297. September, 1988. A value of 3 indicates that the NASI
  298. interface should return data to conform to the Novell
  299. version 3 documentation.
  300.  
  301. The default value is 2. If you are having trouble with
  302. your communications programs correctly recognizing modem
  303. status (such as the CTS or DSR signals), try running
  304. with a value of 3.
  305. @@Trigger Character
  306. Trigger characters are any set (up to 16) of characters
  307. that are to cause transmission of network packets. You
  308. might, for example, want to specify the carriage return
  309. character (0DH) to force packet transmission if you are
  310. working in an interactive mode. This will cause packets to
  311. be sent when you hit the ENTER key, rather than waiting
  312. for a Packet Timeout or Character Timeout to occur. Note,
  313. however, that trigger characters are bi-directional. That
  314. is, they cause network transmission both from the
  315. ModemShare client to the ModemShare server and from the
  316. server to the client.
  317. @@No Line Parameters in Client
  318. The ModemShare client shouldn't have line parameters if
  319. you want to use the default line parameters supplied by
  320. the ModemShare server which provides a line for your
  321. connection. If the client has line parameters they're
  322. always used for establishing a connection.
  323. @@Server Name
  324. Specify the name to which this ModemShare server should
  325. respond for the Remote Monitor program. Each server should
  326. have a unique name.
  327.  
  328. If you're using the NASI interface, server names are
  329. limited to eight characters; otherwise server names can
  330. be up to 16 characters long.
  331.  
  332. IMPORTANT NOTE for NASI users - the NASI architecture
  333. expects that each server has a different name. In
  334. addition, NASI expects that -
  335.  
  336.   o Every line belongs to at least one group
  337.   o You do not have duplicate group/line pair names
  338.     on different servers
  339.  
  340. INSYNC ModemShare permits duplicate group/line pair names
  341. to exist. Having duplicate group/line pair names may
  342. cause problems for communications programs using the NASI
  343. interface.
  344.  
  345. You can avoid any problems using the NASI interface if you
  346.  
  347.   o  Ensure that server, group, and line names don't
  348.      exceed the maximum lengths for the NASI interface
  349.   o  Make sure that each line name is unique across all
  350.      servers
  351.   o  Make sure that each line belongs to at least one group
  352. @@Server Transmit Sets
  353. Each transmit set is named and contains communications
  354. parameters that can be applied as default settings to line
  355. and group definitions. The information defined here
  356. includes items such as line speed, parity, data bits,
  357. and stop bits. In addition, information that controls
  358. network transmission such as packet size, network
  359. transmission timers and trigger characters is also
  360. specified.
  361.  
  362. When you define a line or group, you can reference a
  363. complete set of communication and network parameters
  364. simply by giving the transmit set name. The parameters
  365. associated with a line or group are used as the default
  366. values for both communications and network transmission if
  367. a ModemShare client doesn't provide these parameters when
  368. requesting a connection. See the Help topic "Server
  369. Values For a Connection" for a description of how the
  370. complete set of communication and network parameters is
  371. selected when a connection is made.
  372.  
  373. You should define a transmission set for each unique
  374. combination of these (communication/network) parameters
  375. that you want to apply to individual lines or line group
  376. definitions.
  377.  
  378. For example, suppose that you have two physical ports on
  379. the ModemShare server, one with a 4800-baud modem and the
  380. other with a 9600-baud modem. You'll need two transmission
  381. sets (one reflecting a 4800-baud line speed and the other
  382. for the 9600-baud line). If both of the lines have the
  383. same speed modem and you want to supply identical values
  384. for both lines, only one transmission parameter set needs
  385. to be defined.
  386. @@Server Lines (Ports)
  387. Each physical line that is to be shared by the ModemShare
  388. server must be defined. This definition includes the
  389. hardware address of the line and the interrupt level that
  390. will be used to service the line. If you use standard
  391. computer communications (async) ports, you'll be limited
  392. to two lines because each needs a separate interrupt level
  393. to operate properly. This is true even though most current
  394. boards are capable of being addressed at one of four
  395. different addresses.
  396.  
  397. Common name  Address   Interrupt level
  398.  
  399.    COM1        3F8          4
  400.    COM2        2F8          3
  401.    COM3        3E8          4
  402.    COM4        2E8          3
  403.  
  404. Notice that even though four different addresses are used,
  405. only two interrupt levels (3 and 4) are used. This means
  406. that, for example, you could not use COM1 and COM3
  407. together on the server.
  408.  
  409. Optionally, you can use a multiport board which contains
  410. either four or eight external connections. A multiport
  411. board uses only one interrupt level and, because two
  412. interrupt levels are normally reserved for asynchronous
  413. ports (actually, you can use any interrupt level that is
  414. not in use), you can install two in each server.
  415.  
  416. In any case, you must know the correct hardware address
  417. and interrupt level for each line (port) or the server will
  418. not function properly. Please consult the hardware manuals
  419. that came with your equipment to determine the proper
  420. values to specify.
  421. @@Server Group
  422. Groups perform two primary functions in the ModemShare
  423. server. The first is to give a name (which can then be
  424. used by ModemShare clients to request connections) to a
  425. set of lines that can supply a common service. For
  426. example, you define a group of all lines which are
  427. attached to a 4800-baud modem. Similarly, you could define
  428. a group of lines attached to a 9600-baud modem. Since
  429. almost all 9600-baud modems are capable of running at
  430. 4800-baud, you could include all of the 9600-baud lines in
  431. the 4800-baud line group. This grouping allows clients to
  432. request connections based on a general requirement (such
  433. as line speed) and increases the likelihood that a line
  434. will be available when requested. You can define any line
  435. grouping that suits your requirements based on any
  436. criteria that you choose.
  437.  
  438. The second use of a group is to apply different default
  439. values to the same line or set of lines based only on the
  440. name used in the connection request. You could, for
  441. example, define a group called "DOWJONES" that contained
  442. the proper communications parameters (speed, parity, flow
  443. control, etc.) for accessing this service.
  444.  
  445. A group contains one or more lines and a single line may
  446. belong to many groups.
  447.  
  448. IMPORTANT NOTE for NASI users - the NASI architecture
  449. expects that each server will have a different name. In
  450. addition, NASI expects that -
  451.  
  452.   o Every line will belong to at least one group
  453.   o You don't have duplicate group/line pair names
  454.     on different servers
  455.  
  456. INSYNC ModemShare permits duplicate group/line pair names
  457. to exist. Having duplicate group/line pair names may
  458. cause problems for communications programs using the NASI
  459. interface.
  460.  
  461. You can avoid any problems using the NASI interface if you
  462.  
  463.   o  Ensure that server, group, and line names do not
  464.      exceed the maximum lengths for the NASI interface
  465.   o  Make sure that each line name is unique across all
  466.      servers
  467.   o  Make sure that each line belongs to at least one
  468.      group
  469. @@Server Inbound Service
  470. Lines are marked as eligible for Inbound Service using the
  471. group function.
  472.  
  473. Note that the inbound facility is not the same as a
  474. ModemShare client using a modem to auto-answer an incoming
  475. phone call. The advantage of the inbound facility is that
  476. the line and modem can continue to be used for outgoing
  477. calls. If a client allocates a line and modem, and sets
  478. the modem in auto-answer mode, the line and modem are
  479. unavailable for other use until the client releases the
  480. connection.
  481. @@Call Forward Name
  482. Call Forward allows you to bypass the normal
  483. conversation that the ModemShare server has with an
  484. off-network caller and automatically runs the communication
  485. program you selected when you ran the INHOST program. This
  486. permits the communication program to see a full call
  487. sequence since the server doesn't answer the phone.
  488.  
  489. For Call Forward to be active, the following conditions
  490. must be met:
  491.  
  492.   o One or more ModemShare clients must have used the
  493.     INHOST program using the same service name that you
  494.     specify as the Call Forward name.
  495.   o The group must have at least one line selected as an
  496.     inbound line (see Help topic "Server Inbound Service").
  497.  
  498. If the above conditions are met, the server doesn't answer
  499. the phone when a ring is detected. The service name is used
  500. for a connection request as if the caller had typed it in
  501. during the standard inbound conversation. If the request
  502. fails, then standard inbound processing is started.
  503.  
  504. This function allows a communication program to answer the
  505. phone rather than the server. That program could then take
  506. different actions depending on the type of call. For
  507. example, one use is to allow FAX/data/voice recognition by
  508. a communications program.
  509. @@Server Group Name
  510. Group names are one to sixteen characters in length,
  511. unless you're using the NASI interface, in which case the
  512. names can't be longer than eight characters.
  513.  
  514. ModemShare clients can request a connection using either a
  515. line name or a group name. Group names must be unique
  516. within a ModemShare server (different servers can have the
  517. same group name) and must not be the same as a line name.
  518.  
  519. IMPORTANT NOTE for NASI users - the NASI architecture
  520. expects that each server has a different name. In
  521. addition, NASI expects that -
  522.  
  523.   o Every line will belong to at least one group
  524.   o You won't have duplicate group/line pair names
  525.     on different servers
  526.  
  527. INSYNC ModemShare permits duplicate group/line pair names
  528. to exist. Having duplicate group/line pair names may
  529. cause problems for communications programs using the NASI
  530. interface.
  531.  
  532. You can avoid any problems using the NASI interface if you
  533.  
  534.   o  Ensure that server, group, and line names don't
  535.      exceed the maximum lengths for the NASI interface
  536.   o  Make sure that each line name is unique across all
  537.      servers
  538.   o  Make sure that each line belongs to at least one group
  539. @@Server Conference
  540. The conference attribute can be associated with the lines
  541. in a group and allows multiple ModemShare clients to connect
  542. to the same line. This is a very powerful facility for users
  543. who all want to see the same information, since only one
  544. external connection is required. All users in the
  545. conference are allowed to input data, so care must be
  546. exercised to avoid interspersed data from being sent
  547. to the off-network device. Conference is specified as either
  548. half (H) or full (F) duplex which controls the echo of
  549. characters input from one computer to all other computers
  550. in the conference. H specifies that the off-network device
  551. won't echo characters and causes the server to echo
  552. input characters to all computers. F specifies that the
  553. off-network device echoes characters and that the server
  554. need not echo input characters to all computers.
  555. @@Server Group Lines
  556. You must specify which lines (ports) belong to each
  557. group. Since 16 lines are supported, each group can have
  558. 16 lines. Lines are allocated by the ModemShare server in
  559. the same order that you specify them.
  560. @@Server Group Transmit
  561. Just as a transmit set can be (and usually is) associated
  562. with a line, a transmit set can also be associated with a
  563. group. If you associate a transmit set with a group, the
  564. parameters from the set specified are used as the default
  565. values for connections made using the group name. If
  566. no transmit set is associated with the group, the transmit
  567. set associated with the line selected by the ModemShare
  568. server will be used for default values.
  569. @@Server Inbound Lines
  570. Some or all of the lines in a group can be marked as
  571. inbound service lines. Inbound lines will be set up by the
  572. ModemShare server to answer incoming calls, interact with
  573. the caller to determine what service is requested, and
  574. attempt to locate a ModemShare client that is able to
  575. accept the call. Lines that are set up as inbound lines are
  576. still eligible to service outgoing calls.
  577.  
  578. The number you specify is the number of lines (starting
  579. with the first line specified) that are to be set up for
  580. inbound service. If you specify a number greater than the
  581. number of lines in the group, all lines are set up for
  582. inbound service.
  583. @@Server Group Phone
  584. A phone number can be associated with the lines in a group
  585. which will cause the ModemShare server to automatically
  586. dial the number specified when a connection is made using
  587. the group name. The necessary Hayes-compatible control
  588. characters are added to the number given.
  589. @@Server Buffer Size
  590. Specify the amount of space (in bytes) to be reserved for
  591. buffers. Buffers are used to hold information sent to and
  592. received from the ModemShare server. Generally, the
  593. movement of information across the network (between the
  594. server and client) is much faster than the movement of
  595. data across communications lines. Data is therefore saved
  596. in buffers until it can be sent by the server or received
  597. by the communications program being run in the
  598. client. Providing more buffer space in a
  599. client allows the system to more efficiently
  600. process your communication data since there will be
  601. fewer conditions in which the system will need wait for
  602. buffer space. The default value is 65536 bytes. The
  603. minimum value for this parameter is 10240 bytes.
  604. @@Server Log Size
  605. Specify the amount of space (in bytes) to be reserved for
  606. the activity log. The amount specified is taken from the
  607. buffer and reduces the amount of available buffer space.
  608. The activity log is used to record information about the
  609. resources used by each connection. A connection record is
  610. about 40 bytes long and the minimum size is 400 bytes
  611. (enough space for 10 connection entries.) You must run
  612. MONITOR to remove the entries from the
  613. activity log and place the data in a file. The size of the
  614. log required depends on the rate of connections and the
  615. overall load on the system. See the INSYNC ModemShare
  616. manual for information on collecting the activity log
  617. records.
  618. The default value is 0 bytes (no logging.)
  619. @@Server Remote Monitor Password
  620. You can require that a user on another computer running
  621. the Remote Server Monitor enter a password for control
  622. functions.
  623. Control functions include actions such as breaking
  624. connections and removing lines from service. The password
  625. can be from one to 16 characters long and is encrypted in a
  626. separate file which is read when the ModemShare server is
  627. started. If you don't specify a password or set the
  628. password to blanks, no password is required for issuing
  629. control functions from the Remote Server Monitor.
  630. @@Flow Control
  631. Flow control is used to pace the interchange of data
  632. between the ModemShare client and off-network device (or
  633. program). Pacing is required since both sides are allowed
  634. to transmit at the same time and some mechanism is needed
  635. to prevent data from arriving faster than it can be
  636. processed.
  637. Three options are available -
  638.  
  639. Xon/Xoff uses "reserved" characters to signal the other
  640. side when to suspend/resume transmission. This mechanism
  641. works only when the data being transmitted doesn't
  642. contain the values selected for the Xon or Xoff character.
  643. In standard text interaction this works fine, but for
  644. operations such as file transfers, Xon/Xoff can't be used
  645. as any characters might be in the transmitted data.
  646.  
  647. No flow control is used when pacing is performed by a
  648. "file transmission" protocol, such as XMODEM, YMODEM,
  649. KERMIT, etc. These protocols are synchronous;
  650. only one side is allowed to transmit at a time.
  651.  
  652. Hardware flow control is implemented by setting and testing
  653. a hardware signal. This type of flow control can be used
  654. for any type of transmission and is the preferred method.
  655. This requires that your hardware (modem) and software
  656. (communications package) support hardware flow control.
  657. @@Server Transmit Set Name
  658. Each transmit set has a name (up to four characters long)
  659. that you must use in other definitions (such as line
  660. definitions) to apply default communications parameters.
  661. When you define lines and groups, you can reference a
  662. complete set of communications and network parameters
  663. simply by giving the transmit set name.
  664. @@Server Permit Sets
  665. Permit sets allow you to restrict access to a line. The
  666. only computers that will be granted access to the line
  667. named are those in the set of computers that you list.
  668. Computers are identified by their 12 hexadecimal digit
  669. network names assigned to the network adaptor card.
  670. @@Server Values For a Connection
  671. When a ModemShare server allocates a line to a ModemShare
  672. client (makes a connection), a complete set of
  673. communications and network parameters is required. The
  674. order for collection of these parameters is -
  675.  
  676.  1) any value supplied by the client
  677.  
  678.  2) any value not supplied by a client but obtained from
  679.     the server parameter file for the allocated line
  680.  
  681.  3) any value not supplied in either parameter file but
  682.     defaulted based on values internally kept in the
  683.     server program
  684. @@Server Line Name
  685. Each line (port) being shared by a ModemShare server must
  686. havea name that is unique. (Different servers can have the
  687. same line name.) The line name serves as a referent for
  688. the line and can be used by a ModemShare client for a
  689. connection request.
  690.  
  691. If you're using the NASI interface, line names can't be
  692. longer than 14 characters; otherwise line names can be up
  693. to 16 characters long.
  694.  
  695. IMPORTANT NOTE for NASI users - the NASI architecture
  696. expects that each server has a different name. In
  697. addition, NASI expects that -
  698.  
  699.   o Every line will belong to at least one group
  700.   o You won't have duplicate group/line pair names
  701.     on different servers
  702.  
  703. INSYNC ModemShare permits duplicate group/line pair names
  704. to exist. Having duplicate group/line pair names may
  705. cause problems for communications programs using the NASI
  706. interface.
  707.  
  708. You can avoid any problems using the NASI interface if you
  709.  
  710.   o  Ensure that server, group, and line names don't
  711.      exceed the maximum lengths for the NASI interface
  712.   o  Make sure that each line name is unique across all
  713.      servers
  714.   o  Make sure that each line belongs to at least one group
  715. @@Server Line Address
  716. Each line (port) being shared by a ModemShare server must
  717. have a hardware address that is unique and isn't being
  718. used by any other device in the system. The address can be
  719. specified either as a decimal or hexadecimal number
  720. followed by the character h.
  721.  
  722. The standard "COM" addresses are shown below.
  723.  
  724.  
  725. Common name  Address   Interrupt level
  726.  
  727.    COM1        3F8          4
  728.    COM2        2F8          3
  729.    COM3        3E8          4
  730.    COM4        2E8          3
  731.  
  732. @@Modem Presence
  733. Each line must specify whether or not a Hayes-compatible
  734. modem is attached. If you indicate that a modem is
  735. attached, the ModemShare server will check for the presence
  736. of the modem and, if no modem is attached, will reset this
  737. value.
  738.  
  739. Modems are required for lines that either have a phone
  740. number associated (for automatic dialing) or are being
  741. used with the inbound feature.
  742.  
  743. If you're using the INSYNC ModemShare inbound calling
  744. feature, you must indicate that the line has a modem
  745. attached, you may specify a setup string for the modem
  746. and you can choose to set the port speed to the line
  747. speed when an inbound call is detected. The alternative
  748. to matching speeds is to fix the port speed at the value
  749. selected in the server parameter file regardless of the
  750. line speed detected when an incoming call is answered.
  751. @@Inbound Setup String
  752. Used only for inbound lines, this specifies the modem
  753. initialization string that is to be used to condition
  754. the modem to accept incoming calls. Lines that you
  755. indicate have a modem but aren't marked as inbound lines
  756. are reset with the string ATZ when a connection is
  757. terminated.
  758.  
  759. The string can be up to 32 characters long and must begin
  760. with the characters AT. A carriage return character is
  761. always appended to the string.
  762.  
  763. The default setup string is ATQ0E1X1V1S0=0
  764.  
  765. The default string, for most Hayes-compatible modems, will
  766. satisfy the ModemShare server requirements for inbound modem
  767. conditioning. In order for inbound service to work
  768. properly, your modem must be set to the following state:
  769.  
  770.  o  Commands must be echoed (E1 in the default string)
  771.  o  Command responses must be returned (Q0)
  772.  o  Verbal command responses must be returned (V1)
  773.  o  Minimum set of command responses and trans-
  774.       mission speed must be returned when a connection is
  775.       made (X1)
  776.  o  Auto answer must be disabled (S0=0)
  777.  
  778. In addition, you may need to set parameters to ensure:
  779.  
  780.  o  The modem is in DTR normal mode (drops a connection
  781.     and returns to command state when DTR is dropped)
  782.  
  783.  o  Returns the port (not the line) speed when a
  784.     connection is made, preceded by the characters
  785.     CONNECT, for example: CONNECT 9600
  786.  
  787. The port speed returned is used only if you choose to
  788. match speeds (see the description that follows). If
  789. you aren't matching speeds, it doesn't matter what
  790. speed is reported in the CONNECT string as the server
  791. will ignore the information.
  792.  
  793. In addition to specifying an initialization string, you can
  794. choose to have the port speed set to the line speed when an
  795. inbound call is detected. The alternative to matching
  796. speeds is to fix the port speed at the value selected in
  797. the server parameter file regardless of the line speed
  798. detected when an incoming call is answered.
  799. @@Server Line Interrupt Level
  800. You must specify the interrupt level being used by the
  801. line. Care must be exercised to ensure that a single
  802. interrupt level isn't used by more than one board or
  803. the system won't operate properly. The possible
  804. interrupt levels (and most common uses) are shown below.
  805. The lower the number, the higher the priority (handled
  806. first) in the system.
  807.  
  808. Level    Standard use
  809.  
  810.   0    Not available, used for timer
  811.   1    Not available, used for keyboard
  812.   2    Available, generally used for network cards and
  813.     devices such as tape drives. If possible, you
  814.     shouldn't run your network at a higher priority
  815.     than your lines as the network activity could
  816.     cause data overruns to occur in high-activity
  817.     systems.
  818.   3    Available, the "standard" COM2/COM4 level
  819.   4    Available, the "standard" COM1/COM3 level
  820.   5    In a PC (8088, 8086), not available if you have a
  821.     hard disk
  822.     In an AT (286/386/486), available if you aren't
  823.     using LPT2 (the second parallel port). This is a
  824.     good choice for your network card.
  825.   6    If you have a floppy disk, not available
  826.     Available for systems without a floppy disk
  827.   7    Available if you are not using LPT1 (the primary
  828.     parallel port)
  829.  
  830. Remember that standard "COM" boards each use an interrupt
  831. level and that multiport boards can share a single
  832. interrupt level.
  833. @
  834.