REMOTE (JANUS DEFINE parameter): Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 24: | Line 24: | ||
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 <code>REMOTE * *</code>, any '''hostID''' and '''portnum''' on that invocation are a match. | 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 <code>REMOTE * *</code>, any '''hostID''' and '''portnum''' on that invocation are a match. | ||
If the default setting, <code>REMOTE * *</code>, is in effect for a CLSOCK or DEBUGGERCLIENT port, <code>REMOTE * *</code> is not included in JANUS DISPLAY output. | If the default setting, <code>REMOTE * *</code>, is in effect for a CLSOCK or <var>[[JANUS DEFINE#type|DEBUGGERCLIENT]]</var> port, <code>REMOTE * *</code> 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.) | The [[JANUS CLSOCK]] command is required to allow a User Language application to access the CLSOCK or <var>[[JANUS DEFINE#type|DEBUGGERCLIENT]]</var> 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 <var>JANUS DEFINE REMOTE</var>. | 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 <var>JANUS DEFINE REMOTE</var>. | ||
<var>REMOTE</var> is valid only for CLSOCK and DEBUGGERCLIENT ports, for which it is a required parameter. | <var>REMOTE</var> is valid only for CLSOCK and <var>[[JANUS DEFINE#type|DEBUGGERCLIENT]]</var> ports, for which it is a required parameter. | ||
==See also== | ==See also== | ||
Revision as of 20:35, 29 February 2012
<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.