General options

Of all these options, most users will only use -sz to specify the number of nodes required by the parallel application.

-batch

This option informs yod that it is not being run interactively, so, for instance, yod will not await user responses in certain circumstances.

-file {file-name}

When all processes in the parallel application have completed, yod displays a one line completion message for each process. This message lists the wall-clock time elapsed from start to finish for the process, and the exit code and terminating signal, if any, for the process. By default the listing goes to stdout, but may be redirected to a file with this option.

-help

This option displays a usage message for yod.

-interactive

This option informs yod that it is being run interactively by a living user. This is the default mode. If yod is being run by a script, be certain to specify -batch on the command line. One difference between interactive mode and batch mode is that if the load fails on one node, interactive mode waits for the user to interrupt yod with control-c before cancelling the load on all allocated nodes. Batch mode goes ahead and cancels the load.

-kill

When yod is run in interactive mode (the default) and a process of a parallel application terminates abnormally, yod displays the fact that the process terminated but does not kill the other processes in the job. The user may choose to abort the job by terminating yod with control-C.

If the user wishes yod to automatically kill the application when one or more processes terminates abnormally, then use the -kill option to yod.

-list {node-list}

If a node-list is provided on the yod command line, then the nodes requested will be allocated out of this list. If -sz n is specified, then n nodes will be allocated out of the list. If there does not exist n free nodes in the list, yod will display an error message. If no -sz option is specified, yod will assume you want all the nodes in the node-list.

A node-list is a list of node specifiers separated by commas. A node specifier is a node number or a node range. A node range is specified by two node numbers separated by one or more dots. No white space may be included in the node-list. Example: -l 25..35,112..140,160,165

-NOBUF

yod displays it's own messages and also text printed by the parallel application processes while they are running. Normally this combination of buffered (yod's status messages) and unbuffered (application output and yod's error messages) messages appear sensibly on the tty that started yod. But if yod was started by an rsh from a remote node, the output appears garbled. The -NOBUF option solves this problem by making all yod output unbuffered.

-quiet

yod is quite verbose. It lists many status and error messages as it loads and runs a parallel application. If you wish to have these messages suppressed, run yod with the -quiet option.

-sz {nodes}

The number of compute nodes required to run the parallel application. One member (process) of the application will run on each node. The default if no node list is specified is -sz 1. The default if a node list is specified is the number of nodes in the node list.

-vhelp

This option displays a more verbose usage message for yod.