Utilities in JRButils v4.00 Part B

Con_ops

Con_ops allows you to add or delete one or more console operators
in a single command. Features include:

o   May add or delete user or group objects
o   May also list console operators and optionally sort them
o   Can display only the number of console operators on the server

Copyuser

Copyuser copies users and groups from one server to another retaining
all bindery properties and their contents where possible, and copies
the contents of mail and home directories, retaining all attributes,
trustees, quotas etc as per netcopy. Copyuser may also be used to
replicate users on the same server using an existing user as a
template. Other features include:

o   Quotas can be adjusted during the copy (for larger block sizes
    on the destination volume)
o   Groups can be substituted
o   Passwords may be left NULL or set to the username
o   The home directory path may be altered during copying (e.g. from
    VOL1:USERS to USERS:ECON)
o   Groups can be created on the destination server as required when
    moving users who belong to these groups on the source server
o   Ownership of files can be set to the user regardless of the
    original owner
o   Can copy only the contents of home or mail directories. When
    copying mail directories, it uses the object ID for each user
    on the source and target servers, and will create the mail
    directory on the target server if it does not exist. This
    provides a means of transferring mail directories when the users
    have been transferred by other means and the object IDs have
    changed. For example, a combined hardware upgrade and upgrade
    from NW 3.x to NW 4 can be done by installing NW 3 on the new
    server, copying the bindery then doing an in-place upgrade to
    retain the passwords.

Fsupdate

Fsupdate allows you to perform file maintenance operations across
multiple servers. Its features include:

o   Can copy individual files, files selected via wild cards, or
    entire directory trees to multiple servers. Fsupdate attempts to
    retain all file attributes including ownership, creation and
    last update dates.
o   Can delete individual files, files selected via wild cards, or
    entire directory trees on multiple file servers.
o   Can rename files on multiple servers. This facility may be used to
    move files from one directory to another providing that the source
    and target directories are on the same volume.
o   Can specify what attributes you want set on copied files and
    directories
o   Can overwrite, delete or rename files flagged read-only
o   Can copy trustee assignments
o   Can purge files which have been deleted
o   Handles non-DOS name spaces
o   Can retain compression when copying files under NW 4.x
o   Copies sparse files correctly.

Getbal

Getbal lists account balances (adjusted or unadjusted), account
holds or credit limits for multiple users. Features include:

o   Can specify a multiplier to change the units of output
o   Can control which values are output and in what order
o   The output may be sorted by username, balance, or credit limit
o   The output can be filtered by value e.g. all users with a
    balance of less than $10.00
o   May be used in a login script to display the account balance
    for each user as they log in
o   Can also display the default account balance and credit limit
    given to new users (normally viewed via SYSCON's "Supervisor
    Options" - "Default Account Balance/Restrictions")
o   Totals are given when displaying balances and holds for multiple
    users
o   Can list users without credit limits or account balances.
o   Can display balances and credit limits for print servers

Jrbmap

Jrbmap is a replacement for Novell's MAP, primarily for use in
BAT files where it will map drives without fuss and piping in 'y's
and 'n's. While it does not have all the features of MAP, it has
numerous features which MAP does not have including:

o   Can specify alternative paths so that in the event of one being
    unavailable it will try the next (this is used for all applications
    at Lincoln University so that in the event of an APPS volume
    failing, the application will simply be retrieved from the
    corresponding volume on another server).
o   Can save existing mappings in the DOS master environment
    and subsequently restore from there
o   Supports map root
o   Supports map next
o   Can map multiple drive letters in a single command
o   Can save all mappings to a file and subsequently restore them
o   Can display current mappings including the paths for local drives
o   Can map network drives to local drives under the VLMs (this is not
    possible under NETX)
o   Can force truncation of the lowest level directory to eight chars.
    This could be useful in a login script e.g.
    #jrbmap p:=vol1:users\%LOGIN_NAME
o   Can specify the username and password to use when connecting to
    other servers (it defaults to GUEST)
o   Can map to a user's home directory by specifying the path as ~HOME.

Jrbpurge

Jrbpurge allows selective purging of files. Features include:

o   Supports purging by name
o   Supports purging by size
o   Supports purging by owner
o   Supports purging by deletor
o   Supports purging by deletion date and time
o   Can specify multiple files to purge in a single run e.g.
    *.obj,*.tmp,*.swp,fred.bak

Killzero

This program will delete zero length files in a single directory or
in an entire directory tree. It was written to remove the large
numbers of zero length files which accumulate in student mail
directories when using Pegasus Mail when directory quotas are enabled.
When a user has no space available and an attempt is made to deliver
a message, the file is created but cannot be written to, leaving a
zero length file. Options include:

o   Can delete read-only files
o   Can optionally list the zero length files without deleting them
o   Can display only the total zero length files
o   Can optionally purge deleted files (this is recommended as there
    is no reason to recover an empty file!)
o   Can retain certain zero length files by giving a list of one or
    more file names, optionally containing wild cards.
o   Is smart enough not to delete Mac files with a zero length data
    fork but a non-zero length resource fork

Lastlgn

Lastlgn can be used in a login script under NW 2.x, 3.x and 4.x to
display the user's previous login date and time. This provides a useful
indication of when the account was last used. Note that the NW 4.x
version of LOGIN.EXE provides a login script variable which gives
access to this value and using this variable is more efficient that
running an external program. Lastlgn requires that each user have a
MISC_LOGIN_INFO property and it can be used to create these and to
copy the previous login date and time from the LOGIN_CONTROL property
by a supervisor equivalent user or a manager. The last login date and
time in the LOGIN_CONTROL property is overwritten with the current
date/time by the login process, and so has been changed by the time
LOGIN begins executing the login script. LOGIN does not update the
date/time in the MISC_LOGIN_INFO property until immediately prior to
exit, thereby making the previous login time available during execution
of the login script.

Mattach

Mattach allows you to attach to or detach from multiple servers in a
single command. Features include:

o   Can specify one or more server names, each of which may contain
    wild cards, and you may exclude servers by preceding the name
    with '!' e.g. 'mattach rata,toki,p*,!pn*/john' would log you into the
    designated servers as user JOHN
o   Can optionally give the password on the command line
o   Can optionally list all visible servers as per slist
o   Can optionally perform a whoami function and list all servers to
    which your workstation is attached.
o   Optional sorting by server name for both the whoami and slist
    functions
o   When listing all visible servers, mattach can also display the
    version of NetWare running on each server
o   When listing all visible servers, mattach can also display the
    serial number of each server

Mgradd

Mgradd adds one or more users or groups to a user account
manager or to a work group manager. On the command line you
may specify multiple entities to become managed by the
nominated manager object (a user or a group). Each entity may
be a username (possibly containing wild cards), a group name
(possibly containing wild cards) or a file containing a list
of users or groups. When a group name is specified, either the
group object or the members of the group may become managed.
The manager may be made a work group manager if desired.

Mgrdel

Mgrdel removes one or more users or groups from a user account
manager or from a work group manager. On the command line you
may specify multiple entities to removed from management by
the nominated manager object (a user or a group). Each entity
may be a username (possibly containing wild cards), a group
name (possibly containing wild cards) or a file containing a
list of users or groups. When a group name is specified,
either the group object or the members of the group may become
unmanaged. The manager may be removed from being a work group
manager if desired.

Mgrlist

Mgrlist lists managers and their managed users. Features include:

o   Can list all objects managed by a nominated user or group
o   Can list all managed users on the server
o   Can list all work group managers and/or all user account managers on
    the server.
o   Output may be sorted by object name
o   May output totals only
o   Detects user account managers and work group managers who obtain
    this status by being security equivalent to another work group
    manager or user account manager

Netcopy

Netcopy copies individual files or an entire directory tree from
one location to another, possibly on a different volume, on a
different server, or on a local drive. It preserves the following
when copying files and directories:

o   All file information including the creation date, last
    update date and time, file attributes, and if possible,
    file ownership. If a file is being copied from one server
    to another, and the owner is not registered on the
    destination server, the owner becomes the username under
    which you are logged in on that server.
o   All directory information including the creation date,
    directory attributes, and if possible, directory
    ownership. If a directory is being copied from one server
    to another, and the owner is not registered on the
    destination server, the owner becomes the username under
    which you are logged in on that server.
o   Optionally, all directory trustee assignments, providing
    that the object to which the rights are granted, is
    registered on both the source and destination server.
    Trustee rights are automatically converted when copying
    from NW 2.x to NW 3.x or NW 4.x and vice versa.
o   Optionally, all file trustee assignments, providing that
    (a) both the source and destination server are running NW
    3.x or NW 4.x, and (b) that the object to which the
    rights are granted is registered on both the source and
    destination servers.
o   Optionally, all directory quotas if both the source and
    destination servers are running NW 3.x or NW 4.x.
o   Optionally, all volume quotas, providing that both the
    source and destination servers are running NW 3.x or 4.x,
    and that the object to which each quota applies is
    registered on both the source and destination servers.

Netcopy copies DOS and Mac name space entries, and I believe it
copies OS/2 and NFS (with -t) correctly. It will attempt to
retain name space information for FTAM, but this has not been
tested. Other features include:

o   An update option allows you to copy only those files which do not
    exist in the destination tree, or have more recent update dates
    Or you can copy only those files which do not have an exact match of
    size and update date in the destination directory
o   Quotas may be removed during copying and restored later. This is
    often useful when copying to a volume with a larger block size
    where each file is likely to have more space allocated.
o   Quotas may be altered as they are copied
o   Checks that there is sufficient space available before copying
    a file. This can be suppressed for a slight gain in speed.
o   Can optionally ignore hidden files and directories
o   Can copy only those files with the archive bit set with optional
    resetting of the archive bit on the original and copy of the file
o   Can query whether or not to copy each file
o   Can disable the receipt of broadcasts while copying
o   Can retain compression when copying files under NW 4.x
o   Copies sparse files correctly.

Nsrename

Nsrename allows the renaming of files and directories in any name
space without affecting the name in other name spaces. It requires
NW 3.12 or NW 4.x as the functionality to perform the rename in a
single name space is not present in earlier versions. Nsrename can
also change the case of names of multiple files or directories and
was in fact written to overcome a problem where a particular product
failed to function correctly when it encountered NFS names in
uppercase.

Openfile

Openfile can

o  Display open files by object name or connection number
o  Display who has a particular file or files open

Features include

o  Can display open files for all logged in objects on a
   server
o  Can display open files for any type of object
o  Can display open files in any name space
o  Can display who has any files open in a particular directory, or
   in an entire directory tree.
o  Can display lock information for open files
o  Can clear connections holding a file open
o  Can sort the output as follows
     o  by connection number
     o  by directory name
     o  by file name
     o  by object name
     o  data from multiple files, users, or connections can
        be merged before sorting
     o  the sort order can be reversed
o  Can display the total number of open files on the server
o  When doing a merged sort by directory, it gives the number
   of unique files open

Pqadd

Pqadd makes one or more users or groups 'operators' or 'users'
of the specified print queue. Features include:

o   Can use wild cards in the queue name
o   Can also add print servers to a queue
o   You may specify multiple entities on the command line, each of
    which may be a single user, one or more users selected via wild
    cards (e.g. z*), a group, or a list of usernames in a file.
o   Can make a group object a queue user or operator, or the individual
    members of the group may be made queue users or operators
o   Can add both queue users and operators (but not print servers) in
    a single invocation

Pqcopy

Pqcopy copies bindery queues, possibly to another server, and will
optionally retain all queue operators, users, servers, and print jobs.

Pqdel

Pqdel removes one or more users or groups from being 'operators' or
'users' of the specified print queue. Features include:

o   Can use wild cards in the queue name
o   Can also remove print servers from a queue
o   You may specify multiple entities on the command line, each of
    which may be a single user, one or more users selected via wild
    cards (e.g. z*), a group, or a list of usernames in a file.
o   Can remove a group object from being a queue user or operator,
    or the individual members of the group may be removed as queue
    users or operators
o   Can remove both queue users and operators (but not print servers) in
    a single invocation

Pqdeljob

Pqdeljob deletes one or more jobs from a print queue. Features include:

o   You may specify one or more job numbers on the command line, '*'
    meaning all jobs in the queue, a range e.g. jobs 10-20, or
    usernames possibly including wild cards
o   Can chose to have pqdeljob ask for confirmation before deleting
    each job

Pqlist

Pqlist lists the jobs in one or more queues on one or more file
servers. Features include:

o   Wild cards may be used in the queue name
o   Any number of file server names may be specified (e.g.
    tui,kea,weka/laser*) or you may specify 'A' meaning all servers
    to which you are currently attached. Files servers preceded
    by '!' will be skipped.
o   The default output gives the job number, user, description or
    file name, size, date/time submitted and status for each job
o   You may design you own output selecting from 16 fields and choosing
    the size and order of each field. The fields are:
      Banner file name
      Connection number of the workstation from which the job was
        submitted
      Description
      Job entry time
      File name (may be blank if the job was captured directly from
        an application)
      Job number
      Form number
      Form name
      Job position in the queue
      Number of copies
      The path associated with the file being printed
      The name of job file in the queue directory
      Target server name if specified
      The job status (open, ready, user hold, etc)
      The name of the object which enqueued the job
      Job execution time
      Number of bytes to be printed
o   Output may be limited to jobs submitted by a particular user
o   The number of jobs can be returned as an error level

Pqmovjob

Pqmovjob allows print jobs to be copied from one bindery queue to
another possibly on a different server. The jobs may optionally be
deleted from the source server.

Pqreljob

Pqreljob allows jobs to be released from user and/or operator hold
on bindery or NDS queues. It may optionally be used to place
existing jobs on user or operator hold.

Pqstatus

Pqstatus allows you to view and alter the status of multiple print
queues across multiple servers. It displays:

o   Whether jobs can be submitted to the queue
o   Whether print servers can attach to the queue
o   Whether print servers can service the queue
o   The number of jobs in the queue
o   Attached print servers and their connection numbers

Features include:

o   Can use wild cards in queue names
o   Any number of file server names may be specified (e.g.
    tui,kea,weka/laser*) or you may specify 'A' meaning all servers
    to which you are currently attached. Files servers preceded
    by '!' will be skipped.
o   Allows you to toggle or set to a specific value:
      (a) jobs can be submitted to the queue
      (b) servers can attach to the queue
      (c) servers can service the queue

Pqusers

Pqusers lists the queue users, operators and/or print servers for one
or more queues on one or more file servers. Features include:

o   Wild cards may be used in the queue name
o   Any number of file server names may be specified (e.g.
    tui,kea,weka/laser*) or you may specify 'A' meaning all servers
    to which you are currently attached. Files servers preceded
    by '!' will be skipped.
o   The list of users, operators or print servers for each queue may
    be sorted
o   Can limit the output to the total number of users, operators and/or
    print servers for each queue
o   User or operator groups may be expanded so that all user objects
    which are queue users or queue operators are listed
o   Can output 'pqadd' commands for users, operators and print servers

Psadd

Psadd makes one or more users or groups 'operators' or 'users'
of the specified print server. Features include:

o   Can use wild cards in the print server name
o   You may specify multiple entities on the command line, each of
    which may be a single user, one or more users selected via wild
    cards (e.g. z*), a group, or a list of usernames in a file.
o   Can make a group object a print server user or operator, or the
    individual members of the group may be made print server users
    or operators
o   Can add both print server users and operators in a single invocation

Pscopy

Pscopy can replicate print servers on the same file server, or copy
print servers to another file server. By default, it copies all
attributes including the description, operators, printer definitions,
server and users, but copying each of these may be individually
suppressed.

Psdel

Psdel removes one or more users or groups from being 'operators'
or 'users' of the specified print server. Features include:

o   Can use wild cards in the print server name
o   You may specify multiple entities on the command line, each of
    which may be a single user, one or more users selected via wild
    cards (e.g. z*), a group, or a list of usernames in a file.
o   Can remove a group object from being a print server user or
    operator, or the individual members of the group may be removed
    from being print server users or operators
o   Can remove both print server users and operators in a single
    invocation

Psusers

Psusers lists the print server users and operators for one or more
print servers on one or more file servers. Features include:

o   Wild cards may be used in the print server name
o   Any number of file server names may be specified (e.g.
    tui,kea,weka/laser*) or you may specify 'A' meaning all servers
    to which you are currently attached. Files servers preceded
    by '!' will be skipped
o   The list of users and operators for each print server may be sorted
o   Can limit the output to the total number of users and operators
    for each print server
o   User or operator groups may be expanded so that all user objects
    which are print server users or operators are listed
o   Can output 'psadd' commands for users and operators

Salvlist

Salvlist lists the file name, size, owner, deletor and the date/time of
deletion individual files, for all deleted files in a single directory
or for all directories in a tree. Features include:

o   Output may be sorted by any field
o   Can search for files with a particular name, files owned by a
    given user, files deleted by a given user, by file size, and deletion
    date and time.
o   Can display only the number of deleted files in each directory
o   Files may be recovered based on any selection criteria, with
    automatic renaming if a file exists with the same name.
o   Can request that only the most recently deleted file with a particular
    name be recovered

Setbal

Setbal sets account balances or credit limits for a single
user, each member of a group, one or more users selected using
wild cards, or a list of users in a file. Features include:

o   Both the account balance and credit limit may be set to a
    specified value, or they may be adjusted by a given amount
    (e.g. add $10 to each member of group ABC).
o   Can set the account balance or credit limit to the default value
    used when creating accounts, as set under "Supervisor Options" -
    "Default Account Balance/Restrictions" in SYSCON.
o   When using an input file, the balances may be in the file allowing
    a different balance to be set for each user
o   Can set balances and credit limits for print servers
o   Can delete accounting holds. This is not normally required but
    a bug in A.N.D. Technologies' Pcounter could result in large random
    account holds remaining in existence.

Setequiv

Setequiv allows you to make one or more users security
equivalent to another from the command line. SYSCON will run
out of memory when you attempt to do this when there are
around 3,000 or more registered users. Setequiv can also check
for and restore the security of user accounts modified by
Wolfgang Schreiber's SUPER utility (NW 3.11 and earlier). It
allows input of usernames from a file.

Usermgrs

Usermgrs lists the managers of users or groups. You may list
the managers for a single user, multiple users selected via
wild cards, all members of a group, for one or more group
objects, or for a list of users and/or groups in a file. Features
include:

o   Output may be sorted by object name
o   The managers of each object may be sorted
o   Can exclude certain managers from being listed

Whodidit

Whodidit displays selected information about files and directories
which is useful in determining when they were created, modified,
last accessed, archived and by whom. It can list any combination
of the following fields:

  o  Archiver - the object which last archived the file
  o  Archive date and time
  o  Creation date and time
  o  Extended attributes - does the file have them?
  o  Resource fork size for Mac files
  o  Inherited rights mask
  o  Owning name space
  o  Last access date (the time is not recorded)
  o  Search mode
  o  Logical size as shown by 'dir'
  o  Owner
  o  Physical size (for compressed or sparse files)
  o  Quota (for directories)
  o  Attributes
  o  Update date and time
  o  Updater - the object which last updated the file
  o  Mac name
  o  NFS name
  o  LONG name
  o  FTAM name

The user may select which of the above are to be displayed, in
what order, and the width of the columns. Alternatively, a template
file containing text and substitution identifiers may be given. This
allows any combination of values to be given in any format and may
be useful to create a batch file of commands incorporating file names.
The output can be filtered on any value e.g. it is possible to
display details of files greater than a certain size, files which
are compressed, or all files and directories owned by a particular
name space.

Whodidit has the ability to use a template file to format the output.
The file can contain one or more lines of text and substitution
identifiers representing informational items, the volume, path
or file name, or any combination of these in any name space. This
allows commands to be built for files or directories matching some
filter criteria. For example, whodidit could scan a volume for files
not accessed during the last 6 months and via the template file, a
batch file could be created to copy these to some other location and
then delete them.

Whodidit can output owner, updater and archiver information in
a form suitable for input to setowner. This option may be useful if
NDS is to be removed from a server and subsequently reinstated.
All object IDs will change when NDS is reinstated with loss of
this information which is stored as object IDs in the directory
entry tables. Saving this information with whodidit allows it to
be restored via setowner. This facility may also be used to restore
ownership for files and directories copied using copy, xcopy and
ncopy.
