drms_run
Synopsis: drms_run [-v|--verbose] [-L|--nolog] [-lifetime num] [-repeat num] [-dryrun] command {command_args}
or: drms_run -h | --help
drms_run runs a DRMS command in a DRMS session. It is a shell script that establishes a session, runs the command with its optional arguments, then terminates the session after doing any required commits to the database. Drms_run is the normal way of running a simple pipeline module, one that does not need multiple modules to complete a task. The optional flags for drms_run are:
- -h, --help -- Prints the usage information (same as synopsis above).
- -v, --verbose -- Run the script in verbose mode, prints the session status and key events on stdout.
- -l, --nolog -- supress the copy of logfiles to SUDIR
-lifetime number -- Passes the lifetime numerical value on to drms_server (see DrmsServerCmd).
-repeat number -- Causes the command to be repeated number times. Default is 1. purpose not clear to this document writer
- -dryrun -- Performs a "kill -s TERM $DRMS_PID" command after the user's command finishes but before anything is committed to the DRMS database.
The user command may be followed by arguments which will be passed to the command. The user's command and its args should be the final entries on the command line. I.e. all drms_run flags should preceed the command. Drms_run runs in the csh so be prepared to have the arguments parsed again by csh after they have already been parsed by your shell.
Warning - If your command arguments contain embedded spaces you should place the command and its arguments into a script file and pass that file (marked executable) to drms_run. This will preserve the quotation marks that you must use to keep the spaces from generating too many and incorrect arguments.