MASTER (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
m (show "JANUS DEFINE parameter" in title)
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:MASTER}}
<span class="pageSubtitle">Set as default "outgoing" port</span>
<span class="pageSubtitle"><section begin="desc" />Set as default 'outgoing' port<section end="desc" /></span>


<var>MASTER</var> is a parameter on the <var>[[JANUS DEFINE]]</var> command, which defines and sets characteristics of a Janus port.  
<var>MASTER</var> is a parameter on the <var>[[JANUS DEFINE]]</var> command, which defines and sets characteristics of a Janus port.  


This parameter specifies that this is the default port for '''outgoing''' connections to remote servers. A single <var>MASTER</var> port will serve as the access route to multiple external server address spaces.
This parameter specifies that this is the default port for ''outgoing'' connections to remote servers. A single <var>MASTER</var> port will serve as the access route to multiple external server address spaces.
<ul>
<ul>
<li> The servers may be other <var class="product">Model 204</var> servers or may be Sybase/Microsoft servers that are to receive <var class="product">[[Media:JoclrNew.pdf|Janus Open Client]]</var> function calls.
<p>
Users accessing the <var class="product">Model 204</var> address space over an <var>[[JANUS DEFINE#type|OPENSERV]]</var> port will use the same port they came in on for any outgoing <var class="product">Janus Open Client</var> connections. Users accessing the <var class="product">Model 204</var> address space with other threads (for example, 3270 or web based applications) must have a <var>MASTER</var> port defined in order for the <var class="product">Janus Open Client</var> functions to establish connections to other address spaces. </p>
<p>
Note that the port number is irrelevant for outgoing purposes, though it must still be specified. </p></li>


<li> The servers may be other ''Model 204'' servers or may be Sybase/Microsoft servers that are to receive ''[[Janus Open Client]]'' function calls.
<li> The servers may host server sockets for <var class="product">[[Janus Sockets]]</var> client (<var>[[JANUS DEFINE#type|CLSOCK]]</var>) calls, or (as of <var class="product">Sirius Mods</var> Version 7.9) <var class="product">[[Debugger|Janus/TN3270 Debugger]]</var> client (<var>[[JANUS DEFINE#type|DEBUGGERCLIENT]]</var>) calls. A single <var>MASTER</var> port will serve as the access route to multiple external servers.  
 
<p>
Users accessing the ''Model 204'' address space over an OPENSERVER port will use the same port they came in on for any outgoing ''[[Janus Open Client]]'' connections. Users accessing the ''Model 204'' address space with other threads (for example, 3270 or web based applications) must have a <var>MASTER</var> port defined in order for the ''[[Janus Open Client]]'' functions to establish connections to other address spaces.
A port defined as <var>MASTER</var> can be accessed on a <var class="product">Janus Sockets</var> or <var class="product">Debugger</var> connection request without specifying its port name on the $function, object method, or command  that establishes the connection to a remote server socket. The socket port name parameter on <var>[[$Sock_Conn]]</var>, on the <var>[[Socket class|Socket]]</var> and <var>[[UdpSocket class|UdpSocket]]</var> object <var>New</var> constructors, on the <var class="product">[[HTTP Helper]]</var> <var>Get</var> and <var>Post</var> methods, and on the <var>[[SIRIUS DEBUG, SIRDEBUG, or SIRIUSDEBUG command|SIRIUS DEBUG ON]]</var> command defaults to the <var>MASTER</var> port, if any.</p></li>
 
Note that the port number is irrelevant for outgoing purposes, though it must still be specified.
 
<li> The servers may host server sockets for <var class="product">[[Janus Sockets]]</var> client (<var>[[JANUS DEFINE#type|CLSOCK]]</var>) calls, or (as of <var class="product">Sirius Mods</var> Version 7.9) <var class="product">[[Debugger|Janus/Sirius Debugger]]</var> client (<var>[[JANUS DEFINE#type|DEBUGGERCLIENT]]</var>) calls. A single <var>MASTER</var> port will serve as the access route to multiple external servers.  
 
A port defined as <var>MASTER</var> can be accessed on a <var class="product">Janus Sockets</var> or <var class="product">Debugger</var> connection request without specifying its port name on the $function, object method, or command  that establishes the connection to a remote server socket. The socket port name parameter on <var>$SOCK_CONN</var>, on the Socket object <var>New</var> constructor, on the <var class="product>HTTP Helper</var> <var>Get</var> and <var>Post</var> methods, and on the <var>[[SIRIUSDEBUG command|SIRIUS DEBUG ON]]</var> command defaults to the <var>MASTER</var> port, if any.
</ul>
</ul>


Multiple ports may be DEFINEd and STARTed with the <var>MASTER</var> parameter specified, but the one used in any particular instance will not be predictable.  
You can define and start multiple ports that have the <var>MASTER</var> parameter specified, but the one used in any particular instance will not be predictable.  


<var>MASTER</var> is valid only for <var class="product">Janus Sockets</var> client (<var>CLSOCK</var>), <var>DEBUGGERCLIENT</var>, <var>OPENSERV</var>, or <var>SDS</var> ports.
<var>MASTER</var> is valid only for <var>CLSOCK</var>, <var>CLSOCKU</var>, <var>DEBUGGERCLIENT</var>, <var>OPENSERV</var>, or <var>SDS</var> ports.


==Examples==
==Examples==
This command defines an SSL-protected, client socket MASTER port:
This command defines an SSL-protected, client socket MASTER port:
<p class="code">JANUS DEFINE CLMASTER * CLSOCK 5 TIMEOUT 240 REMOTE * * MASTER SSL 0 SSLOPT  -
<p class="code">JANUS DEFINE CLMASTER * CLSOCK 5 TIMEOUT 240 REMOTE * * MASTER SSL 0 SSLOPT  -
            SSLMAXCERTL 4096 SSLBSIZE 32767 LINEND 0D0A
            SSLMAXCERTL 4096 SSLBSIZE 32767 LINEND 0D0A
</p>
</p>


Line 33: Line 31:
<li>[[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]
<li>[[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]
</ul>
</ul>


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

Latest revision as of 15:44, 23 April 2015

Set as default "outgoing" port

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

This parameter specifies that this is the default port for outgoing connections to remote servers. A single MASTER port will serve as the access route to multiple external server address spaces.

  • The servers may be other Model 204 servers or may be Sybase/Microsoft servers that are to receive Janus Open Client function calls.

    Users accessing the Model 204 address space over an OPENSERV port will use the same port they came in on for any outgoing Janus Open Client connections. Users accessing the Model 204 address space with other threads (for example, 3270 or web based applications) must have a MASTER port defined in order for the Janus Open Client functions to establish connections to other address spaces.

    Note that the port number is irrelevant for outgoing purposes, though it must still be specified.

  • The servers may host server sockets for Janus Sockets client (CLSOCK) calls, or (as of Sirius Mods Version 7.9) Janus/TN3270 Debugger client (DEBUGGERCLIENT) calls. A single MASTER port will serve as the access route to multiple external servers.

    A port defined as MASTER can be accessed on a Janus Sockets or Debugger connection request without specifying its port name on the $function, object method, or command that establishes the connection to a remote server socket. The socket port name parameter on $Sock_Conn, on the Socket and UdpSocket object New constructors, on the HTTP Helper Get and Post methods, and on the SIRIUS DEBUG ON command defaults to the MASTER port, if any.

You can define and start multiple ports that have the MASTER parameter specified, but the one used in any particular instance will not be predictable.

MASTER is valid only for CLSOCK, CLSOCKU, DEBUGGERCLIENT, OPENSERV, or SDS ports.

Examples

This command defines an SSL-protected, client socket MASTER port:

JANUS DEFINE CLMASTER * CLSOCK 5 TIMEOUT 240 REMOTE * * MASTER SSL 0 SSLOPT - SSLMAXCERTL 4096 SSLBSIZE 32767 LINEND 0D0A

See also