\input manualMacros.tex
\manBegin
\manPageInfo{RCI Reference Manual}{}{}
\manTitle{getDefaultRobot}{3}
\manSection{NAME}
{\raggedright
{\tt \manName{getDefaultRobot}}
-- RCI database routine to get name of default robot.

}
\manSection{USAGE}
\cverbatim
char *getDefaultRobot()
@endcverbatim
\manSection{RESTRICTIONS}
This routine must be called from the planning level.
\manSection{DESCRIPTION}
Returns a string identifying the system's {\it default robot},
which is described in the single-line file 
{\filefont \$RCCL/conf/defaultRobot}. This
string can be used as an argument to the routines that return 
parameters for a robot, such as {\tt getJls()} or {\tt getKyn()}.

\manSection{DIAGNOSTICS}
The function returns {\tt NULL} if it can't find the name.
Error information is reported on the
{\it errorStack} (q.v.), and returned error codes are accessible with 
{\tt getErrorCode()}. Possible error codes are:

\manItem{{\tt EEnvironment} --}
The environment variable {\tt RCCL} is not set.
\manItem{{\tt EBadAccess} --}
Can't open the file {\filefont \$RCCL/conf/defaultRobot}.
\manItem{{\tt EBadObj} --}
Can't read the file {\filefont \$RCCL/conf/defaultRobot}.

The routine will abort the program if called from the control level.
\manSection{SEE ALSO}
\raggedright
{\tt getJls(3)}, {\tt errorStack(3)}.
\manEnd
\end
