home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / nwos2utl.zip / README < prev   
Text File  |  1995-10-02  |  3KB  |  84 lines
  1. NWUTILS.DLL - A limited Netware External Function Library for REXX
  2.  
  3. This Netware external function library for REXX was written by Scotty Hudson.
  4. This software is free. You may do anything you choose with this software.
  5. The author and the company he works for is in no way responsible for any
  6. damages that may be incurred from the use of this software. The author in no
  7. way has any affiliation with Novell Inc.
  8.  
  9. Netware is a trademark of Novell Inc.
  10.  
  11. With this said here goes: I have to preform daily task on 200+ fileservers at
  12. certain times each day. I needed a way to automate this using OS/2 because the
  13. link between many of these servers is very slow and DOS sessions in OS/2
  14. don't take avantage of PBURST. In DOS you can redirect standard in to login.exe
  15. or map.exe, but you can't in OS/2. To solve this I wrote this DLL for REXX. It
  16. only has three functions in it. ( I needed something fast and these were all I
  17. needed to get the job done. )
  18.  
  19. Directions:
  20. First you need to register the DLL and the functons with REXX. These two
  21. statements will do the trick.
  22.  
  23. call RXFuncAdd 'NWLoadFuncs', 'NWUTILS', 'NWLoadFuncs'
  24. call NWLoadFuncs
  25.  
  26. Make sure that NWUTILS.DLL is in your libpath. I put mine in my netware
  27. directory.
  28.  
  29. Function 1 - NWAttach
  30.  
  31. This function attaches to a specific file server.
  32.  
  33. This function takes three arguments: fileserver, login name, password
  34.  
  35. example:
  36. ret = NWAttach( "FileServer", "LoginName", "Password" )
  37.  
  38. The return codes are:
  39. success -> 0
  40. connection failure -> 1
  41. invalid password -> 2
  42. just can't attach -> 3
  43. NWCALLS.DLL intialzation failure -> 4
  44. invalid number of args -> 5
  45.  
  46. Function 2 - NWCkConn
  47.  
  48. This function checks to see if you are connected. This is useful to check to
  49. see if you are attached to a fileserver before you try to do so. Remember all
  50. Netware connections in OS/2 are global. If you have a background task running
  51. you don't want to kill it by attaching again.
  52.  
  53. This function only takes on argument: fileserver
  54.  
  55. example:
  56. ret = NWCkConn( "FileServer" )
  57.  
  58. The return codes are:
  59. if connected -> 0
  60. if not connected -> 1
  61.  
  62. Function 3 - NWLogout
  63.  
  64. This function is self explanitory. It logouts and detaches from a fileserver.
  65.  
  66. This function takes one argument: fileserver
  67.  
  68. example:
  69. ret = NWLogout( "FileServer" )
  70. success -> 0
  71. failure -> 1
  72.  
  73. I hope this is some use to someone. I use it everyday and have yet to have a
  74. problem with it. I don't know how well it will work on Netware 4.x fileservers,
  75. but it seems to do the job with 3.x fileservers. I do not claim to be a C
  76. programmer and my code is rather messy, so that is why I did not include
  77. it with this package. Sometime I would like to clean up the code and add some
  78. more useful functions to it. If anyone has any questions feel free to email me.
  79.  
  80. Scotty Hudson
  81. shudson@cbrl.cbrlcorp.com
  82.  
  83.  
  84.