Utilities in JRButils for MICRO FOCUS v23

P to R

Pnadd

Adds users, operators, managers and queues to NDPS printers. It can do the following:

  • Can add objects to multiple printers in a single command.
  • Can add users, groups or all members of a group.
  • Can prompt for confirmation before adding each object.
  • Can add objects as users, operators and/or managers in the same invocation.

Pnctrl

Stops, starts, restarts, pauses and resumes NDPS printers.

Pndel

Removes users, operators, managers and queues from NDPS printers. It can do the following:

  • Can remove objects from multiple NDPS printers in a single command.
  • Can remove users, groups or all members of a group.
  • Can prompt for confirmation before removing each object.
  • Can add objects as users, operators and/or managers in the same invocation.

Pndeljob

Deletes jobs queued to NDPS printer agents. It can do the following:

  • Allows jobs to be selected by job number. Individual numbers may be given or a range may be used e.g. 1-20.
  • Allows jobs to be deleted by user.
  • Allows jobs to be deleted based on the contents of the description field.
  • Allows deletion of jobs which are older than a given date.

Pnlist

Pnlist lists the jobs enqueued to NDPS printer agents. Features include:

  • Wildcards may be used.
  • The default output gives the job position, job ID, user, description, size, date/time submitted and status for each job.
  • You may design you own output selecting from 10 fields and choosing the size and order of each field. The fields are: Description
    Job entry time
    Number of documents in the job
    Job ID
    Job position
    Job priority
    The printer name
    The job status (pending, paused, held, etc)
    The name of the user who enqueued the job
    Number of bytes to be printed
  • Output may be limited to jobs submitted by a particular user.
  • Output may be filtered on job description.
  • The number of jobs can be returned as an error level.

Pnmovjob

Pnmovjob moves or copies jobs from one NDPS printer to another.

Pnreljob

Pnreljob changes the status of jobs queued to an NDPS printer. Jobs may be selected by number, range or owner. Pnreljob can do the following:

  • Release or place jobs on user hold.
  • Release or place jobs on operator hold.
  • Release or place jobs on a “print after” hold.
  • Pause/resume jobs.

Pnset

Pnset sets attributes for one or more NDPS or iPrint printers. These include:

Descriptor
Enable/disable auditing
Enable/disable IPP
Enable/disable job banners
Enable/disable LPR
The load command
Location
Manufacturer
Model
NDS description
Security

Other attributes (and there are hundreds of them) can be added as required. Please contact support@jrbsoftware.com if you need to change an attribute which is not already supported.

Pnsetup

Manages public and controlled access NDPS printers on workstations. It can do the following:

  • Install a printer and its driver. The same printer may be installed multiple times with different names.
  • Accepts a user name and password on the command line for authenticating to eDirectory when run via a system service.
  • Remove a printer and optionally its driver.
  • List all installed printers, just the installed NDPS printers, or just the iPrint printers.
  • Remove all installed printers and reinstall those from a specified context.
  • List the installable printers from a specified eDirectory context.
  • Set the default printer.
  • Can restart the print spooler.
  • Can set the port name in the form \\tree\printerName rather than the default NDPSnn where nn is a two digit number.
  • Accepts a user name and password on the command line for authenticating to the tree when run as a system service.

Pnstatus

Pnstatus displays the status of NDPS printers. Values displayed include:

  • Optionally all attributes.
  • The printer manufacturer and model.
  • The printer status and reason for that status if applicable.
  • The printer description.
  • The printer location.
  • Printer agent address.
  • Printer device address.
  • Printer drivers.
  • If auditing is enabled.
  • If banners are enabled.
  • If banners are supported.
  • If LPR and IPP is enabled.
  • The number of scheduled and active jobs.
  • The number of jobs printed since creation.
  • Date and time the last job was processed.
  • Legacy queues serviced.
  • Security level.
  • Accounting command.

These values may also be displayed individually or in csv format.

Pnusers

Lists users, operators, managers and queues of NDPS printers. It can do the following:

  • Can process multiple printers in a single command via use of wildcards.
  • The list of users, operators or managers for each printer may be sorted.
  • Can limit the output to the total number of users, operators and/or managers for each printer.
  • User or operator groups may be expanded so that all user objects which are printer users or printer operators are listed.
  • Can output pnadd commands for users, operators and managers.

Polassoc

Manages the associations of ZEN policy objects. It can do the following.

  • Display all associations of one or more policy objects.
  • Has similar options to usergrps when displaying associations.
  • Add associations.
  • Remove associations.

Profiles

The profiles program adds profiles to users, replaces profiles for users or removes profiles for users. It can process a single user, or multiple selected via wildcards, group membership, or a list in a file. Profiles can create a profile object, but currently cannot assign a login script to it, but you can use lscripts to do this. It can also display the users of a particular profile either by searching the objects which have rights to the profile script (this is quick), or by searching the tree (this may take time in a large tree).

Pwdexp

Pwdexp is intended for use in a login script where it displays a warning if the user’s NDS or Universal password is about to expire. However, it can also perform this check for any nominated user. The number of days before expiration at which warnings begin is adjustable and defaults to seven. Both text mode and GUI versions are available.

Pwdexp can also force a password change before or after password expiration. It will prompt for and change the password.

The GUI version has a number of extra features including:

  • Can change local, AD domain and simple passwords.
  • Can force it to remain as the topmost window.
  • Can force a delay before checking the password expiration status, to allow replication to occur if the password has been changed before the login script begins executing.
  • Allows two lines of user supplied text to be displayed.
  • Can control how long the window warning of impending password expiration remains open.
  • Can prevent changing other passwords if the NDS or Universal password is not changed successfully first.
  • Can display a customer supplied image in the upper right of the window. A range of image formats (e.g. .bmp and .jpg) are supported.
  • Can force operations to occur on the server holding the master of the user’s replica.

Pwdpols

Pwdpols manages the settings for password policy objects. It can do the following:

  • Display settings directly i.e. for the named policy object.
  • Display settings indirectly i.e. for the policy associated with a named object.
  • Display all settings, just the policy rules, or just the policy configuration.
  • Display the objects associated with a policy.
  • Add objects to and remove objects from a policy.

Quotas

The quotas program combines the functionality of getquota and setquota for displaying and setting quotas in a GUI environment. The results are shown in a list view allowing selection of fields to be displayed and sorting by column. When displaying quotas, the quotas can do the following:

  • Process a single user, multiple users selected using wildcards, all members of a group, or a list of users in a file. The quota, space used and space available may be displayed.
  • Read the “Home Directory” attribute to show quotas on the home directory or home volume.
  • Show all volume quotas on a volume.
  • Summarize all usage on a volume based on file ownership.
  • Show volume quotas for all selected users, across all volumes on a server.
  • Filter on quota size, space used and space available so that for example, only those users without quotas, or users whose usage exceeds 200 MB are displayed.
  • Display values in bytes, 4096 bytes blocks, KB, MB and GB.
  • Calculate the usage for directories which do not have a quota on NSS volumes. Unlike traditional volumes, NSS keeps track of usage in a directory, only when a quota is set.
  • Display usage as a percentage of the quota, or as a percentage of the total usage for all selected objects or directories.
  • Displays values for queue directories and for paths pointed to by directory map objects.
  • Supports the new 64 bit quota APIs in OES 2015.

The following features exist for setting quotas:

  • Process a single user, multiple users selected using wildcards, all members of a group, or a list of users in a file.
  • Read the “Home Directory” attribute to set quotas on the home directory or home volume.
  • Set directory quotas for a single directory, all first level subdirectories of a directory, or for all directories in a tree.
  • Set quotas to a given value, or adjust existing quotas by a given amount or percentage.
  • Remove quotas.
  • Prompt for confirmation before setting or modifying each quota.
  • Quotas may be changed by right clicking on the appropriate column in the results list view.

Qwatch.nlm

Qwatch provides a means by which directory and volume quotas can be set via LDAP. It requires an auxiliary class named jrbsQuotas with two optional attributes named jrbsHomeVolumeQuota and jrbsHomeDirectoryQuota. These must be single valued integer attributes which qwatch can create if required. Qwatch monitors changes to the two attributes and when a change is detected, it sets the relevant quota on either the home directory, or on the volume on which the home directory resides. The presence of these two attributes also allows quotas to be read via LDAP provided that whatever program sets the quotas, also maintains the correct values in eDirectory. Programs in JRButils which set quotas have new options which allow this.

Renobj

Renobj allows renaming of eDirectory objects of any class. Features include:

  • Can set a new first name, last name and full name for users.
  • When renaming a user, renobj checks for the existence of the “Home Directory” attribute. If found, renobj renames the user’s home directory to match their new name and updates the contents of “Home Directory” attribute.
  • Can specify the home directory path on the command line when the user does not have a “Home Directory” attribute.
  • Can process a file containing one old name and one new name per line.
  • Can change the case of the names of objects in eDirectory to all lowercase, all uppercase, or to a mixture of upper and lowercase.
  • Can create an alias with the original name of the object and pointing to the renamed object.
  • Can rename associated users in in all versions of GroupWise.
  • Can relink the renamed user with their corresponding GroupWise object in 2012 and earlier if it is not renamed.
  • Can rename an associated group in GroupWise 2014.
  • Can publish the new email address and synchronize changes after a rename for users and groups in GroupWise 2014.
  • Updates the uniqueID attribute when renaming users.
  • Updates the homeDirectory attribute (not to be confused with the “Home Directory” attribute) when the user belongs to the posixAccount auxiliary class.
  • Can override “rename inhibit” status on home directories when renaming them.
  • Can set the old name as a nickname when renaming a user in GroupWise.
  • Can update the “Internet Email Address” and “Email Address” attributes.
  • Can update DSfW attributes sAMAccountName and userPrincipalName. The new value for sAMAccountName will conform with Microsoft’s rules in terms of length and characters contained. The generated value is checked for uniqueness.
  • Allows selective updating of attributes and the home directory without performing a rename. This may be useful when a rename has already been done by other means but not all attributes were updated at the time.
  • Can change the naming attribute of users from CN to uniqueID and vice versa.

Requests

Requests continuously displays the total requests, bytes read and bytes written for up to 20 connections since the program began running. This allows easy identification of workstations imposing the greatest load on a server. The output is sorted into descending order by whichever column you select, and the column on which you are sorting can be changed without restarting the program. Requests can perform a background authentication to the nominated server and works correctly across trees. Both text mode and GUI versions are available. The GUI version can track more than 20 connections and can display the files held open by each connection. It may also clear connections.

Note that this program has not worked on OES Linux prior to 2013. Mid year updates to OES2 SP3 and OES11 SP1 finally included a fix for the NCP function which returns the number of NCP requests, bytes read and bytes written.