GBCH-CICHANGE(1)

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.