DEFINE PROCESSGROUP command: Horizon for TCP/IP - Revision history

ELowell: /* Example */

2016-03-17T15:35:32Z

Example

← Older revision		Revision as of 15:35, 17 March 2016
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>

ELowell: /* Syntax */

2016-03-17T15:33:28Z

Syntax

← Older revision		Revision as of 15:33, 17 March 2016
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==

Tbullock: OUTLIMIT is in the examples and M204 will take it, don't know what it does though.

2016-02-23T23:03:04Z

OUTLIMIT is in the examples and M204 will take it, don't know what it does though.

← Older revision		Revision as of 23:03, 23 February 2016
Line 12:		Line 12:
	REMOTEID={address \| symbolicaddress} LOOKUP=IPV6ONLY\|IPV4ONLY\|ANY		REMOTEID={address \| symbolicaddress} LOOKUP=IPV6ONLY\|IPV4ONLY\|ANY
	INLIMIT={nnnn \| 0}		INLIMIT={nnnn \| 0}
			OUTLIMIT={nnnn \| 0}
	[PORT=nnnnn]		[PORT=nnnnn]
	[GUESTUSER={ACCEPT \| REJECT}]		[GUESTUSER={ACCEPT \| REJECT}]
Line 48:		Line 49:
	</li>		</li>
	</ul>		</ul>

	==Example==		==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.		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.

Alex: Automatically generated page update

2013-02-28T01:04:45Z

Automatically generated page update

New page

==Summary==
<dl>
<dt>Privileges
<dd>User 0 or system manager
<dt>Function
<dd>Sets up a TCP/IP connection via Horizon for processgroup. Supported in all operating systems.
</dl>
==Syntax==
DEFINE PROCESSGROUP name [LIKE previousname] WITH
SCOPE=SYSTEM
LINK=linkname
REMOTEID={address | symbolicaddress} LOOKUP=IPV6ONLY|IPV4ONLY|ANY
INLIMIT={nnnn | 0}
[PORT=nnnnn]
[GUESTUSER={ACCEPT | REJECT}]
[LOGIN=TRUST | NOTRUST}]
[MASK={dotted-decimal | 255.255.255.255}]


Where:
<ul>
<li>
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. 
</li>

<li>
<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. 
</li>

<li>
REMOTEID=address specifies the network address of one or, if a mask is specified, many partner remote nodes in the network. 
address can be: 
<ul>
<li>
a 32-bit number written in dotted-decimal notation, such as 182.148.55.206
</li>

<li>
(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.
</li>
</ul>
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. 
</li>
</ul>
==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
<ol>
<li>
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

</li>

<li>
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.
</li>

<li>
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.
</li>

<li>
Open the client link named TCPC
OPEN LINK TCPC

</li>
</ol>
For the server
<ol>
<li>
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

</li>

<li>
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

</li>

<li>
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.
</li>

<li>
Open the server link named TCPS
OPEN LINK TCPS

</li>
</ol>
==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 command: Horizon for TCP/IP|DEFINE LINK: Horizon for TCP/IP]].
[[Category: System manager commands]]
[[Category:Commands]]