\rhead{\bf MC\_SendAgentMigrationMessage()}
\noindent
\vspace{5pt}
\rule{6.5in}{.01in}
\noindent
{\LARGE \bf MC\_SendAgentMigrationMessage()\index{MC\_SendAgentMigrationMessage()}} [Deprecated] \\
\phantomsection
\addcontentsline{toc}{section}{MC\_SendAgentMigrationMessage()}

\noindent
{\bf Synopsis}\\
{\bf \#include $<$libmc.h$>$}\\
{\bf int MC\_SendAgentMigrationMessage}({\bf MCAgency\_t} $agency$, {\bf char *}$message$, {\bf char *}$hostname$, {\bf int} $port$);\\

\noindent
{\bf Purpose}\\
Send an ACL mobile agent message to a remote agency.

Please note that this function is deprecated. Please use the
\texttt{MC\_SendAgent()} function instead.\\

\noindent
{\bf Return Value}\\
The function returns 0 on success and non-zero otherwise.\\

\noindent
{\bf Parameters}
\vspace{-0.1in}
\begin{description}
\item
\begin{tabular}{p{20 mm}p{135 mm}}
$agency$ & A handle associated with an agency from which to send the ACL 
mobile agent message. A NULL pointer can be used to send the ACL message 
from an unspecified agency.\\ 
$message$ & The ACL mobile agent message to be sent.\\
$hostname$ & The hostname of the remote agency. It can be in number-dot 
format or hostname format, i.e., 169.237.104.199 or machine.ucdavis.edu.\\
$port$ & The port number on which the remote agency is listening. 
\end{tabular}
\end{description}

\noindent
{\bf Description}\\
This function is used to send an XML based ACL mobile agent message, which 
is a string, to a remote agency. 
This function can be used without a running local agency.\\

\noindent
{\bf Example}\\
\noindent
%Compare with output for examples in \CPlot::\Arrow(), \CPlot::\AutoScale(),
%\CPlot::\DisplayTime(), \CPlot::\Label(), \CPlot::\TicsLabel(), 
%\CPlot::\Margins(), \CPlot::\BoundingBoxOffsets(), \CPlot::\TicsDirection(),\linebreak
%\CPlot::\TicsFormat(), and \CPlot::\Title().
%{\footnotesize\verbatiminput{template/example/Data2D.ch}}

\noindent
{\bf See Also}\\

%\CPlot::\DataThreeD(), \CPlot::\DataFile(), \CPlot::\Plotting(), \plotxy().\\
