Dataset class - Revision history

RPuszewski at 15:35, 14 April 2021

2021-04-14T15:35:05Z

← Older revision		Revision as of 15:35, 14 April 2021
Line 7:		Line 7:
	The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.		The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.

	Beginning with Model 204 version 7.9, the <var>Dataset</var> class now supports VSAM datasets.		Beginning with Model 204 version 7.9, the <var>Dataset</var> class now supports read only access to VSAM datasets.

	The <var>Dataset</var> class operates on data sets or streams defined by any of the following:		The <var>Dataset</var> class operates on data sets or streams defined by any of the following:

RPuszewski at 15:02, 14 April 2021

2021-04-14T15:02:54Z

← Older revision		Revision as of 15:02, 14 April 2021
Line 6:		Line 6:

	The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.		The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.

			Beginning with Model 204 version 7.9, the <var>Dataset</var> class now supports VSAM datasets.

	The <var>Dataset</var> class operates on data sets or streams defined by any of the following:		The <var>Dataset</var> class operates on data sets or streams defined by any of the following:

JAL: add link

2016-01-28T17:27:16Z

add link

← Older revision		Revision as of 17:27, 28 January 2016
Line 1:		Line 1:
	The <var>Dataset</var> class provides an object-oriented interface to sequential datasets.		The <var>Dataset</var> class provides an object-oriented interface to sequential datasets.
	This interface is more flexible than the traditional image-oriented		This interface is more flexible than the [[Images\|traditional image-oriented interface]] used in <var class="product">SOUL</var>.
	interface used in <var class="product">~~User Language~~</var>.		In addition, the class provides <var class="product">SOUL</var> access to <var class="product">Model 204</var> streams —
	In addition, the class provides <var class="product">~~User Language~~</var> access to <var class="product">Model 204</var> streams —		datastreams composed of one or more sequential data sets via the <var class="product">Model 204</var>
	datastreams composed of one or more sequential ~~datasets~~ via the <var class="product">Model 204</var>
	<var>[[DEFINE_STREAM_command\|DEFINE STREAM]]</var> command.		<var>[[DEFINE_STREAM_command\|DEFINE STREAM]]</var> command.

	The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.		The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.

	The <var>Dataset</var> class operates on ~~datasets~~ or streams defined by any of the		The <var>Dataset</var> class operates on data sets or streams defined by any of the following:
	following:
	<ul>		<ul>
	<li>An MVS DD card.		<li>An MVS DD card.

Dme: /* Dataset example */

2016-01-28T16:48:58Z

Dataset example

← Older revision		Revision as of 16:48, 28 January 2016
Line 23:		Line 23:

	==Dataset example==		==Dataset example==
	The following simple example is a program that displays the contents of		The following simple example is a program that displays the contents of a
	sequential dataset ~~(or stream) <code>SEQIN</code>~~:		sequential dataset:
	<p class="code">b		<p class="code">ALLOCATE SEQIN WITH SCOPE=SYSTEM OLD SEQUENTIAL -
			DSNAME=PROD.TEST.DATA
			begin
	%ds is object dataset		%ds is object dataset
	%l is longstring		%l is longstring

JAL: minor cleanup

2014-04-14T20:12:32Z

minor cleanup

← Older revision		Revision as of 20:12, 14 April 2014
Line 14:		Line 14:
	<li>A VSE DLBL card.		<li>A VSE DLBL card.
	<li>A CMS FILEDEF command.		<li>A CMS FILEDEF command.
	<li>A <var class="product">Model 204</var> <var>ALLOCATE</var> command ~~(see the <i>Model 204 Command Reference Manual</i>)~~.		<li>A <var class="product">Model 204</var> <var>[[ALLOCATE command\|ALLOCATE]]</var> command.
	<li>A <var class="product">Model 204</var> <var>DEFINE STREAM</var> command ~~(see the <i>Model 204 Command Reference Manual</i>)~~.		<li>A <var class="product">Model 204</var> <var>DEFINE STREAM</var> command.
	</ul>		</ul>

Line 23:		Line 23:

	==Dataset example==		==Dataset example==

	The following simple example is a program that displays the contents of		The following simple example is a program that displays the contents of
	sequential dataset (or stream) <code>SEQIN</code>:		sequential dataset (or stream) <code>SEQIN</code>:
Line 42:		Line 41:
	end		end
	</p>		</p>
	'''Note:'''		<p class="note">'''Note:'''
	If you want to do more extensive work with <var class="product">Model 204</var> journals,		If you want to do more extensive work with <var class="product">Model 204</var> journals,
	the <var>[[Journal class\|Journal]]</var> class is designed for that purpose.		the <var>[[Journal class\|Journal]]</var> class is designed for that purpose. </p>

	==The RecordFormat enumeration==		==The RecordFormat enumeration==
	The <var>RecordFormat</var> [[Enumerations\|enumeration]] indicates the format of the blocks in the sequential		The <var>RecordFormat</var> [[Enumerations\|enumeration]] indicates the format of the blocks in the sequential dataset.
	dataset.
	While, strictly speaking, the <var>RecordFormat</var> enumeration actually describes block		While, strictly speaking, the <var>RecordFormat</var> enumeration actually describes block
	formats or maybe file formats, it corresponds to the RECFM value used in DD cards,		formats or maybe file formats, it corresponds to the RECFM value used in DD cards,
Line 54:		Line 52:

	The values of the <var>RecordFormat</var> enumeration are:		The values of the <var>RecordFormat</var> enumeration are:
	<table>		<table class="thJustBold">
	<tr><th>U		<tr><th>U
	</th><td>Undefined format (each block is treated as a single record).		</th><td>Undefined format (each block is treated as a single record).
	</td></tr>		</td></tr>

	<tr><th>F		<tr><th>F
	</th><td>Fixed format (each block contains one fixed length record).		</th><td>Fixed format (each block contains one fixed length record).
	</td></tr>		</td></tr>

	<tr><th>V		<tr><th>V
	</th><td>Variable format (each block contains one variable length record).		</th><td>Variable format (each block contains one variable length record).
	</td></tr>		</td></tr>

	<tr><th>FB		<tr><th>FB
	</th><td>Fixed blocked format (each block contains one or more fixed length records).		</th><td>Fixed blocked format (each block contains one or more fixed length records).
	</td></tr>		</td></tr>

	<tr><th>VB		<tr><th>VB
	</th><td>Variable blocked format (each block contains one or more variable length records).		</th><td>Variable blocked format (each block contains one or more variable length records).
	</td></tr></table>		</td></tr></table>

	'''Note:''' As with all enumerations, the <var>ToString</var> method implicitly converts an enumeration value to a character string whose value is the name of the enumeration value. For more information about methods available to all enumerations, see [[Enumerations#Common enumeration methods\|"Common enumeration methods"]].		<p class="note">'''Note:''' As with all enumerations, the <var>ToString</var> method implicitly converts an enumeration value to a character string whose value is the name of the enumeration value. For more information about methods available to all enumerations, see [[Enumerations#Common enumeration methods\|Common enumeration methods]]. </p>

	==The DatasetState enumeration==		==The DatasetState enumeration==
Line 81:		Line 83:

	The values of the <var>DatasetState</var> enumeration are:		The values of the <var>DatasetState</var> enumeration are:
	<table>		<table class="thJustBold">
	<tr><th>Closed		<tr><th>Closed
	</th><td>Object has just been created or just closed.		</th><td>Object has just been created or just closed.
	</td></tr>		</td></tr>

	<tr><th>Open		<tr><th>Open
	</th><td>Object has been opened and can either be read from or written to.		</th><td>Object has been opened and can either be read from or written to.
	</td></tr>		</td></tr>

	<tr><th>AfterEnd		<tr><th>AfterEnd
	</th><td>Last read from object detected end of file.		</th><td>Last read from object detected end of file.
	</td></tr>		</td></tr>

	<tr><th>Full		<tr><th>Full
	</th><td>Last write to object detected a file full condition.		</th><td>Last write to object detected a file full condition.
Line 96:		Line 101:

	==List of Dataset methods==		==List of Dataset methods==
	The [[List of Dataset methods~~\|"List of Dataset methods"~~]] shows all the class methods.		The [[List of Dataset methods]] shows all the class methods.

	[[Category:System classes]]		[[Category:System classes]]

DCameron at 11:49, 14 April 2014

2014-04-14T11:49:55Z

← Older revision		Revision as of 11:49, 14 April 2014
Line 4:		Line 4:
	In addition, the class provides <var class="product">User Language</var> access to <var class="product">Model 204</var> streams —		In addition, the class provides <var class="product">User Language</var> access to <var class="product">Model 204</var> streams —
	datastreams composed of one or more sequential datasets via the <var class="product">Model 204</var>		datastreams composed of one or more sequential datasets via the <var class="product">Model 204</var>
	<var>[[DEFINE_STREAM_command\|DEFINE STREAM]]</var> command ~~(see the <var class="product">[http://www.cca-int.com/custsupp/documentation/catalog.html Model 204 Command Reference Manual]</var>)~~.		<var>[[DEFINE_STREAM_command\|DEFINE STREAM]]</var> command.

	The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.		The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.

DCameron at 11:49, 14 April 2014

2014-04-14T11:49:11Z

← Older revision		Revision as of 11:49, 14 April 2014
Line 4:		Line 4:
	In addition, the class provides <var class="product">User Language</var> access to <var class="product">Model 204</var> streams —		In addition, the class provides <var class="product">User Language</var> access to <var class="product">Model 204</var> streams —
	datastreams composed of one or more sequential datasets via the <var class="product">Model 204</var>		datastreams composed of one or more sequential datasets via the <var class="product">Model 204</var>
	<var>DEFINE STREAM</var> command (see the <var class="product">[http://www.cca-int.com/custsupp/documentation/catalog.html Model 204 Command Reference Manual]</var>).		<var>[[DEFINE_STREAM_command\|DEFINE STREAM]]</var> command (see the <var class="product">[http://www.cca-int.com/custsupp/documentation/catalog.html Model 204 Command Reference Manual]</var>).

	The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.		The <var>Dataset</var> class is available in <var class="product">Sirius Mods</var> 7.2 and later.

JAL: /* Dataset example */

2012-11-15T00:42:40Z

Dataset example

← Older revision		Revision as of 00:42, 15 November 2012
Line 40:		Line 40:
	print %l		print %l
	end repeat		end repeat

	end		end
	</p>		</p>

JAL: /* Dataset example */

2012-11-14T23:42:17Z

Dataset example

← Older revision		Revision as of 23:42, 14 November 2012
Line 26:		Line 26:
	The following simple example is a program that displays the contents of		The following simple example is a program that displays the contents of
	sequential dataset (or stream) <code>SEQIN</code>:		sequential dataset (or stream) <code>SEQIN</code>:
	<p class="code"> b		<p class="code">b
	%ds is object dataset		%ds is object dataset
	%l is longstring		%l is longstring

	%ds = [[New (Dataset constructor)\|new]]('SEQIN')		%ds = [[New (Dataset constructor)\|new]]('SEQIN')
	%ds:[[Open (Dataset function)\|open]]		%ds:[[Open (Dataset function)\|open]]

	repeat forever		repeat forever
	%l = %ds:[[ReadRecord (Dataset function)\|readRecord]]		%l = %ds:[[ReadRecord (Dataset function)\|readRecord]]
	if %ds:[[State (Dataset property)\|state]] eq afterEnd then		if %ds:[[State (Dataset property)\|state]] eq afterEnd then
	loop end		loop end
	end if		end if
	print %l		print %l
	end repeat		end repeat

	end		end
	</p>		</p>
	'''Note:'''		'''Note:'''

JAL2: /* Dataset example */

2012-05-17T18:37:02Z

Dataset example

← Older revision		Revision as of 18:37, 17 May 2012
Line 25:		Line 25:

	The following simple example is a program that displays the contents of		The following simple example is a program that displays the contents of
	sequential dataset (or stream) SEQIN:		sequential dataset (or stream) <code>SEQIN</code>:
	<p class="code"> b		<p class="code"> b
	%ds is object dataset		%ds is object dataset