DEFINE PROCESSGROUP command: Horizon for TCP/IP: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (OUTLIMIT is in the examples and M204 will take it, don't know what it does though.)
 
(One intermediate revision by the same user not shown)
Line 7: Line 7:
</dl>
</dl>
==Syntax==
==Syntax==
<p class="syntax">DEFINE PROCESSGROUP name [LIKE previousname] WITH
<p class="syntax">DEFINE PROCESSGROUP <span class="term">name</span> [LIKE <span class="term">previousname</span>] WITH
   SCOPE=SYSTEM
   SCOPE=SYSTEM
   LINK=linkname  
   LINK=<span class="term">linkname</span>
   REMOTEID={address | symbolicaddress}  LOOKUP=IPV6ONLY|IPV4ONLY|ANY
   REMOTEID={<span class="term">address</span> | <span class="term">symbolicaddress</span>}  LOOKUP=IPV6ONLY|IPV4ONLY|ANY
   INLIMIT={nnnn | 0}
   INLIMIT={<span class="term">nnnn</span> | 0}
   OUTLIMIT={nnnn | 0}
   OUTLIMIT={<span class="term">nnnn</span> | 0}
   [PORT=nnnnn]
   [PORT=<span class="term">nnnnn</span>]
   [GUESTUSER={ACCEPT | REJECT}]
   [GUESTUSER={ACCEPT | REJECT}]
   [LOGIN=TRUST | NOTRUST}]
   [LOGIN=TRUST | NOTRUST}]
   [MASK={dotted-decimal | 255.255.255.255}]
   [MASK={<span class="term">dotted-decimal</span> | 255.255.255.255}]
</p>
</p>
   
   
Line 22: Line 22:
<ul>  
<ul>  
<li>
<li>
<p>name is used on DEFINE PROCESS commands to refer to this processgroup. The length of the name must be eight characters or less. ALL is a reserved word and cannot be used. </p>
<p><var class="term">name</var> is used on DEFINE PROCESS commands to refer to this processgroup. The length of the name must be eight characters or less. ALL is a reserved word and cannot be used. </p>
</li>
</li>
   
   
<li>
<li>
<p><var>LINK</var> is required and associates the group with a locally defined link that implies the transport type and conversation protocol. A linkname must match the name used in a local DEFINE LINK command. </p>
<p><var>LINK</var> is required and associates the group with a locally defined link that implies the transport type and conversation protocol. <var class="term">linkname</var> must match the name used in a local DEFINE LINK command. </p>
</li>
</li>
   
   
<li>
<li>
<p>REMOTEID=address specifies the network address of one or, if a mask is specified, many partner remote nodes in the network. </p>
<p>REMOTEID=<var class="term">address</var> specifies the network address of one or, if a mask is specified, many partner remote nodes in the network. </p>
<p>address can be: </p>
<p><var class="term">address</var> can be: </p>
<ul>  
<ul>  
<li>
<li>
Line 38: Line 38:
   
   
<li>
<li>
<p>(z/OS only) an IPv6 address, with up to 8 halfwords separated by colons, such as </p>
<p>(z/OS only) an IPv6 address, with up to 8 halfwords separated by colons, such as: </p>
<p class="code">C0:12:46:F0:00:00:00:01
<p class="code">C0:12:46:F0:00:00:00:01</p>
</p><p>, which can also be written as </p>
<p>which can also be written as: </p>
<p class="code">C0:12:46:F0::01
<p class="code">C0:12:46:F0::01</p>
</p><p>. In other words, the double colon shows that there are missing halfwords of binary zeros.</p>
<p>In other words, the double colon shows that there are missing halfwords of binary zeros.</p>
</li>
</li>
</ul>
</ul>
<p>REMOTEID=symbolicaddress specifies the symbolic address of one partner remote node in the network, such as MYMVS1, or SMTP.MYDOMAIN.COM. </p>
<p>REMOTEID=<var class="term">symbolicaddress</var> specifies the symbolic address of one partner remote node in the network, such as MYMVS1, or SMTP.MYDOMAIN.COM. </p>
<p>The MASK parameter cannot be used with REMOTEID=symbolicaddress. </p>
<p>The MASK parameter cannot be used with REMOTEID=<var class="term">symbolicaddress</var>. </p>
</li>
</li>
</ul>
</ul>


==Example==
==Example==
Line 64: Line 64:
   
   
<li>
<li>
<p>Define a processgroup named TCPG</p>
<p>Define a processgroup named TCPG.</p>
<p class="code">DEFINE PROCESSGROUP TCPG WITH SCOPE=SYSTEM LINK=TCPC -
<p class="code">DEFINE PROCESSGROUP TCPG WITH SCOPE=SYSTEM LINK=TCPC -
INLIMIT=30 OUTLIMIT=30  REMOTEID=192.207.28.129 -
INLIMIT=30 OUTLIMIT=30  REMOTEID=192.207.28.129 -
Line 73: Line 73:
   
   
<li>
<li>
<p>Define a process named CPR</p>
<p>Define a process named CPR.</p>
<p class="code">DEFINE PROCESS CPR  WITH SCOPE=SYSTEM -
<p class="code">DEFINE PROCESS CPR  WITH SCOPE=SYSTEM -
DATALEN=9999  PARTNER=SPR -
DATALEN=9999  PARTNER=SPR -
Line 82: Line 82:
   
   
<li>
<li>
<p>Open the client link named TCPC</p>
<p>Open the client link named TCPC.</p>
<p class="code">OPEN LINK TCPC
<p class="code">OPEN LINK TCPC
</p>
</p>
Line 99: Line 99:
   
   
<li>
<li>
<p>Define a processgroup TSPG for the server</p>
<p>Define a processgroup TSPG for the server.</p>
<p class="code">DEFINE  PROCESSGROUP TSPG  WITH SCOPE=SYSTEM - LINK=TCPS -
<p class="code">DEFINE  PROCESSGROUP TSPG  WITH SCOPE=SYSTEM - LINK=TCPS -
INLIMIT=30 OUTLIMIT=30  REMOTEID=192.207.28.129 -
INLIMIT=30 OUTLIMIT=30  REMOTEID=192.207.28.129 -
Line 107: Line 107:
   
   
<li>
<li>
<p>Define a process named SPR for the server</p>
<p>Define a process named SPR for the server.</p>
<p class="code">DEFINE PROCESS SPR  WITH SCOPE=SYSTEM FROM TSPG -
<p class="code">DEFINE PROCESS SPR  WITH SCOPE=SYSTEM FROM TSPG -
DATALEN=9999  TIMEOUT=0 -
DATALEN=9999  TIMEOUT=0 -
Line 116: Line 116:
   
   
<li>
<li>
<p>Open the server link named TCPS</p>
<p>Open the server link named TCPS.</p>
<p class="code">OPEN LINK TCPS   
<p class="code">OPEN LINK TCPS   
</p>
</p>
</li>
</li>
  </ol>
  </ol>
==Usage notes==
==Usage notes==
<b>IPv6 addressing</b>
<b>IPv6 addressing</b>

Latest revision as of 15:35, 17 March 2016

Summary

Privileges
User 0 or system manager
Function
Sets up a TCP/IP connection via Horizon for processgroup. Supported in all operating systems.

Syntax

DEFINE PROCESSGROUP name [LIKE previousname] WITH SCOPE=SYSTEM LINK=linkname REMOTEID={address | symbolicaddress} LOOKUP=IPV6ONLY|IPV4ONLY|ANY INLIMIT={nnnn | 0} OUTLIMIT={nnnn | 0} [PORT=nnnnn] [GUESTUSER={ACCEPT | REJECT}] [LOGIN=TRUST | NOTRUST}] [MASK={dotted-decimal | 255.255.255.255}]

Where:

  • name is used on DEFINE PROCESS commands to refer to this processgroup. The length of the name must be eight characters or less. ALL is a reserved word and cannot be used.

  • LINK is required and associates the group with a locally defined link that implies the transport type and conversation protocol. linkname must match the name used in a local DEFINE LINK command.

  • REMOTEID=address specifies the network address of one or, if a mask is specified, many partner remote nodes in the network.

    address can be:

    • a 32-bit number written in dotted-decimal notation, such as 182.148.55.206

    • (z/OS only) an IPv6 address, with up to 8 halfwords separated by colons, such as:

      C0:12:46:F0:00:00:00:01

      which can also be written as:

      C0:12:46:F0::01

      In other words, the double colon shows that there are missing halfwords of binary zeros.

    REMOTEID=symbolicaddress specifies the symbolic address of one partner remote node in the network, such as MYMVS1, or SMTP.MYDOMAIN.COM.

    The MASK parameter cannot be used with REMOTEID=symbolicaddress.

Example

To set up a Horizon for TCP/IP connection, take the following steps. You define a link, processgroup, and a process for a client and open the link. Then you define the same items on the server side and open the link, as shown in the following steps.

For the client

  1. Define a link for a client named TCPC.

    DEFINE LINK TCPC WITH SCOPE=SYSTEM PROTOCOL=IP - LOCALID=192.207.28.129 INBUFSIZE=4096 - TRANSPORT=TCPSE - CONNECTIONS=60 SERVPORT=65535

  2. Define a processgroup named TCPG.

    DEFINE PROCESSGROUP TCPG WITH SCOPE=SYSTEM LINK=TCPC - INLIMIT=30 OUTLIMIT=30 REMOTEID=192.207.28.129 - MASK=255.255.255.255 PORT=65534

    The value of PORT, 65534, is used as the SERVPORT value in the DEFINE LINK command for the server.

  3. Define a process named CPR.

    DEFINE PROCESS CPR WITH SCOPE=SYSTEM - DATALEN=9999 PARTNER=SPR - DESTINATION=TCPG UIDSOURCE=OPEN

    The value of PARTNER, SPR, is the process name in the DEFINE PROCESS command for the server.

  4. Open the client link named TCPC.

    OPEN LINK TCPC

For the server

  1. Define a link for the server named TCPS that corresponds to the link for the client. In this example, the SERVPORT value 65534 matches the PORT value defined in the client DEFINE PROCESSGROUP command.

    DEFINE LINK TCPS WITH SCOPE=SYSTEM PROTOCOL=IP - LOCALID=192.207.28.129 INBUFSIZE=4096 - TRANSPORT=TCPSE - CONNECTIONS=60 SERVPORT=65534

  2. Define a processgroup TSPG for the server.

    DEFINE PROCESSGROUP TSPG WITH SCOPE=SYSTEM - LINK=TCPS - INLIMIT=30 OUTLIMIT=30 REMOTEID=192.207.28.129 - MASK=255.255.255.255

  3. Define a process named SPR for the server.

    DEFINE PROCESS SPR WITH SCOPE=SYSTEM FROM TSPG - DATALEN=9999 TIMEOUT=0 - SUBSYSTEM=CONS SUBSYSPARM='CONSPROC RE-TPROC - NOPEN'

    The process name defined for the server must match the value of the PARTNER parameter in the client DEFINE PROCESS command.

  4. Open the server link named TCPS.

    OPEN LINK TCPS

Usage notes

IPv6 addressing

IPv6 addressing is supported on IBM z/OS systems only.

Take care using symbolic addresses when your Online is running on a host that is enabled for IPv6 addressing. If your Online needs to communicate with IPv4 partner nodes, you must specify LOOKUP=IPV4ONLY on the LINK or PROCESSGROUP definition. For details, see "Usage Notes" in DEFINE LINK: Horizon for TCP/IP.