home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 July / PCO_07_97.ISO / filesbbs / OS2 / ISDNPM28.ARJ / ISDNPM28.ZIP / readme.txt < prev    next >
Encoding:
Text File  |  1997-05-04  |  37.7 KB  |  1,265 lines
  1. Description of ISDN pm
  2. ======================
  3.  
  4.  
  5. License
  6. -------
  7.  
  8. This is a shareware program. Each program user recognizes the
  9. following license agreement:
  10.  
  11. 1. This program may be passed on to third parties only within this
  12. package.
  13.  
  14. 2. All rights for the commercial application of the program remain
  15. with the author.
  16.  
  17. 3. It may be utilized for a probationary period of 20 hours
  18. connection time. Any utilization exceeding this time limit
  19. requires the user's registration, by which he or she acquires a
  20. license for further use. Without this registration access to the
  21. program is no longer possible. Any subsequent use will be defined
  22. as a violation of the author's copyrights.
  23. NOTE: Make sure you never change system time during an ISDN
  24. connection (e.g. time server via Internet). If you do so the test
  25. period immediately terminates and you are no longer able to test
  26. the program.
  27.  
  28. 4. If you want to be registered send an EC check totalling DM 50.-
  29. (private users) or DM 100.-- (companies) to the following address:
  30.  
  31.                         Irene Meyer
  32.                         Kandelstr. 11
  33.                         D-79194 Heuweiler
  34.                         Germany
  35.  
  36.                     Telephone: +49-7666-948 555
  37.                     Fax      : +49-7666-948 556
  38.  
  39.  
  40. For payment please use either of the following methods:
  41.  
  42. - EC-cheque, in DM
  43. - bank cheque, in your country's home currency!! (otherwise our
  44.                    bank will charge us too many fees)
  45. - postal money orders
  46. - bank transfer (maybe via SWIFT)
  47. - cash
  48.  
  49.  
  50. 5. After receipt of the payment the licensee receives a unique
  51. registration key enabling him for further use of the program on
  52. exactly one computer.
  53.  
  54. Therefore, for the communication between two computers with this
  55. program two licenses are required.
  56.  
  57. 6. The use of this program is at the user's own risk. Due to the
  58. complexity of ISDN and to the possibility of CAPI errors, the
  59. author refuses to accept liability for any damage (e.g. your
  60. telephone bill) resulting from operating errors or malfunctioning
  61. of the program.
  62.  
  63. ---- UPDATE FEATURES --------------------------------------------------------
  64.  
  65. Version 2.8
  66.  
  67. - The parameters 'UserId' and 'Password' of the file 'isdnuser.cfg' are
  68.   passed on to the 'Script'.
  69.   The password may be queried via a dialogue window
  70.   ( enter '???' in the password field)
  71.  
  72. - The masquerading feature has been enhanced:
  73.   Please refer to the file 'masquere.txt'
  74.  
  75. - IsdnPm can be started in multiple mode
  76.   Please refer to the file 'multie.txt'
  77.  
  78. - MS-CHAP for Windows-NT RAS has been completed.
  79.   The windows domain may be specivied (now also with the LAN-manager password).
  80.  
  81. - MS-CALLBACK for Windows-NT RAS has been implemented
  82.  
  83. - Password query is possible
  84.  
  85. - T-ONLINE has been enhanced (only valid for users in Germany)
  86.   Please refer to the file 'tonline.txt'
  87.  
  88. - AVM-B1 can be used with 'CAPI.DLL'.
  89.  
  90.  
  91. Version 2.7
  92.  
  93. - WARP-4 (Merlin) is now supported
  94.  
  95. - complete implementation of MS-CHAP for Windows-RAS
  96.   window domains may be specified
  97.  
  98. - the default value of 'PAKETSIZE' is now 2048
  99.  
  100. - a call list may be defined
  101.  
  102. - automatic switch to another provider specified by the user
  103.  
  104. - timeouts may be adapted to the charging unit
  105.  
  106. - adaptation to ELSA-CAPI (but in ELSA-CAPI)
  107.  
  108. - implementation of 'named pipe' control
  109.  
  110. - implementation of IP-masquerading
  111.  
  112.  
  113. Version 2.6a
  114.  
  115. - AVM-B1 works again.
  116. - Compuserve works now
  117.  
  118. Version 2.6
  119.  
  120.         - This version supports T-ONLINE and asynchone PPP.
  121.         - PPP has been enhanced for Windows-NT RAS.
  122.  
  123. NOTE: The following modifications have been implemented:
  124.  
  125. - Function "ISDNREAD" has been changed. The first character of
  126.   the return string now returns the connection status. Please adapt
  127.   your login scripts accordingly.
  128.  
  129. - The password has no longer to be entered in the login scripts. It
  130.   may be queried via the 'READPASSWORD' function
  131.  
  132. - For PPP with dynamic address assignment the interface is no longer
  133.   configured via the line
  134.         'Script  :  ppp.fnc'
  135.   but with the line
  136.         'IfConfigFile  :  ppp.fnc'
  137.  
  138.  
  139. ------------------------------------------------------------------
  140.  
  141. General Features
  142. ----------------
  143.  
  144. ISDN pm has been designed as a supplement or an alternative to
  145. SLIPPM (IAK) or SLIP (TCP/IP, Version 2.0). It offers the
  146. possibility of an internet connection via the telephone which is
  147. not only faster than a modem connection but which takes
  148. advantageof the digital data transfer of ISDN (64000 bits/s).
  149.  
  150. For the user this means that ISDN requires an ISDN card with CAPI
  151. 1.1-DLL instead of a modem. Data transfer is considerably faster
  152. (up to 7.6 kBytes/s). For the communication between two stations,
  153. however, both counterparts must have an ISDN access with the
  154. suitable TCP/IP protocol.
  155.  
  156.  
  157. ------------------------------------------------------------------
  158.  
  159.  
  160. Installation
  161. ------------
  162.  
  163. The ZIP file will be unpacked in a user-defined subdirectory,
  164. resulting in the following files:
  165.  
  166.  
  167.   MULTI.TXT            -  multiple use of IsdnPm (German version)
  168.   MULTIE.TXT           -  multiple use of IsdnPm (English version)
  169.   TONLINE.TXT          -  updates in the TONLINE function (only
  170.                           relevant in Germany)
  171.   MASQUER.TXT          -  use of the masquerading feature (German)
  172.   MASQUER.TXT          -  use of the masquerading feature (English)
  173.   README.TXT           -  the file you are reading
  174.   ISDNPM.EXE           -  the program
  175.   ISDNSET.CMD          -  optional initialization script for
  176.                           TCP/IP
  177.   ISDNRES.CMD          -  optional reset script
  178.   PIPE.CMD             -  REXX example for pipe-supported monitoring
  179.   LOGINx.FNC           -  sample script for SLIP/PPP login
  180.   TONLINE.FNC          -  sample script for T-ONLINE login
  181.   TONCOMP.FNC          -  sample script for COMPUSERVE via T-ONLINE
  182.   PPP.FNC              -  script for PPP interface configuration
  183.   ISDN.CFG             -  program configuration file
  184.   ISDNUSER.CFG         -  user configuration file
  185.   RESOLV               -  name server configuration for TCP/IP
  186.   RESOLV2              -  name server configuration for TCP/IP 3.0
  187.   ISDNWAIT.EXE         -  waits until ISDNPM.EXE has been started
  188.  
  189. 1. Unpack the ZIP file 'ISDNPMxx.ZIP' in a user-defined directory.
  190.  
  191. 2. Copy the programs 'ISDNPM.EXE', the scripts 'ISDNSET.CMD', 'ISDNRES.CMD'
  192.    'PIPE.CMD' and the script functions 'PPP.FNC', 'LOGINx.FNC'
  193.    and 'TONLINE.FNC' to a user-defined directory of the PATH search path
  194.    e.g. to 'X:\TCPIP\BIN'.
  195.  
  196. 3. Copy the configuration files 'ISDN.CFG', 'ISDNUSER.CFG', 'RESOLV'
  197.    and/or 'RESOLV2' to the 'ETC' directory of TCPIP (important!),
  198.    e.g. to 'X:\TCPIP\MPTN'.
  199.    If you want to use TCP/IP under WINOS2 or DOS don't forget to
  200.    copy the 'RESOLV' file to the corresponding ETC directory.
  201.  
  202.    If you cannot find your ETC directory, use the command 'SET ETC'
  203.    in an OS/2 command line.
  204.  
  205.    NOTE: For WARP CONNECT the directory is 'X:\MPTN\ETC' !!!!!!!
  206.          When using WARP CONNECT the name server may be
  207.          configured via 'TCPCFG.EXE'.
  208.  
  209.    NOTE: For WARP-3 the directory is: 'X:\TCPIP\ETC'  !!!!!!!
  210.  
  211. 4. The 'CAPI.DLL' must be accessible via 'LIBPATH'. When you are using
  212.    the AVM-B1 card you should rename 'CAPI16.DLL' to 'CAPI.DLL'.
  213.    Alternatively, you may specify the complete path of the CAPI.DLL
  214.    in the 'ISDN.CFG' file, line 'CAPIDLL'.
  215.  
  216.  
  217. -------------------------------------------------------------------
  218.  
  219. Configuration
  220. -------------
  221.  
  222. The global configuration, together with its ISDN and IP
  223. characteristics, is defined in the file 'ISDN.CFG'.
  224.  
  225. The file 'ISDNUSER.CFG' is available for defining various internet
  226. users (providers).
  227. Currently the configuration is still made by editing the mentioned
  228. files with any text editor.
  229.  
  230. The enclosed 'ISDNUSER.CFG' file contains a number of sample
  231. configurations.
  232. The samples given there are useful for almost all providers.
  233.  
  234. The configuration files are structured into paragraphs headed by
  235. key words in square brackets.
  236. Each paragraph contains a number of variable names and their
  237. values, separated by ':'.
  238.  
  239. Comment lines are introduced by '#'.
  240.  
  241. ----------------------------------------------------------------------
  242.  
  243.                           CONFIGURATION
  244.  
  245. Use the following check list when making your configuration:
  246.  
  247. 1. Which kind of information have you got from your provider?
  248.  
  249.    1.1. Which ISDN number has the host?
  250.  
  251.    1.2. Which protocol does your provider use?
  252.    1.3. What is the IP address of the gateway?
  253.    1.4. What is your own IP Address?
  254.    1.5. What is the name of the subnet mask?
  255.    1.6. What size is the MTU?
  256.  
  257.    1.7. What is the IP address of the name server (DNS)?
  258.    1.8. What is the domain name?
  259.  
  260.    1.9. Which kind of authentification does your provider use?
  261.    1.10.Does your provider use a login procedure?
  262.  
  263.  
  264. 2. Choose one of the entries in 'isdnuser.cfg' which is most suitable
  265.    for your provider.
  266.    The protocol he uses will be the best criterion to base your choice on.
  267.  
  268.    Delete all remaining entries from the 'isdnuser.cfg' file.
  269.    (Don't forget to make a backup of the original before you do so!)
  270.  
  271.    2.1. PROVIDER
  272.  
  273.         Define a mnemo for your provider and enter it in the field
  274.         'Name'. The name must not contain any spaces.
  275.  
  276.    2.2. ISDN Number
  277.  
  278.         Enter the phone number of your provider (1.1.) in the field
  279.         'OutgoingISDN'. '-' is a valid entry. If you are calling from a
  280.         subscriber's apparatus of an extension line, remember to enter the
  281.         area code first.
  282.  
  283.    2.3. PROTOCOL
  284.  
  285.         Enter the protocol information from your provider (1.2.)
  286.         in the field 'Protocol'. This field sometimes causes problems.
  287.         If you cannot solve them on your own, you may send me a FAX
  288.         containing your provider data (my FAX number is given above)
  289.         so that I can help you.
  290.  
  291.         Note the following for the different protocols:
  292.  
  293.         2.3.1. Protocol 'X75'
  294.                Protocol 'M_LAPB'
  295.                Protocol 'HDLC_UI'
  296.                Protocol 'HDLC'
  297.                Protocol 'CISCO'
  298.  
  299.                All these protocol types convert the IP packet directly into
  300.                an ISDN packet.
  301.                'M_LAPB' is an 'X75' protocol with a preceding multi-
  302.                protocol-header. As the 'CISCO' protocol, 'M_LAPB' is
  303.                used only in connection with CISCO routers.
  304.  
  305.                Some providers claim to use the 'X.75' protocol but use
  306.                only HDLC frames with an X.75 header. In such cases you
  307.                should use the protocol 'HDLC_UI'. If you cannot get any
  308.                protocol information from your provider, it is best to
  309.                test both alternatives.
  310.  
  311.         2.3.2. Protocol 'SLIP'
  312.  
  313.                This protocol type converts the IP packet into a SLIP
  314.                packet and transmits it via X.75.
  315.  
  316.         2.3.3. Protocol 'T-ONLINE'
  317.  
  318.                This protocol type is used only for the internet access
  319.                via telecom. You can use the sample configuration given
  320.                in 'isdnuser.cfg' without any modifications.
  321.  
  322.         2.3.4. Protocol 'PPP'
  323.  
  324.                The 'PPP' protocol is available for "synchronous PPP",
  325.                i.e. PPP via HDLC. This corresponds to the general
  326.                internet drafts.
  327.  
  328.         2.3.5. Protocol 'PPP_ASYNC'
  329.  
  330.                This protocol provides asynchronous PPP, i.e. PPP
  331.                via X.75. This protocol type is required if your provider
  332.                has "enhanced" his asynchronous PPP access with an
  333.                ISDN modem.
  334.  
  335.  
  336.    2.4. OPTIONS
  337.  
  338.         The field 'Flags' may be used to set options for the selected
  339.         protocol. The most important flags are the following:
  340.  
  341.         2.4.1. 'IPCONFIG'
  342.  
  343.                Set the 'IPCONFIG' flag when you want to configure the
  344.                IP interface with the correct IP adresses each time
  345.                ISDNPM is started. Of course this flag is useful only
  346.                if you are working with STATIC IP addresses (1.4.).
  347.  
  348.         2.4.2. 'AUTODIAL'
  349.  
  350.                Set the 'AUTODIAL' flag when the connection is to be
  351.                established automatically.  !!! ATTENTION !!! If your
  352.                IP address is assigned dynamically, the 'AUTODIAL' flag
  353.                may cause problems.
  354.                If you use this flag with more than one 'user' be care.
  355.                Every user must be configured for an other net/subnet.
  356.                (see HOSTLIST,EXLCUDELIST )
  357.  
  358.         2.4.3. 'LOGINDIALOG'
  359.  
  360.                The 'LOGINDIALOG' flag is recommended only for the
  361.                protocol types 'SLIP' and 'ASYNC-PPP'. It is implicit
  362.                for the 'T-ONLINE' protocol.
  363.                When this flag has been set, a dialog with the router
  364.                of the provider is established immediately after the
  365.                connection has been set up but before any IP data
  366.                transmission takes place. This login procedure may be
  367.                controlled via a REXX script defined in the field 'Script'.
  368.                If required, the mentioned dialog may also be used
  369.                to exchange IP addresses or other types of information
  370.                (1.3. - 1.10).
  371.                For more details please refer to the given samples
  372.                ('loginx.fnc').
  373.  
  374.         2.4.4. 'PPPIPSEND', 'IPSEND', 'PPP_IPSEND'
  375.  
  376.                You are advised to use these flags for the protocol types
  377.                'PPP' and 'PPP_ASYNC'. It transmits your IP adress to
  378.                the router or causes the router to assign an IP address.
  379.  
  380.         2.4.5. 'PPPPAP', 'PPP_PAP', 'PAP'
  381.  
  382.                The 'PPPPAP' flag defines whether the authentification
  383.                (1.9.) is to be made via PAP for the protocol types
  384.                'PPP' or 'PPP_ASYNC'. If you provider is using a
  385.                Windows-NT RAS access the 'PPPPAP' flag is mandatory.
  386.                MS is using an own CHAP mode which does not comply with
  387.                the current internet standard. With the 'PPPPAP' flag
  388.                the authentification will be made via CHAP.
  389.  
  390.         2.4.6. 'PPPCHAP', 'PPP_CHAP', 'CHAP'
  391.  
  392.                When this flag is set, the authentification
  393.                (1.9.) is made via Microsoft CHAP for 'PPP' or 'PPP_ASYNC'.
  394.  
  395.         2.4.7. 'PPPCHAPMS', 'PPP_CHAP_MS', 'CHAP_MS'
  396.  
  397.                 The flag 'PPPCHAP' defines that the authentification
  398.                 (1.9) is made via Microsoft-CHAP for 'PPP' and 'PPP_ASYNC'.
  399.  
  400.         2.4.8.  'PPPSTANDARD', 'PPP_STANDARD', 'STANDARD'
  401.  
  402.                 The flag 'PPPSTANDARD' sets the most common flags 'PPPIPSEND',
  403.                 'PPPPAP', 'PPPCHAP' and 'PPP_CHAPMS'. Usually the
  404.                 setting of this flag is sufficient for most protocol types.
  405.  
  406.  
  407.         2.4.9.  'PPP_NACKTOPAP'
  408.  
  409.                 When the flag 'PPP_NACHTOPAP' is set, authentification is
  410.                 made via PAP.
  411.  
  412.         2.4.10. 'USEV110'
  413.  
  414.                With this flag you specify that V110 is to be used
  415.                instead of X.75 for the PPP_ASYNC protocol.
  416.                The flag ist required for the Compuserve access.
  417.  
  418.  
  419.  
  420.    2.5. AUTHENTIFICATION
  421.  
  422.         See also 2.4.5. and 2.4.6.
  423.         When your provider has assigned you an ID and PASSWORD for
  424.         the protocols 'PPP' and/or 'PPP_ASYNC', enter these in the
  425.         fields 'PapId' and 'PapPasswd'.
  426.         When the authentification is achieved online during login for
  427.         the 'SLIP' and/or 'PPP_ASYNC' protocols, you must enter
  428.         the ID and PASSWORD or ask for them in the login script.
  429.         Another way of getting your ID and password is to use the
  430.         REXX_function 'READPASSWORD'.
  431.  
  432.    2.6. IP ADDRESSES
  433.  
  434.         Finally, a number of Ip addresses must be entered in
  435.         'isdnuser.cfg':
  436.  
  437.         2.6.1. GATEWAY address (1.3.)
  438.  
  439.                When you know your provider's gateway address enter
  440.                it in the fields 'HostIp' and 'DefaultIp'. The gateway
  441.                address is not identical with the DNS address!
  442.                When the gateway address is assigned dynamically (which
  443.                happens very rarely), you may skip this entry.
  444.  
  445.         2.6.2. IP address (1.4)
  446.  
  447.                If your provider has assigned you a fixed (static)
  448.                Ip address enter it in the field 'LocalIp'. When the
  449.                assignment is made dynamically by the provider skip
  450.                this line.
  451.                Dynamic IP address assignment is made either on-line
  452.                during login or by 'PPP' and/or 'PPP_ASYNC'.
  453.                If it is assigned on-line in a login procedure, it
  454.                is necessary to configure the Ip interface there, too.
  455.                See also 'TONLINE.FNC'.
  456.                If the Ip address is assigned via the PPP protocol you
  457.                have to specify the configuration  script 'PPP.FNC'
  458.                in the field 'IfConfigFile'.
  459.  
  460.         2.6.3  SUBNET MASK (1.5)
  461.  
  462.                The subnet mask is generally uncritical. However, the
  463.                value 255.255.255.255 is NOT valid. In most cases
  464.                the value 255.255.255.0 works well. Enter this value
  465.                in the field 'Netmask'.
  466.  
  467.  
  468. 3. Some minor modifications are required when the name server is to
  469.    operate properly:
  470.  
  471.    Enter the values 'DNS address' and 'Domain Name' in the files
  472.    'RESOLV' and/or 'RESOLV2'.
  473.    NOTE: Make sure you are not using any capital letters (UNIX)!!
  474.  
  475. 4. If your provider is using CLI (Calling Line Identification), i.e.
  476.    if your MSN (phone number) is checked, make sure you are using
  477.    the correct MSN. This is done in two steps:
  478.  
  479.    4.1 Assignment of MSN to an EAZ.
  480.  
  481.         Please refer to your ISDN software documentation to find out
  482.         how this is achieved with your CAPI. Teles provies an object
  483.         for this purpose in the Capi folder.
  484.  
  485.    4.2  The file 'isdn.cfg' contains the field 'OAD', in which you
  486.         specify (1st digit) the EAZ you want to use for the call.
  487.  
  488.  
  489. 5. MTU Size (Message Transfer Unit Size)
  490.  
  491.    The default value of 1500 Bytes is correct in the majority of cases.
  492.    If your provider is using a different value, modify the field
  493.    'if-mtu' in the file 'isdn.cfg' accordingly.
  494.  
  495.  
  496. 6. Some other configuration variants are possible. Please refer to
  497.    the following parameter list.
  498.  
  499.  
  500. 7. If a login is required for the establishment of a connection to your
  501.    provider, use any of the existing 'login.fnc' and adapt the REXX
  502.    scripts to your requirements.
  503.    Geting familiar with the REXX script programming language
  504.    requires some study and effort!
  505.  
  506. 8. IP masquerading requires an entry in the following line of the
  507.    'isdn.cfg' file:
  508.    The line
  509.  
  510.            if_masquerade  :  1
  511.  
  512.    must be inserted in the section 'ip'.
  513.  
  514.    When the IP address is assigned dynamically (as PPP)
  515.    you have to set the IP address in the REXX procedure. This may be
  516.    done directly from the REXX procedure with the call
  517.  
  518.            rc = SETLOCALIP (Channel,LocalIp)
  519.  
  520.    provided the 'IP-Forewarding' flag is set (IPGATE ON).
  521.  
  522.    If your provider assignes the IP-Adress dynamically and you want
  523.    to use AUTODIAL, plaese set
  524.  
  525.         if_masquerade = 2
  526.  
  527.    For more information on the masquerading feature please refer
  528.    to 'masquere.txt'.
  529.  
  530. -----------------------------------------------------------------------
  531.  
  532. Sample configuration of 'ISDN.CFG' :
  533. ------------------------------------
  534.  
  535. #
  536. # Global configuration
  537. #
  538.  
  539. [global]
  540.  
  541. #
  542. # 'LogFile'
  543. #
  544. # Path definition of the log file
  545. #
  546.  
  547. LogFile         : C:\TMP\ISDN.LOG
  548.  
  549. #
  550. # 'TraceFile'
  551. #
  552. # Path definition of the trace file
  553. #
  554. # NOTE! This entry reduces the data flow rate. It should not be
  555. # used unless you have run into problems which can be solved only
  556. # by sending detail information to the author of 'IsdnPm'.
  557. # ( FAX +49-7666-948556  )
  558. # Normally this line is omitted.
  559. #
  560.  
  561. TraceFile       : C:\TMP\ISDN.TRC
  562.  
  563. #
  564. # 'Buffers'
  565. # 'BufferSize'
  566. #
  567. # Number and size of buffers
  568. # The number of buffers should be >= 10
  569. # The buffer size should be the MTU size plus 32.
  570. # Typical values are 50 or 1600
  571. #
  572.  
  573. Buffers         : 50
  574. BufferSize      : 3600
  575.  
  576. #
  577. # 'IpPriority'
  578. # 'IsdnPriority'
  579. #
  580. # Priorities of the IP thread and of the ISDN thread.
  581. # Default priority values range from 0 to 63.
  582. # Server priority values range from 64 to 127.
  583. # 100 and/or 120 have resulted to be appropriate values.
  584. # (If possible, do not change these values!)
  585. #
  586.  
  587. IpPriority      : 100
  588. IsdnPriority    : 120
  589.  
  590. ## 'CallBackWait'
  591. #
  592. # Slow computers may cause problems with the 'CAPI.DLL' of
  593. # 'Teles'.
  594. # When an infinite number of calls of the signalling routine
  595. # is made from the 'CAPI.DLL' this takes up too much processing
  596. # time causing very slow processing!
  597. #
  598. # If you come across this problem it is useful to set this
  599. # parameter. Any value between 30 and 200 is valid.
  600. #
  601. # Otherwise skip this parameter or set it to the value '0'.
  602. #
  603.  
  604. CallBackWait    : 0
  605.  
  606. #
  607. # 'FilterList'
  608. #
  609. # A filter list may be used to define global acces restrictions
  610. # for all users that have been defined in 'ISDNUSER.CFG'.
  611. #
  612. # A list entry contains an IP address and a net mask, separated
  613. # by slash ('/'). When making more than one entry, separate them
  614. # by commas.
  615. #
  616. # When, for example, you want to restrict the access to the
  617. # network '133.133.0.0.' make the following entry:
  618. #
  619. #   FilterList  : 133.133.0.0/255.255.0.0
  620. #
  621. # Usually, filters are interesting for providers. When no access
  622. # restrictions are required, i.e. when all networks are to be
  623. # accessible for all users, the appropriate entry is:
  624. #
  625.  
  626. FilterList      : 0.0.0.0/0.0.0.0
  627.  
  628. #
  629. # 'Register'
  630. # 'Key'
  631. #
  632. # These entries are necessary for the program registration.
  633. #
  634. # The field 'Register' contains the user name. 'Key' defines
  635. # the registration key.
  636. #
  637.  
  638. Register        :   Anyone
  639. Key             :   1234.5678.90
  640.  
  641. #
  642. # The 'CapiDll' parameter specifies the Capi.dll to be loaded.
  643. # When no entry is made here, the CAPI is searched via LIBPATH.
  644. #
  645. #
  646.  
  647. CapiDll         :   .\capi.dll
  648.  
  649. #
  650. # Isdn configuration
  651. #
  652.  
  653. [isdn]
  654.  
  655. #
  656. # 'Channels'
  657. #
  658. # This entry defines the number of ISDN channels.
  659. # The default is 2.
  660. #
  661.  
  662. Channels        : 2
  663.  
  664. #
  665. #
  666. # 'Oad'
  667. #
  668. # This field is required for the 'EAZ' definition. The first digit
  669. # specifies the EAZ to be used for outgoing calls. The subsequent
  670. # digits define incoming EAZs.
  671. #
  672. #
  673.  
  674. Oad             : 0123456789
  675.  
  676. #
  677. # IP configuration
  678. #
  679.  
  680. [ip]
  681.  
  682. #
  683. # Field for the IP interface configuration. We recommend the use of the
  684. # following values:
  685. #
  686. #
  687.  
  688. if_name     : sl0
  689. if_unit     : 0
  690. if_mtu      : 1500
  691. if_speed    : 64000
  692. if_rtt      : 0
  693. if_rttvar   : 0
  694. if_rttmin   : 0
  695. if_sendpipe : 8192
  696. if_recvpipe : 8192
  697. if_ssthresh : 0
  698. if_maxqueue : 24
  699. if_maxfastq : 12
  700.  
  701.  
  702. #
  703. # for ip-masquerading the following entry is required
  704. #
  705.  
  706. if_masquerade  :  1      // 2 or 3
  707.  
  708.  
  709.  
  710. Example of an'ISDNUSER.CFG' configuration:
  711. ------------------------------------------
  712.  
  713. #
  714. # Configuration of a user.
  715. # It is possible to define sequences of user names.
  716. #
  717.  
  718. [user]
  719. #
  720. # 'Name'
  721. # Mnemo for 'provider'
  722. #
  723.  
  724.   Name          : internet
  725.  
  726. #
  727. # 'IncomingISDN'
  728. # List of ISDN numbers for incoming calls (up to 4).
  729. # Usually, this entry is relevant only for providers.
  730. # Wildcards are valid entries.
  731. #
  732.  
  733.  
  734.   IncomingISDN  : *130-777777,*130-777778,*130-777779
  735.  
  736. #
  737. # 'OutgoingISDN'
  738. #
  739. # ISDN number(s) of the provider and/or user.
  740. #
  741.  
  742.   OutgoingISDN  : 0130-1, 0130-2, 0130-3, 0130-4
  743.  
  744. #
  745. # 'Alternate'
  746. #
  747. # refers to another user entry which will be dialled when the
  748. # connection establishment to the different ISDN numbers fails
  749. # (OutgoingISDN  -  OutgoingISDN4)
  750. #
  751.  
  752.    Alternate     : Provider2
  753.  
  754.  
  755. #
  756. # 'MailAddress'
  757. # 'Address'
  758. #
  759. # Only for information purposes.
  760. #
  761.  
  762.   MailAddress   : user@anypop.de
  763.   Address       : AnyPop PLZ DE-Stadt
  764.  
  765. #
  766. # 'Flags'
  767. #
  768. # The flags 'IPCONFIG','AUTODIAL' and 'DIALBACK' are used to
  769. # configure the following features:
  770. #
  771. #   'IPCONFIG'    When this flag is set, the parameters
  772. #                 defined for the automatic configuration of
  773. #                 the Ip interface will be used.#
  774. #   'AUTODIAL'    defines whether a connection is to be set up
  775. #                 automatically (only valid in connection with
  776. #                 the TimeOut parameter).
  777. #
  778. #                 WARNING ! 'AUTODIAL' may cause unintentional
  779. #                 connection setup, when IP packets are
  780. #                 sent off by background processes!
  781. #
  782. #   'DIALBACK'    rejects an incoming call and activates an
  783. #                 automatic dialback after the time defined
  784. #                 in 'DialBackWait' has elapsed.
  785. #
  786. #   'TRIGGERIN'   activates the 'TimeOut' parameter for
  787. #                 incoming IP packages.
  788. #
  789. #   'PACKETFILTERIN' applies the 'PACKETFILTER' parameter for
  790. #                 incoming IP packages.
  791. #
  792. #   'LOGINDIALOG' must be set when a login procedure is
  793. #                 required for SLIP. The login procedure will be
  794. #                 executed with the REXX script defined via
  795. #                 the 'Script' parameter.
  796. #
  797. #   The following flags are PPP-protocol-specific:
  798. #
  799. #   'PPP_PAP'
  800. #   'PAP'
  801. #   'PPPPAP'      activate the authentication via PAP.
  802. #
  803. #   'PPP_CHAP_MS'
  804. #   'CHAP_MS'
  805. #   'PPPCHAPMS'   activate the authentication via Microsoft-CHAP.
  806. #
  807. #   'PPP_CHAP'
  808. #   'CHAP'
  809. #   'PPPCHAP'     activate the authentication via CHAP.
  810. #
  811. #   'NACKTOPAP'
  812. #   'PPP_NACKTOPAP'
  813. #   'PPPNACKTOPAP' activate the authentication via PAP.
  814. #
  815. #   'PPP_IP_SEND'
  816. #   'IPSEND'
  817. #   'PPPIPSEND'   activates the exchange of IP addresses.
  818. #                 When a REXX script was defined with the
  819. #                 'Script' parameter ('PPP.FNC') the IP
  820. #                 interface can be re-configured with the
  821. #                 negotiated IP addresses.
  822. #
  823. #   'STANDARD'
  824. #   'PPP_STANDARD'
  825. #   'PPPSTANDARD' are used to set PPPPAP, PPPCHAP, PPPCHAPMS and PPPIPSEND
  826. #
  827. #   'PPPCALLBACK' uses the CALL-BACK option for WIN-NT RAS
  828. #
  829. #   'LMHASH'      uses the LAN manager password for WIN-NT RAS
  830. #
  831. #      the following flags are modem-specific:
  832. #
  833. #   'MODEM'       This flag is possible only when the ELSA card
  834. #                 ISDN/PCFpro is used. It enables you to
  835. #                 set up a slip connection via the built-in
  836. #                 V.34 modem.
  837. #
  838.  
  839.   Flags         : IPCONFIG,AUTODIAL
  840.  
  841. #
  842. # 'Protocol'
  843. #
  844. # This parameter defines the type of IP encapsulation.
  845. #
  846. #   'X75'          direct encapsulation of Ip packets in X75-
  847. #                  data packets
  848. #   'SLIP'         Ip packets with SLIP framing in X75 data packets
  849. #   'T70'          direct encapsulation of Ip packets in X75/T70NL
  850. #                  data packets
  851. #   'PPP'          IP-PPP protocol, compatible with SUN and CISCO
  852. #                  (answers to PAP and CHAP requests !)
  853. #   'HDLC'         direct encapsulation of Ip packets in HDLC frames
  854. #   'HDLC_UI'      direct encapsulation of Ip packets in HDLC_UI frames
  855. #   'CISCO'        CISCO-HDLC encapsulation with 'KEEP-ALIVE'
  856. #   'M_LAPB'       CISCO Multi-Lapb protocol
  857. #   'T_ONLINE      internet access via T-Online
  858. #   'T_ONLINE_PPP' internet access via T-Online to COMPUSERVE
  859. #   'Async_PPP'    as for 'PPP' but via X.75
  860. #
  861.  
  862.   Protocol      : X75
  863.  
  864. #
  865. # 'PapId' and 'PapPasswd'
  866. #
  867. #  User-ID and password for PPP-PAP and/or PPP-CHAP
  868. #
  869.  
  870. PapId           : MyWi
  871. PapPasswd       : Secret
  872.  
  873. #
  874. #  'MSNDomain'
  875. #
  876. #  Specification of the login domain for MS networks.
  877. #
  878.  
  879. MSNDomain       : DOMAIN1
  880.  
  881. #
  882. # 'Script'
  883. #
  884. #  REXX Script.
  885. #  This REXX script is started as soon as the connection has been
  886. #  established. The user may define the actions to be executed.
  887. #  For the 'SLIP' protocol and the flag 'LOGINDIALOG' this script
  888. #  is used for the login dialog. The file 'LOGIN.FNC' contains a
  889. #  procedure which may be adapted any time to the user's needs.
  890.  
  891. Script          : Login.fnc
  892.  
  893. #
  894. #  'IfConfigFile'
  895. #
  896. #  For the 'PPP' protocol with the Flag 'PPPIPSEND' this script
  897. #  may be used for the configuration of the Ip interface, with
  898. #  the agreed Ip addresses. This is required only when the Ip
  899. #  address is not 'static'. The file 'PPP.FNC' gives you a sample
  900. #  configuration.
  901. #
  902.  
  903. IfConfigFile    :  PPP.fnc
  904.  
  905. #
  906. # 'FragmentSize'
  907. #
  908. # Paket size of the ISDN packets. The value can be adapted only
  909. # for 'SLIP', 'T70' and 'PPP_ASYNC'. It defines the packeting type.
  910. # The default is 256.
  911. #
  912.  
  913. Fragmentsize    : 1024
  914.  
  915. #
  916. # 'PacketSize'
  917. #
  918. # This value defines the maximum FRAME size of Isdn packets.
  919. # The default is 2048.
  920. #
  921.  
  922. PaketSize       : 2048
  923.  
  924. #
  925. # 'TimeOut' n
  926. #
  927. # This value defines the time of inactivity (in seconds) after
  928. # which the connection is to be disconnected automatically.
  929. # It is recommended to adapt the value to the charge indicator.
  930. # '0' deactivates the function and disables the  'AUTODIAL' function.
  931. # Of course, this value has no influence on the timeout of the
  932. # counterpart (the shorter timeout wins).
  933. #
  934.  
  935. TimeOut        : 400
  936.  
  937. #
  938. # 'TimeOut' <a>,<b>,<c>
  939. #
  940. # This variation of the timeout function allows you to align with
  941. # the charging unit. Since the duration of a chargeing unit is
  942. # unknown until the first unit is received, you may define the
  943. # duration of the initial unit with the option
  944. # <a>.
  945. # <b> defines periods of inactivity
  946. # <c> defines the point when a disconnect is required prior to the next
  947. # charge indicator.
  948. #
  949. # e.g. TimeOut :  400,20,3
  950. # estimates the duration of the first indicator at 400 seconds.
  951. # If no packet is transmitted during the last 23 seconds of a charging
  952. # unit, IsdnPm cuts the connection 3 seconds before the next charging
  953. # unit is received.
  954. #
  955.  
  956. TimeOut        :  400,20,3
  957.  
  958. #
  959. # 'Connections'
  960. #
  961. # defines the number of connections that can be set up
  962. # simultaneously to a provider and/or user.
  963. #
  964.  
  965.   Connections   : 1
  966.  
  967. #
  968. # 'HostIp'
  969. #
  970. # Ip address of the counterpart.
  971. #
  972.  
  973.  
  974.  
  975.   HostIp        : 192.192.3.254
  976.  
  977. #
  978. # 'LocalIp'
  979. #
  980. # Your own Ip address.
  981. #
  982.  
  983.   LocalIp       : 192.192.3.6
  984.  
  985. #
  986. # 'Netmask'
  987. #
  988. # Your own subnet mask.
  989. #
  990.  
  991.   Netmask       : 255.255.255.0
  992.  
  993. #
  994. # 'DefaultIp'
  995. #
  996. # Ip address to be used for the 'Default Route' functionality.
  997. #
  998.  
  999.   DefaultIp     : 192.192.3.254
  1000.  
  1001. #
  1002. # 'Metric'
  1003. #
  1004. # Only relevant for providers. (Do not modify!).
  1005. #
  1006.  
  1007.   Metric        : 15
  1008.  
  1009. #
  1010. # 'HostList', 'ExcludeList' and 'AccessList' have the same
  1011. # structure as 'FilterList' in 'ISDN.CFG'.
  1012. #
  1013. # 'HostList'
  1014. #
  1015. # The host list defines which networks are accessible via the
  1016. # specified connection.
  1017. # When the default '0.0.0.0/0.0.0.0' is entered, the user in
  1018. # question is authorized to access the entire INTERNET.
  1019. # Providers wanting to forward only specific addresses to a
  1020. # user are requested to adapt the entry accordingly.
  1021. #
  1022. # When this configuration line is skipped altogether, the
  1023. # default entry will be applied.
  1024. #
  1025. # Default entry :
  1026. #
  1027.  
  1028.   HostList      : 0.0.0.0/0.0.0.0
  1029.  
  1030. #
  1031. # 'ExcludeList'
  1032. #
  1033. # This list is used to restrict the host list.
  1034. # Default: no entry.
  1035. #
  1036.  
  1037.   ExcludeList   :
  1038.  
  1039. #
  1040. # 'AccessList'
  1041. #
  1042. # The access list is required only for providers. It offers the
  1043. # possibility to restrict the access to certain networks.
  1044. # Default: no entry.
  1045. #
  1046.  
  1047.   AccessList    :
  1048.  
  1049. #
  1050. # 'DialFilter'
  1051. #
  1052. # This filter is applied to the contents of specific Ip packets.
  1053. # Ip packets matching this filter trigger neither an 'Autodial'
  1054. # nor a 'TimeOut'.
  1055. # The packets are transmitted as usual for existing connections.
  1056. #
  1057. # The maximum length of a filter is 64 Bytes.
  1058. # The filter definition contains a mask string and a value string,
  1059. # separated by '/'. Several filters (up to 16) may be defined for
  1060. # one user.
  1061. #
  1062. # (This feature is active only in the registered version!).
  1063. #
  1064. # A filter entry may be used, for example, when you want to
  1065. # prevent ICMP packets from keeping alive connections that are
  1066. # no longer required. When using the filter make sure you
  1067. # know the exact structure of an IP or ICP packet.
  1068. #
  1069. # Example of an ICMP filter and an IGMP filter:
  1070. #
  1071.  
  1072. DialFilter  : 45000000-00000000-0001/F0000000-00000000-00FF
  1073. DialFilter  : 45000000-00000000-0002/F0000000-00000000-00FF
  1074.  
  1075. #
  1076. # 'PacketFilter'
  1077. #
  1078. # This filter is applied to the contents of specific Ip packets.
  1079. # Ip packets matching this filter are ignored. The filter usually
  1080. # 'filters' outgoing Ip packets. When the flag 'PACKETFILTERIN'
  1081. # has been set, the filter also reacts to incoming Ip packets.
  1082. # (This feature is active only in the registered version!).
  1083.  
  1084. #
  1085.  
  1086. PaketFilter  : 45000000-00000000-0001/F0000000-00000000-00FF
  1087.  
  1088. #
  1089. # We are working on a simplified form of filter configuration.
  1090. #
  1091.  
  1092. ------------------------------------------------------------------
  1093.  
  1094.  
  1095. Application
  1096. -----------
  1097.  
  1098. The program may be started when booting the system. For this
  1099. purpose please
  1100.  
  1101.  - generate a program object in the system start file and execute
  1102.    the IP configuration script ISDNSET.CMD for the first (and
  1103.    usually the only) user with the IPCONFIG flag.
  1104.    The corresponding IP numbers for automatic configuration must
  1105.    have been entered for the user.
  1106.  
  1107.  - start the system via TCPSTART.CMD / SETUP.CMD, as for SLIP,
  1108.    and make the necessary configuration entries.
  1109.  
  1110.  
  1111. The PM interface of the program allows you to manually set up a
  1112. connection to any user you have selected in the provider list box
  1113. (Menu Connection->Dial). Also, it is possible to call the IP
  1114. configuration of the selected user (Menu File->Ip Setup).
  1115. All the remaining fields of the provider are passive, i.e. the
  1116. major user data are displayed.
  1117.  
  1118. You may disconnect the selected ISDN channel with 'Hangup' (Menu
  1119. Connection -> Hangup).
  1120. In the 'trace window' the ISDN interface allows you to analyse the
  1121. CAPI output messages etc. and to monitor the flow of data.
  1122. Note: When large quantities of data are transferred this may cause
  1123. a decrease of the performance with some computers (a problem that
  1124. will no longer exist with version 2.03 onwards).
  1125. Therefore it is recommended to request only those outputs apart
  1126. from 'Connections' that are helpful for your problem solution.
  1127.  
  1128. Starting with version 2.5 the content of the Trace Window may be
  1129. stored in a file (Trace File). Also, it is possible to set up a
  1130. default trace level upon activation of 'IsdnPm' using the
  1131. '-v -d255' option.
  1132.  
  1133. ------------------------------------------------------------------
  1134.  
  1135.  
  1136. Tecnical Data
  1137. -------------
  1138.  
  1139. ISDN pm runs with TCPIP 2.0 as well as with the IAK of Warp.
  1140.  
  1141. Basically, ISDN pm runs with all ISDN cards released with a
  1142. CAPI.DLL, version 1.1, für OS/2.
  1143.  
  1144. It has been successfully tested with the following hardware:
  1145.  
  1146.   Diehl  : Diehl SCOM, SX, Diva, S2m,
  1147.   NCP    : NCP-P16, NCP-A
  1148.  
  1149.   Teles  : Teles 8/16 Bit with CAPI version 2.97
  1150.  
  1151.   Bintec : positive test by one user
  1152.   IBM    : PCMCIA Active 2000
  1153.            (works only in SLOT-1)
  1154.  
  1155.   AVM    : AVM-B1
  1156.            here the CAPOI16.DLL must be copied to CAPI.DLL
  1157.  
  1158.   ELSA   : ISDN/PCFpro
  1159.  
  1160. The CAPIs of some producers have their idiosyncrasies, which may
  1161. cause problems with some cards.
  1162. ------------------------------------------------------------------
  1163.  
  1164. History
  1165. -------
  1166.  
  1167. Version 2.0 (isdnpm.zip)
  1168.  
  1169.     - This is the first version coming with a PM interface.
  1170.       A new feature is also the support of various providers
  1171.       with different subnets (key HOSTLIST in the section
  1172.       USER in ISDNUSER.CFG) as well as program-controlled
  1173.       dialling and hangup via 'Timeout'.
  1174.  
  1175.     - Version 2.0 is the first version available as shareware
  1176.       to a large number of users.
  1177.  
  1178. Version 2.03 (isdnpm203.zip)
  1179.  
  1180.     - The 'Trace Window' functionality has been improved.
  1181.  
  1182.     - A 'Semaphore' prevents multiple starting of the program.
  1183.  
  1184. Version 2.4 (isdnpm24.zip)
  1185.  
  1186.     - Implementation of the protocols 'HDLC','CISCO','M_LAPB',
  1187.       PPP-PAP and PPP-CHAP
  1188.  
  1189.     - 'CallBackWait' ,'PacketFilter' and 'DialFilter' have been
  1190.       implemented.
  1191.     - The entry 'HostList' may be omitted.
  1192.  
  1193.     - New keywords are  : 'IncomingISDN' 'OutgoingISDN'
  1194.  
  1195. Version 2.5 (isdnpm25.zip)
  1196.  
  1197.     - Implementation of the 'HDLCUI' protocols
  1198.  
  1199.     - REXX script for SLIP via X.75
  1200.       for the login procedure and definition of the Ip addresses
  1201.  
  1202.     - Improvement of PPP
  1203.       dynamic assignment of the Local-Ip address
  1204.  
  1205.     - Improvements for AVM-B1 and ELSA ISDN/PCFpro
  1206.  
  1207.  
  1208. Version 2.6 (isdnpm26.zip)
  1209.  
  1210.     !!!!!  ATTENTION  !!!!!!
  1211.  
  1212.     - Different procedures for login and configuration of the
  1213.       'Script' and 'IfConfigFile' interfaces!
  1214.       Please change older configurations with dynamic IP address
  1215.       assignment accordingly.
  1216.  
  1217.     - PPP has been enhanced
  1218.       The remote Ip address can be assigned dynamically, too.
  1219.  
  1220.     - Implementation of 'T-ONLINE'
  1221.     - ImplementatioP of 'PPP_ASYNC'
  1222.  
  1223.     - Minor modifications of the user interface:
  1224.       - the program can be started with the '-min' option
  1225.  
  1226.     With former versions we have received many suggestions for
  1227.     improvement by program users. We welcome any of these suggestions.
  1228.     Many of them referred to the user interface. With version 2.6, however,
  1229.     we have concentrated on enhancements on the protocol level.
  1230.  
  1231.  
  1232. Version 2.7 (isdnpm27.zip)
  1233.  
  1234.     Implementation of
  1235.     - communication via '\PIPE\ISDNPM' with 'isdnpm'
  1236.     - MS-Chap
  1237.     - alternative calling numbers and providers
  1238.     - IP masquerading
  1239.  
  1240.     Tested with
  1241.     - WARP-4 (Merlin)
  1242.  
  1243. Version 2.8 (isdnpm28.zip)
  1244.  
  1245.     - enhancement of masquerading feature
  1246.     - implementation of multiple mode IsdnPm
  1247.     - MS-CHAP with LAN manager password
  1248.     - MS-CALLBACK for Windows-NT RAS
  1249.     - on-line pass word query
  1250.     - enhancement of T-ONLINE
  1251.     - AVM-B1 with 'CAPI.DLL'
  1252.  
  1253. ------------------------------------------------------------------
  1254.  
  1255.  
  1256. Where is the latest version available?
  1257. ======================================
  1258.  
  1259.     The latest version is available on :
  1260.  
  1261.         'ftp.uni-freiburg.de'
  1262.     in
  1263.         '/pub/pc/os2/isdn'.
  1264.  
  1265.