REMOTE (JANUS DEFINE parameter)
<section begin="desc" />REMOTE hostID portnum | * -- remote host and port identifier.<section end="desc" />
REMOTE is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port. See the List of JANUS DEFINE parameters.
This parameter identifies the remote server and the remote port number to be used with a set of Janus Sockets CLSOCK connections or with DEBUGGERCLIENT connections.
hostID can be any one of the following:
- An IP address.
- A host name.
- Pattern matching characters that identify the host name. In this case, the $function or object method that establishes the remote host -- $SOCK_CONN, the Socket object New constructor, or the HTTP Helper Url or Host methods -- must specify the actual host ID, which must satisfy the pattern.
- An asterisk (*), which means whatever host is specified on the $function or object method that establishes the remote host. This is the default.
portnum can be either of the following:
- A TCP/IP port number in the range 1 through 65535.
- An asterisk (*), which means whatever port number is specified on the $function or object method that establishes the remote host. This is the default.
If you use a pattern or asterisk for hostId, or an asterisk for portnum, the identity of the remote server is not fully determined until the invocation of the $function or object method that establishes the remote host. Any host ID and port number specified as arguments on that invocation must be a match for the hostID and portnum combination. If you specify REMOTE * *, any hostID and portnum on that invocation are a match.
If the default setting, REMOTE * *, is in effect for a CLSOCK or DEBUGGERCLIENT port, REMOTE * * is not included in JANUS DISPLAY output.
The JANUS CLSOCK command is required to allow a User Language application to access the CLSOCK or DEBUGGERCLIENT port, and it can be used to further restrict both the hostID and portnum specified on the port definition. (System administrators are not subject to CLSOCK or DEBUGGERCLIENT access restrictions.)
See $Sock_Conn or the "New constructor" for sockets, for a discussion of the arguments provided to $Sock_Conn or to the Socket class New method See the description of $Sock_Conn or of the Socket class New method in the Janus Sockets Reference Manual for a discussion of the arguments provided to $Sock_Conn or to New and their interaction with JANUS DEFINE REMOTE.
REMOTE is valid only for CLSOCK and DEBUGGERCLIENT ports, for which it is a required parameter.