RESTART operator command - Revision history

Dme: /* See also */

2017-10-03T20:15:34Z

JAL: minor cleanup

2014-11-11T20:32:20Z

minor cleanup

← Older revision		Revision as of 20:32, 11 November 2014
Line 1:		Line 1:
	<p class="note"><b>Note:</b> Prior to Version 7.5 of <var class="product">[[Model 204]]</var>, the command processing described below is available only to <var class="product">[[Sirius Mods]]</var> customers.</p>		<p class="note"><b>Note:</b> Prior to Version 7.5 of <var class="product">[[Model 204]]</var>, the command processing described below is available only to <var class="product">[[Sirius Mods]]</var> customers.</p>

	~~This~~ RESTART operator command		The <var>RESTART</var> operator command
	requests that the Restart utility issue the equivalent of a user		requests that the Restart utility issue the equivalent of a user
	abend in [[Model 204]] for the indicated user or task.		abend in [[Model 204]] for the indicated user or task.
Line 8:		Line 8:
	failed (see [[BUMP command]]).		failed (see [[BUMP command]]).
	In this situation, the only options left are to cancel (FORCE under CMS)		In this situation, the only options left are to cancel (FORCE under CMS)
	the run or to issue the RESTART utility's RESTART command.		the run or to issue the RESTART utility's <var>RESTART</var> command.
	The RESTART command is preferable because:		The <var>RESTART</var> command is preferable because:
	<ul>		<ul>
	<li>		<li>The Online might intercept the abend, possibly take a snap dump, and
	The Online might intercept the abend, possibly take a snap dump, and		then continue running. </li>
	then continue running.
	<li>		<li>Even if the Online does not continue, it might at least intercept the
	Even if the Online does not continue, it might at least intercept the		abend and terminate "cleanly," preventing files from being broken
	abend and terminate ~~“~~cleanly~~”~~, preventing files from being broken
	and eliminating the need to run recovery.		and eliminating the need to run recovery.
	Cancelling or forcing the Online ensures:		<p>
			Cancelling or forcing the Online ensures: </p>
	<ul>		<ul>
	<li>Any file with active updating transactions will be left broken.		<li>Any file with active updating transactions will be left broken. </li>

	<li>Recovery will have		<li>Recovery will have
	to be run before the Online files can be used again.		to be run before the Online files can be used again. </li>
	</ul>		</ul></li>
	<li>
	The RESTART command will generally result in a CCASNAP being taken		<li>The <var>RESTART</var> command will generally result in a CCASNAP being taken
	rather than (or in addition to) a SYSMDUMP, SYSUDUMP, or VMDUMP.		rather than (or in addition to) a SYSMDUMP, SYSUDUMP, or VMDUMP.
	CCASNAPs are generally easier to deal with than other types of dumps.		CCASNAPs are generally easier to deal with than other types of dumps. </li>
	</ul>		</ul>

	The "~~abend_code~~" must be a 1- to 3-digit hexadecimal code that		The "abend code" must be a 1- to 3-digit hexadecimal code that
	indicates the abend code to be used for the artificially generated		indicates the abend code to be used for the artificially generated
	abend.		abend.
Line 36:		Line 37:
	Any dumps will indicate the specified abend code.		Any dumps will indicate the specified abend code.

	<p class="note">~~<b>~~Note:~~</b>~~ It is important to inform the support personnel that are examining the dump		<p class="note">'''Note:'''
			It is important to inform the support personnel that are examining the dump
	that the abend code was artificially generated by the RESTART utility		that the abend code was artificially generated by the RESTART utility
	and that the situation was actually a hung or looping Online.</p>		and that the situation was actually a hung or looping Online. </p>

	To prevent accidentally terminating a user or an Online, a user number		To prevent accidentally terminating a user or an Online, a user number
	can be specified on the RESTART command.		can be specified on the <var>RESTART</var> command.
	When a user number is specified on the RESTART command, no simulated		When a user number is specified on the <var>RESTART</var> command, no simulated
	abend will occur if the indicated user is not running in the Online.		abend will occur if the indicated user is not running in the Online.
	For example:		For example, this command simulates a 0C4 abend if user 23 is running:
	<p class="code">RESTART 0C4 USER 23		<p class="code">RESTART 0C4 USER 23
	</p>		</p>
	~~simulates a 0C4 abend if user 23 is running.~~
	If user 23 is not running, no abend ~~will be~~ simulated.		If user 23 is not running, no abend is simulated.

	If no user is running (a hung Online), it might be necessary to issue		If no user is running (a hung Online), it might be necessary to issue
	the RESTART command with a task number instead.		the <var>RESTART</var> command with a task number instead.
	Unless running MP/204, the task number must be specified as 0.		Unless running MP/204, the task number must be specified as 0.
	If MP/204 is running, the task number must be 0 (for the maintask) or		If MP/204 is running, the task number must be 0 (for the maintask) or
	the subtask number (from 1 to NMPSUBS) to be restarted.		the subtask number (from 1 to <var>NMPSUBS</var>) to be restarted.
	For example		For example, this simulates a 0A9 abend on the <var class="product">Model 204</var> maintask:
	<p class="code">RESTART 0A9 TASK 0		<p class="code">RESTART 0A9 TASK 0
	</p>		</p>
	~~simulates a 0A9 abend on the <var class="product">Model 204</var> maintask.~~
	Note that it is almost always preferable to specify a user number		Note that it is almost always preferable to specify a user number
	rather than a task number on the RESTART command.		rather than a task number on the <var>RESTART</var> command.

	==See also==		==See also==
	<ul>		<ul>
	<li>The [[RESTART command\|RESTART]][[RESTART command\| user 0 command]] is an entirely different command, which restarts <var class="product">Model 204</var> and optionally recovers files after a system failure.		<li>The [[RESTART command\|RESTART]][[RESTART command\| user 0 command]] is an entirely different command, which restarts <var class="product">Model 204</var> and optionally recovers files after a system failure.
			</li>
			</ul>

	[[Category: Operator commands]]		[[Category: Operator commands]]
	[[Category: Commands]]		[[Category: Commands]]

ELowell at 20:26, 11 November 2014

2014-11-11T20:26:00Z

← Older revision		Revision as of 20:26, 11 November 2014
Line 30:		Line 30:
	</ul>		</ul>

	The ''abend_code'' must be a 1- to 3-digit hexadecimal code that		The "abend_code" must be a 1- to 3-digit hexadecimal code that
	indicates the abend code to be used for the artificially generated		indicates the abend code to be used for the artificially generated
	abend.		abend.
Line 36:		Line 36:
	Any dumps will indicate the specified abend code.		Any dumps will indicate the specified abend code.

	~~'''~~Note:~~'''~~		<p class="note"><b>Note:</b> It is important to inform the support personnel that are examining the dump
	It is important to inform the support personnel that are examining the dump
	that the abend code was artificially generated by the RESTART utility		that the abend code was artificially generated by the RESTART utility
	and that the situation was actually a hung or looping Online.		and that the situation was actually a hung or looping Online.</p>

	To prevent accidentally terminating a user or an Online, a user number		To prevent accidentally terminating a user or an Online, a user number

JAL at 21:43, 25 August 2014

2014-08-25T21:43:42Z

← Older revision		Revision as of 21:43, 25 August 2014
Line 6:		Line 6:
	This command should be used only as a last resort when a <var class="product">Model 204</var>		This command should be used only as a last resort when a <var class="product">Model 204</var>
	Online is looping or hung and all efforts to clear up the situation have		Online is looping or hung and all efforts to clear up the situation have
	failed [[~~Bump Command~~]].		failed (see [[BUMP command]]).
	In this situation, the only options left are to cancel (FORCE under CMS)		In this situation, the only options left are to cancel (FORCE under CMS)
	the run or to issue the RESTART utility's RESTART command.		the run or to issue the RESTART utility's RESTART command.

Dme at 19:59, 8 May 2013

2013-05-08T19:59:47Z

← Older revision		Revision as of 19:59, 8 May 2013
Line 62:		Line 62:
	Note that it is almost always preferable to specify a user number		Note that it is almost always preferable to specify a user number
	rather than a task number on the RESTART command.		rather than a task number on the RESTART command.
			==See also==
			<ul>
			<li>The [[RESTART command\|RESTART]][[RESTART command\| user 0 command]] is an entirely different command, which restarts <var class="product">Model 204</var> and optionally recovers files after a system failure.
	[[Category: Operator commands]]		[[Category: Operator commands]]
	[[Category: Commands]]		[[Category: Commands]]

JAL at 01:44, 8 March 2013

2013-03-08T01:44:59Z

← Older revision		Revision as of 01:44, 8 March 2013
Line 1:		Line 1:
			<p class="note"><b>Note:</b> Prior to Version 7.5 of <var class="product">[[Model 204]]</var>, the command processing described below is available only to <var class="product">[[Sirius Mods]]</var> customers.</p>

	This RESTART operator command		This RESTART operator command
	requests that the Restart utility issue the equivalent of a user		requests that the Restart utility issue the equivalent of a user

Alex: Created page with "This RESTART operator command requests that the Restart utility issue the equivalent of a user abend in Model 204 for the indicated user or task. This command should be us..."

2013-03-03T03:38:21Z

Created page with "This RESTART operator command requests that the Restart utility issue the equivalent of a user abend in Model 204 for the indicated user or task. This command should be us..."

New page

This RESTART operator command
requests that the Restart utility issue the equivalent of a user
abend in [[Model 204]] for the indicated user or task.
This command should be used only as a last resort when a <var class="product">Model 204</var>
Online is looping or hung and all efforts to clear up the situation have
failed [[Bump Command]].
In this situation, the only options left are to cancel (FORCE under CMS)
the run or to issue the RESTART utility's RESTART command.
The RESTART command is preferable because:
<ul>
<li>
The Online might intercept the abend, possibly take a snap dump, and
then continue running.
<li>
Even if the Online does not continue, it might at least intercept the
abend and terminate “cleanly”, preventing files from being broken
and eliminating the need to run recovery.
Cancelling or forcing the Online ensures:
<ul>
<li>Any file with active updating transactions will be left broken.
<li>Recovery will have
to be run before the Online files can be used again.
</ul>
<li>
The RESTART command will generally result in a CCASNAP being taken
rather than (or in addition to) a SYSMDUMP, SYSUDUMP, or VMDUMP.
CCASNAPs are generally easier to deal with than other types of dumps.
</ul>

The ''abend_code'' must be a 1- to 3-digit hexadecimal code that
indicates the abend code to be used for the artificially generated
abend.
Under CMS, the abend code must be between 0C1 and 0CF.
Any dumps will indicate the specified abend code.

'''Note:'''
It is important to inform the support personnel that are examining the dump
that the abend code was artificially generated by the RESTART utility
and that the situation was actually a hung or looping Online.

To prevent accidentally terminating a user or an Online, a user number
can be specified on the RESTART command.
When a user number is specified on the RESTART command, no simulated
abend will occur if the indicated user is not running in the Online.
For example:
<p class="code">RESTART 0C4 USER 23
</p>
simulates a 0C4 abend if user 23 is running.
If user 23 is not running, no abend will be simulated.

If no user is running (a hung Online), it might be necessary to issue
the RESTART command with a task number instead.
Unless running MP/204, the task number must be specified as 0.
If MP/204 is running, the task number must be 0 (for the maintask) or
the subtask number (from 1 to NMPSUBS) to be restarted.
For example
<p class="code">RESTART 0A9 TASK 0
</p>
simulates a 0A9 abend on the <var class="product">Model 204</var> maintask.
Note that it is almost always preferable to specify a user number
rather than a task number on the RESTART command.

[[Category: Operator commands]]
[[Category: Commands]]

← Older revision		Revision as of 20:15, 3 October 2017
Line 66:		Line 66:
	==See also==		==See also==
	<ul>		<ul>
			<li>The discussion of [[:Category:Operator_commands#oprCmdFmt\|operator commands]] describes the format used on the z/OS console for the <var>RESTART</var> command.
			</li>
	<li>The [[RESTART command\|RESTART]][[RESTART command\| user 0 command]] is an entirely different command, which restarts <var class="product">Model 204</var> and optionally recovers files after a system failure.		<li>The [[RESTART command\|RESTART]][[RESTART command\| user 0 command]] is an entirely different command, which restarts <var class="product">Model 204</var> and optionally recovers files after a system failure.
	</li>		</li>