JRBUTILS v3.00

JRButils v3.00 comprises 68 bindery based and 55 NDS aware utilities
for managing NetWare. This collection of utilities is in three parts:

(1)  Part A comprises the 36 bindery based utilities which are
     available on the Internet in JRB300A.ZIP. These utilities are
     free.
(2)  Part B comprises a further 32 bindery based utilities. They
     are available from the author upon payment of a registration fee.
(3)  Part C comprises 55 NDS aware utilities. This set consists
     mostly of utilities from Part A and B with NDS support added.
     Part C is included in the price of Part B.

The Part A and Part B utilities run under NW 2.1x, 2.2, 3.x and under
bindery emulation on NW 4.x. The Part C utilities derived from Parts A
and B retain all their previous bindery functionality plus, with few
exceptions, incorporate the same functionality under NDS, In some
programs e.g. psadd and psdel, extra functionality under NDS has been
added. Some of the utilities in Part C are NDS specific and do not
have counterparts in Parts A and B.

The programs in JRButils are provided without warranty of any kind.
Although, every effort has been made to ensure that they are bug free
and perform as described, neither the author nor JRB Software accept
any liability whatsoever for any damages including lost profits or
revenue, or any other consequential damages resulting from the use of
these programs comprising JRButils. Any action brought against the
author or JRB Software will be under the jurisdiction of the courts
of New Zealand.

The author may be contacted at:

Email:   J.Baird@lincoln.ac.nz
Fax:     (64) 3 332 8947
Phone:   (64) 3 332 5996 (the least preferred option!)
Www:     http://nz.com/webnz/JRBSoftware
Postal:  PO Box 28118
         Christchurch
         New Zealand

Please report bugs. Suggestions for enhancements and new features
are always welcome.


Registering JRButils

The ongoing development of JRButils involves hundreds of hours of
time, plus it incurs significant costs for hardware, compilers,
copies of NetWare, development kits and so on. To help meet these
costs, I have the following registration scheme:

Register your site as a user of JRButils, pay the $US350.00
registration fee and you will receive the 32 utilities in part
B, the 55 utilities in Part C, plus any updates or new utilities
developed during the 12 months from the date that I receive your
registration with cheque, purchase order or credit card details.

Each program in Parts A, B and C contains in-built help giving the
basic details necessary to use them. More extensive
documentation covering each program and including examples is
available. Due to the costs of printing, and shipping from New
Zealand, the manual is now supplied on CDROM in both html and
printable formats. There are no restrictions on the number of 
copies which may be printed by the registered organization for 
use at sites covered by the registration. If I update the 
documentation within 12 months of receipt of your order, you will 
receive updated documentation free of charge. The cost structure is:

(a)  Software only                                     $US350
(b)  Software plus documentation                       $US450

or if re-registering within 6 months of expiry

(a)  Software only                                     $US250
(c)  Software plus documentation                       $US300

All currently registered sites will receive the v3.00 updates.

To order JRButils, fill in the details in ORDER.FRM and mail it to:

JRB Software
PO Box 28118
Christchurch 8000
New Zealand

Alternatively you may e-mail ORDER.FRM to
j.baird@lincoln.ac.nz, or fax it to (64) 3 332 8947

Note that a single registration covers an organisation within
one metropolitan area where a metropolitan area is limited to
the area contained within a 30 Km diameter circle. Organisations
spanning more than one metropolitan area and wanting to use
JRButils within each area should register more than one copy.
A five site license may be obtained for the price of two
registrations. For large numbers of site, please contact the
author.


Summary of Utilities

The utilities in this release are as follows. 'A', 'B' and 'C'
indicates which set they are in.

ACCEXP    Warns of impending account expiration in a login script (A)
BINDCLOS  Closes the bindery (A)
BINDOPEN  Opens the bindery (A)
CHKHOME   For use with David Harris' SETHOME utility (A, C)
CL_TYPE   Determines if your client is NETX, VLMs or Client32 (A)
CON_OPS   Lists, adds, or deletes console operators (B)
COPYUSER  Copies users from one server to another (B)
CREATOBJ  Creates bindery and NDS objects en masse (A, C)
DELADDR   Removes network addresses from NDS for users no longer
          logged in (C)
DELOBJ    Deletes bindery and NDS objects en masse (A, C)
DISABLE   Disables logins (A)
DOWNSRVR  Downs a file server (A)
DQUOTA    Displays quota, space used, space available for a single
          user - intended for use in a login script (A, C)
ENABLE    Enables logins (A)
FSUPDATE  Copies, deletes or renames files across multiple servers (B, C)
GETBAL    Displays account balances and credit limits en masse (B, C)
GETEQUIV  Displays security equivalences, lists who is
	  equivalent to who (A)
GETQUOTA  Displays quotas, space used, space available for
	  multiple users (A, C)
GETREST   Displays account, time and station restrictions for
	  multiple users (A, C)
GRPADD    Adds users to groups (A, C)
GRPDEL    Removes users from groups (A, C)
GRPLIST   Lists the members of a group, membership or non-membership
          of multiple groups linked using logical operators (A, C)
GRPMEMB   Checks group membership in a BAT file (A, C)
HOME2     An NDS aware version of David Harris' HOME (C)
IS_VLMS   Detects VLMs or NETX in a BAT file (A)
JBERRTXT  Displays descriptions for NetWare error codes (A)
JRBMAP    Enhanced version of Novell's MAP utility (B)
JRBPURGE  Enhanced version of Novell's PURGE utility (B, C)
KILLCONN  Clears connections from a file server (A, C)
KILLZERO  Deletes zero length files (B, C)
LASTLGN   Display the previous login time in a login script (B)
LISTOBJ   Lists bindery and NDS objects of any type (A, C)
LSCRIPTS  For management of login scripts for bindery and NDS users (C)
MAKEMEMB  Makes a user a member of one or more groups (A, C)
MATTACH   Attaches/detaches to/from multiple servers and
	  incorporates 'slist' and 'whoami' functions (B, C)
MGRADD    Adds managed users to a user account manager or work
	  group manager (B)
MGRDEL    Removes managed users from a user account manager or
	  work group manager (B)
MGRLIST   Lists managers and their managed users (B)
MOVE_OBJ  Moves NDS objects from one container to another (C)
NETCOPY   Copies a directory tree preserving attributes,
	  ownership, trustee assignments, directory quotas (B, C)
OPENFILE  Display open files by user or connection, or who has one
          or more files open (B, C)
PQADD     Assigns operators, users or print servers to a print
	  queue (B, C)
PQCOPY    Replicates bindery queues on the same or across servers (B, C)
PQDEL     Removes operators, users or print servers from a print
	  queue (B, C)
PQDELJOB  Deletes one or more jobs from a print queue (B, C)
PQLIST    Lists jobs in one or more print queues (B, C)
PQMOVJOB  Moves jobs from one queue to another (B, C)
PQRELJOB  Sets/removes user hold and operator hold status (B, C)
PQSTATUS  Displays the status of one or print queues across one or
	  more servers, allows changing of queue status (B, C)
PQUSERS   Lists operators, users or print servers for one or more
	  print queues (B, C)
PRADD     Assigns queues to printers (C)
PRDEL     Removes queues from printers (C)
PROFILES  Assigns profiles to or removes profiles from users (C)
PSADD     Assigns operators, users and printers (NDS only) to print
          servers (B, C)
PSCOPY    Replicates bindery print servers on the same or across
          servers (B, C)
PSDEL     Removes operators, users and printers (NDS only) from print
          servers (B, C)
PSUSERS   Lists operators, users and printers (NDS only) for one
          or more print servers (B, C)
PWDEXP    Warns of impending password expiration in a login script (A)
RENOBJ    Renames bindery objects (A, C)
REQUESTS  Continuously displays the total requests, bytes read and
          written for connections under 4.x (A, C)
SALVLIST  Lists deleted files in one or more directories (B, C)
SETACL    Sets/deletes/views ACLs en masse (C)
SETBAL    Sets account balances and credit limits en masse (B, C)
SETCX     Locates a user in an NDS tree and sets the context to the
          container in which the user is found (C)
SETEQUIV  Sets security equivalences (B)
SETHOME2  Sets the HOME_DIR bindery property or the NDS "Home
	  Directory" attribute for multiple users (A, C)
SETNAME   Sets the full name for user, groups, printservers, and
          any text attribute for NDS objects (A, C)
SETOWNER  Sets file ownership en masse (A, C)
SETPWORD  Sets passwords en masse (A, C)
SETQUOTA  Sets disk/volume/directory quotas en masse (A, C)
SETREST   Sets account, time and station restrictions en masse (A, C)
SPARSE    Identifies sparse files, optionally displaying the block
          bitmap (B, C)
TRSTLIST  Lists trustees for users, groups, files, directories (A, C)
USERGRPS  Lists the groups belonged to for one or more users (A, C)
USERS     Lists users logged in to one or more servers (A, C)
USERMGRS  Lists the managers of one or more users (B)
WHODIDIT  Displays selected file and directory information e.g.
          owners, updaters, physical size, logical size (B, C)
VOL_INFO  Displays information about one or more volumes (A)


JRBUTILS History

Some of the programs in JRBUTILS were originally developed as
an aid to managing the NetWare fileservers at Lincoln
University. As a result various requests for utilities on
novell@suvm.bitnet and comp.sys.novell, I tidied some of my
utilities, improved the error handling, and released them onto
the Internet in early 1991. Development of these utilities and
of new utilities has continued, in my own time. All the
original programs have been rewritten in C (from Turbo Pascal)
and have been significantly enhanced. In September 1992, with
the support of the Director of the Centre for Computing and
Biometrics at Lincoln University, I have obtained legal ownership
of the programs in JRBUTILS. Development has continued ever since.


Acknowledgements

1.   Dr Alan McKinnon, Director of the Centre for Computing
     and Biometrics at Lincoln University for assistance in
     obtaining ownership of the utilities from Lincoln
     University.

2.   David Harris for permission to include his SETHOME and
     HOME utilities, for permission to write SETHOME2, and
     for lots of sound advice.

3.   Simon Carter (sac@tusc.com.au), the author of various
     utilities, who provided code for setting dates/times of
     directories on local drives, for use in netcopy. Ironically,
     this was one of the enhancements which I did not find time to
     implement in v3.00.

4.   Lots of people for providing invaluable feedback including
     bug reports and suggestions for new features. In particular,
     Brian Cassidy, Mark Cramer, Al Lowe-Norris, Herb McBride
     and Jaap van Ginkel.

John Baird
5 October 1996.

