Go to the first, previous, next, last section, table of contents.

### `ox_launch`, `ox_launch_nox`, `ox_shutdown`

`ox_launch([host[,dir],command])`
`ox_launch_nox([host[,dir],command])`
  :: Initialize OpenXM servers.
`ox_shutdown(id)`
  :: Terminates OpenXM servers.

return
  integer
host
  string or 0
dir command
  string
id
  integer

- Function `ox_launch()` invokes a process to execute command on a host host and enables Asir to communicate with that process. If the number of arguments is 3, ``ox_launch'` in dir is invoked on host. Then ``ox_launch'` invokes command. If host is equal to 0, all the commands are invoked on the same machine as the Asir is running. If no arguments are specified, host, dir and command are regarded as 0, the value of `get_rootdir()` and ``ox_asir'` in the same directory respectively.
- If host is equal to 0, then dir can be omitted. In such a case dir is regarded as the value of `get_rootdir()`.
- If command begins with ``/'`, it is regarded as an absolute pathname. Otherwise it is regarded as a relative pathname from dir.
- On UNIX, `ox_launch()` invokes ``xterm'` to display standard outputs from command. If `X11` is not available or one wants to invoke servers without ``xterm'`, use `ox_launch_nox()`, where the outputs of command are redirected to ``/dev/null'`. If the environment variable `DISPLAY` is not set, `ox_launch()` and `ox_launch_nox()` behave identically.
- The returned value is used as the identifier for communication.
- The peers communicating with Asir are not necessarily processes running on the same machine. The communication will be successful even if the byte order is different from those of the peer processes, because the byte order for the communication is determined by a negotiation between a client and a server.
- The following preparations are necessary. Here, Let `A` be the host on which Asir is running, and `B` the host on which the peer process will run.
  1. Register the hostname of the host `A` to the ``~/.rhosts'` of the host `B`. That is, you should be allowed to access the host `B` from `A` without supplying a password.
  2. For cases where connection to `X` is also used, let `Xserver` authorize the relevant hosts. Adding the hosts can be done by command `xhost`.
  3. If an environment variable `ASIR_RSH` is set, the content of this variable is used as a promgram to invoke remote servers instead of rsh. For example,

         % setenv ASIR_RSH "ssh -f -X -A "

     implies that remote servers are invoked by ``ssh'` and that X11 forwarding is enabled. See the manual of ``ssh'` for the detail.
  4. Some command's consume much stack space. You are recommended to set the stack size to about 16MB large in ``.cshrc'` for safe. To specify the size, put `limit stacksize 16m` for an example.
- When command opens a window on `X`, it uses the string specified for display; if the specification is omitted, it uses the value set for the environment variable `DISPLAY`.
- `ox_shutdown()` terminates OpenXM servers whose identifier is id.
- When Asir is terminated successfully, all I/O streams are automatically closed, and all the processes invoked are also terminated. However, some remote processes may not terminated when Asir is terminated abnormally. If ever Asir is terminated abnormally, you have to kill all the unterminated process invoked by Asir on every remote host. Check by `ps` command on the remote hosts to see if such processed are alive.
- ``xterm'` for displaying the outputs from command is invoked with ``-name ox_term'` option. Thus, by specifying resources for the resource name ``ox_term'`, only the behaviour of the ``xterm'` can be customized.

      /* iconify on start */
      ox_xterm*iconic:on
      /* activate the scroll bar */
      ox_xterm*scrollBar:on
      /* 1000 lines can be shown by the scrollbar */
      ox_xterm*saveLines:1000

    [219] ox_launch();
    0
    [220] ox_rpc(0,"fctr",x^10-y^10);
    0
    [221] ox_pop_local(0);
    [[1,1],[x^4+y*x^3+y^2*x^2+y^3*x+y^4,1],
    [x^4-y*x^3+y^2*x^2-y^3*x+y^4,1],[x-y,1],[x+y,1]]
    [222] ox_shutdown(0);
    0

`References`
  section `ox_rpc`, `ox_cmo_rpc`, `ox_execute_string`, section `ox_pop_cmo`, `ox_pop_local`, section `ifplot`, `conplot`, `plot`, `polarplot`, `plotover`

Go to the first, previous, next, last section, table of contents.