gbch-start - start batch scheduler

# NAME

gbch-start - start batch scheduler

gbch-conn - connect to host

gbch-disconn - disconnect from host

btdst - adjust for daylight saving time

# SYNOPSIS

gbch-start [ -options ]

gbch-conn hostname

gbch-disconn hostname

gbch-dst [ -R ] startdate enddate adjustment

# DESCRIPTION

gbch-start initiates the GNUbatch batch scheduler system, by starting the processes `btsched(8)` and xbnetserv(8).

Optional arguments enable the initial sizes of shared memory to be determined and also an initial value for the `LOADLEVEL` variable, which may determine how many jobs (possibly none) start up as soon as GNUbatch comes up.

gbch-conn instructs the GNUbatch scheduler to attempt to raise a connection to the given host, which should be specified in the file gnubatch.hosts, and not currently active.

gbch-disconn instructs the GNUbatch scheduler to close a connection to the given host, which should be specified in the file /etc/, and currently active.

gbch-dst adjusts all jobs between the specified start and end dates and times by adding the specified (possibly signed) adjustment in seconds to it.

The dates and times may be specified in the forms

            dd/mm
            mm/dd
    or

            yy/mm/dd

Which of the first two forms is chosen is taken from the existing time zone. For time zones greater or equal to 4 West from GMT, the `mm/dd` form is chosen, otherwise `dd/mm`.

The dates may be followed by a comma and a time in the form `hh:mm`, otherwise midnight is assumed.

When working out what to do, remember that Unix internal time is based upon Greenwich Mean Time (GMT), it is the display which changes, so that the effect of moving the clocks forward is to make the times (held as GMT) appear later than they did before.

A negative adjustment is subtracted from the time, making jobs run sooner. This is therefore appropriate when the clocks go forward at the start of the summer time. Likewise a positive adjustment should be used at the end of summer time.

The optional argument -R tries to apply the option to all exported remote jobs, but this really is not recommended as the local jobs on those hosts will be unaffected probably leaving the users on those machines confused.

# OPTIONS

Note that everything in this section only applies to gbch-start.

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_START` 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.

-l number or +initial-load-level number

  set the initial value of the `LOADLEVEL` variable, which controls the total load level of running jobs to the specified number (usually zero). If this option is not specified, then the value is unchanged from its initial value saved by the scheduler when it was last shut down.

  If the GNUbatch scheduler is already running, this option has no effect.

-j number or +initial-job-size number

  Allocate shared memory initially for the specified number of jobs. This is necessary in some situations where other applications use up the system limit of shared memory and it is not possible to allocate further after the system has been running for some time.

  If the gnubatch scheduler is already running, this option has no effect.

-v number or +initial-var-size number

  Allocate shared memory initially for the specified number of variables. This is necessary in some situations where other applications use up the system limit of shared memory and it is not possible to allocate further after the system has been running for some time.

  If the GNUbatch scheduler is already running, this option has no effect.

+freeze-current

  Save all the current options in a .gnubatch file in the current directory. If this option is specified, there is no further action.

+freeze-home

  Save all the current options in a .gnubatch file in the user's home directory. If this option is specified, there is no further action.

# FILES

~/.gnubatch configuration file (home directory)

.gnubatch configuration file (current directory)

btrest.help message file

# ENVIRONMENT

GBCH_START

  space-separated options to override defaults for gbch-start

BTRESTCONF

  location of alternative help file.

# SEE ALSO

gbch-quit(1), btsyntax(5), gnubatch.conf(5), gnubatch.hosts(5), btsched(8), xbnetserv(8).

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