%% $OpenXM: OpenXM/src/ox_math/documents/math2ox.texi,v 1.2 2000/03/11 09:17:42 ohara Exp $
\input texinfo
@iftex
@catcode`@#=6
@def@b#1{{@bf@gt #1}}
@catcode`@#=@other
@end iftex
@overfullrule=0pt
@c -*-texinfo-*-
@comment %**start of header
@setfilename Math2ox
@settitle Math2ox
@comment %**end of header
@comment %@setchapternewpage odd
@iftex
@comment @finalout
@end iftex
@titlepage
@title Math2ox
@subtitle Math2ox User's Manual (English Edition)
@subtitle Edition 1.1.2 for OpenXM/oxmath
@subtitle March 2000
@author by Katsuyoshi Ohara
@end titlepage
@synindex vr fn
@comment node-name, next, previous, up
@node Top,, (dir), (dir)
@menu
* Mathematica Client Functions::
* Sample Programs::
@end menu
@node Mathematica Client Functions,,, Top
@chapter Mathematica Client Functions
The program @code{math2ox} is an external module for Mathematica
to call OpenXM servers.
The @code{math2ox} communicates with OpenXM servers by the OpenXM protocol
and communicates with Mathematica by MathLink.
@c Description of OxStart
@menu
* OxStart::
@end menu
@node OxStart,,, Mathematica Client Functions
@section @code{OxStart}
@findex OxStart
@table @t
@item OxStart[@var{s}]
:: Start the OX server @code{s}.
@end table
@table @var
@item return
Integer
@item s
String
@end table
@itemize @bullet
@item It starts the OX server @code{s}.
@item Servers are looked for in the directory $OenXM_HOME/bin , hoge hoge.
@end itemize
@example
In[1]:= Install["math2ox"]
In[2]:= pid = OxStart["ox_sm1"]
@end example
In this example, @code{ox_sm1} is started on the local machine.
@c Description of OxSendMessage
@menu
* OxSendMessage::
@end menu
@node OxSendMessage,,, Mathematica Client Functions
@section @code{OxSendMessage}
@findex OxSendMessage
@table @t
@item OxSendMessage[@var{pid}, @var{s}]
:: SendMessage @code{s} to the OX server @code{pid}.
@end table
@table @var
@item return
Integer
@item id
Integer
@item s
String
@end table
@itemize @bullet
@item It starts the OX server @code{s}.
@item Servers are looked for in the directory $OenXM_HOME/bin , hoge hoge.
@end itemize
@example
In[4] := OxSendMessage[pid, "(CMO_LIST, (CMO_STRING, "hello world"), (CMO_ZERO))"]
In[5] := OxSendMessage[pid, "(OX_COMMAND, (SM_popCMO))"]
@end example
In this example, an OX data message
(OX_DATA, (CMO_LIST, (CMO_STRING, "hello world"), (CMO_ZERO))
and an OX command message (OX_COMMAND, (SM_popCMO)) are sent to
the OX server @code{pid}.
@c Put descriptions of a next function.
@node Starting OX servers on a remote machines,,, Top
@chapter Starting OX servers on a remote machines
@node Sample Programs,,, Top
@chapter Sample Programs
@tex
\noindent
1.
{\tt OpenXM/lib/math/primadec.m} is a Mathematica program
to make primary ideal decompositions by calling
{\tt ox\_asir}.
As to usages, see comments in this file.
\noindent 2.
{\tt OpenXM/lib/math/beta.m} is a Mathematica program
to get beta-nbc bases by calling {\tt ox\_asir}.
@end tex
@node Index,,, Top
@unnumbered Index
@printindex fn
@printindex cp
@iftex
@vfill @eject
@end iftex
@summarycontents
@contents
@bye