run - Script to submit job to PBS (Portable Batch System) as easy as possible
run "command line" run [-h | -m | -v | -l | -e] -h help -m print the manual -v print the version number -l list the current config -e edit the config
run is a small script applying PBS::Client. It aims at making job submission to PBS quick and easy. It reads queueing options from the config file .runrc in the home directory, generate job script and then submit to PBS.
run
PBS::Client
Current config can be listed by the -l option. The -e option is used to create or edit the config, using the editor specified by the EDITOR or VISUAL environment variables.
-l
-e
To submit a command (say ./a.out), simply add run before it, e.g. run ./a.out. Arguments (say arg) of a.out can also be added behind, e.g. run ./a.out arg.
./a.out
run ./a.out
arg
a.out
run ./a.out arg
After submission, a job script will be generated. The default name is the command appended by ".sh". After the job is finished, two more files -- output and error file will be generated. They have names "[job name].o[job ID]" and "[job name].e[job ID]" respectively.
Queueing options are declaring in .runrc in the home directory. It has .ini-style format, i.e.
.ini
Parameter_1 = Value_1 Parameter_2 = Value_2
Spaces beside = are optional. Also, lines beginning with "#" and blank lines are ignored. For example:
=
# This is a sample config file for the "run" utility server = server01 queue = queue01 name = sample nodes = ['node01', 'node02'] ppn = 2 cput = 01:00:00 mem = 600mb
To list the current configuration, use the -l option. To create or edit the config file, use the -e option. The default editor is vi. To use other editor, please modify the environment variable EDITOR or VISUAL.
vi
EDITOR
VISUAL
For a sample config file, please see bin/runrc in the module directory.
run "./a.out"
./a.out -a arg1 -b arg2 arg3
run "./a.out -a arg1 -b arg2 arg3"
./a.out > /tmp/a.dat
run "./a.out > /tmp/a.dat"
Not known yet. Please email to kwmak@cpan.org for bug report or suggestions.
Ka-Wai Mak <kwmak@cpan.org>
Copyright (c) 2006-2007 Ka-Wai Mak. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install PBS::Client, copy and paste the appropriate command in to your terminal.
cpanm
cpanm PBS::Client
CPAN shell
perl -MCPAN -e shell install PBS::Client
For more information on module installation, please visit the detailed CPAN module installation guide.