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