gbch-charge - display/update user charges
gbch-charge [ -options ] [ user ] ...
gbch-charge displays and/or updates the charges recorded by GNUbatch against various users specified on the command line, or all users if none are specified.
It is only available to users with the Write admin file privilege.
Charges relate to jobs which have originated on the machine on which gbch-charge was invoked. The actual charging rate is determined by the machine on which the job is run.
Note that the order of treatment, letters and keywords described below may be modified by editing the file btrest.help - see btsyntax(5).
The environment variable on which options are supplied is GBCH_CHARGE
and the
environment variable to specify the help file is BTRESTCONF
.
causes a summary of the other options to be displayed without taking further action.
Causes a consolidation record or ``current balance'' to be written in the file for each user, which summarises the charges to date for each user. The previous records remain in the file.
Causes the specified fee to be added to the charge for the specified user or users, or all users if none are given.
If combined with a print option (-p or -P), the print is done after the charge is applied, so the charge will be included in the output.
Cancels all previously-set options -p, -P, -z, -C and -R. Useful if you want to start again from some indeterminate state in a configuration file.
causes the full log of charges for the specified user or users, or all users if none are given, to be displayed on standard output.
(the default if no other options are specified) causes the charge summary for the specified user or users, or all users if none are given, to be displayed on standard output.
Causes all records to be deleted from the file except for consolidation records for each user with a non-zero charge. If the charge for each user is zero (as a result of applying the -z option perhaps), then the file will be left empty.
Note that the batch scheduler btsched(8)
should not be running when
this option is invoked, otherwise this option is ignored.
Clears to zero the charges for the specified user or users, or all users if none are given. This is done by appending an appropriate record or records to the charge file, the previous information (as displayed by -P will still be available.
If combined with a print option (-p or -P), the print is done before the option is applied.
Save all the current options in a .gnubatch file in the current
directory with keyword GBCH_CHARGE
. If this option is supplied, and no
users are specified, then no further action is taken.
Save all the current options in a .gnubatch file in the user's home
directory with keyword GBCH_CHARGE
. If this option is supplied, and no
users are specified, then no further action is taken.
Print charges for all users
gbch-charge
Add a fee of 9.1 units to user sec
and print the result
gbch-charge -p -c 9.1
Print charges for all users and zero them
gbch-charge -z -p
~/.gnubatch configuration file (home directory)
.gnubatch configuration file (current directory)
btrest.help message file
gbch-chargesn.n charges file (with version number suffix)
space-separated options to override defaults.
location of alternative help file.
btsyntax(5), gbch-user(1), gnubatch.conf(5), (5).
Various diagnostics are read and printed as required from the message file, by default btrest.help.
No one seems to use charges and the file of charges takes up increasing space so this program is deprecated.
Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
John M Collins, Xi Software Ltd.