OPEN LINK command - Revision history

ELowell: /* Replacing an abandoned Horizon VTAM link */

2013-10-10T21:53:11Z

Replacing an abandoned Horizon VTAM link

← Older revision		Revision as of 21:53, 10 October 2013
Line 22:		Line 22:
	<p>OPEN LINK must be issued before any TPROCESS, Transfer Control, or Horizon User Language statements are issued or before a Connect:connection is established. </p>		<p>OPEN LINK must be issued before any TPROCESS, Transfer Control, or Horizon User Language statements are issued or before a Connect:connection is established. </p>
	==Replacing an abandoned Horizon VTAM link==		==Replacing an abandoned Horizon VTAM link==
	<p>When a Horizon VTAM link has been abandoned, using the ABANDON keyword of the CLOSE LINK command, it is sometimes possible to open a new Horizon VTAM link to replace the abandoned link and to take over its associated REMOTE, SESSIONGROUP and PROCESSGROUP definitions, using the REPLACE keyword in an OPEN LINK command.</p>		<p>When a Horizon VTAM link has been abandoned, using the ABANDON keyword of the CLOSE LINK command, it is sometimes possible to open a new Horizon VTAM link to replace the abandoned link and to take over its associated REMOTE, SESSIONGROUP and PROCESSGROUP definitions, using the REPLACE keyword in the OPEN LINK command.</p>
	<p class="code">OPEN LINK <var class="term">~~newlink~~</var> REPLACE <var class="term">~~oldlink~~</var>		<p class="code">OPEN LINK <var class="term">newlinkname</var> REPLACE <var class="term">oldlinkname</var>
	</p>		</p>
	<p>This is possible if the CLOSE LINK <var class="term">linkname</var> ABANDON command left the old link in an abandoned state. </p>		<p>This is possible if the CLOSE LINK <var class="term">linkname</var> ABANDON command left the old link in an abandoned state. </p>

ELowell: /* Syntax */

2013-10-10T21:52:15Z

Syntax

← Older revision		Revision as of 21:52, 10 October 2013
Line 9:		Line 9:
	<p class="syntax"><b>O</b>PEN LINK <var class="term">linkname</var> </p>		<p class="syntax"><b>O</b>PEN LINK <var class="term">linkname</var> </p>
	or		or
	<p class="syntax"><b>O</b>PEN LINK <var class="term">~~newlink~~</var> REPLACE <var class="term">~~oldlink~~</var></p>		<p class="syntax"><b>O</b>PEN LINK <var class="term">newlinkname</var> REPLACE <var class="term">oldlinkname</var></p>

	<b>Where:</b>		<b>Where:</b>
	<var class="term">linkname</var> is the link specified on the DEFINE LINK command.		<var class="term">linkname</var> is the link specified on the DEFINE LINK command.
	<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>		<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>
	<p><var class="term">~~newlink~~</var> is the name of the link to replace the abandoned Horizon VTAM link.</p>		<p><var class="term">newlinkname</var> is the name of the link to replace the abandoned Horizon VTAM link.</p>

	==Usage notes==		==Usage notes==

ELowell: /* Syntax */

2013-10-10T21:51:01Z

Syntax

← Older revision		Revision as of 21:51, 10 October 2013
Line 14:		Line 14:
	<var class="term">linkname</var> is the link specified on the DEFINE LINK command.		<var class="term">linkname</var> is the link specified on the DEFINE LINK command.
	<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>		<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>
	<p><var class="term">newlink</var> is the name of the link to ~~supplant~~ the abandoned Horizon VTAM link.</p>		<p><var class="term">newlink</var> is the name of the link to replace the abandoned Horizon VTAM link.</p>

	==Usage notes==		==Usage notes==

ELowell: /* Syntax */

2013-10-10T21:50:41Z

Syntax

← Older revision		Revision as of 21:50, 10 October 2013
Line 14:		Line 14:
	<var class="term">linkname</var> is the link specified on the DEFINE LINK command.		<var class="term">linkname</var> is the link specified on the DEFINE LINK command.
	<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>		<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>
	<p>newlink is the name of the link to supplant the abandoned Horizon VTAM link.</p>		<p><var class="term">newlink</var> is the name of the link to supplant the abandoned Horizon VTAM link.</p>

	==Usage notes==		==Usage notes==

ELowell: /* Syntax */

2013-10-10T21:48:17Z

Syntax

← Older revision		Revision as of 21:48, 10 October 2013
Line 14:		Line 14:
	<var class="term">linkname</var> is the link specified on the DEFINE LINK command.		<var class="term">linkname</var> is the link specified on the DEFINE LINK command.
	<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>		<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>
	<p>newlink is the name of ~~thelink~~ to supplant the abandoned Horizon VTAM link.</p>		<p>newlink is the name of the link to supplant the abandoned Horizon VTAM link.</p>

	==Usage notes==		==Usage notes==

ELowell: /* Syntax */

2013-10-10T21:48:00Z

Syntax

← Older revision		Revision as of 21:48, 10 October 2013
Line 7:		Line 7:
	</dl>		</dl>
	==Syntax==		==Syntax==
	<p class="syntax"><b>O</b>PEN LINK <var class="term">linkname</var> [REPLACE <var class="term">~~oldlinkname~~</var>]		<p class="syntax"><b>O</b>PEN LINK <var class="term">linkname</var> </p>
	</p>		or
			<p class="syntax"><b>O</b>PEN LINK <var class="term">newlink</var> REPLACE <var class="term">oldlink</var></p>

	<b>Where:</b>		<b>Where:</b>
	<var class="term">linkname</var> is the link specified on the DEFINE LINK command.		<var class="term">linkname</var> is the link specified on the DEFINE LINK command.
	<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>		<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>
			<p>newlink is the name of thelink to supplant the abandoned Horizon VTAM link.</p>

	==Usage notes==		==Usage notes==

ELowell: /* Syntax */

2013-10-10T21:42:01Z

Syntax

← Older revision		Revision as of 21:42, 10 October 2013
Line 7:		Line 7:
	</dl>		</dl>
	==Syntax==		==Syntax==
	<p class="syntax"><b>O</b>PEN LINK <var class="term">linkname</var> REPLACE <var class="term">oldlinkname</var>		<p class="syntax"><b>O</b>PEN LINK <var class="term">linkname</var> [REPLACE <var class="term">oldlinkname</var>]
	</p>		</p>

ELowell: /* Replacing an abandoned Horizon VTAM link */

2013-10-10T21:37:15Z

Replacing an abandoned Horizon VTAM link

← Older revision		Revision as of 21:37, 10 October 2013
Line 21:		Line 21:
	==Replacing an abandoned Horizon VTAM link==		==Replacing an abandoned Horizon VTAM link==
	<p>When a Horizon VTAM link has been abandoned, using the ABANDON keyword of the CLOSE LINK command, it is sometimes possible to open a new Horizon VTAM link to replace the abandoned link and to take over its associated REMOTE, SESSIONGROUP and PROCESSGROUP definitions, using the REPLACE keyword in an OPEN LINK command.</p>		<p>When a Horizon VTAM link has been abandoned, using the ABANDON keyword of the CLOSE LINK command, it is sometimes possible to open a new Horizon VTAM link to replace the abandoned link and to take over its associated REMOTE, SESSIONGROUP and PROCESSGROUP definitions, using the REPLACE keyword in an OPEN LINK command.</p>
	<p class="code">OPEN LINK <i>newlink</i> REPLACE <i>oldlink</i>		<p class="code">OPEN LINK <var class="term">newlink</var> REPLACE <var class="term">oldlink</var>
	</p>		</p>
	<p>This is possible if the CLOSE LINK linkname ABANDON command left the old link in an abandoned state. </p>		<p>This is possible if the CLOSE LINK <var class="term">linkname</var> ABANDON command left the old link in an abandoned state. </p>
	<p>If, however, the CLOSE LINK command completed in such a way that the link can be re-opened, the following new message is produced:</p>		<p>If, however, the CLOSE LINK command completed in such a way that the link can be re-opened, the following new message is produced:</p>
	<p class="code">M204.2890: LINK linkname CLOSED NORMALLY. IT CAN BE RE-OPENED		<p class="code">M204.2890: LINK <var class="term">linkname</var> CLOSED NORMALLY. IT CAN BE RE-OPENED
	</p>		</p>
	<p>In this case the keyword REPLACE of the OPEN LINK command cannot be used to replace the link. Instead the link should be re-opened as normal.</p>		<p>In this case the keyword REPLACE of the OPEN LINK command cannot be used to replace the link. Instead the link should be re-opened as normal.</p>

ELowell: /* Syntax */

2013-06-27T18:43:22Z

Syntax

← Older revision		Revision as of 18:43, 27 June 2013
Line 7:		Line 7:
	</dl>		</dl>
	==Syntax==		==Syntax==
	<p class="syntax"><b>O</b>PEN LINK <i>linkname</i> REPLACE <i>oldlinkname</i>		<p class="syntax"><b>O</b>PEN LINK <var class="term">linkname</var> REPLACE <var class="term">oldlinkname</var>
	</p>		</p>

	<b>Where:</b>		<b>Where:</b>
	linkname is the link specified on the DEFINE LINK command.		<var class="term">linkname</var> is the link specified on the DEFINE LINK command.
	<p>oldlinkname is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>		<p><var class="term">oldlinkname</var> is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.</p>

	==Usage notes==		==Usage notes==
	<p>Depending on the TRANSPORT option of the DEFINE LINK command, the OPEN LINK command opens the CRAM channel or terminal connection. The OPEN LINK command also opens the SNA Communications Server ACB, the access method control block that SNA Communications Server uses to gather all information about the application program, which in this case is <var class="product">Model 204</var>.</p>		<p>Depending on the TRANSPORT option of the DEFINE LINK command, the OPEN LINK command opens the CRAM channel or terminal connection. The OPEN LINK command also opens the SNA Communications Server ACB, the access method control block that SNA Communications Server uses to gather all information about the application program, which in this case is <var class="product">Model 204</var>.</p>

Alex: Automatically generated page update

2013-02-28T01:05:18Z

Automatically generated page update

New page

==Summary==
<dl>
<dt>Privileges
<dd>User 0, system administrator, system manager
<dt>Function
<dd>The OPEN LINK command enables the link specified on the DEFINE LINK command.
</dl>
==Syntax==
OPEN LINK linkname REPLACE oldlinkname


Where:
linkname is the link specified on the DEFINE LINK command.
oldlinkname is a Horizon VTAM link that was abandoned using the CLOSE LINK command with the ABANDON keyword.
==Usage notes==
Depending on the TRANSPORT option of the DEFINE LINK command, the OPEN LINK command opens the CRAM channel or terminal connection. The OPEN LINK command also opens the SNA Communications Server ACB, the access method control block that SNA Communications Server uses to gather all information about the application program, which in this case is <var class="product">Model 204</var>.
All system-wide control blocks and buffers necessary for activating sessions are allocated during open processing. 
If the DEFINE LINK command specifies the PSWD parameter, the user is prompted for a password. 
OPEN LINK must be issued before any TPROCESS, Transfer Control, or Horizon User Language statements are issued or before a Connect:connection is established. 
==Replacing an abandoned Horizon VTAM link==
When a Horizon VTAM link has been abandoned, using the ABANDON keyword of the CLOSE LINK command, it is sometimes possible to open a new Horizon VTAM link to replace the abandoned link and to take over its associated REMOTE, SESSIONGROUP and PROCESSGROUP definitions, using the REPLACE keyword in an OPEN LINK command.
OPEN LINK newlink REPLACE oldlink

This is possible if the CLOSE LINK linkname ABANDON command left the old link in an abandoned state. 
If, however, the CLOSE LINK command completed in such a way that the link can be re-opened, the following new message is produced:
M204.2890: LINK linkname CLOSED NORMALLY. IT CAN BE RE-OPENED

In this case the keyword REPLACE of the OPEN LINK command cannot be used to replace the link. Instead the link should be re-opened as normal.
[[Category: System administrator commands]]
[[Category: System manager commands]]
[[Category:Commands]]