gbch-cichange - add/delete/change details of a command interpreter.
gbch-cichange [ -options ] name
gbch-cichange is a shell-level command to create, delete or change details of a command interpreter according to the options specified. Only one command interpreter may be operated upon at a time.
The command interpreter in question is that given by the final argument name to the command.
The user must have special create permission to operate this command - see gbch-user(1).
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_CICHANGE
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.
The command interpreter whose name and details are given with the other options is to be added.
Set the "predefined argument list" to be that given by args. This
replaces any existing predefined arguments. Supply an empty string
with ""
to delete all arguments.
Almost invariably with shells, the -s
option should be supplied as
a predefined argument. This will cause the "real" arguments supplied
by the job, e.g. with the -a option to gbch-r(1), which follow the
predefined arguments, to be treated as strings and not the names of
files.
The specified command interpreter is to be deleted. Note that the
first entry on the list, which is initialised on installation to be
the Bourne shell sh
, cannot be deleted.
N.B. This is not subject to extensive checking to ensure that no job currently uses the specified command interpreter, so please check first.
Expand $
-prefixed environment variables, ~user
and backquote
constructs in job argument strings before invoking the command
interpreter, rather than relying upon the command interpreter to do
it.
Argument 0 of the job, often displayed as the process name, is the name of the command interpreter. This is the default.
Set the load level to number to be the default for new jobs created with this command interpreter. The default for new command interpreters if this option is not given is the special create load level given in the user's profile as displayed by gbch-user(1).
Remember that this load level must be less than or equal to a user's maximum load level per job to make use of this.
Set the nice(2)
value to number.
Supply a new name name for an existing command interpreter. N.B. Beware that existing jobs referring to the old name will not be checked for or changed.
Set the path pathname to be the process invoked as the command
interpreter. Note that gbch-cichange does not attempt to verify the
accuracy of this path name. Environment variables etc are not expanded
here, the full path name (starting from /
) should be given.
Set the flag whereby the process name (or 0th argument) to the command interpreter becomes the job title.
The specified command interpreter is to have details changed as specified. This is the default in the absence of other options.
Turn off expansion of environment variables, ~name
constructs and
backquote commands.
Save all the current options in a .gnubatch file in the current
directory with keyword GBCH_CICHANGE
. The program will exit without
error if no command interpreter argument is given.
Save all the current options in a .gnubatch file in the user's home
directory with keyword GBCH_CICHANGE
. The program will exit without
error if no command interpreter argument is given.
~/.gnubatch configuration file (home directory) .gnubatch configureation file (current directory) btrest.help message file
space-separated options to override defaults.
location of alternative help file.
To change the nice value, load level and to specify that the job title
will become the process name for jobs running under the sh
command
interpreter:
gbch-cichange -N 22 -L 500 -t sh
To add a new command interpreter using the Korn shell with the -s option:
gbch-cichange -A -N 25 -L 1500 -p /bin/ksh -a '-s' ksh
The quotes around -s
are not necessary in this case, only if spaces
are included.
To change the name to korn
gbch-cichange -n korn ksh
btsyntax(5)
,
gbch-cilist(1),
gbch-user(1),
gnubatch.conf(5),
gnubatch.hosts(5).
Various diagnostics are read and printed as required from the message file, btrest.help.
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.