home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / msnwrexx.zip / msnwrexx.doc < prev    next >
Text File  |  1996-02-07  |  4KB  |  114 lines
  1.  
  2.                             MSNWREXX Version 1.1
  3.  
  4.      ** This program is compatible with all 2.x and 3.x versions of OS/2 **
  5.         ** This program is compatible with all 3.x versions of Netware **
  6. ** This program is believed compatible with all 4.x versions of Netware in bindery mode **
  7.  
  8.             Copyright (c) 1996 Moore Stephens - All Rights Reserved.
  9.  
  10.  
  11.  MSNWREXX - An OS/2 DLL to permit REXX programs to call basic Netware functions
  12.  ─────────────────────────────────────────────────────────────────────────────
  13.  
  14.  
  15. 1.  INSTALLATION OF MSNWREXX
  16.  
  17. The only requirement for the installation of MSNWREXX is to place the DLL
  18. (msnwrexx.dll) in a directory that is on the LIBPATH of the PC.
  19.  
  20.  
  21.  
  22. 2.  REGISTRATION OF THE MSNWREXX ROUTINES
  23.  
  24. Before the MSNWREXX routines can be used, they must be registered to REXX 
  25. using the following code:
  26.  
  27. CALL RxFuncAdd 'MSNWLoadFuncs', 'msnwfunc', 'MSNWLoadFuncs'
  28. CALL MSNWLoadFuncs
  29.  
  30.  
  31.  
  32. 3.  CALLING THE MSNWREXX ROUTINES
  33.  
  34. Most routines can be called either as functions or with the CALL keyword.  Each
  35. routine provides a return code that indicates any problem conditions that have
  36. occurred in interfacing to Netware.  A few routines return a value which is the
  37. purpose of calling them.  The possible return codes are listed below.
  38.  
  39.  
  40. 3.1.  return=MSNWDefaultName()
  41.  
  42. There are no parameters for this routine, which returns the name of the default
  43. server.  
  44.  
  45.  
  46. 3.2.  return=MSNWCheckUser(Server,UserName,Password)
  47.  
  48. You must already have an attachment to the server specified in order for this 
  49. routine to work.  Provided that condition is satisfied, the parameters are checked
  50. on the specified server to see whether the UserName and Password combination
  51. provided are legitimate.  If they are, the return code will be zero.
  52.  
  53.  
  54. 3.3.  return=MSNWAttach(Server,UserName,Password)
  55.  
  56. This routine will attempt to achieve an attachment to the specified server, using
  57. the UserName and Password combination provided.  If successful, the return code
  58. will be zero.  If the password is expired, but there are still grace logins, the
  59. attachment will succeed, but the return code will be (100+number of grace logins
  60. remaining).  If the user is already attached, no action will be taken (i.e. there is
  61. no logout and re-attach) and a zero return code will be given.
  62.  
  63.  
  64. 3.4.  return=MSNWMap(Server, Volume, Drive, Path)
  65.  
  66. There must already be an attachment for the server specified.  Provided that is the
  67. case, then a mapping will be attempted.  The server volume name must be specified
  68. as the second parameter.  The drive to be mapped is the third parameter and is
  69. specified simply as a drive letter with no additional punctuation as shown in the 
  70. example.  The final parameter may be null, or may specify a legal path on the
  71. volume to be mapped.  If a path is specified, then a root mapping will be
  72. attempted.  An example of a call is:
  73.  
  74.     return=MSNWMap('MYSERVER', 'SYS', 'F', '')
  75.  
  76.  
  77. 3.5.  serverlist=MSNWSListServers()
  78.  
  79. You can obtain a list of currently visible servers by calling the function MSNWSList 
  80. which requires no parameters.  The result is a space separated list of server names.
  81. It is equivalent to the information obtained from the SLIST utility.
  82.  
  83.  
  84. 3.6.  connection=getconnctn()
  85.  
  86. This routine returns the Netware connection number for the default server, provided
  87. there is an attachment to a server.
  88.  
  89.  
  90. 3.7.  segment=
  91.  
  92. The network number of the attached segment is returned.
  93.  
  94.  
  95.  
  96. 4.  ERROR RETURN CODES
  97.  
  98. Where an error occurs, the return code will indicate which of the Netware routines
  99. provided in the standard Netware SDK gave an error return.  The key to error codes is:
  100.  
  101. 1.  init_calls            2.  get_attach            3.  get_status
  102. 4.  do_login            5.  do_logout            6.  read_property
  103. 7.  get_dconn            8.  check_user            9.  write_property
  104. 10. get_handle            11. get_pconn            12. GetDriveStatus
  105. 13. Drive in use        14. ParsePath            15. SetDriveBase
  106. 16. ChangeObjectPassword    17. GetConnectionInformation    18. GetInternetAddress
  107.  
  108.  
  109. 5.  DEBUGGING
  110.  
  111. After the parameters specified above, it is possible to code one additional parameter.
  112. If the additional parameter is coded and has the value 'X' then the function will
  113. operate in debug mode, and any error messages will be shown on the screen.
  114.