Batch (Non-Interactive) Execution of S-PLUS

DESCRIPTION:

Executes a file of S-PLUS expressions and places the results in another file or the normal output destination. This is useful for simulations and other computer-intensive but predetermined tasks. This must be run from a UNIX shell prompt, and it replaces .

USAGE:

Splus SBATCH [options] [inputfile]

OPTIONAL ARGUMENTS:

--help
prints this message and quits.
--cwd directory
change to this directory before doing any processing.
--input inputfile
read input from inputfile (or specify inputfile as last argument).
--output file
send output to file. The default is the inputfile basename with .txt.
--logfile file
write session log to file. The default is the inputfile basename with .slg. The inputfile is stripped of any period extension.
--appendlog
append to log file. The default is to overwrite.
--nologfile
do not make a session log.
--work directory
use directory for working database (where=1), making it if needed. If directory is not specified, a new randomly named directory for working database is made.
--noclean
do not remove the new randomly named directory used for working database.
--newworkparent
directory in which to make the new randomly named working database. The default is the current working directory.
--echo
echo command lines to output (sets options(echo=T)). This is the default.
--noecho
Do not set options(echo=T).
--verbose
echo verbose logging information to output (sets options(verbose=T)).
--quitonerror
terminate immediately on engine error. Default is to continue through error.
--background
run S-PLUS in the background (returning immediately).
--nobigdata
do not load bigdata library.
--bigdata
load bigdata library.
--vanilla
do not run user-defined startup scripts or functions. The --work directory is ignored.
-j
Enable java.
--headless
do not use X Windows connection if running java. The DISPLAY variable does not need to be set.
name=value
will be added to environment so getenv("name") returns value.

DETAILS:

An input file must be specified either as a command line argument or following the --input option. The input file contains the S-PLUS expressions to be executed.

NOTE:

The Splus program is case sensitive, and the word SBATCH needs to be in all capital letters. This must be run from a UNIX shell prompt to execute.

WARNING:

Execution begins immediately after SBATCH is invoked. If you are on a UNIX system, you may want to put the SBATCH job in the background or use the UNIX at (or chron) command to delay execution.

SEE ALSO:

, , .

EXAMPLES:

# Read input from file, write output and logfile
Splus SBATCH --input /homes/test/script1.ssc --output /homes/test/script1.txt --logfile /homes/test/script1.log