version 1.4, 2000/01/07 09:56:08 |
version 1.8, 2000/01/15 03:46:27 |
|
|
% $OpenXM: OpenXM/doc/issac2000/openxm-stackmachines.tex,v 1.3 2000/01/03 04:27:52 takayama Exp $ |
% $OpenXM: OpenXM/doc/issac2000/openxm-stackmachines.tex,v 1.7 2000/01/14 10:45:10 tam Exp $ |
|
|
\section{OpenXM Stack machines} (Tamura) |
\section{OpenXM Stack machines}\label{sec:ox-stackmachines} (Tamura) |
|
|
In OpenXM specification, all servers are stack machines. |
In OpenXM specification, all servers are stack machines. |
These are called OpenXM stack machines. |
%These are called OpenXM stack machines. |
When a server ox\_xyz gets an OX data message, |
When a server ox\_xyz gets an OX data message, |
it translates the data into its own object and push the object |
it translates the data into an object of its local mathematical system |
on the stack. |
and push the object on the stack. |
The translation scheme together with definitions of |
Following the OpenMath specification, |
mathematical operations |
the translation scheme together with definitions of mathematical operations |
of the system ox\_xyz is called the {\it phrase dictionary} of |
of the system ox\_xyz is called the {\it PhraseBook} of ox\_xyz. |
ox\_xyz following the OpenMath specification. |
|
|
|
Any OX command message starts with the int32 tag OX\_COMMAND. |
Any OX command message starts with the int32 tag OX\_COMMAND. |
The body is OX stack machine operation code expressed by int32. |
The body is an OpenXM stack machine operation code expressed by int32. |
The codes are listed below. |
The codes are listed below. |
\begin{verbatim} |
\begin{verbatim} |
#define SM_popSerializedLocalObject 258 |
#define SM_popSerializedLocalObject 258 |
Line 42 The codes are listed below. |
|
Line 41 The codes are listed below. |
|
|
|
OpenXM does not have a standard for mathematical operation sets |
OpenXM does not have a standard for mathematical operation sets |
while it is a work in progress in \cite{gap}. |
while it is a work in progress in \cite{gap}. |
Each OpenXM server has its own mathematical operation set. |
Each OpenXM server has its own set of mathematical operations, |
Mathematical operations are performed as follows. |
which are performed as follows. |
Mathematical operator name, such as fctr (asir factorization command), |
Mathematical operator name, such as {\tt fctr} (asir factorization command), |
is pushed as a string, |
is pushed as a string, |
the stack machine command |
the stack machine command |
SM\_executeFunction (269) pops the operator name, the number of arguments |
{\tt SM\_executeFunction} (269) pops the operator name, the number of arguments |
and arguments, and |
and arguments, and |
the OX stack machine evaluates the operator, and pushes the result on the stack. |
the OX stack machine evaluates the operator, and pushes the result onto the stack. |
For example, the following code factorizes $x^{100}-1$ by calling |
For example, the following code factorizes $x^{100}-1$ by calling |
ox\_asir from asir. |
ox\_asir from asir. |
\begin{verbatim} |
\begin{verbatim} |
P = ox_launch(); |
P = ox_launch(); |
ox_push_cmo(P,x^100-1); ox_push_cmo(P,ox_int32(1)); |
ox_push_cmo(P,x^100-1); ox_push_cmo(P,ntoint32(1)); |
ox_push_cmd(P,269); |
ox_push_cmd(P,269); |
Ans = ox_pop_cmo(P); |
Ans = ox_pop_cmo(P); |
\end{verbatim} |
\end{verbatim} |
Line 69 which caused the error, and an error message. |
|
Line 68 which caused the error, and an error message. |
|
error([8,fctr : invalid argument]) |
error([8,fctr : invalid argument]) |
\end{verbatim} |
\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 |
OX stackmachines works in the asynchronous mode which is similar |
to X servers. |
to X servers. |
For servers for graphic applications, it is an advantageous feature. |
For servers for graphic applications, it is an advantageous feature. |