home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / network / rexxlan / readme.1st < prev    next >
Encoding:
Text File  |  1993-11-10  |  5.9 KB  |  142 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                   REXXLAN/2 1.0
  10.  
  11.                                    README.1ST
  12.  
  13.  
  14.                ┌──────────────────────────────────────────────────┐
  15.                │                    REXXLAN/2                     │
  16.                │     the programmers REXX API extension for       │
  17.                │     IBM LAN Server (and compatible) networks.    │
  18.                └──────────────────────────────────────────────────┘
  19.  
  20.                   (c) EDV Beratung Leif Braeuer, 1992, 1993
  21.                       25421 Pinneberg, Germany
  22.                       EMAIL: CIS: 100024,3436, Fido: 2:240/5200.13
  23.  
  24.  
  25.  
  26.    CONTENT:
  27.            I.   Latest information ............................. 3
  28.            II.  Installation ................................... 3
  29.            III. VTSCTRL ........................................ 4
  30.            IV.  Release history ................................ 5
  31.  
  32.  
  33.  
  34.  
  35.    LATEST INFORMATION
  36.    ──────────────────
  37.  
  38.    This version 1.0 was verified by several early experience tester, who
  39.    I wish to thank for their constructive and creative critics. They
  40.    helped me to make this version user-proofed. In this README you will
  41.    find some hints for installation and the missing documentation of the
  42.    license and version control program VTSCTRL.
  43.    Also you will find some of the development steps of REXXLAN/2 in the
  44.    release history section, that may help you to find, whether a problem
  45.    is fixed or a long needed feature was added.
  46.  
  47.  
  48.  
  49.    INSTALLATION
  50.    ────────────
  51.  
  52.    The installation is descibed in the enclosed manual. If you don't
  53.    want a fully installed version of REXXLAN/2, you have to mind that
  54.  
  55.    - VTSCTRL.EXE is in the current directory or in a directory included
  56.      in the PATH statement of your CONFIG.SYS
  57.  
  58.    - the RXLAN20.DLL (or RXLAN30.DLL) is in one of the LIBPATH directories.
  59.      If you added  "."  as a directory entry, having te DLL in the current
  60.      directory is also possible.
  61.  
  62.  
  63.  
  64.    VTSCTRL
  65.    ───────
  66.  
  67.    VTSCTRL is the program REXXLAN/2 needs to verify the serial number,
  68.    product name and version. It is a detached process, that REXXLAN/2
  69.    starts automatically. Once started, the program stays resident and
  70.    registers your serialized version of REXXLAN/2.
  71.  
  72.    VTSCTRL.EXE is also used to control this backgroud process. You start
  73.    it with the following command paramters:
  74.  
  75.    ┌─────────────────┬──────────────────────────────────────────────────┐
  76.    │ Command         │   Action taken                                   │
  77.    ├─────────────────┼──────────────────────────────────────────────────┤
  78.    │ VTSCTRL         │   If not already started, VTSCTRL installs its   │
  79.    │                 │   services and waits for requests. This mode can │
  80.    │                 │   be used for debugging purposes, because        │
  81.    │                 │   VTSCTRL reports each received message and      │
  82.    │                 │   action taken. If you receive the message that  │
  83.    │                 │   VTSCTRL cannot be started or a duplicate serial│
  84.    │                 │   number is found, you can start VTSCTRL in a    │
  85.    │                 │   windowed session and monitor, which requester  │
  86.    │                 │   has the duplicate serial number.               │
  87.    ├─────────────────┼──────────────────────────────────────────────────┤
  88.    │ VTSCTRL /D      │   Sends a kill request to a running instance of  │
  89.    │                 │   VTSCTRL. If VTSCTRL receives a kill request it │
  90.    │                 │   closes and frees all used resources and termi- │
  91.    │                 │   nates.                                         │
  92.    ├─────────────────┼──────────────────────────────────────────────────┤
  93.    │ VTSCTRL /I      │   Displays a information message about a running │
  94.    │                 │   VTSCTRL. This includes a table of all on this  │
  95.    │                 │   workstation registered products.               │
  96.    │                 │   This is an alternative to the ABOUT.CMD to     │
  97.    │                 │   retrieve the personal datas of your REXXLAN/2  │
  98.    │                 │   copy.                                          │
  99.    └─────────────────┴──────────────────────────────────────────────────┘
  100.  
  101.  
  102.    RELEASE HISTORY
  103.    ───────────────
  104.  
  105.    Version 0.99
  106.  
  107.         - Version includes LAN Server 3.0 API
  108.         - Implementation for the main server API sections finished.
  109.  
  110.   Version 0.992
  111.  
  112.         - Many fixes especially in the "SetInfo" and "Add" were done.
  113.  
  114.   Version 1.0
  115.  
  116.         The performance of the function calls has been improved. Using
  117.         SetInfo or Add API, unneccessary parameters will be ignored or
  118.         set to their old values.
  119.         The UPM functions were added to allow a full logon/logoff in
  120.         a domain.
  121.  
  122.         Please notice that you are not allowed to use the evaluation
  123.         copy more than 30 days. After this period the NetFuncAdd will
  124.         always terminate with an error.
  125.  
  126.         The function NetRexxVersion has two new info level. Please
  127.         refer to the description in the manual.
  128.  
  129.     ┌────────────────────────────────────────────────────────────────────┐
  130.     │   IMPORTANT:                                                       │
  131.     │   It seems that the IBM NetAppAdd C library function does not      │
  132.     │   mind what parameters it receives in the app_info_X. In my        │
  133.     │   test environment, invalid data passed to the Domain controller   │
  134.     │   destroyed its DCDB.A. This problem occured only once during my   │
  135.     │   tests and is under investigation at the IBM developers support.  │
  136.     │   I do strongly recommend to avoid this function or to install     │
  137.     │   programs using this API only after a long and intensive testing  │
  138.     │   period. A fix will be supplied as soon as the problem is solved. │
  139.     └────────────────────────────────────────────────────────────────────┘
  140.  
  141.  
  142.