NAME

gbch-cichange - add/delete/change details of a command interpreter.


SYNOPSIS

gbch-cichange [ -options ] name


DESCRIPTION

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).


OPTIONS

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.

-? or +explain

causes a summary of the other options to be displayed without taking further action.

-A or +add

The command interpreter whose name and details are given with the other options is to be added.

-a args or +args args

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.

-D or +delete

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.

-e or +expand-args

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.

-i or +set-arg0-name

Argument 0 of the job, often displayed as the process name, is the name of the command interpreter. This is the default.

-L number or +load-level number

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.

-N number or +nice number

Set the nice(2) value to number.

-n name or +new-name name

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.

-p pathname or +path pathname

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.

-t or +set-arg0-title

Set the flag whereby the process name (or 0th argument) to the command interpreter becomes the job title.

-U or +update

The specified command interpreter is to have details changed as specified. This is the default in the absence of other options.

-u or +no-expand-args

Turn off expansion of environment variables, ~name constructs and backquote commands.

+freeze-current

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.

+freeze-home

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.


FILES

~/.gnubatch configuration file (home directory) .gnubatch configureation file (current directory) btrest.help message file


ENVIRONMENT

GBCH_CICHANGE

space-separated options to override defaults.

BTRESTCONF

location of alternative help file.


EXAMPLES

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


SEE ALSO

btsyntax(5), gbch-cilist(1), gbch-user(1), gnubatch.conf(5), gnubatch.hosts(5).


DIAGNOSTICS

Various diagnostics are read and printed as required from the message file, btrest.help.


COPYRIGHT

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.


AUTHOR

John M Collins, Xi Software Ltd.