SWITCH STREAM command: Difference between revisions
Jump to navigation
Jump to search
(→Syntax) |
m (misc formatting) |
||
| Line 4: | Line 4: | ||
<dd>System manager | <dd>System manager | ||
<dt>Function | <dt>Function | ||
<dd>You can switch streams | <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> | ||
< | Where: | ||
<var | |||
<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> | ||
</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> | ||
</ul></li> | |||
</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> | ||
< | |||
[[Category: System manager commands]] | [[Category: System manager commands]] | ||
[[Category:Commands]] | [[Category: Commands]] | ||
Revision as of 23:23, 12 May 2015
Summary
- Privileges
- System manager
- Function
- You can switch streams — parallel, ring, concatenated, GDG — to the next member at any time.
Syntax
SWITCH STREAM streamname [ RESET ]
Where:
| streamname | CCAJRNL, CCAJLOG, CHKPOINT, or CHKPNTS. The command is valid only for these streams. |
|---|---|
| RESET | This optional parameter causes any disabled parallel GDG members to be reopened during the switch.
Valid only for a CCAJLOG stream specified as a Parallel GDG. |
Usage notes
- If you specify:
- Journal stream CCAJRNL or CCAJLOG: the currently active data set is closed and the next data set defined to the stream is opened.
- 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.
- If a
SWITCH STREAM CCAJRNLcommand is issued duringCHECKPOINT EXTENDED QUIESCEcommand processing, the journal is switched, a new checkpoint is issued, and the duration of the extended quiesce time-out set in CPQZSECS is reset to its maximum, original value (disregarding the already-elapsed time).