BINDADDR (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
m (add IPV6 address format)
Line 1: Line 1:
<span class="pageSubtitle">BINDADDR xxx.xxx.xxx.xxx &mdash; Bind port to a particular IP address</span>
<span class="pageSubtitle">Bind port to a particular IP address</span>


<var>BINDADDR</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port.  
<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 <var class="product">Model 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 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 host IP address. Address formats for IPV4 and (as of version 7.7 of Model&nbsp;204) IPV6 are supported.  


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.  
IPV4 addresses are 32-bit integers, commonly displayed as "dotted decimal." For example, the IP address X'C6F2F40D' is commonly displayed as 198.242.244.13.
 
IPV6 addresses are 128-bit integers. An IPV6 address is formally represented with eight, colon-separated, 16-bit (four hex-digit) groups. For example:
<p class="code">2011:0ab4:15a1:0000:0000:4a0e:0280:5274 </p>
 
==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.

Revision as of 19:21, 14 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 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." For example, the IP address X'C6F2F40D' is commonly displayed as 198.242.244.13.

IPV6 addresses are 128-bit integers. An IPV6 address is formally represented with eight, colon-separated, 16-bit (four hex-digit) groups. For example:

2011:0ab4:15a1:0000:0000:4a0e:0280:5274

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