Annotation of OpenXM/doc/OpenXM-specs/stackmachine.tex, Revision 1.12
1.12 ! takayama 1: %% $OpenXM: OpenXM/doc/OpenXM-specs/stackmachine.tex,v 1.11 2003/08/23 08:42:35 takayama Exp $
1.1 noro 2: //&jp \section{ OX スタックマシン }
1.4 noro 3: //&eg \section{ OX stack machine }
4: \label{sec:stackmachine}
1.1 noro 5: /*&jp
6: この節では, OX スタックマシン operator の説明
7: (TCP/IP ソケット上での標準 encoding 法 を用いる),
8: および, サンプルサーバとリンクする場合または
9: open XM ライブラリとしてリンクして使用する場合の
10: ための C の関数の仕様を説明する.
11:
12: 説明の前に, OX サーバスタックマシンの動作の原則を
13: 説明しておく.
14: サーバスタックマシンは,
15: {\tt SM\_pop*} 系のスタックマシンコマンドがこないかぎり,
16: 自発的にメッセージを送信することはない.
17: この原則に基づいて分散計算のプログラミングをおこなう.
18: イベントドリブンなプログラム法とはちがうことに
19: 注意しよう.
1.2 noro 20: */
1.1 noro 21:
1.2 noro 22: /*&eg
23: In this section we describe the OX stack machine operators. In
24: the descriptions OX messages are represented by th standard encoding
25: scheme on TCP/IP sockets. In principle, an OX stack machine never
26: sends data to the output stream unless it receives {\tt SM\_pop*}
27: commands. Note that the programming style should be different from
28: that for event-driven programming.
29: */
1.1 noro 30:
1.2 noro 31: //&jp \subsection{サーバスタックマシン }
32: //&eg \subsection{Server stack machine}
1.1 noro 33:
1.2 noro 34: /*&jp
1.1 noro 35: サンプルサーバである {\tt oxserver00.c}
36: は以下の仕様の C の関数を用意して,
37: {\tt nullstackmachine.c } を置き換えれば一応動作するはずである.
1.2 noro 38: */
39: /*&eg
40: {\tt oxserver00.c} is implemented as a sample server.
41: If you want to implement you own server,
42: write the following functions and use them instead of
1.4 noro 43: those in {\tt nullstackmachine.c}.
1.2 noro 44: */
1.1 noro 45:
1.4 noro 46: //&jp \subsubsection{サーバスタックマシンのグループ SMobject/Primitive に属するオペレータ}
47: //&eg \subsubsection{Operators in the group SMobject/Primitive}
1.1 noro 48:
1.2 noro 49: /*&jp
1.1 noro 50: \noindent
1.2 noro 51: サーバスタックマシンは最低で1本のスタック
52: \begin{verbatim}
53: Object xxx_OperandStack[SIZE];
54: \end{verbatim}
55: をもつ. ここで, {\tt Object} はそのシステム固有の Object 型で構わない.
56: CMObject は各サーバ固有のローカルオブジェクトに変換してスタックへプッ
57: シュしてよい. ただし変換, 逆変換を合成したものは恒等写像であることが
58: のぞましい. CMObject をどのように (local) Object に変換するか, Object
59: が受け付けるメッセージの定義は,各システムが独自にきめて文書化しておく
60: ものとする. つまりすべてのメッセージは, private である. たとえば,
61: {\tt add } のような基本的な メッセージにたいしても, OX スタックマシン
62: はなにもきめていない. 将来的には open math \cite{openmath} のように
63: CMObject に対する最大公約数的なメッセージの仕様をcontent dictionary
64: (CD) の形で定義したい.
65:
66: 以下, \verb+ xxx_ + は誤解の恐れがないときは省略する.
67: \verb+ xxx_ + は local サーバシステムに固有の識別子である.
68: {\tt Asir} の場合は \verb+ Asir_ + を用いる. {\tt kan/sm1} の場合は
69: \verb+ Sm1_ + を用いる. 関数名, タグ名は長いので省略形を用いてもよい.
70:
71: 以下では次のようにパケットを記述する. 各フィールドは,
72: \fbox{データ型 \quad データ} なる形式
73: で書く. たとえば, {\tt int32 OX\_DATA} は 32 bit network byte order
74: の数字 {\tt OX\_DATA}という意味である. ``イタリックで書かれているフィー
75: ルドは,定義が別のところでなされているか解釈に誤解のないような自然言語
76: で説明されている object を表す.'' たとえば, {\it String commandName}
77: は, String データ型の local object {\it commandName} を意味する. (サー
78: バスタックマシン上の object は, CMO 形式の objectとは限らないことに注
79: 意. CMO 形式で書いてあっても, それはサーバスタックマシンのlocal 形式
80: でスタック上にあると解釈して下さい.)
1.1 noro 81:
1.4 noro 82: すべてのサーバスタックマシンは以下の操作を実装していないといけない.
83: 各操作に対し, その前後におけるスタックの状態を示す. 図において,
84: 右端のオブジェクトがスタックのトップに対応する.
1.2 noro 85: */
1.1 noro 86:
1.2 noro 87: /*&eg
1.1 noro 88: \noindent
1.2 noro 89: Any OX stack machine has at least one stack.
1.1 noro 90: \begin{verbatim}
91: Object xxx_OperandStack[SIZE];
92: \end{verbatim}
1.2 noro 93: Here {\tt Object} may be local to the system {\tt xxx} wrapped by the stack
94: machine.
1.4 noro 95: That is, the server may translate CMObjects into its local
96: objects and push them onto the stack. It is preferable that
1.2 noro 97: the composition of such a translation and its inverse is equal to the
1.4 noro 98: identity map. The translation scheme is called the {\it phrase book} of the
1.2 noro 99: server and it should be documented for each stack machine. In OpenXM,
1.4 noro 100: any message is private to a connection. In future we will provide a content
1.2 noro 101: dictionary (CD; see OpenMath \cite{openmath}) for basic specifications
102: of CMObjects.
103:
104: In the following, \verb+ xxx_ + may be omitted if no confusion occurs.
105: As the names of functions and tags are long, one may use abbreviated
1.4 noro 106: names. Message packets are represented as follows.
107:
108: Each field is shown as \fbox{data type \quad data}. For example {\tt
109: int32 OX\_DATA} denotes a number {\tt OX\_DATA} which is represented
110: by a 32 bit integer with the network byte order. If a field is
111: displayed by italic characters, it should be defined elsewhere or its
112: meaning should be clear. For example {\it String commandName} denotes
113: a local object {\it commandName} whose data type is String. Note that
114: an object on the stack may have a local data type even if it is
115: represented as CMO.
1.1 noro 116:
1.2 noro 117: Any server stack machine has to implement the following operations.
1.4 noro 118: For each operation we show the states of the stack before and after
119: the operation. In the figures the rightmost object corresponds to the
120: top of the stack. Only the modified part of the stack are shown.
1.2 noro 121: */
1.1 noro 122:
123: \begin{enumerate}
1.2 noro 124: \item
125: /*&jp
1.4 noro 126: CMObject/Primitive の CMO データのうち必須のもの, {\tt CMO\_ERROR2}, {\tt
1.2 noro 127: CMO\_NULL}, {\tt CMO\_INT32}, {\tt CMO\_STRING}, {\tt CMO\_LIST}がおく
128: られて来た場合それをスタックに push する. たとえば, {\tt CMO\_NULL}
129: あるいは {\tt CMO\_String} の場合次のようになる.
130: */
131: /*&eg
1.4 noro 132: Any server should accept CMObjects in the group CMObject/Primitive.
1.2 noro 133: The server pushes such data onto the stack.
134: The following examples show the states of the stack after receiving
135: {\tt CMO\_NULL} or {\tt CMO\_String} respectively.
136: */
1.1 noro 137:
1.2 noro 138: Request:
1.1 noro 139: \begin{tabular}{|c|c|} \hline
140: {\tt int32 OX\_DATA} & {\tt int32 CMO\_NULL} \\
141: \hline
142: \end{tabular}
1.2 noro 143:
144: Stack after the request:
1.1 noro 145: \begin{tabular}{|c|} \hline
146: {\it NULL} \\
147: \hline
148: \end{tabular}
149:
1.4 noro 150: Output: none.
1.2 noro 151:
1.4 noro 152: Request:\\
1.1 noro 153: \begin{tabular}{|c|c|c|c|c|c|} \hline
154: {\tt int32 OX\_DATA} & {\tt int32 CMO\_String} &{\tt int32} {\rm size}
155: &{\tt byte} {\rm s1} & $\cdots$ &{\tt byte} {\rm ssize}\\
156: \hline
157: \end{tabular}
1.2 noro 158:
159: Stack after the request:
1.1 noro 160: \begin{tabular}{|c|} \hline
161: {\it String s} \\
162: \hline
163: \end{tabular}
164:
1.4 noro 165: Output: none.
1.2 noro 166:
167: //&jp CMO データの受け取りに失敗した時のみ \\
1.4 noro 168: //&eg If the server fails to receive a CMO data,\\
1.1 noro 169: \begin{tabular}{|c|c|c|} \hline
170: {\tt int32 OX\_DATA} & {\tt int32 CMO\_ERROR2} & {\it CMObject} ob\\
171: \hline
172: \end{tabular}
173: \\
1.2 noro 174: /*&jp
1.1 noro 175: をスタックへ push する.
176: 現在のところ, ob には, \\
177: \centerline{
178: [{\sl Integer32} OX パケット番号, {\sl Integer32} エラー番号,
179: {\sl CMObject} optional 情報]
180: }
181: なるリストを入れる (CMO 形式でかいてあるが, これはサーバ独自の形式でよい.
182: CMO として送出されるときこのような形式でないといけないという意味である.)
1.2 noro 183: */
184: /*&eg
185: is pushed onto the stack.
186: Currently ob is a list\\
187: \centerline{
188: [{\sl Integer32} OX serial number, {\sl Integer32} error code,
189: {\sl CMObject} optional information]
190: }
191: */
1.1 noro 192:
193: \item
194: \begin{verbatim}
1.2 noro 195: SM_mathcap
1.1 noro 196: \end{verbatim}
1.2 noro 197: /*&jp
198: このサーバの mathcap をもどす (termcap のまね). サーバのタイプ, サー
199: バスタックマシンの能力を知ることができる. C 言語で実装する場合は,
1.4 noro 200: mathcap の構造体をシステム毎にきめるものとし,この関数はその構造体への
201: ポインタを戻す. (open sm1 では {\tt struct mathcap} を用いている.
1.2 noro 202: */
203: /*&eg
1.3 noro 204: It requests a server to push the mathcap of the server.
1.2 noro 205: The mathcap is similar to the termcap. One can know the server type
206: and the capability of the server from the mathcap.
207: */
1.1 noro 208: @plugin/mathcap.h)
1.2 noro 209:
210: Request:
1.1 noro 211: \begin{tabular}{|c|c|} \hline
212: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_mathcap} \\
213: \hline
214: \end{tabular}
1.2 noro 215:
1.3 noro 216: Stack after the request:
1.1 noro 217: \begin{tabular}{|c|c|} \hline
218: {\tt int32 OX\_DATA} & {\sl Mathcap} mathCapOb \\
219: \hline
220: \end{tabular}
221:
1.4 noro 222: Output: none.
1.3 noro 223:
1.1 noro 224: \item
225: \begin{verbatim}
1.4 noro 226: SM_setMathcap
1.1 noro 227: \end{verbatim}
1.2 noro 228: /*&jp
229: 受け取った Mathcap {\tt m} を自分のシステムに設定して, 相手側が理解不
1.4 noro 230: 能な CMO をおくらないようにする. C 言語で実装する場合は, mathcap の構
1.2 noro 231: 造体をシステム毎にきめるものとし,この関数はその構造体へのポインタを引
1.4 noro 232: 数とする. (open sm1 では {\tt struct mathcap} を用いている.
1.2 noro 233: */
234: /*&eg
1.3 noro 235: It requests a server to register the peer's mathcap {\tt m} in the server.
1.2 noro 236: The server can avoid to send OX messages unknown to its peer.
237: */
1.1 noro 238: @plugin/mathcap.h)
1.2 noro 239:
1.5 noro 240: Stack before the request:
241: \begin{tabular}{|c|} \hline
242: {\it Mathcap m} \\
243: \hline
244: \end{tabular}\\
1.2 noro 245: Request:
1.1 noro 246: \begin{tabular}{|c|c|} \hline
247: {\tt int32 OX\_DATA} & {\sl Mathcap} m \\ \hline
1.4 noro 248: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_setMathcap} \\
1.1 noro 249: \hline
250: \end{tabular}
1.2 noro 251:
1.4 noro 252: Output: none.
1.2 noro 253: /*&jp
254: \noindent
1.1 noro 255: 注意: mathcap は一般にクライアント主体で設定する.
256: クライアントがサーバに {\tt SM\_mathcap} をおくり,
257: サーバ側の mathcap を得る.
258: それを, クライアントはそのサーバに付随した mathcap として
259: 設定する.
260: 次に, クライアントはサーバに自分の mathcap を
1.4 noro 261: {\tt SM\_setMathcap} でおくり, 自分の mathcap を設定させる.
1.2 noro 262: */
263: /*&eg
264: \noindent
265: Remark: In general the exchange of mathcaps is triggered by a client.
266: A client sends {\tt SM\_mathcap} to a server and obtains the server's
267: mathcap. Then the client registers the mathcap. Finally the client
1.4 noro 268: sends its own mathcap by {\tt SM\_setMathcap} and the server
1.2 noro 269: registers it.
270: */
1.1 noro 271:
272: \item
273: \begin{verbatim}
1.2 noro 274: SM_executeStringByLocalParser
1.1 noro 275: \end{verbatim}
1.2 noro 276: /*&jp
1.3 noro 277: 文字列 {\tt s} を stack から pop し,
278: その文字列をシステム固有の文法(サーバスタックマシンの組み込みローカ
279: ル言語)にしたがったコマンドとして実行する. コマンドの実行の結
1.2 noro 280: 果の最後に戻り値があるときは, {\tt OperandStack} に戻り値を push する.
1.3 noro 281: OpenXM では, 現在のところ関数名の標準化はおこなっていない.
1.2 noro 282: この関数および {\tt popString} の機能を実現すれば, 最低限の open XM の
283: サーバになれる. 実装では, まずこの二つの関数の機能を実現すべきである.
284: */
285: /*&eg
1.3 noro 286: It requests a server to pop a character string {\tt s}, to
287: parse it by the local parser of the stack machine, and
1.4 noro 288: to interpret by the local interpreter.
289: If the execution produces a Output, it is pushed onto
1.2 noro 290: {\tt OperandStack}.
1.4 noro 291: If an error has occurred, Error2 Object is pushed onto the stack.
1.2 noro 292: OpenXM does not provide standard function names.
293: If this operation and {\tt SM\_popString} is implemented, the stack machine
1.4 noro 294: is ready to be used as an OX server.
1.2 noro 295: */
296:
297: Stack before the request:
1.1 noro 298: \\
299: \begin{tabular}{|c|} \hline
300: {\it String commandString} \\
301: \hline
302: \end{tabular}
1.2 noro 303:
304: Request:
1.1 noro 305: \begin{tabular}{|c|c|} \hline
306: {\tt int32 OX\_COMMAND}& {\tt int32 SM\_executeStringByLocalParser} \\
307: \hline
308: \end{tabular}
1.2 noro 309:
1.4 noro 310: Output: none.
1.2 noro 311: /*&jp
312: \noindent
313: 参考: \ 実行前のスタックのデータは,
1.4 noro 314: {\it String commandString} なる local stack machine の object としてス
1.2 noro 315: タック上にあるが, TCP/IP の通信路では, 次のようなデータがまずながれて
1.1 noro 316: {\it commandName} がスタックに push される:
1.2 noro 317: */
318: /*&eg
319: \noindent
320: Remark: Before this request, one has to push {\it String commandString}
321: onto the stack. It is done by sending the following OX data message.
322: */
1.1 noro 323: \begin{tabular}{|c|c|c|} \hline
324: {\tt int32 OX\_DATA} & {\tt int32 CMO\_string} & {\it size and the string commandString} \\
325: \hline
326: \end{tabular}
327:
328: \item
329: \begin{verbatim}
1.2 noro 330: SM_executeStringByLocalParserInBatchMode
1.1 noro 331: \end{verbatim}
1.2 noro 332: /*&jp
333: スタックに副作用がない(スタックにたいしてなんの操作もしない)ことを除き
334: 上とまったく同じ関数である. エラーの時のみ, Error2 Object をスタック
335: へプッシュする.
336: */
337: /*&eg
338: This is the same request as {\tt SM\_executeStringByLocalParser}
339: except that it does not modify the stack. It pushes an Error2 Object
1.4 noro 340: if an error has occurred.
1.2 noro 341: */
1.1 noro 342: \item
343: \begin{verbatim}
1.2 noro 344: SM_popString
345: \end{verbatim}
346: /*&jp
347: {\tt OperandStack} より Object を pop し, それを xxx の出力規則にしたがい文
348: 字列型に変換して送信する. スタックが空のときは, {\tt (char *)NULL} を戻す.
1.3 noro 349: 文字列は TCP/IP stream へ CMO のデー
1.2 noro 350: タとして送信する. エラーの場合は {\tt CMO\_ERROR2} を戻すべきである.
351: */
352: /*&eg
1.3 noro 353: It requests a server to pop an object from {\tt OperandStack},
1.2 noro 354: to convert it into a character string according to the output format
355: of the local system, and to send the character string via TCP/IP stream.
356: {\tt (char *)NULL} is returned when the stack is empty.
1.5 noro 357: The returned string is sent as a CMO string data.
1.4 noro 358: {\tt CMO\_ERROR2} should be returned if an error has occurred.
1.2 noro 359: */
360:
361: Stack before the request:
1.1 noro 362: \begin{tabular}{|c|} \hline
363: {\it Object} \\
364: \hline
365: \end{tabular}
1.2 noro 366:
367: Request:
1.1 noro 368: \begin{tabular}{|c|c|} \hline
369: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_popString} \\
370: \hline
371: \end{tabular}
1.2 noro 372:
1.4 noro 373: Output:
1.1 noro 374: \begin{tabular}{|c|c|c|} \hline
375: {\tt int32 OX\_DATA} & {\tt int32 CMO\_STRING} & {\it size and the string s} \\
376: \hline
377: \end{tabular}
378:
379: \item
380: \begin{verbatim}
1.2 noro 381: SM_getsp
1.1 noro 382: \end{verbatim}
1.2 noro 383: /*&jp
384: 現在のスタックポインタの位置をもどす. スタート時点での位置は 0 であり,
385: object が push されたばあい, 1 づつ増えるものとする.
386: */
387: /*&eg
1.3 noro 388: It requests a server to push the current stack pointer onto the stack.
1.2 noro 389: The stack pointer is represented by a non-negative integer.
390: Its initial value is 0 and a push operation increments the
391: stack pointer by 1.
392: */
393:
394: Stack before the request:
1.1 noro 395: \begin{tabular}{|c|} \hline
396: {\it Object} \\
397: \hline
398: \end{tabular}
1.2 noro 399:
400: Request:
1.1 noro 401: \begin{tabular}{|c|c|} \hline
402: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_getsp} \\
403: \hline
404: \end{tabular}
1.2 noro 405:
1.3 noro 406: Stack after the request:
1.1 noro 407: \begin{tabular}{|c|c|c|} \hline
408: {\tt int32 OX\_DATA} & {\tt int32 CMO\_INT32} & {\it stack pointer value} \\
409: \hline
410: \end{tabular}
411:
1.4 noro 412: Output: none.
1.3 noro 413:
1.1 noro 414: \item
415: \begin{verbatim}
1.2 noro 416: SM_dupErrors
1.1 noro 417: \end{verbatim}
1.2 noro 418: /*&jp
419: スタック上のエラーオブジェクトをリストにして戻す. スタック自体は変化
420: させない.
421: */
422: /*&eg
1.3 noro 423: It requests a server to push a list object containing all error objects on the stack.
1.2 noro 424: */
425:
426: Request:
1.1 noro 427: \begin{tabular}{|c|c|} \hline
428: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_dupErrors} \\
429: \hline
430: \end{tabular}
1.2 noro 431:
1.3 noro 432: Stack after the request:
1.1 noro 433: \begin{tabular}{|c|c|c|} \hline
434: {\tt int32 OX\_DATA} & {\sl CMObject} \ a list of errors\\
435: \hline
436: \end{tabular}
1.3 noro 437:
1.4 noro 438: Output: none.
1.6 takayama 439:
440: \item
441: \begin{verbatim}
442: SM_pushCMOtag
443: \end{verbatim}
444: /*&jp
445: スタックの先頭オブジェクトが CMO に変換された場合の CMO tag を
446: {\tt CMO\_INT32} としてスタックへ push する.
447: 先頭オブジェクトはスタックに留まる.
448: 先頭オブジェクトをCMO へ変換する方法が無い場合は, エラー object を積む.
449: */
450: /*&eg
451: It requests a server to push the CMO tag of the top object on the server
452: stack. The tag is pushed as {\tt CMO\_INT32}.
453: The top object remains on the stack.
454: If there is no way to translate the object into CMO,
455: push an error object.
456: */
457:
458: Request:
459: \begin{tabular}{|c|c|} \hline
460: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_pushCMOtag} \\
461: \hline
462: \end{tabular}
463:
464: Stack after the request:
465: \begin{tabular}{|c|c|c|} \hline
466: {\tt int32 OX\_DATA} & {\sl CMO\_INT32} \ tag\\
467: \hline
468: \end{tabular}
469:
470: Output: none.
1.1 noro 471: \end{enumerate}
472:
473: \medbreak
474: \noindent
1.9 takayama 475:
476: //&C \subsubsection{ MathCap } \label{subsubsection:mathcap}
477:
1.2 noro 478: /*&jp
1.1 noro 479: {\bf 例}: \
480: mathcap の問い合わせに対して, {\tt ox\_sm1} は次のように答える.
1.2 noro 481: */
482: /*&eg
483: {\bf Example}: \
484: {\tt ox\_sm1} returns the following data as its mathcap.
485: */
1.4 noro 486: %%Prog: [(cmoMathcap)] extension ::
1.1 noro 487: \begin{verbatim}
488: Class.mathcap
489: [ [199909080 , $Ox_system=ox_sm1.plain$ , $Version=2.990911$ ,
490: $HOSTTYPE=i386$ ] ,
491: [262 , 263 , 264 , 265 , 266 , 268 , 269 , 272 , 273 , 275 , 276 ] ,
492: [[514] , [2130706434 , 1 , 2 , 4 , 5 , 17 , 19 , 20 , 22 , 23 , 24 ,
493: 25 , 26 , 30 , 31 , 60 , 61 , 27 , 33 , 40 , 34 ]]]
494: \end{verbatim}
495:
1.2 noro 496: /*&jp
1.11 takayama 497: mathcap は 3つの要素をもつリストである. まづ, 最初の要素(これもリスト)を見よう.
498: リストの先頭の数字は OpenXM プロトコルのバージョンである.
1.4 noro 499: Ox\_system は openXM システム名である. 読み込むライブラリがちがって
1.2 noro 500: いて, 関数名(または シンボル)の意味がちがうときはこの名前もかえる. た
501: とえば, open math の basic content dictionary 対応の関数定義マクロを読
1.4 noro 502: みこんだ sm1 は, ox\_sm1\_basicCD なる名前にする. HOSTTYPE 値は, CPU
1.2 noro 503: の種類をあらわしunix では環境変数\verb+$HOSTTYPE+ の値である. 2 番目
504: の要素は 利用可能な SM コマンドをあつめたリストである. 3 番目のリスト
505: は, 処理可能な数学データの形式, およびCMOの場合なら処理可能なCMOのタグ
506: のリストが続く. 上の例では, 514 は {\tt OX\_DATA} をあらわし, 数学デー
507: タのフォマットは(サイズ情報なしの) CMO であることを示す.
508: */
509: /*&eg
1.11 takayama 510: A mathcap has three components. The first one, which is also a list,
511: contains informations
1.7 takayama 512: to identify the version number of the OpenXM protocol,
513: the system and hosts on which the application runs.
1.4 noro 514: In the above example, {\tt Ox\_system} denotes the system name.
515: {\tt HOSTTYPE} represents the OS type and taken from \verb+$HOSTTYPE+
1.2 noro 516: enviroment variable.
517: The second component consists of avaiable SM commands.
518: The third component is a list of pairs. Each pair consists
1.5 noro 519: of an OX message tag and the list of available message tags.
1.2 noro 520: Again in the above example, 514 is the value of {\tt OX\_DATA}
521: and it indicates that the server accepts CMO (without size information)
522: as mathematical data messages. In this case the subsequent
523: list represents available CMO tags.
524: */
1.1 noro 525:
1.9 takayama 526: /*&C
527: \noindent
528: OpenXM/XML expression of the example above:
529: \begin{verbatim}
530: <cmo_mathcap>
531: <cmo_list for="mathcap">
532:
533: <cmo_list>
534: <int32 for="length"> 4 </int32>
1.10 takayama 535: <cmo_int32 for="Protocol version"> 001001003 </cmo_int32>
1.9 takayama 536: <cmo_string for="system name"> Ox_system=ox_sm1.plain </cmo_string>
537: <cmo_string for="system version"> Version=2.990911 </cmo_string>
538: <cmo_string for="hosttype"> HOSTTYPE=i386 </cmo_string>
539: </cmo_list>
540:
541: <cmo_list for="Available SM tags">
542: <int32 for="length"> 11 </int32>
1.10 takayama 543: <cmo_int32> 262 </cmo_int32>
544: <cmo_int32> 263 </cmo_int32>
1.9 takayama 545: ...
546: </cmo_list>
547:
548: <cmo_list for="Available OX_DATA tags">
549: <int32 for="length"> 2 </int32>
550: <cmo_list for="OX_DATA tag">
551: <int32 for="length"> 1 </int32>
1.10 takayama 552: <cmo_int32 comment="OX_DATA"> 514 </cmo_int32>
1.9 takayama 553: </cmo_list>
554: <cmo_list for="Available CMO tags">
555: <int32 for="length"> 21 </int32>
1.10 takayama 556: <cmo_int32 comment="CMO_ERROR2"> 2130706434 </cmo_int32>
557: <cmo_int32 comment="CMO_NULL"> 1 </cmo_int32>
1.9 takayama 558: ....
559: </cmo_list>
560:
561: </cmo_list>
562: </cmo_list>
563: </cmo_mathcap>
564: \end{verbatim}
565: */
566:
1.1 noro 567: \medbreak
1.9 takayama 568:
569: //&jp \subsubsection{ 例 }
570: //&eg \subsubsection{ Examples }
571:
1.1 noro 572: \noindent
1.2 noro 573: //&jp {\bf 例}: \
574: //&eg {\bf Example}: \
1.1 noro 575: %%Prog: (ox.sm1) run sm1connectr [(oxWatch) ox.ccc] extension
576: %%Prog: ox.ccc (122345; ) oxsubmit ;
1.2 noro 577: //&jp {\tt message\_body} の実例をあげる. シリアル番号部は除いてある.
1.3 noro 578: //&eg We show examples of {\tt message\_body}. Serial numbers are omitted.
1.1 noro 579: \begin{enumerate}
580: \item {\tt executeStringByLocalParser("12345 ;");}
1.2 noro 581: /*&jp
582: は次のようなパケットに変換される. 各数字は 16進1バイトをあらわす.
583: {\tt xx(yy)} のなかの {\tt (yy)} は対応するアスキーコードをあわらす.
584: */
585: /*&eg
1.3 noro 586: is converted into the following packet. Each number denotes
587: one byte in hexadecimal representation.
588: {\tt (yy)} in {\tt xx(yy)} represents the corresponding ASCII code.
1.2 noro 589: */
1.1 noro 590: \begin{verbatim}
591: 0 0 2 2 0 0 0 4 0 0 0 7
592: 31(1) 32(2) 33(3) 34(4) 35(5) 20 3b(;)
593: 0 0 2 1 0 0 1 c
594: \end{verbatim}
1.2 noro 595: /*&jp
1.3 noro 596: それぞれのデータの意味は次のとおりである.
597: */
598: /*&eg
599: Each data has the following meaning.
1.2 noro 600: */
1.1 noro 601:
602: \begin{verbatim}
603: 0 0 2 2 (OX_DATA) 0 0 0 4 (CMO_STRING)
604: 0 0 0 7 (size)
605: 31(1) 32(2) 33(3) 34(4) 35(5) 20 3b(;) (data)
606: 0 0 2 1 (OX_COMMAND)
607: 0 0 1 c (SM_executeStringByLocalParser)
608: \end{verbatim}
1.2 noro 609: //&jp これを OXexpression で表記すると次のようになる.
1.3 noro 610: //&eg This is expressed by OXexpression as follows.
1.1 noro 611: \begin{center}
612: (OX\_DATA, (CMO\_STRING, 7, "12345 ;"))
613: \end{center}
614: \begin{center}
615: (OX\_COMMAND, (SM\_executeStringByLocalParser))
616: \end{center}
617:
1.2 noro 618: //&jp \item {\tt popString()} を要請するメッセージ:
1.3 noro 619: //&eg \item A message which requests {\tt SM\_popString}:
1.1 noro 620: \begin{verbatim}
621: 0 0 2 1 (OX_COMMAND)
622: 0 0 1 7 (SM_popString)
623: \end{verbatim}
1.3 noro 624: //&jp OXexpression では
625: //&eg In OXexpression it is represented as
1.1 noro 626: (OX\_COMMAND, (SM\_popString)).
627:
628: \noindent
1.2 noro 629: //&jp これにたいして次の返答メッセージがくる.
1.3 noro 630: //&eg The server returns the following reply message:
1.1 noro 631: \begin{verbatim}
632: 0 0 2 2 (OX_DATA)
633: 0 0 0 4 (CMO_STRING) 0 0 0 5 (size)
634: 31(1) 32(2) 33(3) 34(4) 35(5)
635: \end{verbatim}
1.2 noro 636: //&jp OXexpression でかくと,
1.3 noro 637: //&eg In OXexpression it is represented as
1.1 noro 638: (OX\_DATA, (CMO\_STRING, 7, "12345 ;")).
639: \end{enumerate}
640:
1.4 noro 641: //&jp \subsubsection{グループ SMobject/Basic に属するオペレータ}
642: //&eg \subsubsection{Operators in the group SMobject/Basic}
1.1 noro 643:
644: \begin{enumerate}
645: \item
646: \begin{verbatim}
1.3 noro 647: SM_pops
1.1 noro 648: \end{verbatim}
1.2 noro 649: /*&jp
1.4 noro 650: operand stack より, {\it n} 個の元 ({\it obj1, obj2, $\ldots$, objn}
1.2 noro 651: を pop して捨てる.
652: */
653: /*&eg
1.3 noro 654: It requests a server to pop {\it n} and to discard elements {\it obj1, obj2,
1.5 noro 655: $\ldots$, objn} from the stack.
1.2 noro 656: */
657:
1.4 noro 658: //&jp Stack before the request: \\
659: //&eg Stack before the request: \\
1.1 noro 660: \begin{tabular}{|c|c|c|c|c|} \hline
1.4 noro 661: {\it obj1} & {\it obj2} & $\cdots$ & {\it objn} &{\it Integer32 n} \\
1.1 noro 662: \hline
663: \end{tabular}
1.2 noro 664:
665: Request:
1.1 noro 666: \begin{tabular}{|c|c|} \hline
667: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_pops } \\
668: \hline
669: \end{tabular}
1.2 noro 670:
1.4 noro 671: Output: none.
1.1 noro 672:
673:
674: \item
675: \begin{verbatim}
1.3 noro 676: int SM_setName
1.1 noro 677: \end{verbatim}
1.2 noro 678: /*&jp
679: {\tt OperandStack} より {\it name} を pop し, つぎに{\tt OperandStack}
680: より {\it obj} を pop し, それを現在の名前空間で変数 {\it name} に
681: bind する. 正常終了なら 0 を, 異常終了なら -1 をもどす. TCP/IP によ
682: る通信では, 異常終了の時のみ, {\tt CMO\_ERROR2} をstack へ push する.
683: */
684: /*&eg
1.3 noro 685: It requests a server to pop {\it name}, to pop {\it obj}, and to
1.4 noro 686: bind {\it obj} to a variable {\it name} in the current name space
687: of the server.
688: If an error has occurred {\tt CMO\_ERROR2} is pushed onto the stack.
1.2 noro 689: */
1.4 noro 690: //&jp Stack before the request:
691: //&eg Stack before the request:
1.1 noro 692: \begin{tabular}{|c|c|} \hline
693: {\it obj} & {\it String name} \\
694: \hline
695: \end{tabular}
1.2 noro 696:
697: Request:
1.1 noro 698: \begin{tabular}{|c|c|} \hline
699: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_setName} \\
700: \hline
701: \end{tabular}
1.2 noro 702:
1.4 noro 703: Output: none.
1.1 noro 704:
705: \item
706: \begin{verbatim}
1.3 noro 707: SM_evalName
1.1 noro 708: \end{verbatim}
1.3 noro 709:
1.2 noro 710: /*&jp
711: 現在の名前空間で変数 {\it name} を評価する. 評価の結果 {\it
1.4 noro 712: OutputObj} をスタックへ戻す. 関数自体は正常終了なら 0 を, 異常終了な
1.2 noro 713: ら -1 をもどす. TCP/IP の場合, 異常終了の場合のみ {\tt CMO\_ERROR2}
714: を stack へ push する.
715: */
1.3 noro 716:
1.2 noro 717: /*&eg
1.3 noro 718: It requests a server to pop {\it name} and to evaluate a variable
1.4 noro 719: {\it name} in the current name space. The Output of the evaluation
720: {\it OutputObj} is pushed to the stack.
1.5 noro 721: If an error has occurred {\tt CMO\_ERROR2} is pushed onto the stack.
1.2 noro 722: */
723:
1.4 noro 724: //&jp Stack before the request:
725: //&eg Stack before the request:
1.1 noro 726: \begin{tabular}{|c|} \hline
727: {\it String name} \\
728: \hline
729: \end{tabular}
1.2 noro 730:
731: Request:
1.1 noro 732: \begin{tabular}{|c|c|} \hline
733: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_evalName} \\
734: \hline
735: \end{tabular}
1.2 noro 736:
1.4 noro 737: //&jp Stack after the request:
738: //&eg Stack after the request:
1.1 noro 739: \begin{tabular}{|c|} \hline
1.4 noro 740: {\it OutputObj} \\
1.1 noro 741: \hline
742: \end{tabular}
1.2 noro 743:
1.4 noro 744: Output: none.
1.1 noro 745:
746: \item
747: \begin{verbatim}
1.3 noro 748: SM_executeFunction
1.1 noro 749: \end{verbatim}
1.2 noro 750: /*&jp
751: スタックより {\it n} 個のデータを pop して, サーバのローカル関数{\it
752: s} を実行する. エラーのときのみ {\tt CMO\_ERROR2} を stack へ push す
753: る.
754: */
755: /*&eg
1.3 noro 756: It requests a server to pop {\it s} as a function name,
757: to pop {\it n} as the number of arguments and to execute
758: a local function {\it s} with {\it n} arguments popped from
759: the stack.
1.4 noro 760: If an error has occurred {\tt CMO\_ERROR2} is pushed to the stack.
1.2 noro 761: */
762:
1.4 noro 763: //&jp Stack before the request: \\
764: //&eg Stack before the request: \\
1.1 noro 765: \begin{tabular}{|c|c|c|c|c|} \hline
766: {\it objn} & $\cdots$ & {\it obj1} & {\it INT32 n} & {\it String s} \\
767: \hline
768: \end{tabular}
1.2 noro 769:
770: Request:
1.1 noro 771: \begin{tabular}{|c|c|} \hline
772: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_executeFunction} \\
773: \hline
774: \end{tabular}
775:
1.2 noro 776: //&jp Stack after the request: 関数実行の結果.
1.4 noro 777: //&eg Stack after the request: The Output of the execution.
1.1 noro 778:
1.4 noro 779: Output: none.
1.1 noro 780:
781: \item
782: \begin{verbatim}
1.3 noro 783: SM_popSerializedLocalObject
1.1 noro 784: \end{verbatim}
1.3 noro 785:
1.2 noro 786: /*&jp
1.3 noro 787: スタックより pop した object を local 形式で serialization して
788: OX message として stream へ出力する. OX message tag としては,
789: local 形式に対応したものが定義されていることが必要である.
790: この関数はおもに, homogeneous な分散システムで用いる.
1.2 noro 791: */
792: /*&eg
1.3 noro 793: It requests a sever to pop an object, to convert it into a
794: serialized form according to a local serialization scheme, and
795: to send it to the stream as an OX message.
796: An OX message tag corresponding to
797: the local data format must be sent prior to the serialized data
798: itself.
799: This operation is used mainly on homogeneous distributed systems.
1.2 noro 800: */
1.1 noro 801:
802: \item
803: \begin{verbatim}
1.3 noro 804: SM_popCMO
1.1 noro 805: \end{verbatim}
806:
1.2 noro 807: /*&jp
1.3 noro 808: {\tt OperandStack} より object を pop し CMO 形式の serialized object を
809: stream へ header {\tt OX\_DATA} をつけてながす.
1.2 noro 810: */
811: /*&eg
1.3 noro 812: It requests a server to pop an object from the stack, to convert
813: it into a serialized form according to the standard CMO encoding scheme,
814: and to send it to the stream with the {\tt OX\_DATA} header.
1.2 noro 815: */
816:
817: Request:
1.1 noro 818: \begin{tabular}{|c|c|} \hline
819: {\tt int32 OX\_COMMAND} & {\tt int32 OX\_popCMO} \\
820: \hline
821: \end{tabular}
1.2 noro 822:
1.4 noro 823: Output:
1.1 noro 824: \begin{tabular}{|c|c|} \hline
825: {\tt int32 OX\_DATA} & {\it Serialized CMO} \\
826: \hline
827: \end{tabular}
1.12 ! takayama 828:
! 829:
! 830: \item
! 831: \begin{verbatim}
! 832: SM_executeFunctionWithOptionalArgument
! 833: \end{verbatim}
! 834: /*&jp
! 835: スタックより {\it n} 個のデータおよび一つの optional 引数 {\it opt} を pop して,
! 836: サーバのローカル関数{\it s} を実行する. エラーのときのみ {\tt CMO\_ERROR2} を stack へ push す
! 837: る.
! 838: {\it opt} はキーワードと値のリストのリストである. キーワードは文字列型である.
! 839: */
! 840: /*&eg
! 841: It requests a server to pop {\it s} as a function name,
! 842: to pop an optional argument {\it opt},
! 843: to pop {\it n} as the number of arguments and to execute
! 844: a local function {\it s} with {\it n} arguments popped from
! 845: the stack.
! 846: If an error has occurred {\tt CMO\_ERROR2} is pushed to the stack.
! 847: {\it opt} is a list of lists of a keyword and a value.
! 848: Keywords are strings.
! 849: */
! 850:
! 851: //&jp Stack before the request: \\
! 852: //&eg Stack before the request: \\
! 853: \begin{tabular}{|c|c|c|c|c|c|} \hline
! 854: {\it objn} & $\cdots$ & {\it obj1} & {\it INT32 n} & {\it Obj opt} & {\it String s} \\
! 855: \hline
! 856: \end{tabular}
! 857:
! 858: Request:
! 859: \begin{tabular}{|c|c|} \hline
! 860: {\tt int32 OX\_COMMAND} & {\tt int32 SM\_executeFunctionWithOptionalArgument} \\
! 861: \hline
! 862: \end{tabular}
! 863:
! 864: //&jp Stack after the request: 関数実行の結果.
! 865: //&eg Stack after the request: The Output of the execution.
! 866:
! 867: Output: none.
! 868:
! 869: \noindent
! 870: Example of {\it opt} : \verb@ (("p", 13),("vars",("x","y")))@
! 871:
! 872: \noindent
! 873: [Added in 2004-3-8]
1.1 noro 874:
875: \end{enumerate}
876:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to stackmachine.tex CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [local] / OpenXM / doc / OpenXM-specs