Purpose
Connect
a Mosel instance.
Synopsis
function connect(mi:Mosel, host:string|text):integer
Arguments
|
mi
|
The instance to connect
|
|
host
|
A host specification
|
Return value
0 if successful, a positive value otherwise
Example
Start instance
inst1 on a separate process:
With default settings, the 2 following statements are equivalent:
r:=connect(ins2,"ariane")
r:=connect(ins3,"xsrv:ariane")
Further information
1. Any Mosel instance has to be connected before it can be used for executing commands.
2. If the
host provided is an empty string (
""), it is replaced by
"rcmd:" (instance started on the same machine in a separate process). Otherwise, the string
host is searched in the list of defined aliases (see
sethostalias) and, if found, it is replaced by the associated text. If the resulting specification does not contain any IO driver reference, a valid specification is generated using the current connection template (see
conntmpl): each occurrence of the
%h marker in the template is replaced by the value of
host.
3. The
host argument (or the string resulting from the transformations described above) is expected to be an extended file name using an IO driver the task of which is to start a process running the
mosel program in remote mode and create/manage the communication streams between the processes. The
mmjobs module provides three drivers supporting this service (see Section
I/O drivers):
"rcmd:" to start a Mosel instance on a separate process on the same machine,
"xsrv:" to start a Mosel instance on a host running the Mosel Remote Launcher (see Section
The Mosel Remote Launcher xprmsrv) and
"xssh:" to use a secure connection with an xprmsrv server.
Related topics
Module
© 2001-2023 Fair Isaac Corporation. All rights reserved. This documentation is the
property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not
convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except
solely for internal evaluation purposes to determine whether to purchase a license to the software
described in this documentation, or as otherwise set forth in a written software license agreement
between you and FICO (or a FICO affiliate). Use of this documentation and the software described in
it must conform strictly to the foregoing permitted uses, and no other use is permitted.
