Return to openxm-clients.tex CVS log

Up to [local] / OpenXM / doc / issac2000

Annotation of OpenXM/doc/issac2000/openxm-clients.tex, Revision 1.3

1.3     ! noro        1: % $OpenXM: OpenXM/doc/issac2000/openxm-clients.tex,v 1.2 2000/01/02 07:32:12 takayama Exp $
1.2       takayama    2:
                      3: \section{OpenXM Clients}
                      4: (noryo and Ohara)
                      5: MEMO: keywords:
                      6: Asir and Mathematica clients.
1.3     ! noro        7:
        !             8: \subsection{Risa/Asir}
        !             9:
        !            10: Risa/Asir provides a launcher to invoke an OpenXM server and to set up the
        !            11: communication between the server and itself. It also provides primitives
        !            12: for communication as built-in functions.
        !            13:
        !            14: \subsubsection{{\tt ox\_launch}}
        !            15: {\tt ox\_launch} is a general purpose launcher.  This application
        !            16: invokes a server and initiates the server-client communication
        !            17: according to the protocol stated in Section \ref{launcher}, then
        !            18: itself becomes a control server.
        !            19: Several facilities related to {{\tt ox\_launch}} are provided
        !            20: as built-in functions of Risa/Asir: a function to invoke a server
        !            21: automatically from a give host name and a server name, and a set
        !            22: of functions to execute the port generation, {\tt bind}, {\tt listen},
        !            23: {\tt connect} and {\tt accept} operations on sockets individually.
        !            24:
        !            25: \subsubsection{Manipulating servers}
        !            26:
        !            27: Fundamental operations on OpenXM servers are sending and receiving
        !            28: of {\tt OX} data and sending of {\tt OX} commands. The following functions
        !            29: are provided to execute these primitive operations:
        !            30: {\tt ox\_push\_cmo()} for pushing data to a server,
        !            31: {\tt ox\_push\_cmd()} for sending an {\tt SM} command to a server
        !            32: and {\tt ox\_get()} for receiving data from a stream.
        !            33:
        !            34: Some operations including the reset operation are realized by
        !            35: combining these primitives.  Among them, frequently used ones are
        !            36: provided as built-in functions. We show several ones.
        !            37:
        !            38: \begin{itemize}
        !            39: \item {\tt ox\_pop\_cmo()}
        !            40:
        !            41: It requests a server to send data on the stack to the stream, then
        !            42: it receives the data from the stream.
        !            43:
        !            44: \item {\tt ox\_cmo\_rpc()}
        !            45:
        !            46: After pushing the name of a function, arguments and the number of the
        !            47: arguments to the stack of a server , it request the server to execute
        !            48: the function. It does not wait the termination of the function call.
        !            49:
        !            50: \item {\tt ox\_reset()}
        !            51:
        !            52: After sending {\tt SM\_control\_reset\_connection} to a control server,
        !            53: it completes the operations stated in Section \ref{control}.
        !            54: \end{itemize}
        !            55: Furthermore {\tt ox\_select()} is provided to detect streams ready for
        !            56: reading. It is realized by the {\tt select()} system call and is used
        !            57: to avoid blocking on read operations.