DEFINE STREAM command - Revision history

RPuszewski: /* Syntax */

2026-06-15T14:29:00Z

Syntax

← Older revision		Revision as of 14:29, 15 June 2026
Line 126:		Line 126:
	<tr><th><var>CONTROL</var></th>		<tr><th><var>CONTROL</var></th>
	<td>Specifies the name of a data set that contains control information for the <var>RING</var> stream or <var>GDG</var> data set. The <var>CONTROL</var> data set is required only for CCAJRNL <var>RING</var> streams and <var>GDG</var> data sets. <code>SPACE=CYL,(1,1)</code> is sufficient. You do not need to specify any DCB attributes, <var class="product">Model 204</var> sets those to:		<td>Specifies the name of a data set that contains control information for the <var>RING</var> stream or <var>GDG</var> data set. The <var>CONTROL</var> data set is required only for CCAJRNL <var>RING</var> streams and <var>GDG</var> data sets. <code>SPACE=CYL,(1,1)</code> is sufficient. You do not need to specify any DCB attributes, <var class="product">Model 204</var> sets those to:
	<p class="code">RECFM=U,LRECL=24,BLKSIZE=24		<p class="code">For RING streams: RECFM=U,LRECL=24,BLKSIZE=24 </p>
	</p>		<p class="code">For GDG streams: RECFM=U,LRECL=76,BLKSIZE=76 </p>
	<p>The <var>CONTROL</var> data set keeps track of each offload that has occurred and what the current ring member or GDG stream is. It is an output data set during the original run. If recovery is subsequently required, it is an input data set that tells recovery:</p>		<p>The <var>CONTROL</var> data set keeps track of each offload that has occurred and what the current ring member or GDG stream is. It is an output data set during the original run. If recovery is subsequently required, it is an input data set that tells recovery:</p>
	<ul>		<ul>

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>