home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / netutl.zip / NetUtil.ANN < prev    next >
Text File  |  1997-10-30  |  3KB  |  70 lines
  1. ******************************************************************************
  2. *  (c) Copyright International Business Machines Corporation 1995, 1997.     *
  3. *                  All Rights Reserved.                                      *
  4. *                                                                            *
  5. *        NetUtil (REXX functions that enhance NET commands)       Ver 1.23   *
  6. *                                                                            *
  7. *        Author: Shintaroh Hori        (shori@jp.ibm.com)                    *
  8. *                Yamato Lab, IBM Japan                                       *
  9. *                                                                            *
  10. ******************************************************************************
  11.  
  12. List of files extracted from NETUTL.ZIP
  13. ---------------------------------------
  14.    LICENSE.TXT   IBM License Agreement
  15.    NetUtil.ABS   Abstract of this program
  16.    NetUtil.ANN   Short description of this package
  17.    NetUtil.INF   On-line document of NetUtil functions
  18.    NetUtil.DLL   NetUtil functions for OS/2 Warp v3 and up.
  19.    NetUtil.DL2   NetUtil functions for OS/2 Warp v2 and up.
  20.  
  21.  
  22. Abstract:
  23. ---------
  24.   NetUtil.DLL is a REXX function package which includes REXX functions that
  25.   simulate and enhance NET commands of IBM OS/2 LAN Server products. It also
  26.   includes functions that can perform what NET commands do not offer.
  27.  
  28.   It is designed to provide REXX programmers with ease-of-use interface
  29.   and more capabilities than NET commands.
  30.  
  31.   Note:
  32.    IBM offers an applet WSLSRXUT("LAN Server/Warp Server REXX API extension")
  33.    as a free AS-IS software from a Web site;
  34.       http://www.software.ibm.com/warp/pspinfo/wsapplets.html
  35.  
  36.    NetUtil has less functions than WSLSRXUT, but I think it will be more
  37.    friendly to use than WSLSRXUT because NetUtil is is an implementation of
  38.    NET commands as REXX functions but WSLSRXUT is an implementation of LAN
  39.    Server APIs as REXX functions.
  40.  
  41.  
  42. Advantage of NetUtil functions:
  43. -------------------------------
  44.   * It sets information directly into REXX variables.
  45.   * It offers more simple interface than NET commands.
  46.   * It provides non-ADMIN users with limited information that cannot be
  47.     obtained by NET commands.
  48.   * There are also useful functions of non-NET command type.
  49.   * It returns an exact return code from NET APIs.
  50.  
  51.  
  52. NetUtil makes a REXX program simple:
  53. ------------------------------------
  54.   Here is an example of REXX program that lists all the group names of
  55.   a logon domain and the user ids within the groups.
  56.   (Imagine your coding work if you have to code it with NET GROUP command.)
  57.  
  58.    /* Example.  */
  59.    if NetGroup('Query','out','.')=0 then do
  60.      do i=1 to out.0
  61.        say out.i.0gid       /* group id*/
  62.        say out.i.0remark    /* comment for this group */
  63.  
  64.        do j=1 to out.i.0    /* number of users */
  65.          say out.i.j        /* user id within the group*/
  66.        end
  67.      end
  68.    end
  69.    Exit
  70.