=================================================================== RCS file: /home/cvs/OpenXM/doc/issac2000/openxm-stackmachines.tex,v retrieving revision 1.3 retrieving revision 1.7 diff -u -p -r1.3 -r1.7 --- OpenXM/doc/issac2000/openxm-stackmachines.tex 2000/01/03 04:27:52 1.3 +++ OpenXM/doc/issac2000/openxm-stackmachines.tex 2000/01/14 10:45:10 1.7 @@ -1,19 +1,18 @@ -% $OpenXM: OpenXM/doc/issac2000/openxm-stackmachines.tex,v 1.2 2000/01/02 07:32:12 takayama Exp $ +% $OpenXM: OpenXM/doc/issac2000/openxm-stackmachines.tex,v 1.6 2000/01/13 10:54:33 ohara Exp $ -\section{OpenXM Stackmachines} (Tamura) +\section{OpenXM Stack machines}\label{sec:ox-stackmachines} (Tamura) -In OpenXM specification, all servers are stackmachines. -These are called OX stachmachines. +In OpenXM specification, all servers are stack machines. +These are called OpenXM stack machines. When a server ox\_xyz gets an OX data message, -it translates the data into its own object and push the object -on the stack. -The translation scheme together with definitions of -mathematical operations -of the system ox\_xyz is called the {\it phrase dictionary} of +it translates the data into an object of its local mathematical system +and push the object on the stack. +The translation scheme together with definitions of mathematical operations +of the system ox\_xyz is called the {\it PhraseBook} of ox\_xyz following the OpenMath specification. Any OX command message starts with the int32 tag OX\_COMMAND. -The body is OX stackmachine operation code expressed by int32. +The body is OpenXM stack machine operation code expressed by int32. The codes are listed below. \begin{verbatim} #define SM_popSerializedLocalObject 258 @@ -46,10 +45,10 @@ Each OpenXM server has its own mathematical operation Mathematical operations are performed as follows. Mathematical operator name, such as fctr (asir factorization command), is pushed as a string, -the stackmachine command +the stack machine command SM\_executeFunction (269) pops the operator name, the number of arguments and arguments, and -the OX stackmachine evaluates the operator, and pushes the result on the stack. +the OX stack machine evaluates the operator, and pushes the result on the stack. For example, the following code factorizes $x^{100}-1$ by calling ox\_asir from asir. \begin{verbatim} @@ -69,7 +68,8 @@ which caused the error, and an error message. error([8,fctr : invalid argument]) \end{verbatim} -Errors are not sent to the client except a SM\_pop* command is received. +OpenXM server won't send error messages to the client +except when it receives a SM\_pop* command. OX stackmachines works in the asynchronous mode which is similar to X servers. For servers for graphic applications, it is an advantageous feature.