DEFINE STREAM command - Revision history

JAL: /* Usage notes */ typo

2017-11-29T00:36:52Z

Usage notes: typo

← Older revision		Revision as of 00:36, 29 November 2017
Line 168:		Line 168:
	The <var>DEFINE STREAM</var> command is only for the recovery streams CCAJLOG, CCAJRNL, CCARF, CHKPNTS, CHKPOINT, RESTART, and RESTARTS. The ring stream <var>OFFLOAD</var> option can also be a stream of any type or a data set. These <var>DEFINE STREAM</var> commands can be entered before the User 0 parameter line in the CCAIN data set. This allows them to be defined by the system manager before they are opened by the initialization routines.</p>		The <var>DEFINE STREAM</var> command is only for the recovery streams CCAJLOG, CCAJRNL, CCARF, CHKPNTS, CHKPOINT, RESTART, and RESTARTS. The ring stream <var>OFFLOAD</var> option can also be a stream of any type or a data set. These <var>DEFINE STREAM</var> commands can be entered before the User 0 parameter line in the CCAIN data set. This allows them to be defined by the system manager before they are opened by the initialization routines.</p>
	<p>		<p>
	For more information on sequential file processing, see ~~<var>~~[[OFFLOAD command]]~~</var>~~.</p>		For more information on sequential file processing, see [[OFFLOAD command]].</p>

	<p>For general syntax and usage notes that apply to all forms of the <var>DEFINE</var> command, see ~~<var>~~[[DEFINE command]]~~</var>~~.</p>		<p>For general syntax and usage notes that apply to all forms of the <var>DEFINE</var> command, see [[DEFINE command]].</p>

	====Handling mutually exclusive or missing options====		====Handling mutually exclusive or missing options====

ELowell: /* Usage notes */

2017-04-06T21:43:48Z

Usage notes

← Older revision		Revision as of 21:43, 6 April 2017
Line 168:		Line 168:
	The <var>DEFINE STREAM</var> command is only for the recovery streams CCAJLOG, CCAJRNL, CCARF, CHKPNTS, CHKPOINT, RESTART, and RESTARTS. The ring stream <var>OFFLOAD</var> option can also be a stream of any type or a data set. These <var>DEFINE STREAM</var> commands can be entered before the User 0 parameter line in the CCAIN data set. This allows them to be defined by the system manager before they are opened by the initialization routines.</p>		The <var>DEFINE STREAM</var> command is only for the recovery streams CCAJLOG, CCAJRNL, CCARF, CHKPNTS, CHKPOINT, RESTART, and RESTARTS. The ring stream <var>OFFLOAD</var> option can also be a stream of any type or a data set. These <var>DEFINE STREAM</var> commands can be entered before the User 0 parameter line in the CCAIN data set. This allows them to be defined by the system manager before they are opened by the initialization routines.</p>
	<p>		<p>
	For more information on sequential file processing, ~~refer~~ to [[~~OFFLOAD~~ command]].</p>		For more information on sequential file processing, see <var>[[OFFLOAD command]]</var>.</p>

			<p>For general syntax and usage notes that apply to all forms of the <var>DEFINE</var> command, see <var>[[DEFINE command]]</var>.</p>

	====Handling mutually exclusive or missing options====		====Handling mutually exclusive or missing options====

JAL: add link

2015-05-14T21:56:28Z

add link

← Older revision		Revision as of 21:56, 14 May 2015
Line 20:		Line 20:

	<table>		<table>
			<tr><th>name</th>
			<td>Identifies the stream. It may be a keyword or, for a sub- or member stream, a non-keyword. See the example in [[#Example\|Example]], below.
			<p>
			Valid keywords, which refer to Model 204 recognized data set DDnames, are: <var>CCAJLOG</var>, <var>CCAJRNL</var>, <var>CHKPOINT</var>, <var>CHKPNTS</var>, <var>RESTART</var>, <var>RESTARTS</var>, <var>CCARF</var>, <var>CCAGEN</var>. </p></td></tr>

	<tr><th><var>CONCATENATE</var></th>		<tr><th><var>CONCATENATE</var></th>
	<td>Specifies a stream defined with a concatenated configuration.		<td>Specifies a stream defined with a concatenated configuration.
Line 196:		Line 201:
	<p>		<p>
	When you encounter these types of errors, the solution is to rewrite the commands.</p>		When you encounter these types of errors, the solution is to rewrite the commands.</p>

			==See also==
			<ul>
			<li>[[SWITCH STREAM command]] </li>
			<li>[[COPY STREAM command]] </li>
			<li>[[Configuring checkpoint and journal data streams]] </li>
			</ul>

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

JAL: syntax tweak

2015-05-13T18:50:06Z

syntax tweak

← Older revision		Revision as of 18:50, 13 May 2015
Line 14:		Line 14:
	\| PARALLEL=(<span class="term">stream1</span> [,<span class="term">streamn</span>]) MINAVAIL=<span class="term">n</span>		\| PARALLEL=(<span class="term">stream1</span> [,<span class="term">streamn</span>]) MINAVAIL=<span class="term">n</span>
	\| GDG=<span class="term">ddname</span> CONTROL=<span class="term">ddname2</span>		\| GDG=<span class="term">ddname</span> CONTROL=<span class="term">ddname2</span>
	\| RING=(<span class="term">stream1</span> [,<span class="term">streamn</span>]...) ~~[AUTOOFFLOAD~~=<span class="term">n</span>~~] OFFLOAD~~=<span class="term">~~stream~~</span> [~~CLOSE={AUTO \| NOAUTO}] CONTROL~~=<span class="term">~~ddname~~</span> <span class="squareb">}</span>		\| RING=(<span class="term">stream1</span> [,<span class="term">streamn</span>]...) OFFLOAD=<span class="term">stream</span> CONTROL=<span class="term">ddname</span> [AUTOOFFLOAD=<span class="term">n</span>] [CLOSE={AUTO \| NOAUTO}] <span class="squareb">}</span>
	</p>		</p>
	<p>		<p>

JAL: misc cleanup

2015-05-12T23:14:08Z

misc cleanup

← Older revision		Revision as of 23:14, 12 May 2015
Line 10:		Line 10:

	==Syntax==		==Syntax==
	<p class="syntax">DEFINE STREAM <span class="term">name</span> [LIKE <span class="term">previousname</span>] WITH		<p class="syntax">DEFINE STREAM <span class="term">name</span> [LIKE <span class="term">previousname</span>] WITH SCOPE=SYSTEM
	SCOPE=SYSTEM		<span class="squareb">{</span> CONCATENATE=(<span class="term">stream1</span> [,<span class="term">streamn</span>]...)
	{CONCATENATE=(<span class="term">stream1</span> [,<span class="term">streamn</span>]...)		\| PARALLEL=(<span class="term">stream1</span> [,<span class="term">streamn</span>]) MINAVAIL=<span class="term">n</span>
	\| [PARALLEL=(<span class="term">stream1</span> [,<span class="term">streamn</span>] MINAVAIL=<span class="term">n</span>]		\| GDG=<span class="term">ddname</span> CONTROL=<span class="term">ddname2</span>
	\| GDG=<span class="term">ddname</span> CONTROL=<span class="term">ddname2</span>}		\| RING=(<span class="term">stream1</span> [,<span class="term">streamn</span>]...) [AUTOOFFLOAD=<span class="term">n</span>] OFFLOAD=<span class="term">stream</span> [CLOSE={AUTO \| NOAUTO}] CONTROL=<span class="term">ddname</span> <span class="squareb">}</span>
	\| ((RING=(<span class="term">stream1</span> [,<span class="term">streamn</span>]...)
	[AUTOOFFLOAD=<span class="term">n</span>] OFFLOAD=<span class="term">stream</span>
	[CLOSE={AUTO \| NOAUTO}]) CONTROL=<span class="term">ddname</span>)
	</p>		</p>
	<p>		<p>
Line 24:		Line 21:
	<table>		<table>
	<tr><th><var>CONCATENATE</var></th>		<tr><th><var>CONCATENATE</var></th>
	<td>Specifies a stream defined with a concatenated configuration. </td></tr>		<td>Specifies a stream defined with a concatenated configuration.
			<p><var>CONCATENATE</var>, <var>PARALLEL</var>, <var>GDG</var>, and <var>RING</var> are mutually exclusive options.</p></td></tr>

	<tr><th nowrap>stream1 ... streamn</th>		<tr><th nowrap>stream1 ... streamn</th>
	<td>Options stream1 through streamn specify the names of the streams that are members of the concatenated configuration in the order of their use. The streams referred to can be:		<td>Options <var class="term">stream1</var> through <var class="term">streamn</var> specify the names of the streams that are members of the concatenated configuration in the order of their use. The streams referred to can be:
	<ul>		<ul>
	<li>		<li>
Line 40:		Line 38:

	<tr><th><var>PARALLEL</var></th>		<tr><th><var>PARALLEL</var></th>
	<td>Specifies a stream defined with a parallel configuration. A <var>PARALLEL</var> stream requires a <var>MINAVAIL</var> value.</td></tr>		<td>Specifies a stream defined with a parallel configuration. A <var>PARALLEL</var> stream requires a <var>MINAVAIL</var> value.
			<p><var>CONCATENATE</var>, <var>PARALLEL</var>, <var>GDG</var>, and <var>RING</var> are mutually exclusive options.</p></td></tr>

	<tr><th><var>MINAVAIL</var></th>		<tr><th><var>MINAVAIL</var></th>
Line 59:		Line 58:
	<p>Data set </p>		<p>Data set </p>
	</li>		</li>
	</ul></td></tr>		</ul>
			<p><var>CONCATENATE</var>, <var>PARALLEL</var>, <var>GDG</var>, and <var>RING</var> are mutually exclusive options.</p></td></tr>

	<tr><th><var>AUTOOFFLOAD</var></th>		<tr><th><var>AUTOOFFLOAD</var></th>
Line 90:		Line 90:

	<tr><th><var>CLOSE</var></th>		<tr><th><var>CLOSE</var></th>
	<td>Specifies the offloading action taken when the <var>RING</var> stream is closes.		<td>Specifies the offloading action taken when the <var>RING</var> stream closes.

	<table>		<table>
Line 117:		Line 117:
	</table>		</table>
	</td></tr>		</td></tr>
			</table>

	<tr><th><var>CONTROL</var></th>		<tr><th><var>CONTROL</var></th>
Line 138:		Line 139:
	<p>		<p>
	The <var>GDG</var> data set is available for only z/OS. GDG streams may only be used for journals and checkpoints. Use of GDG streams for directed output files does not work.</p>		The <var>GDG</var> data set is available for only z/OS. GDG streams may only be used for journals and checkpoints. Use of GDG streams for directed output files does not work.</p>
	</td></tr>		<p><var>CONCATENATE</var>, <var>PARALLEL</var>, <var>GDG</var>, and <var>RING</var> are mutually exclusive options.</p></td></tr>
	</~~table~~>
	</table>		</table>

JAL: misc cleanup

2015-05-11T20:14:53Z

misc cleanup

Show changes

JAL: minor cleanup

2014-08-29T18:32:47Z

minor cleanup

← Older revision		Revision as of 18:32, 29 August 2014
Line 20:		Line 20:
	</p>		</p>

	~~<b>Where:</b>~~		The command options are described in the following table. See also [[Configuring checkpoint and journal data streams]]. </p>
	~~You can use~~ the following ~~options to define a stream~~. See ~~the Rocket <var class="product">Model 204</var> System Manager's Guide for a discussion of configuring~~ checkpoint and journal data streams ~~and data sets~~.

	<table>		<table>
Line 104:		Line 103:
	<table>		<table>
	<caption>Effects of AUTO and NOAUTO options</caption>		<caption>Effects of AUTO and NOAUTO options</caption>
	<tr> <th>		<tr class="head"> <th>
	<p>Option</p>		<p>Option</p>
	</th>		</th>
Line 175:		Line 174:

	==Usage notes==		==Usage notes==
	<p>The DEFINE STREAM command is only for the recovery streams CCAJLOG, CCAJRNL, CCARF, CHKPNTS, CHKPOINT, RESTART, and RESTARTS. The ring stream OFFLOAD option can also be a stream of any type or a data set. These DEFINE STREAM commands can be entered before the User 0 parameter line in the CCAIN data set. This allows them to be defined by the system manager before they are opened by the initialization routines.</p>		<p>
	<p>For more information on sequential file processing, refer to [[OFFLOAD command]].</p>		The DEFINE STREAM command is only for the recovery streams CCAJLOG, CCAJRNL, CCARF, CHKPNTS, CHKPOINT, RESTART, and RESTARTS. The ring stream OFFLOAD option can also be a stream of any type or a data set. These DEFINE STREAM commands can be entered before the User 0 parameter line in the CCAIN data set. This allows them to be defined by the system manager before they are opened by the initialization routines.</p>
			<p>
			For more information on sequential file processing, refer to [[OFFLOAD command]].</p>

	====Handling mutually exclusive or missing options====		====Handling mutually exclusive or missing options====
	<p>Each type of stream you can define-CONCATENATE, PARALLEL, RING, GDG-is mutually exclusive of the other types of streams. If you define a stream with more than one type, <var class="product">Model 204</var> issues various messages, depending on the combination of types you defined.</p>		<p>
			Each type of stream you can define-CONCATENATE, PARALLEL, RING, GDG-is mutually exclusive of the other types of streams. If you define a stream with more than one type, <var class="product">Model 204</var> issues various messages, depending on the combination of types you defined.</p>
	<p>In the following example, CCAJRNL is defined with both the CONCATENATE and PARALLEL options:</p>		<p>In the following example, CCAJRNL is defined with both the CONCATENATE and PARALLEL options:</p>
	<p class="code">DEFINE STREAM CCAJRNL WITH SCOPE=SYSTEM -		<p class="code">DEFINE STREAM CCAJRNL WITH SCOPE=SYSTEM -
Line 204:		Line 206:
	<b></b>* 2 **** M204.0630: DEFINE COMMAND REJECTED		<b></b>* 2 **** M204.0630: DEFINE COMMAND REJECTED
	</p>		</p>
	<p>When you encounter these types of errors, the solution is to rewrite commands.</p>		<p>
			When you encounter these types of errors, the solution is to rewrite commands.</p>

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

JAL at 16:04, 7 March 2013

2013-03-07T16:04:56Z

← Older revision		Revision as of 16:04, 7 March 2013
Line 1:		Line 1:
			<p class="pageSubtitle">Describing sequential I/O streams</p>

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

JAL: /* Syntax */

2013-03-07T16:02:44Z

Syntax

← Older revision		Revision as of 16:02, 7 March 2013
Line 41:		Line 41:
	<td>Specifies a stream defined with a parallel configuration. A PARALLEL stream requires a MINAVAIL value.</td></tr>		<td>Specifies a stream defined with a parallel configuration. A PARALLEL stream requires a MINAVAIL value.</td></tr>

	<tr><th>MINAVAIL</th>		<tr><th><var>MINAVAIL</var></th>
	<td>Specifies the number of members that must remain available for a parallel stream to continue as a valid output stream.		<td>Specifies the number of members that must remain available for a parallel stream to continue as a valid output stream.
	<p>		<p>

JAL at 16:00, 7 March 2013

2013-03-07T16:00:41Z

Show changes