BINDADDR (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
m (→‎Syntax: add link)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:BINDADDR}}
<span class="pageSubtitle">Bind port to a particular IP address</span>
<span class="pageSubtitle"><section begin="desc" />BINDADDR xxx.xxx.xxx.xxx -- bind port to a particular ip address<section end="desc" /></span>


<var>BINDADDR</var> 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]].
<var>BINDADDR</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port.  


This parameter specifies the IP address to which the port will be bound, if the host (machine) on which ''Model 204'' is running supports multiple IP addresses. The IP address must be an IP address of the host. If <var>BINDADDR</var> is not specified, the port binds the port number for all IP addresses associated with the host; that is, it can be accessed via any IP address associated with the host.  
This parameter specifies the IP address to which the port will be bound, if the host (machine) on which <var class="product">Model&nbsp;204</var> is running supports multiple IP addresses. The IP address must be an IP address of the host. If <var>BINDADDR</var> is not specified, the port binds the port number for all IP addresses associated with the host; that is, it can be accessed via any IP address associated with the host.  


This parameter only really makes sense on a host with more than one IP address. For example, if a host on which an Online is running has IP addresses 198.242.244.47 and 198.242.244.130, a <code>BINDADDR 198.242.244.47</code> specification indicates that the port can only be reached through IP address 198.242.244.47.
==Syntax==
<p class="syntax">BINDADDR <span class="term">address</span> </p>


This parameter is especially useful for allowing a single mainframe host or even an Online to act as more than one web server without the inconvenience of having port numbers on URLs. This can be done because there can be multiple port 80's (the default web port number) on the host, each accessed by its indicated <var>BINDADDR</var>. The separate IP addresses could, in turn, be associated with different DNS host names even though these separate names refer to the same underlying machine.  
Where: <var class="term">address</var> is a string containing the host IP address. Address formats for IPV4 and (as of version 7.7 of Model&nbsp;204) IPV6 are supported:
<ul>
<li>IPV4 addresses are 32-bit integers, commonly displayed as "dotted decimal" 8-bit groups. For example, the IP address X'C6F2F40D' is commonly displayed (and must be specified for <var class="term"> address</var>) as <code>198.242.244.13</code>. </li>


Note that there is not likely to be much, if any, performance benefit to having multiple Janus ports with the same port number but different <var>BINDADDR</var>s in the same Online. There might certainly be, however, some organizational advantages to running such a configuration.  
<li>IPV6 addresses are 128-bit integers, represented with eight, colon-separated, 16-bit (four hex-digit) groups, which may be abbreviated and represented with fewer groups. For example,
<code>fe80:0000:0000:0000:0200:0000:0300:0016</code> or <code>fe80::200:0:300:16</code>.
<p>
For more information about the supported format, see [https://en.wikipedia.org/wiki/IPv6_address Recommended representation as text]. </p></li>
</ul>
 
==Usage==
<ul>
<li>This parameter only really makes sense on a host with more than one IP address. For example, if a host on which an Online is running has IP addresses 198.242.244.47 and 198.242.244.130, a <code>BINDADDR 198.242.244.47</code> specification indicates that the port can only be reached through IP address 198.242.244.47. </li>
 
<li><var>BINDADDR</var> is especially useful for allowing a single mainframe host or even an Online to act as more than one web server without the inconvenience of having port numbers on URLs. This can be done because there can be multiple port 80's (the default web port number) on the host, each accessed by its indicated <var>BINDADDR</var>. The separate IP addresses could, in turn, be associated with different DNS host names, even though these separate names refer to the same underlying machine. </li>
 
<li>There is not likely to be much, if any, performance benefit to having multiple Janus ports with the same port number but different <var>BINDADDR</var> specifications in the same Online. However, there might certainly be some organizational advantages to running such a configuration. </li>
</ul>


Valid for all port types.
Valid for all port types.


==References==
==See also==
<ul>
<li>[[List of Janus commands]]
<li>[[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]
</ul>


See: [[List of Janus commands]] | [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]].


[[Category:JANUS DEFINE parameters|BINDADDR]]
[[Category:JANUS DEFINE parameters|BINDADDR]]

Latest revision as of 17:28, 19 September 2016

Bind port to a particular IP address

BINDADDR is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port.

This parameter specifies the IP address to which the port will be bound, if the host (machine) on which Model 204 is running supports multiple IP addresses. The IP address must be an IP address of the host. If BINDADDR is not specified, the port binds the port number for all IP addresses associated with the host; that is, it can be accessed via any IP address associated with the host.

Syntax

BINDADDR address

Where: address is a string containing the host IP address. Address formats for IPV4 and (as of version 7.7 of Model 204) IPV6 are supported:

  • IPV4 addresses are 32-bit integers, commonly displayed as "dotted decimal" 8-bit groups. For example, the IP address X'C6F2F40D' is commonly displayed (and must be specified for address) as 198.242.244.13.
  • IPV6 addresses are 128-bit integers, represented with eight, colon-separated, 16-bit (four hex-digit) groups, which may be abbreviated and represented with fewer groups. For example, fe80:0000:0000:0000:0200:0000:0300:0016 or fe80::200:0:300:16.

    For more information about the supported format, see Recommended representation as text.

Usage

  • This parameter only really makes sense on a host with more than one IP address. For example, if a host on which an Online is running has IP addresses 198.242.244.47 and 198.242.244.130, a BINDADDR 198.242.244.47 specification indicates that the port can only be reached through IP address 198.242.244.47.
  • BINDADDR is especially useful for allowing a single mainframe host or even an Online to act as more than one web server without the inconvenience of having port numbers on URLs. This can be done because there can be multiple port 80's (the default web port number) on the host, each accessed by its indicated BINDADDR. The separate IP addresses could, in turn, be associated with different DNS host names, even though these separate names refer to the same underlying machine.
  • There is not likely to be much, if any, performance benefit to having multiple Janus ports with the same port number but different BINDADDR specifications in the same Online. However, there might certainly be some organizational advantages to running such a configuration.

Valid for all port types.

See also