\input manualMacros.tex
\manBegin
\manPageInfo{RCI Reference Manual}{}{}
\manTitle{rciSetOptions}{3}
\manSection{NAME}
{\rightskip=0ptplus1fil
{\tt \manName{rciSetOptions}},
{\tt \manName{rciClearOptions}},
{\tt \manName{rciPutOptions}},
{\tt \manName{rciGetOptions}}
-- set and clear various RCI system options.

}
\manSection{USAGE}
\cverbatim
#include <rci.h>

unsigned long rciSetOptions (optionMask)
   unsigned long optionMask;

unsigned long rciClearOptions (optionMask)
   unsigned long optionMask;

unsigned long rciPutOptions (optionMask)
   unsigned long optionMask;

unsigned long rciGetOptions (optionMask)
   unsigned long optionMask; @endcverbatim
\manSection{ARGUMENTS}
\manItem{{\tt optionMask} --}
Bitmask specifying a set of options.
\manSection{DESCRIPTION}
These functions allow the programmer to set, clear, and access the various 
RCI system options.

{\tt rciSetOptions()} sets the options specified by the bitmask
{\tt optionMask} and returns a mask describing the previous
settings of those options.

{\tt rciClearOptions()} clears the options specified by the bitmask
{\tt optionMask} and returns a mask describing the previous
settings of those options.

{\tt rciPutOptions()} sets all the RCI system options to the
values indicated by {\tt optionMask}, and returns a mask
describing all previous settings.

{\tt rciGetOptions()} returns a mask obtained by anding together all the RCI
system options with {\tt optionMask}.

Options currently defined include:

\manItem{{\tt EXIT_ON_ERROR} --}
Boolean value which causes the main planning level RCI functions
to print their error stack and force an exit from the program if they
discover an error.  This is useful for prototyping work where one
does not want to check all possible error conditions. 
Default setting for this is false.

\raggedright
\manEnd
\end
