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