SWITCH STREAM command - Revision history

Goff: Update to reflect PDS8571

2024-10-13T22:05:41Z

Update to reflect PDS8571

← Older revision		Revision as of 22:05, 13 October 2024
Line 20:		Line 20:
	<td>This optional parameter causes any disabled parallel GDG members to be reopened during the switch.		<td>This optional parameter causes any disabled parallel GDG members to be reopened during the switch.
	<p>		<p>
	Valid only ~~for a~~ <var>CCAJLOG</var> parallel stream defined with GDG members, as in the following example, which specifies two complete copies of CCAJLOG using GDGs as a base:</p>		Valid only when <var>CCAJLOG</var> or <var>CCAJRNL</var> are defined as a parallel stream defined with GDG members, as in the following example, which specifies two complete copies of CCAJLOG using GDGs as a base:</p>
	<p class="code">DEFINE STREAM CCAJLOG … PARALLEL=(P1,P2) …		<p class="code">DEFINE STREAM CCAJLOG … PARALLEL=(P1,P2) …
	DEFINE STREAM P1 … GDG=(D1) …		DEFINE STREAM P1 … GDG=(D1) …
Line 26:		Line 26:
	DEFINE DATASET D1….		DEFINE DATASET D1….
	DEFINE DATASET D2… </p>		DEFINE DATASET D2… </p>
			<p>Note: <var>RESET</var> of <var>CCAJNRL</var> is only possible as version 8.0 of Model 204. A custom zap may be available for earlier versions.</p>
	</td></tr>		</td></tr>
	</table>		</table>

Goff: Update to reflect PDS8571

2024-10-13T21:59:37Z

Update to reflect PDS8571

← Older revision		Revision as of 21:59, 13 October 2024
Line 39:		Line 39:

	<li>If a <code>SWITCH STREAM CCAJRNL</code> command is issued during <code>CHECKPOINT EXTENDED QUIESCE</code> command processing, the journal is switched, a new checkpoint is issued, and the duration of the extended quiesce time-out set in <var>[[CPQZSECS parameter\|CPQZSECS]]</var> is reset to its maximum, original value (disregarding the already-elapsed time).</li>		<li>If a <code>SWITCH STREAM CCAJRNL</code> command is issued during <code>CHECKPOINT EXTENDED QUIESCE</code> command processing, the journal is switched, a new checkpoint is issued, and the duration of the extended quiesce time-out set in <var>[[CPQZSECS parameter\|CPQZSECS]]</var> is reset to its maximum, original value (disregarding the already-elapsed time).</li>

			<li>A <code>SWITCH STREAM CCAJRNL RESET</code> command is only allowed during <code>CHECKPOINT EXTENDED QUIESCE</code> command processing. Ie</li>
			<p class="code">CHECKPOINT SET E Q
			CHECKPOINT
			SWITCH STREAM CCAJRNL RESET
			CHECKPOINT UNSET E Q
			</p>

	<li>For an extensive discussion about using the <var>SWITCH STREAM</var> command, see [[Tracking system activity (CCAJRNL, CCAAUDIT, CCAJLOG)#SWITCH STREAM command\|Tracking system activity (CCAJRNL, CCAAUDIT, CCAJLOG)]]. </li> </ul>		<li>For an extensive discussion about using the <var>SWITCH STREAM</var> command, see [[Tracking system activity (CCAJRNL, CCAAUDIT, CCAJLOG)#SWITCH STREAM command\|Tracking system activity (CCAJRNL, CCAAUDIT, CCAJLOG)]]. </li> </ul>

JAL: add link

2018-06-29T17:31:19Z

add link

← Older revision		Revision as of 17:31, 29 June 2018
Line 8:		Line 8:

	==Syntax==		==Syntax==
	<p class="syntax">SWITCH STREAM <span class="term">streamname</span> [ RESET ]		<p class="syntax">SWITCH STREAM <span class="term">streamname</span> [RESET]
	</p>		</p>

Line 39:		Line 39:

	<li>If a <code>SWITCH STREAM CCAJRNL</code> command is issued during <code>CHECKPOINT EXTENDED QUIESCE</code> command processing, the journal is switched, a new checkpoint is issued, and the duration of the extended quiesce time-out set in <var>[[CPQZSECS parameter\|CPQZSECS]]</var> is reset to its maximum, original value (disregarding the already-elapsed time).</li>		<li>If a <code>SWITCH STREAM CCAJRNL</code> command is issued during <code>CHECKPOINT EXTENDED QUIESCE</code> command processing, the journal is switched, a new checkpoint is issued, and the duration of the extended quiesce time-out set in <var>[[CPQZSECS parameter\|CPQZSECS]]</var> is reset to its maximum, original value (disregarding the already-elapsed time).</li>
	</ul>
			<li>For an extensive discussion about using the <var>SWITCH STREAM</var> command, see [[Tracking system activity (CCAJRNL, CCAAUDIT, CCAJLOG)#SWITCH STREAM command\|Tracking system activity (CCAJRNL, CCAAUDIT, CCAJLOG)]]. </li> </ul>

	==See also==		==See also==

JAL: misc cleanup

2015-05-14T22:02:42Z

misc cleanup

← Older revision		Revision as of 22:02, 14 May 2015
Line 20:		Line 20:
	<td>This optional parameter causes any disabled parallel GDG members to be reopened during the switch.		<td>This optional parameter causes any disabled parallel GDG members to be reopened during the switch.
	<p>		<p>
	Valid only for a CCAJLOG parallel stream defined with GDG members, as in the following example, which specifies two complete copies of CCAJLOG using GDGs as a base:</p>		Valid only for a <var>CCAJLOG</var> parallel stream defined with GDG members, as in the following example, which specifies two complete copies of CCAJLOG using GDGs as a base:</p>
	<p class="code">DEFINE STREAM CCAJLOG … PARALLEL=(P1,P2) …		<p class="code">DEFINE STREAM CCAJLOG … PARALLEL=(P1,P2) …
	DEFINE STREAM P1 … GDG=(D1) …		DEFINE STREAM P1 … GDG=(D1) …
Line 33:		Line 33:
	<li>If you specify:		<li>If you specify:
	<ul>		<ul>
	<li>~~Journal~~ stream CCAJRNL or CCAJLOG: the currently active data set is closed and the next data set defined to the stream is opened. </li>		<li>A journal stream (<var>CCAJRNL</var> or <var>CCAJLOG</var>): the currently active data set is closed and the next data set defined to the stream is opened. </li>

	<li>~~Checkpoint~~ stream CHKPOINT or CHKPNTS: the currently active data set in the stream is closed after the next record is written to the data set.</li>		<li>A checkpoint stream (<var>CHKPOINT</var> or <var>CHKPNTS</var>): the currently active data set in the stream is closed after the next record is written to the data set.</li>
	</ul></li>		</ul></li>

Line 44:		Line 44:
	<ul>		<ul>
	<li>[[DEFINE STREAM command]] </li>		<li>[[DEFINE STREAM command]] </li>
			<li>[[COPY STREAM command]] </li>
	<li>[[Configuring checkpoint and journal data streams]] </li>		<li>[[Configuring checkpoint and journal data streams]] </li>
	</ul>		</ul>

JAL: add example

2015-05-13T22:24:22Z

add example

← Older revision		Revision as of 22:24, 13 May 2015
Line 20:		Line 20:
	<td>This optional parameter causes any disabled parallel GDG members to be reopened during the switch.		<td>This optional parameter causes any disabled parallel GDG members to be reopened during the switch.
	<p>		<p>
	Valid only for a CCAJLOG stream ~~specified~~ as a ~~Parallel~~ GDG.</p></td></tr>		Valid only for a CCAJLOG parallel stream defined with GDG members, as in the following example, which specifies two complete copies of CCAJLOG using GDGs as a base:</p>
			<p class="code">DEFINE STREAM CCAJLOG … PARALLEL=(P1,P2) …
			DEFINE STREAM P1 … GDG=(D1) …
			DEFINE STREAM P2 … GDG=(D2) …
			DEFINE DATASET D1….
			DEFINE DATASET D2… </p>
			</td></tr>
	</table>		</table>

Line 33:		Line 39:

	<li>If a <code>SWITCH STREAM CCAJRNL</code> command is issued during <code>CHECKPOINT EXTENDED QUIESCE</code> command processing, the journal is switched, a new checkpoint is issued, and the duration of the extended quiesce time-out set in <var>[[CPQZSECS parameter\|CPQZSECS]]</var> is reset to its maximum, original value (disregarding the already-elapsed time).</li>		<li>If a <code>SWITCH STREAM CCAJRNL</code> command is issued during <code>CHECKPOINT EXTENDED QUIESCE</code> command processing, the journal is switched, a new checkpoint is issued, and the duration of the extended quiesce time-out set in <var>[[CPQZSECS parameter\|CPQZSECS]]</var> is reset to its maximum, original value (disregarding the already-elapsed time).</li>
			</ul>

			==See also==
			<ul>
			<li>[[DEFINE STREAM command]] </li>

			<li>[[Configuring checkpoint and journal data streams]] </li>
	</ul>		</ul>

	[[Category: System manager commands]]		[[Category: System manager commands]]
	[[Category: Commands]]		[[Category: Commands]]

JAL: misc formatting

2015-05-12T23:23:11Z

misc formatting

← Older revision		Revision as of 23:23, 12 May 2015
Line 4:		Line 4:
	<dd>System manager		<dd>System manager
	<dt>Function		<dt>Function
	<dd>You can switch streams-parallel, ring, concatenated, GDG-to the next member at any time.		<dd>You can switch streams — parallel, ring, concatenated, GDG — to the next member at any time.
	</dl>		</dl>

	==Syntax==		==Syntax==
	<p class="syntax">SWITCH STREAM <span class="term">streamname</span> [ RESET ]		<p class="syntax">SWITCH STREAM <span class="term">streamname</span> [ RESET ]
	</p>		</p>

	<b>~~Where:~~</b>		Where:
	<var ~~class="term"~~>~~streamname~~</var> ~~specifies CCAJRNL~~, CCAJLOG, CHKPOINT, or CHKPNTS. The command is valid for ~~only~~ these streams.
			<table>
			<tr><th>streamname</th>
			<td><var>CCAJRNL</var>, <var>CCAJLOG</var>, <var>CHKPOINT</var>, or <var>CHKPNTS</var>. The command is valid only for these streams.</td></tr>

			<tr><th><var>RESET</var></th>
			<td>This optional parameter causes any disabled parallel GDG members to be reopened during the switch.
			<p>
			Valid only for a CCAJLOG stream specified as a Parallel GDG.</p></td></tr>
			</table>

	==Usage notes==		==Usage notes==
	If you specify:		<ul>
			<li>If you specify:
	<ul>		<ul>
	<li>		<li>Journal stream CCAJRNL or CCAJLOG: the currently active data set is closed and the next data set defined to the stream is opened. </li>
	<p>Journal stream CCAJRNL or CCAJLOG, the currently active data set is closed and the next data set defined to the stream is opened. ~~</p>~~
	</li>

	<li>		<li>Checkpoint stream CHKPOINT or CHKPNTS: the currently active data set in the stream is closed after the next record is written to the data set.</li>
	<p>Checkpoint stream CHKPOINT or CHKPNTS, the currently active data set in the stream is closed after the next record is written to the data set.~~</p>~~		</ul></li>
	</li>
	</ul>
	<p>If a SWITCH STREAM CCAJRNL command is issued during CHECKPOINT EXTENDED QUIESCE command processing, the journal will be switched, a new checkpoint issued, and the duration extended quiesce time-out set in CPQZSECS will be reset to its maximum, original value-disregarding the already elapsed time.</p>

	<~~table~~>		<li>If a <code>SWITCH STREAM CCAJRNL</code> command is issued during <code>CHECKPOINT EXTENDED QUIESCE</code> command processing, the journal is switched, a new checkpoint is issued, and the duration of the extended quiesce time-out set in <var>[[CPQZSECS parameter\|CPQZSECS]]</var> is reset to its maximum, original value (disregarding the already-elapsed time).</li>
	<tr><th><~~var~~>~~RESET~~</var></th>		</ul>
	~~<td>This optional parameter will cause any disabled parallel GDG members~~ to ~~be reopened during~~ the ~~switch~~.
	<p>~~Valid only for a CCAJLOG stream specified as a Parallel GDG.~~

	[[Category: System manager commands]]		[[Category: System manager commands]]
	[[Category:Commands]]		[[Category: Commands]]

ELowell: /* Syntax */

2015-04-28T21:05:24Z

Syntax

← Older revision		Revision as of 21:05, 28 April 2015
Line 7:		Line 7:
	</dl>		</dl>
	==Syntax==		==Syntax==
	<p class="syntax">SWITCH STREAM streamname [ RESET ]		<p class="syntax">SWITCH STREAM <span class="term">streamname</span> [ RESET ]
	</p>		</p>

	<b>Where:</b>		<b>Where:</b>
	streamname specifies CCAJRNL, CCAJLOG, CHKPOINT, or CHKPNTS. The command is valid for only these streams.		<var class="term">streamname</var> specifies CCAJRNL, CCAJLOG, CHKPOINT, or CHKPNTS. The command is valid for only these streams.

	==Usage notes==		==Usage notes==
	If you specify:		If you specify:

DVRICKP at 20:38, 28 April 2015

2015-04-28T20:38:20Z

← Older revision		Revision as of 20:38, 28 April 2015
Line 28:		Line 28:
	<tr><th><var>RESET</var></th>		<tr><th><var>RESET</var></th>
	<td>This optional parameter will cause any disabled parallel GDG members to be reopened during the switch.		<td>This optional parameter will cause any disabled parallel GDG members to be reopened during the switch.
	<p>Valid only for a CCAJLOG stream specified as a Parallel GDG.~~</td></tr>~~		<p>Valid only for a CCAJLOG stream specified as a Parallel GDG.

	[[Category: System manager commands]]		[[Category: System manager commands]]
	[[Category:Commands]]		[[Category:Commands]]

DVRICKP at 20:37, 28 April 2015

2015-04-28T20:37:05Z

← Older revision		Revision as of 20:37, 28 April 2015
Line 27:		Line 27:
	<table>		<table>
	<tr><th><var>RESET</var></th>		<tr><th><var>RESET</var></th>
	<td>This optional parameter will cause any disabled parallel GDG members to be reopened during the switch. ~~</td>~~		<td>This optional parameter will cause any disabled parallel GDG members to be reopened during the switch.
	<td>Valid only for a CCAJLOG stream specified as a Parallel GDG.</td></tr>		<p>Valid only for a CCAJLOG stream specified as a Parallel GDG.</td></tr>

	[[Category: System manager commands]]		[[Category: System manager commands]]
	[[Category:Commands]]		[[Category:Commands]]

DVRICKP at 20:35, 28 April 2015

2015-04-28T20:35:40Z

← Older revision	Revision as of 20:35, 28 April 2015
Line 1:	Line 1:
		==Summary==
		<dl>
		<dt>Privileges
		<dd>System manager
		<dt>Function
		<dd>You can switch streams-parallel, ring, concatenated, GDG-to the next member at any time.
		</dl>
		==Syntax==
		<p class="syntax">SWITCH STREAM streamname [ RESET ]
		</p>

		<b>Where:</b>
		streamname specifies CCAJRNL, CCAJLOG, CHKPOINT, or CHKPNTS. The command is valid for only these streams.
		==Usage notes==
		If you specify:
		<ul>
		<li>
		<p>Journal stream CCAJRNL or CCAJLOG, the currently active data set is closed and the next data set defined to the stream is opened. </p>
		</li>

		<li>
		<p>Checkpoint stream CHKPOINT or CHKPNTS, the currently active data set in the stream is closed after the next record is written to the data set.</p>
		</li>
		</ul>
		<p>If a SWITCH STREAM CCAJRNL command is issued during CHECKPOINT EXTENDED QUIESCE command processing, the journal will be switched, a new checkpoint issued, and the duration extended quiesce time-out set in CPQZSECS will be reset to its maximum, original value-disregarding the already elapsed time.</p>

		<table>
		<tr><th><var>RESET</var></th>
		<td>This optional parameter will cause any disabled parallel GDG members to be reopened during the switch. </td>
		<td>Valid only for a CCAJLOG stream specified as a Parallel GDG.</td></tr>

		[[Category: System manager commands]]
		[[Category:Commands]]