REMOTE (JANUS DEFINE parameter): Difference between revisions
m (1 revision) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:REMOTE}} | {{DISPLAYTITLE:REMOTE}} | ||
<span class="pageSubtitle"><section begin="desc" />hostID portnum | *<section end="desc" /></span> | <span class="pageSubtitle"><section begin="desc" />REMOTE hostID portnum | * -- remote host and port identifier.<section end="desc" /></span> | ||
REMOTE is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]. | REMOTE is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|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. | This parameter identifies the remote server and the remote port number to be used with a set of ''[[Janus Sockets]]'' CLSOCK connections. | ||
''hostID'' can be any one of the following: | ''hostID'' can be any one of the following: | ||
<ul> | <ul> | ||
<li>An IP address. | <li>An IP address. | ||
<li>A host name. | <li>A host name. | ||
| Line 16: | Line 14: | ||
<li>An asterisk (*), which means whatever host is specified on the $function or object method that establishes the remote host. This is the default. | <li>An asterisk (*), which means whatever host is specified on the $function or object method that establishes the remote host. This is the default. | ||
</ul> | </ul> | ||
''portnum'' can be either of the following: | ''portnum'' can be either of the following: | ||
<ul> | <ul> | ||
<li>A TCP/IP port number in the range 1 through 65535. | <li>A TCP/IP port number in the range 1 through 65535. | ||
<li>An asterisk (*), which means whatever port number is specified on the $function or object method that establishes the remote host. This is the default. | <li>An asterisk (*), which means whatever port number is specified on the $function or object method that establishes the remote host. This is the default. | ||
</ul> | </ul> | ||
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. | ||
| Line 28: | Line 26: | ||
If the default setting, <code>REMOTE * *</code>, is in effect for a CLSOCK port, <code>REMOTE * *</code> is not included in JANUS DISPLAY output. | If the default setting, <code>REMOTE * *</code>, is in effect for a CLSOCK port, <code>REMOTE * *</code> is not included in JANUS DISPLAY output. | ||
The JANUS CLSOCK command | The [[JANUS CLSOCK]] command is required to allow a User Language application to access the CLSOCK 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 access restrictions.) | ||
See | 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 ports, for which it is a required parameter. | REMOTE is valid only for CLSOCK ports, for which it is a required parameter. | ||
Revision as of 14:46, 14 March 2011
<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.
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 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 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 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 ports, for which it is a required parameter.
References
See: List of Janus commands | List of JANUS DEFINE parameters.