IFAMSTART command - Revision history

JAL: /* Syntax */

2013-03-07T23:36:56Z

Syntax

← Older revision		Revision as of 23:36, 7 March 2013
Line 10:		Line 10:
	==Syntax==		==Syntax==
	<p class="syntax">IFAMSTART [CRAM \| IUCV]		<p class="syntax">IFAMSTART [CRAM \| IUCV]
	[usernumber [,usernumber]...]		[<span class="term">usernumber</span> [,<span class="term">usernumber</span>]...]
	</p>		</p>

	<p><b>Where:</b></p>		<p><b>Where:</b></p>
	usernumber ~~is the~~ number of the HLI IFAM2 thread that is being restarted. If a user is not specified, all IFAM2 threads are restarted.		<table>
			<tr><th>usernumber</th>
			<td>The number of the HLI IFAM2 thread that is being restarted. If a user is not specified, all IFAM2 threads are restarted.</td></tr>
			</table>

	====Syntax notes====		====Syntax notes====

JAL: /* Syntax */

2013-03-07T16:29:34Z

Syntax

← Older revision		Revision as of 16:29, 7 March 2013
Line 13:		Line 13:
	</p>		</p>

	<b>Where:</b>		<p><b>Where:</b></p>
	usernumber is the number of the HLI IFAM2 thread that is being restarted. If a user is not specified, all IFAM2 threads are restarted.		usernumber is the number of the HLI IFAM2 thread that is being restarted. If a user is not specified, all IFAM2 threads are restarted.
	===Syntax notes===
			====Syntax notes====
	If the channel type is not specified, CRAM is assumed. However, if no CRAM threads are defined, IUCV is assumed.		If the channel type is not specified, CRAM is assumed. However, if no CRAM threads are defined, IUCV is assumed.

	==Example==		==Example==
	<p class="code">IFAMSTART IUCV 12, 14, 16		<p class="code">IFAMSTART IUCV 12, 14, 16

JAL at 16:18, 7 March 2013

2013-03-07T16:18:18Z

← Older revision		Revision as of 16:18, 7 March 2013
Line 1:		Line 1:
			<p class="pageSubtitle">Restarting IFAM2 threads</p>

	==Summary==		==Summary==
	<dl>		<dl>

Alex: Automatically generated page update

2013-02-28T01:05:03Z

Automatically generated page update

New page

==Summary==
<dl>
<dt>Privileges
<dd>System manager
<dt>Function
<dd>Restarts a Host Language Interface facility IFAM2 thread
</dl>
==Syntax==
IFAMSTART [CRAM | IUCV]
[usernumber [,usernumber]...]


Where:
usernumber is the number of the HLI IFAM2 thread that is being restarted. If a user is not specified, all IFAM2 threads are restarted.
===Syntax notes===
If the channel type is not specified, CRAM is assumed. However, if no CRAM threads are defined, IUCV is assumed.
==Example==
IFAMSTART IUCV 12, 14, 16

==Usage notes==
The IFAMSTART command restarts the HLI IFAM2 facility or restarts individual threads that have been halted.
A thread can be halted in one of the following ways: 
<ul>
<li>
IFAMHALT command that implicitly or explicitly specified the thread's user number.
</li>

<li>
Successful processing of an IFAMDRAIN command.
</li>

<li>
CRAM OPEN error during <var class="product">Model 204</var> IFAM initialization, usually the result of two IFAM2 versions being active at once. IFAMSTART returns an error message until an IFAMOPEN command is successfully processed.
</li>

<li>
Restarting a thread more than four times between IFSTRT(N) calls. An error message is sent to the operator and the thread is halted. To restart threads halted in this fashion, the thread's user number must be explicitly mentioned in the IFAMSTART command. 
</li>
</ul>
If the IFAMSTART command is specified without arguments, all halted threads are restarted, with the important exception noted in the last list item above. An error message is produced if: 
<ul>
<li>
IFAM2 ICB is not open.
</li>

<li>
Specified thread is not halted.
</li>

<li>
Invalid thread user number is specified. 
</li>
</ul>
In the latter two cases, all valid threads specified in the command are processed.
If the IFAMSTART command is specified without arguments and one or more threads have been halted due to restart loops, an error message identifying the thread is supplied for each such thread. 
Note: In z/VM, only IUCV communications are supported.
[[Category: System manager commands]]
[[Category:Commands]]